=== Ace Products Filters ===
Contributors: acewpdev
Tags: woocommerce, product filters, ajax filtering, elementor, shortcode
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced free Wordpress filters for WooCommerce with unlimited sets, AJAX updates, styling controls, fully responsive, and dedicated Elementor widget.

== Description ==

Ace Products Filters gives you a practical way to build WooCommerce filters once and reuse them across your storefront.

Create saved filter sets for categories, global attributes, and price ranges, style them to match your store, and place them individually or inside reusable filter panels. Whether you are building a shop sidebar, a top bar, or a custom Elementor layout, you can keep the filtering experience consistent without rebuilding the same setup for every page.

🆓 The free plugin already includes:

* Unlimited saved category, attribute, and price filter sets
* Saved filter panels for sidebars, top bars, and grouped storefront layouts
* AJAX filtering with a shared results selector
* Price range filtering with optional Min / Max inputs
* Single-select and multi-select filter behavior
* Product counts, labels, headings, and empty-results messaging controls
* Styling controls for filters and panels, including responsive and mobile presentation settings
* Mobile panel toggle and close button controls
* Elementor widget support plus shortcode placement
* Reusable output for shop pages, category archives, Elementor templates, and custom storefront sections

Use one saved filter when you need a focused control, or combine multiple saved filters into a panel for a complete storefront filtering experience.

📍 Placement options:

* Elementor widget for saved filters and saved panels
* Shortcode for practical use with Wonderblocks or other website builders

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install the zip from the WordPress admin.
2. Activate Ace Products Filters.
3. Make sure WooCommerce is active.
4. Go to Ace Products Filters in the WordPress admin.
5. Create your first filter set, then optionally group filters into a panel.
6. Place the saved filter or panel with the Elementor widget, the block editor, a shortcode widget, or a template area.

== Usage ==

1. Create a filter set and choose whether it should use categories, attributes, or price.
2. Configure the behavior, labels, counts, layout direction, and design settings.
3. Enable AJAX when you want in-place product updates and set one shared results selector.
4. Place the saved filter directly, or create a filter panel and combine multiple saved filters into one reusable block.
5. Insert the result through the Elementor widget or shortcode wherever your storefront layout needs it.

== Screenshots ==

= 1. Saved filter set builder =
Build a reusable filter set, choose the terms to show, and control the frontend order of selected categories.

= 2. Filter dashboard and saved filter management =
Manage saved filter sets from one place and start new filter setups from the main dashboard.

= 3. Frontend filter experience =
Show category, attribute, and price filters together in a clean storefront layout with counts and saved styling.

= 4. AJAX filtering on live product grids =
Refresh WooCommerce product listings in place by targeting one shared results wrapper.

= 5. Live preview styling controls =
Adjust the filter design with live preview controls and check how button states look before publishing.

== Frequently Asked Questions ==

= Is the free version actually powerful enough to use on its own? =
Yes. The free plugin already includes unlimited saved category, attribute, and price filters, saved filter panels, AJAX updates, styling controls, mobile panel settings, and Elementor support.

= Does it work only with Elementor? =
No. Elementor is supported through a dedicated widget, and the plugin also works with shortcodes in regular WordPress pages, widgets, and template areas.

= Does it support AJAX filtering? =
Yes. Enable AJAX and enter one stable CSS selector for the shared results wrapper.

= Can I combine multiple saved filters together? =
Yes. Create saved filter sets individually, then group them into saved filter panels for sidebars, top bars, or multi-filter layouts.

= Can I use it with product category archives? =
Yes. It is designed for WooCommerce archive filtering and can also be placed on custom pages.

= Does uninstall delete my saved filters? =
No. At the moment, deleting the plugin does not automatically remove saved filter sets, filter panels, or related display settings from the database.

== External services ==

Ace Products Filters can load Google Fonts stylesheets for the plugin's built-in brand typography and for optional typography choices used in filter designs.

These requests can happen on Ace Products Filters admin pages and on frontend pages where Ace Products Filters output is rendered.

Service provider:

* Google Fonts API: https://fonts.googleapis.com/
* Google Fonts static files: https://fonts.gstatic.com/

What may be sent:

* The site visitor or admin user's IP address
* Browser and device information
* The requesting site URL through normal HTTP request metadata

Service terms and policies:

* Privacy Policy: https://policies.google.com/privacy
* Terms of Service: https://policies.google.com/terms

== Changelog ==

= 1.0.1 =
Fixed mobile filter-set and panel collapse behavior so closed states work correctly on small screens.

= 1.0.0 =
Initial stable release of Ace Products Filters with AJAX filtering, filter panels, price filters, Elementor-friendly selectors, configurable empty states, and improved contextual count performance.
