=== Webcasata FilterX ===
Contributors:      webcasata
Tags:              search, filter, ajax, taxonomy, posts
Requires at least: 5.8
Tested up to:      7.1
Requires PHP:      7.4
Stable tag:        1.0.23
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Ajax-powered post search and filtering by ACF custom taxonomies. Create unlimited search widgets with shortcodes — no coding required.

== Description ==

**Webcasata FilterX** lets you build powerful, Ajax-driven search widgets for your WordPress site in minutes. Filter posts by any taxonomy — including custom taxonomies created with Advanced Custom Fields (ACF) — with live results, keyword highlighting, and clean pagination.

= Key Features =

* **Ajax search** — results load without page refresh
* **Taxonomy filters** — dropdown filters for any registered taxonomy (including ACF taxonomies)
* **Keyword search** — searches post titles and content, constrained within selected taxonomies
* **Keyword highlighting** — matched keywords are highlighted in results
* **Unlimited search items** — create as many search configurations as you need
* **Shortcode** — each search item generates a ready-to-use shortcode
* **Gutenberg block** — insert search widgets directly in the block editor
* **Numbered pagination** — clean, accessible page navigation
* **Flexible display** — configure columns (1–6), posts per page, grid/list/masonry layout
* **URL sync** — filter state is reflected in the URL for bookmarkable, shareable searches
* **Card customization** — show title only, title + thumbnail, or title + excerpt + thumbnail
* **Custom "no results" message** — set a custom message and image for empty result states
* **WordPress.org compliant** — follows all WordPress coding standards

= Requirements =

* [Advanced Custom Fields (ACF)](https://www.advancedcustomfields.com/) — free version is sufficient

= Pro Version =

[Webcasata FilterX Pro](https://webcasata.com/webcasata-filterx-pro) unlocks:

* **Load More** pagination
* **Infinite Scroll** pagination
* **Hybrid Scroll** (Infinite + Load More)
* **Search Analytics** — top queries, zero-result reports
* **Custom card templates**

== Installation ==

1. Ensure **Advanced Custom Fields (ACF)** is installed and active.
2. Upload the `webcasata-filterx` folder to `/wp-content/plugins/`.
3. Activate **Webcasata FilterX** from the Plugins screen.
4. Go to **Webcasata FilterX → New Search** to create your first search widget.
5. Copy the generated shortcode and paste it into any page or post.

== Frequently Asked Questions ==

= Does this work without ACF? =

No — Webcasata FilterX requires ACF to be installed and active. ACF is used to define and manage custom taxonomies that power the filter dropdowns.

= Can I use it with the free version of ACF? =

Yes, the free version of ACF (available on WordPress.org) is all you need.

= How many search widgets can I create? =

Unlimited, on the free plan.

= Can I search across multiple post types? =

Each search widget targets one post type. You can create multiple widgets (one per post type) and place them anywhere on your site.

= Will it slow down my site? =

Webcasata FilterX uses WordPress's native `WP_Query` with standard nonce verification. All queries run only on user interaction (not on page load). No external API calls are made.

= Is the shortcode output cached? =

The initial results load is triggered by JavaScript after the page loads. You can add server-side caching (e.g. via Transients or object caching) using the `filterx_query_args` filter hook.

= How do I style the search widget? =

By default, Webcasata FilterX includes a clean, lightweight stylesheet. You can disable it in **Webcasata FilterX → Settings** and write your own CSS. All elements have descriptive class names (`.filterx-widget`, `.filterx-post-card`, etc.).

== Screenshots ==

1. Admin dashboard — all search items with shortcodes
2. New search item form — configure taxonomies, display options, pagination
3. Frontend widget — search bar, taxonomy filter dropdowns, post grid, pagination

== Changelog ==

= 1.0.7 =
* Display Options: replaced single "Card shows" dropdown with individual Show/Hide toggles for Title, Image, Excerpt, Meta, Terms, and Button.
* Added "Card Button Label" text field — customize the Read More button text per search form.
* Settings: added "Hide Sort Order dropdown" toggle to remove sort control from the frontend widget.
* Settings: added "Hide Filter tabs / dropdowns" toggle to remove taxonomy filter controls from the frontend widget.
* Frontend: added `.filterx-card-btn` Read More button style.

= 1.0.6 =
* Fixed taxonomy not loading on post type selection: moved all filterxAdmin JS data (nonce, ajaxUrl, isEdit, savedTaxonomies) into wp_localize_script() in class-filterx-assets.php.

= 1.0.5 =
* Three-strategy ACF taxonomy detection (native WP, $wp_taxonomies global walk, ACF CPT meta).

= 1.0.4 =
* Modern stepped admin UI with locked/unlocked steps.

= 1.0.3 =
* Added Load More pagination to free version.

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release. No upgrade action needed.
