=== TwinCart Advanced Integrated Attribute Filters ===
Contributors: ddoukas
Tags: woocommerce, filter, attributes, product filter, shop filters
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
WC requires at least: 8.0
WC tested up to: 10.5.3
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Short Description:Easily filter WooCommerce products by attributes and categories using highly responsive checkbox layouts.

== Description ==

TwinCart Advanced Integrated Attribute Filters is a lightweight and efficient filtering plugin designed for WooCommerce storefronts. It lets shop managers deploy product filters based on core product attributes and categories anywhere on their site using a shortcode, a Gutenberg block, or a widget.

= Features =

* Automatic recognition and listing of WooCommerce product attributes as checkbox filters.
* Clean, accessible product category filter with a hierarchical (nested) tree layout.
* Filter results by combining multiple attributes and categories at once.
* Highly responsive design optimized for desktop, tablet, and mobile displays, with a collapsible filter panel on smaller screens.
* Easy integration via a shortcode, a Gutenberg block, or a classic widget.
* Native URL-based filtering, so filtered views are shareable, bookmarkable, and fully compatible with breadcrumbs and SEO.
* Simple admin screen (under WooCommerce -> Attribute Filters) to choose exactly which attributes and whether the category filter appear on the frontend.

== Installation ==

1. Upload the plugin directory to the `/wp-content/plugins/advanced-attribute-filters` directory, or install it directly through the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to WooCommerce -> Attribute Filters to choose which attributes and the category filter to display.
4. Add the filters to your site using the `[twincaaf_filters_checkboxes]` shortcode, the "Advanced Attribute Filters" widget, or the matching Gutenberg block.

== Frequently Asked Questions ==

= Where do the filters appear? =

Filters are shown automatically on the Shop page, product category/taxonomy pages, and search results pages. They are not shown on the cart, checkout, account pages, or the front page.

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active for this plugin to work.

== Changelog ==

= 1.0.0 =
* Initial release.
* Implemented core attribute and category tree filtering workflows.
* Added native URL integration for robust catalog and sorting compatibility.
* Declared full compatibility with High-Performance Order Storage (HPOS) and Checkout Blocks.