=== StockBeacon - Product Waitlists for WooCommerce ===
Contributors: wpvoid
Tags: waitlist, back in stock, notify me, woocommerce, out of stock
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
Requires Plugins: woocommerce
Text Domain: stockbeacon-product-waitlists-for-woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let customers join a waitlist on out-of-stock WooCommerce products and send automatic restock notification emails.

== Description ==

**StockBeacon - Product Waitlists for WooCommerce** helps you capture demand on out-of-stock products and notify subscribers when items are available again.

= Free =

* **Product and per-variation waitlists** for out-of-stock WooCommerce products, with separate subscriber lists for each variation
* **Secure form submissions** with sanitization, and spam throttling
* **Automatic restock detection** with background notification email batches
* **Duplicate prevention** so the same customer is not added twice for the same product
* **Activity log** for recent waitlist events
* **CSV export** with product, status, and date filters
* **Mobile responsive design** for the customer-facing notify form
* **Form styling and live preview** for copy, colors, typography, and light or dark mode
* **Restock email editor and live preview** for subject, content, button text, colors, and typography

= Pro =

* ⭐ **Double opt-in** flow and confirmation support
* ⭐ **Advanced Analytics** with conversion tracking, product breakdowns, and restock demand reports
* ⭐ **Shortcode and block support** for placing waitlist forms where you need them
* ⭐ **Advanced form editor**, custom CSS, redirects, and device previews
* ⭐ **Advanced email editor** and confirmation-email design
* ⭐ **Provider sync** with Mailchimp, ActiveCampaign, HubSpot, and more
* ⭐ **Low-stock waitlists** to capture demand before products fully sell out
* ⭐ **Restock reminders** for customers who were notified but have not purchased yet
* ⭐ **Webhook notifications** for signup and restock email events
* ⭐ **Cleanup controls** for purging older waitlist records in batches

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install **StockBeacon - Product Waitlists for WooCommerce** from the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Ensure **WooCommerce** is installed, active, and meets the minimum version (see FAQ).
4. Open **WooCommerce → Waitlist** to review settings and subscriber data.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. This plugin runs only when WooCommerce is active. If WooCommerce is missing, the plugin shows an admin notice and does not initialize.

= Which versions do I need? =

StockBeacon requires WordPress **6.0+**, PHP **8.0+**, and WooCommerce **8.0+**.

= Do customers get emailed automatically when I restock? =

Yes. When a tracked waitlist item changes back to in stock, the plugin schedules background notification batches automatically. Pro adds delivery timing controls and restock reminders.

= Where do I manage waitlist subscribers? =

Use **WooCommerce → Waitlist** in wp-admin to review subscribers, filter waitlists, view activity, export CSV files, and run debug checks. You also get waitlist visibility in the WooCommerce product list and in each product's **Waitlist** product-data tab.

= Does it work with variable products? =

Yes. StockBeacon creates separate per-variation waitlists, so each size, color, or style can collect its own subscribers and trigger its own restock notifications.

= Is there a shortcode or block? =

Shortcode and block support are **Pro** features. In free, the notify form is shown automatically on eligible out-of-stock product pages.

= Can I customize the notify form? =

Yes. The plugin includes the default responsive form and lets developers override the template with `stockbeacon-product-waitlists-for-woocommerce/form-out-of-stock.php` in the active theme. Pro adds the visual form editor, presets, colors, layout controls, and live preview.

= How do I export subscriber data? =

Open **WooCommerce → Waitlist**, optionally choose product/status/date filters, and click **Download CSV**.

== Privacy ==

The store owner is responsible for providing an appropriate privacy notice, selecting a lawful retention period, and configuring the optional consent checkbox where required.

== Screenshots ==

1. Overview dashboard with waitlist stats, general settings, and analytics summary.
2. Form editor with live preview for the out-of-stock notify form.
3. Restock email editor with live preview for notification emails.

== Changelog ==

= 1.0.0 =
First public release. Install WooCommerce before activating.
