=== Quaerium – Product Filters & Variation Swatches for WooCommerce ===
Contributors: prodiseum
Tags: woocommerce, product filters, ajax filters, variation swatches, elementor
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AJAX WooCommerce product filters plus color, size and product-page variation swatches in one lightweight plugin.

== Description ==

Quaerium brings product filtering and visual variation swatches together in one WooCommerce workflow.

The free edition includes the essentials needed for a practical storefront:

* AJAX product filtering.
* Product categories and subcategories.
* Global WooCommerce attributes.
* Product tags.
* Common brand taxonomies when available.
* Price range filtering.
* Stock / availability filtering.
* Solid color swatches.
* Size and attribute buttons.
* Active filter chips and reset controls.
* Responsive mobile filter drawer.
* Visual variation selectors on single-product pages.
* `[quaerium_filter]` shortcode.
* Elementor filter widget.
* Compatibility with standard WooCommerce archives and Elementor Archive Products.
* English interface with bundled Spanish translation.

Quaerium Free uses a vertical filter layout and an explicit Apply button so shoppers can select several options before refreshing the product grid.

= Quaerium PRO =

Quaerium PRO is a separate premium plugin for stores that need more adaptive catalog behavior. It adds features such as dynamic option counts, contextual zero-result handling, category-specific filter sets, custom filter ordering, horizontal layouts, automatic apply, advanced swatches, advanced product-option handling, Elementor Loop Grid / Current Query integration, standalone catalog pages and additional optimization controls.

The Free plugin does not contain locked premium functionality. You can compare editions from Prodiseum > Quaerium > Free vs PRO.

More information: https://prodiseum.com/quaerium

= External services =

Quaerium includes the Freemius SDK to provide optional product opt-in, upgrade/account infrastructure and license/update services for the separate PRO edition.

The Free plugin's storefront filtering, swatches and settings do not require a Freemius account or opt-in. If you choose to opt in when prompted, the Freemius SDK may send technical and account information such as the site URL, WordPress/PHP/plugin versions, locale, and the administrator profile/contact details used for the product account, together with diagnostic or plugin-usage metadata covered by the Freemius privacy policy.

Service: https://freemius.com/
Terms: https://freemius.com/terms/
Privacy policy: https://freemius.com/privacy/
SDK source: https://github.com/Freemius/wordpress-sdk

== Installation ==

1. Install and activate WooCommerce.
2. Upload Quaerium from Plugins > Add New, or install it from the WordPress.org plugin directory.
3. Activate Quaerium.
4. Open Prodiseum > Quaerium.
5. Review the detected filters and swatch presentation.
6. Add the Quaerium Product Filters Elementor widget or the `[quaerium_filter]` shortcode next to a WooCommerce product archive.

== Frequently Asked Questions ==

= Does the Free edition use AJAX? =

Yes. The core product filtering flow updates WooCommerce product results with AJAX.

= Does it include variation swatches? =

Yes. Quaerium Free can render solid colors as swatches and other variation attributes as buttons on product pages.

= Can I filter by product attributes? =

Yes. Global WooCommerce attributes are detected automatically and can be displayed as checkboxes, buttons or solid color swatches.

= Does it work with Elementor? =

The Free edition includes a Quaerium Product Filters widget and supports standard WooCommerce archives and Elementor Archive Products. Advanced Elementor Loop Grid / Current Query integration is available in Quaerium PRO.

= Is the Free edition just a trial? =

No. Its included features remain available without a time limit or premium license. Quaerium PRO is a separate plugin with additional functionality.

= Where can I compare Free and PRO? =

Open Prodiseum > Quaerium > Free vs PRO in WordPress, or visit https://prodiseum.com/quaerium.

== Changelog ==

= 1.0.0 =
* Initial WordPress.org Free release.
* Added AJAX filtering for categories, attributes, tags, brands, price and stock.
* Added vertical filters, mobile drawer, active filter chips and reset controls.
* Added solid color swatches and attribute buttons.
* Added visual variation selectors on WooCommerce product pages.
* Added shortcode and Elementor filter widget.
* Added the shared Prodiseum admin hub and a dedicated Free vs PRO comparison page.
* Added English source strings and bundled Spanish translation.
