=== V7 Low Stock Filter ===
Contributors: thevaibhaw
Donate link: https://vaibhawkumar.in/
Tags: woocommerce low stock, low stock alert, stock filter, inventory management, stock notification
Requires at least: 5.8
Tested up to: 7.1
Stable tag: 1.1.0
Requires PHP: 7.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a "Low Stock" filter to WooCommerce Products admin with configurable threshold, email alerts, variable product support & HPOS compatibility.

== Description ==

**Tired of manually checking WooCommerce product stock levels one by one?** The **Low Stock Alert & Inventory Filter for WooCommerce** plugin adds a powerful, one-click **"Low Stock"** filter view directly inside your WooCommerce Products admin screen — so you can instantly see every product that needs restocking, without scrolling through hundreds of SKUs.

Whether you manage 10 products or 10,000 SKUs, this plugin gives you **instant visibility** into your inventory health with zero bloat, zero front-end impact, and full **WooCommerce HPOS compatibility**.

---

### 🔥 Why Store Owners Love This Plugin

* **Instant Low Stock Dashboard** — Adds a "Low Stock" link alongside All, Published, Draft, and Trash on the WooCommerce Products admin screen. One click = instant low stock overview.
* **Configurable Stock Threshold** — Set your own stock threshold (default: 5 units). Products at or below this number appear in your filtered view.
* **Variable Product & Variation Support** — Automatically detects low stock on individual product variations. If any variation is running low, the parent product appears in your filtered list.
* **Email Notifications & Alerts** — Optionally receive an instant email alert when any product drops below a specified stock level, so you never miss a restock opportunity.
* **Backorder & Draft Filtering** — Choose whether to include backorder-allowed products and draft products in your low stock view.
* **100% Native WordPress UI** — No custom CSS, no external JavaScript, no third-party tracking. Looks and feels exactly like core WordPress.
* **HPOS Compatible** — Fully declared compatible with WooCommerce High-Performance Order Storage (HPOS / Custom Order Tables).
* **Zero Front-End Impact** — Runs exclusively on admin screens. Absolutely zero impact on your store's front-end speed or customer experience.
* **WordPress 7.1 & WooCommerce 9.5+ Compatible** — Tested and confirmed working with the latest WordPress and WooCommerce releases.
* **GDPR & Privacy Compliant** — No data collection, no external API calls, no telemetry, no cookies.

---

### 🎯 Who Is This Plugin For?

1. **WooCommerce Store Owners** — Who want instant visibility into which products need restocking without checking each product manually.
2. **Dropshipping & Print-on-Demand Stores** — Where stock levels change frequently and real-time low stock alerts prevent lost sales.
3. **Multi-Vendor Marketplaces** — Where admins need a quick dashboard view of low-inventory products across all vendors.
4. **Agencies Managing Client Stores** — Who need a clean, native-looking admin filter without installing heavy inventory management suites.

---

### 💡 How Is This Different From ATUM or Stock Manager?

| Feature | Low Stock Alert & Filter (This Plugin) | Heavy Inventory Suites (ATUM, Stock Manager) |
| --- | --- | --- |
| **Setup Time** | 30 seconds — activate and go | 15-30 minutes configuration |
| **Front-End Impact** | Zero — admin only | May add front-end scripts |
| **Plugin Size** | Under 50 KB | 5-15 MB |
| **Learning Curve** | None — native WP UI | Complex dashboards |
| **HPOS Support** | Full native support | Varies |
| **Email Alerts** | Built-in | Often requires Pro/addon |

**Bottom line:** If you need a fast, lightweight, zero-bloat low stock filter with email alerts — this is your plugin. If you need full warehouse management with purchase orders and suppliers, use a heavier suite.

---

### ⚡ Key Features at a Glance

* ✅ One-click "Low Stock" admin filter view
* ✅ Configurable stock threshold (default: 5 units)
* ✅ Variable product & variation support
* ✅ Email notification alerts on low stock
* ✅ Backorder & draft product filtering options
* ✅ 100% native WordPress admin UI
* ✅ Full WooCommerce HPOS compatibility
* ✅ Zero front-end performance impact
* ✅ WordPress 7.1 & WooCommerce 9.5+ tested
* ✅ GDPR compliant — no data collection

