=== NWS Product Filter === Contributors: neonus, shamotj Tags: woocommerce, filter, product filter, attributes, price filter Requires at least: 5.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.0.21 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Advanced WooCommerce product filter with attributes, price range, and stock status filtering. == Description == A powerful WooCommerce product filter plugin that allows customers to filter products by attributes, price range, stock status, and navigate between categories. = Features = * **Attribute Filtering** - Filter by any WooCommerce product attribute * **Price Range Slider** - Interactive price range filtering with visual slider * **Stock Status Filter** - Filter products by availability * **Categories Navigation** - Collapsible category tree for browsing product categories * **Responsive Design** - Mobile-friendly interface * **Admin Configuration** - Easy-to-use admin interface for setting up filters * **Drag & Drop Ordering** - Reorder filter items in the admin * **Shortcode Support** - Display filters anywhere using shortcodes `[nwsfilter_product_filter]` and `[nwsfilter_selected_filters]` * **Clean Code** - Object-oriented PHP with proper WordPress coding standards * **AJAX Filtering** - Fast filtering without page reloads * **Multiple Filter Types** - Price range, attributes, stock status, and categories * **Selected Filters Display** - Show active filters separately with remove buttons * **Auto-expand Categories** - Optional automatic expansion of parent categories = Filter Types = **Price Filter** Interactive price range slider that automatically detects the price range for the current category with currency symbol support and real-time visual feedback. **Attribute Filters** Checkbox-based filtering for product attributes with product counts for each option, supports multiple selections, and automatically hides options with zero products. **Stock Filter** Simple checkbox to filter by stock availability, showing only products that are in stock. **Categories Menu** Collapsible category tree showing hierarchical structure with product counts, expandable/collapsible subcategories with visual indicators, current category highlighting, and optional auto-expand parent categories feature. = Usage = Display the main filter using the shortcode: `[nwsfilter_product_filter]` Display only selected/active filters: `[nwsfilter_selected_filters]` Or use PHP in your template: `` `display_filter_form(); ?>` = Configuration = 1. Navigate to Settings > Product Filter in your WordPress admin 2. Select which attributes and filters you want to display 3. Drag and drop to reorder the filter items 4. Configure categories settings (auto-expand, display location) 5. Configure selected filters display options 6. Save your settings = Customization = The plugin includes comprehensive CSS classes for easy customization: * `.nws-filter` - Main container * `.filter-group` - Individual filter sections * `.filter-group.is-active` - Active filter sections * `.range-slider` - Price range slider * `.selected-filters-section` - Selected filters section * `.filter-chip` - Individual filter chip * `.nws-clear-filters` - Clear filters button == Installation == 1. Upload the plugin files to `/wp-content/plugins/nws-filter/` 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Go to Settings > Product Filter to configure 4. Display the filter using shortcode `[nwsfilter_product_filter]` or template functions == Frequently Asked Questions == = How do I display the filter? = Use the shortcode `[nwsfilter_product_filter]` in any page or post, or add it to your theme template using `` = Can I display selected filters separately? = Yes! Use the shortcode `[nwsfilter_selected_filters]` to display only the active/selected filters with remove buttons. This is useful when you want to show filters in a different location or when you've hidden them from the main filter form. = How do I change the order of filters? = In the admin settings (Settings > Product Filter), you can drag and drop the filter items to reorder them. The order you set will be reflected on the frontend. = Can I customize the appearance? = Yes! The plugin includes comprehensive CSS classes that you can override in your theme's CSS file. All main elements have specific classes like `.nws-filter`, `.filter-group`, `.range-slider`, etc. = Does it work with AJAX? = The filtering uses URL parameters and page reloads. The interface includes a loading indicator for better user experience. = Can I hide selected filters from the main filter form? = Yes! In the admin settings, enable "Hide Selected Filters in Filter Form" and use the `[nwsfilter_selected_filters]` shortcode to display them elsewhere. = How do I enable category auto-expand? = In Settings > Product Filter, check the "Auto-expand Parent Categories" option. This will automatically expand parent categories when viewing a subcategory. = What WooCommerce versions are supported? = The plugin requires WooCommerce 4.0 or higher and is tested up to WooCommerce 8.0. == Screenshots == 1. Main filter interface 2. Admin configuration panel == Changelog == = 1.0.21 = * ADDED: Czech translation = 1.0.20 = * UPDATED: Added declaration about HPOS compatibility = 1.0.19 = * UPDATED: Added missing translations = 1.0.18 = * ADDED: Settings link in plugin action list for quick access to plugin settings * UPDATED: Bumped WordPress tested up to version 6.9 = 1.0.17 = * UPDATED: Enhanced readme.txt with comprehensive description and features * UPDATED: Added detailed FAQ section with 8 practical questions and answers * UPDATED: Improved installation instructions and usage examples * ENHANCED: Better WordPress.org plugin directory presentation * DOCUMENTATION: Complete feature list and filter type descriptions = 1.0.16 = * Fixed style enqueue in is_archive() = 1.0.15 = * Fixed plugin URL in main plugin file = 1.0.14 = * BREAKING CHANGE: Updated all prefixes from NWS_ to NWSFILTER_ for WordPress.org compliance (minimum 4 characters required) * CHANGED: Shortcode names updated to [nwsfilter_product_filter] and [nwsfilter_selected_filters] * CHANGED: Class names updated to NWSFILTER_Plugin, NWSFILTER_Frontend, NWSFILTER_Admin, NWSFILTER_Functions * CHANGED: Option names updated to use nwsfilter_ prefix (e.g., nwsfilter_settings, nwsfilter_categories_auto_expand) * CHANGED: Constants updated to NWSFILTER_VERSION, NWSFILTER_PLUGIN_DIR, NWSFILTER_PLUGIN_URL, NWSFILTER_PLUGIN_FILE * CHANGED: Enqueue handles updated to nwsfilter-style, nwsfilter-script, nwsfilter-admin * REMOVED: All inline