=== Filter Ninja ===
Contributors: yodsira
Tags: woocommerce, product filter, faceted search, attribute filter, price filter
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Faceted product filters for WooCommerce: attributes with live counters, price and rating ranges, canonical-safe and JS-free capable.

== Description ==

"Show me red ones under 2000 with 4+ stars." Filter Ninja answers at
the category page - without hiding your products from search engines
and without breaking the shop for visitors with JavaScript off.

= What it does =

* Faceted attribute filters with live counters: "Red (12)" - the
  counter already accounts for the other active filters.
* Price range (min-max) and minimum rating filters.
* AJAX updates without a page reload - and graceful degradation: with
  JavaScript off every filter is a plain link that just works.
* SEO hygiene: filters are GET parameters of the existing archive,
  links are nofollow, the canonical stays on the clean archive - no
  indexable filter URLs, no archive cloning.
* Empty term values are hidden automatically.
* Three placements: a Gutenberg block, the classic widget and the
  [filter_ninja] shortcode - on the shop page or any product taxonomy.
* Works with WooCommerce High-Performance Order Storage (HPOS).

= Filter Ninja Pro =

The Pro companion adds custom-field facets (ACF-compatible), per-
category presets with drag-and-drop ordering and infinite scroll.
Learn more: https://yodsira.com/en/product/filter-ninja/

== Screenshots ==

1. The facet panel with attribute counters.
2. Price range and rating filters.
3. The filtered archive - canonical untouched.

== Installation ==

1. Install the plugin through the WordPress plugins screen (Plugins ->
   Add New -> Upload Plugin) and activate it.
2. WooCommerce must be active.
3. Open WooCommerce -> Filter Ninja, pick the filterable attributes.
4. Place [filter_ninja] or the block on the shop page.

== Frequently Asked Questions ==

= Are filter URLs indexed by search engines? =

No. Filter links are nofollow and every archive keeps its clean
canonical. Filters are plain GET parameters of existing pages - the
plugin never creates new indexable URLs.

= Does the shop work without JavaScript? =

Yes. Every filter is a normal link; JavaScript only adds the AJAX
update on top.

= Which attributes can be filtered? =

Global WooCommerce product attributes (Products -> Attributes). Empty
values hide automatically.

= Does it slow the category page down? =

Counters use one indexed query per facet. On a normal catalog the
panel adds a few milliseconds.

= Is anything sent to third parties? =

No. Filter Ninja works entirely on your site and sends nothing
anywhere.

== Changelog ==

= 1.0.0 =
* First release: attribute facets with live counters, price range,
  minimum rating, AJAX updates with graceful degradation, canonical-
  safe URLs, block/widget/shortcode, HPOS support.

== Privacy & Data ==

Filter Ninja stores settings in your own WordPress database and sends
nothing to any external service.
