=== Filterable Page Cards ===
Contributors: Net Greater Technologies, LLP
Tags: grid, cards, filter, elementor, blocks, pages
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 2.8.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

The ultimate, highly customizable page and post grid builder for Gutenberg and Elementor with dynamic filtering, layout styling, typography controls, and smooth client-side pagination.

== Description ==

Filterable Page Cards is a premium-grade content display plugin that allows you to beautifully showcase your Pages or Blog Posts. 

With its dual-mode engine, you can choose to build an **Interactive Filterable Grid** (where users click custom tabs to sort cards instantly without reloading) or a **Standard Automatic Grid** (which automatically pulls your latest content based on your custom query rules).

Built for modern WordPress websites, this plugin natively supports both the **Gutenberg Block Editor** and **Elementor Page Builder**. It features a robust design engine, allowing you to control colors, hover colors, background image opacities, borders, cards per page, theme typography sizes, and pagination dots directly from the editor without touching a single line of CSS.

= Features: =
*   **Dual Compatibility:** Works natively as a Gutenberg Block and an Elementor Widget.
*   **Typography Controls:** Dedicated typography panel inside the editor allowing users to configure font sizes and inheritance.
*   **Two Grid Modes:** Build manual interactive filter tabs, or set it to "Standard" to automatically pull your latest content.
*   **Posts & Pages:** Seamlessly toggle between displaying Blog Posts or Pages.
*   **Smooth Client-Side Pagination:** Set your cards per page and navigate through pages instantly using modern dots and Prev/Next arrows without reloading the page.
*   **Dynamic Query Builder:** (Standard Mode) Control maximum posts to load, sorting order, and include/exclude specific IDs.
*   **Interactive Categories:** (Filterable Mode) Add, remove, and rename as many category tabs as you need using an intuitive repeater interface.
*   **Page/Post Search:** Easily find content by name using the built-in dropdown search—no need to manually look up IDs.
*   **Advanced Styling Engine:** Customize card background colors, hover background colors, title/text colors, title/text hover colors, and icon colors directly in the editor.
*   **Custom Borders:** Add dynamic borders (Top, Bottom, Left, Right, or All), pick the color, and adjust the thickness.
*   **Featured Image Backgrounds:** Automatically pulls the post's Featured Image with options to toggle visibility, control overlay opacity, adjust hover opacity, or hide the image entirely on hover.
*   **Hover Animations:** Hide text by default and reveal it smoothly only when the user hovers over the card.
*   **Responsive Layout Controls:** Switch between Card Grids or Stacked Lists, align text, and choose 2, 3, or 4 columns per row. Automatically adapts to tablet and mobile screens.
*   **Highly Secure:** Built with stringent data sanitization and output escaping.

== Installation ==

1. Upload the `filterable-page-cards` folder to the `/wp-content/plugins/` directory, or upload the `.zip` file via your WordPress dashboard.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Open any Page or Post using Gutenberg or Elementor.
4. Search for the "Filterable Page Cards" block/widget and add it to your layout.
5. Configure your typography, pagination, and layout options directly from the sidebar settings!

== Changelog ==

= 2.8.1 =
* Improved responsive layout logic: Fixed edge-to-edge padding issues on mobile and tablet devices.
* Optimized grid breakpoints to ensure 2-column layouts on tablets and 1-column layouts on mobile for better readability.

= 2.8.0 =
* Added dedicated "Typography & Fonts" panel with custom font size controls in the editor sidebar.
* Added full Title Hover Color and Text/Excerpt Hover Color controls.

= 2.7.0 =
* Added native Gutenberg typography support framework.

= 2.6.0 =
* Added background image toggle switch and overlay opacity slider.
* Optimized theme font compatibility across card titles and excerpts.

= 2.5.0 =
* Added smooth Client-Side Pagination supporting both Filterable Tabs and Standard Grids.
* Added "Cards Displayed Per Page" and "Total Maximum Posts" configuration controls.
* Added custom color pickers for Pagination Text and Pagination Dot/Arrow elements.

= 2.4.0 =
* Complete Styling Engine Overhaul: Added a dedicated "Styling & Colors" panel.
* Added CSS-variable powered color pickers for Card Backgrounds, Hover Backgrounds, Text, and Icons.
* Added dynamic border controls (Position, Color, and Thickness).
* Added advanced image hover options (Hide on hover, adjust hover opacity).

= 2.3.0 =
* Added "Grid Mode" toggle (Filterable Tabs vs. Standard Grid).
* Added Dynamic Query Builder for Standard Mode (Posts per page, Order By, Include/Exclude).

= 2.2.0 =
* Added support for Blog Posts.
* Added Post/Page segmented toggle button to easily switch content types.

= 2.1.0 =
* Added support for fetching and displaying Featured Images as card backgrounds.
* Added dark image overlays for better text readability.
* Added Hover Reveal effect.

= 2.0.0 =
* Major UI Overhaul: Replaced fixed categories with an unlimited Dynamic Category Repeater.
* Added Page Search Dropdown to easily find and add pages by title.

= 1.2.0 =
* Security Hardening: Added strict data sanitization (wp_parse_id_list) and output escaping.
* Added Elementor Page Builder integration.

= 1.1.0 =
* Added layout attributes and editor layout panel (Card vs. List mode, 2-4 columns).

= 1.0.0 =
* Initial release.