=== Delowar Product Filter for WooCommerce ===
Contributors: delowarhossen57
Tags: woocommerce, product filter, ajax filter, shop filter, woocommerce filter
Requires at least: 5.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.3
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Fast, responsive AJAX product filtering for WooCommerce. Filter products instantly by category, brand, tag, price range, and keyword search.

== Description ==

**Delowar Product Filter for WooCommerce** provides an intuitive, high-performance product filtering solution for your WooCommerce online store. Allows shoppers to refine product results in real-time using AJAX without reloading the page.

### Key Features

* **Instant AJAX Filtering:** Live product results filtering without annoying page reloads.
* **Keyword Search:** Dynamic search input box to instantly locate products by title.
* **Taxonomy Filters:** Filter products by Categories, Brands, and Tags simultaneously.
* **Interactive Price Range Slider:** jQuery UI smooth price range slider auto-detected from WooCommerce store prices.
* **5 Layout Styles:** Choose between Left Sidebar, Right Sidebar, Top Horizontal Bar, Off-Canvas Floating Drawer, and Top FontAwesome toggle panel.
* **Shortcode Generator:** Custom admin metabox and modal generator to copy shortcodes directly into pages or block editors.
* **Exclude Specific Terms:** Built-in multi-select options to hide unwanted categories, brands, or tags from the filter UI.
* **Custom Labels & Localization:** Easily customize heading text, search placeholder, and reset button labels directly from the settings panel.
* **Color Customization:** Personalize text colors, hover states, background colors, button colors, and borders to match your store theme.

== Shortcodes ==

Simply insert the shortcode `[delowar-product-filter]` into any page, post, or layout block.

### Shortcode Attributes

* `style`: Layout style to display. Options: `left-sidebar` (default), `right-sidebar`, `top-sidebar`, `floating`, `top-fontawesome`.
* `text`: Trigger button label for floating drawer style. Default: `Filter Products`.

### Examples

* Left Sidebar (Default): `[delowar-product-filter style="left-sidebar"]`
* Right Sidebar: `[delowar-product-filter style="right-sidebar"]`
* Top Horizontal Bar: `[delowar-product-filter style="top-sidebar"]`
* Off-Canvas Drawer: `[delowar-product-filter style="floating" text="Refine Results"]`
* Top FontAwesome Panel: `[delowar-product-filter style="top-fontawesome"]`

== Installation ==

1. Upload the `delowar-product-filter-for-woocommerce` directory to your `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Ensure **WooCommerce** is installed and activated.
4. Navigate to **Delowar Product Filter** in your WordPress admin sidebar to configure your filter settings.
5. Place the shortcode `[delowar-product-filter]` on your Shop page or target content page.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =
Yes, WooCommerce must be installed and active for this plugin to work.

= How do I switch between filter layout styles? =
You can specify the layout style using the `style` attribute in your shortcode, e.g., `[delowar-product-filter style="top-sidebar"]`. You can also use the **Generate Shortcode** button in the post/page editor metabox.

= Can I hide certain categories or brands from appearing in the filter sidebar? =
Yes. In your WordPress admin dashboard, navigate to **Delowar Product Filter > Settings**. Under **Excluded Taxonomy Terms**, choose the terms you want to exclude and save your settings.

= Is the plugin translation-ready? =
Yes, all strings are wrapped with WordPress localization functions under text domain `delowar-product-filter-for-woocommerce`. You can also customize labels directly from the plugin settings page.

== Screenshots ==

1. Admin Settings Page - Sorting and Module Controls
2. Admin Settings Page - Term Exclusion and Color Styling
3. Shortcode Generator Modal in Page Editor
4. Frontend Filter UI - Left Sidebar Layout
5. Frontend Filter UI - Off-Canvas Floating Drawer Layout

== Changelog ==

= 1.0.3 =
* plugin icon and banner updated

= 1.0.2 =
* plugin prefix updated

= 1.0.1 =
* plugin name and slug updated

= 1.0.0 =
* Initial official release.
* Features 5 responsive layout templates.
* AJAX live product query filtering.
* Taxonomy sorting and exclusion management.
* Shortcode modal generator and settings UI.
