=== ModeFilter Pro ===
Contributors: szeeshanali
Tags: woocommerce, catalog mode, product filters, ajax filters, elementor
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Modern WooCommerce product filters with a chip-based UI, AJAX-powered product grid, and a flexible Shop ⇄ Catalog Mode toggle.

== Description ==

**ModeFilter Pro** is a modern WooCommerce filtering and catalog-control plugin built for performance, flexibility, and clean UX.

It combines:
• A **chip-based, multi-select filtering interface**
• A fast **AJAX product grid**
• A unique **Shop ⇄ Catalog Mode Toggle**

This allows store owners to dynamically switch between a fully functional shop and a catalog-style display — globally or selectively — without altering WooCommerce core behavior.

### Shop and Catalog Modes

* **Shop Mode**  
  Standard WooCommerce behavior with prices and Add to Cart buttons.

* **Catalog Mode**  
  Hides prices and purchase actions, with optional enquiry or stock-notification features.

This makes ModeFilter Pro suitable for hybrid stores, B2B catalogs, wholesale sites, or pre-launch product showcases.

---

== Key Features ==

= 1. Shop ⇄ Catalog Toggle Mode =
Control how products behave at multiple levels:
* Global store mode
* Per-product, category, or tag overrides
* Context-aware control via shortcodes or Elementor widgets

= 2. Chip-Based Product Filters =
A modern alternative to traditional checkboxes:
* Multi-select chips for Categories, Tags, Brands, and attributes
* Mobile-friendly and accessible UI
* Instant AJAX updates without page reloads

= 3. AJAX Product Grid =
* Real-time product filtering
* Load More or numeric pagination
* Uses native WooCommerce queries for maximum compatibility

= 4. Elementor Integration =
Includes dedicated widgets:
* **Filters Widget** – filter chips and mobile sidebar
* **Grid Widget** – product display and layout control

= 5. Out-of-Stock “Notify Me” System =
Optional built-in feature:
* Collects subscriber emails for out-of-stock products
* Sends back-in-stock notifications
* Uses your site’s mail system (no third-party services)

= 6. Developer-Friendly Architecture =
* Object-oriented, modular codebase
* Lightweight and performance-focused
* Hooks and filters for extensibility
* No external APIs or tracking

---

== Shortcode Usage ==

Use the shortcode to render filters and product grids anywhere:

= Basic =
`[modep_filters]`

= Catalog-only view =
`[modep_catalog only_catalog="yes"]`

= With attributes =
`[modep_filters cat_in="helmets,45" tag_in="summer" brand_in="arai" columns="3" per_page="12" sort="price_asc"]`

= Supported Attributes =

| Attribute | Description |
|----------|-------------|
| cat_in | Category slugs or IDs to include |
| tag_in | Tag slugs or IDs to include |
| brand_in | Brand slugs or IDs to include |
| columns | Number of grid columns |
| per_page | Products per page |
| sort | default, price_asc, price_desc, in_stock |
| only_catalog | yes / no |

---

== Elementor Widgets ==

Elementor users get full visual control:

* Query options for filtering, sorting, and pagination
* Style controls for cards, chips, typography, spacing, and layout
* Responsive controls for desktop, tablet, and mobile

---

== Technical Notes ==

* Fully object-oriented architecture
* Uses WordPress AJAX API correctly
* Compatible with page caching plugins
* Template overrides supported:
  `yourtheme/woocommerce/content-product-modep.php`
* Fully translatable
* Declares compatibility with WooCommerce HPOS
* Uses a single custom database table (`{prefix}modep_subscribers`) for optional stock alerts

---

== Frequently Asked Questions ==

= Does ModeFilter Pro require Elementor? =
No. All functionality is available via shortcodes. Elementor widgets are optional.

= Is this plugin compatible with caching plugins? =
Yes. AJAX endpoints are uncached and filtering does not interfere with page caching.

= Does Catalog Mode affect checkout or product data? =
No. It only controls frontend visibility of prices and purchase actions.

= Can I override the product template? =
Yes. Copy:
`/templates/content-product-modep.php`
to:
`yourtheme/woocommerce/content-product-modep.php`

= Does the plugin send data externally? =
No. ModeFilter Pro does not connect to any external services.

---

== Screenshots ==

1. Chip-based filter interface
2. AJAX-powered product grid
3. Elementor widget – query settings
4. Elementor widget – style controls
5. Out-of-stock notification popup
6. Shop ⇄ Catalog mode in action

---

== Changelog ==

= 1.0.5 =
* Initial WordPress.org release
* AJAX filtering engine
* Chip-based UI
* Elementor widgets
* Shop ⇄ Catalog Toggle Mode
* Optional stock notification system
* Mobile-optimized sidebar

---

== License ==

GPLv2 or later  
https://www.gnu.org/licenses/gpl-2.0.html

---

== Credits ==

Developed by **Syed Zeeshan Ali**