---

== Installation ==

### Automatic Installation (Recommended)

1. Log in to your WordPress admin dashboard.
2. Go to **Plugins > Add New**.
3. Search for "**Low Stock Alert WooCommerce**" or "**V7 Low Stock Filter**".
4. Click **Install Now** and then **Activate**.
5. Ensure **WooCommerce** is installed and active.
6. Configure your settings at **WooCommerce > Settings > Products > Low Stock**.

### Manual Installation

1. Download the `v7-low-stock-filter.zip` file from this page.
2. Navigate to **Plugins > Add New > Upload Plugin** in your WordPress admin dashboard.
3. Select the zip file and click **Install Now**.
4. Click **Activate Plugin**.
5. Configure settings at **WooCommerce > Settings > Products > Low Stock**.

---

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. Low Stock Alert & Inventory Filter requires WooCommerce to be installed and active. If WooCommerce is not active, the plugin will display an admin notice and gracefully disable itself.

= What is the default low stock threshold? =

The default threshold is **5 units**. You can change this at **WooCommerce > Settings > Products > Low Stock**.

= Does it work with variable products and variations? =

Yes! The plugin checks stock levels on individual product variations. If any variation has low stock, the parent variable product will appear in the filtered list.

= Will this plugin slow down my WooCommerce store? =

Absolutely not. The plugin uses efficient `WP_Query` calls with optimized meta queries. It only runs on the admin Products screen and has **zero impact** on your store's front-end speed.

= Does the plugin support WooCommerce HPOS (High-Performance Order Storage)? =

Yes. The plugin declares full native compatibility with WooCommerce HPOS / Custom Order Tables.

= Can I receive email alerts when stock is low? =

Yes! Enable email notifications in the plugin settings. You can set a separate email threshold, and the plugin will send an alert to the WordPress admin email whenever a product drops below that level.

= Does the plugin include backorder products in the low stock filter? =

By default, no. But you can toggle this option in the settings to include or exclude products that allow backorders.

= Does this plugin collect any personal data? =

No. This plugin does not collect, store, or transmit any personal data. It makes no external API calls and includes no tracking or telemetry code. Fully GDPR compliant.

= Is this plugin compatible with WordPress 7.1? =

Yes! The plugin is fully tested and confirmed 100% compatible with WordPress 7.1 and WooCommerce 9.5+.

= How is this different from the built-in WooCommerce low stock notification? =

WooCommerce's built-in notification only sends a basic email. This plugin adds a **visual admin filter view** directly on the Products screen, configurable thresholds, variable product support, and draft/backorder filtering — all features not available in WooCommerce core.

---

== Screenshots ==

1. **Low Stock View** — "Low Stock" filter link on the Products admin screen alongside All, Published, Draft, and Trash.
2. **Settings Page** — Configurable threshold, email notifications, and filtering options under WooCommerce > Settings > Products > Low Stock.

---

== Changelog ==

= 1.1.0 - 2026-09-01 =
* Full SEO optimization of plugin title, description, and WordPress.org listing.
* Updated plugin name to "Low Stock Alert & Inventory Filter for WooCommerce" for better discoverability.
* Fixed Author name and URI metadata.
* Tested and confirmed 100% compatible with WordPress 7.1 and WooCommerce 9.5+.
* Updated high-resolution logo and icon assets.
* Enhanced FAQ section with 10 comprehensive questions and answers.

= 1.0.0 =
* Initial release.
* Low Stock view link on Products admin screen.
* Configurable stock threshold.
* Optional email notifications.
* Support for variable products, backorders, and draft filtering.
* HPOS compatibility.

== Upgrade Notice ==

= 1.1.0 =
WordPress 7.1 compatibility, SEO optimization, enhanced FAQ, and new branding. Recommended update for all users.

= 1.0.0 =
Initial release.

---

== Support & Contact ==

* **Author:** Vaibhaw Kumar
* **Website:** [vaibhawkumar.in](https://vaibhawkumar.in)
* **GitHub Repository:** [TheVaibhaw/v7-low-stock-filter](https://github.com/TheVaibhaw/v7-low-stock-filter)
