=== StoreArmory Waitlist for WooCommerce ===
Contributors: abocchetti
Tags: woocommerce, back in stock, waitlist, stock notification, out of stock
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Back-in-stock waitlist for WooCommerce. Email shoppers automatically when out-of-stock products return. Guest sign-ups, double opt-in & GDPR.

== Description ==

**Every out-of-stock product page is a leak.** A shopper who was ready to buy hits "out of stock", leaves, and you have no way to bring them back.

**StoreArmory Waitlist** plugs that leak. It adds a clean "Email me when it's back in stock" form to every out-of-stock WooCommerce product. When you restock, every waiting shopper gets an automatic email so they can come back and buy — often your highest-converting email of the month.

It is lightweight, privacy-first, and works out of the box with your existing WooCommerce store and theme. No account required for shoppers, no complicated setup for you.

= Why choose StoreArmory Waitlist? =

* **Zero setup** — activate it and the sign-up form appears automatically on every out-of-stock simple product.
* **Recover real sales** — turn dead "out of stock" traffic into a warm list that converts the day you restock.
* **Privacy-first by design** — double opt-in is on by default and full GDPR consent (text, IP and timestamp) is recorded for every sign-up.
* **Restocks detected automatically** — works whether you change stock by hand, by CSV import, or from an ERP/inventory sync.
* **No lock-in** — your data lives in your own database and every email has one-click unsubscribe.

= Features =

* **Automatic sign-up form** on out-of-stock simple products — no configuration needed.
* **Guest sign-ups** — shoppers join with just an email address, no account required.
* **Automatic restock emails** — sent the moment a product is back in stock.
* **Double opt-in** — confirm-by-email to protect deliverability and keep clean lists.
* **GDPR consent capture** — records the consent text, IP address and timestamp for every sign-up.
* **One-click unsubscribe** in every notification email.
* **Honeypot + rate limiting** to block spam bots.
* **Optional name field** you can switch on with one click.
* **Waitlist dashboard** — see how many shoppers are confirmed and waiting on each product.
* **Customisable copy** — set the form heading, button label and consent text in plain English.
* **Custom From name & email** for every message you send.
* **Shortcode** `[bisw_waitlist id="123"]` to drop the form anywhere you like.
* **Translation-ready** and fully compatible with WooCommerce **HPOS** and **block-based cart & checkout**.

= Upgrade to Waitlist Pro =

Free covers email waitlists beautifully. When you are ready to scale, [Waitlist Pro](https://storearmory.com/product/waitlist-pro/) builds on this exact plugin — your existing sign-ups carry over automatically, with nothing to migrate — and adds:

* **Multi-channel alerts** — SMS (Twilio), Web Push and WhatsApp, not just email.
* **Per-variation waitlists** — notify on the exact size or colour a shopper wanted.
* **Background batch sending** — notify huge lists reliably without timeouts.
* **Open & click tracking** and a deliverability dashboard.
* **CSV export** and per-subscriber details.
* **Restock revenue reporting** — see the actual sales your waitlists recover.
* **Conversion tools** — reserve stock on restock, hold timers, pre-orders and price-drop alerts.
* **Referrals & re-engagement** campaigns.
* **Mailchimp / ESP integrations** and built-in SMTP.

== Installation ==

= Minimum requirements =

* WordPress 6.2 or higher
* WooCommerce 7.0 or higher
* PHP 7.4 or higher

= Automatic installation =

1. Go to **Plugins → Add New** in your WordPress dashboard.
2. Search for **StoreArmory Waitlist for WooCommerce**.
3. Click **Install Now**, then **Activate**.

= Manual installation =

1. Upload the plugin folder to `/wp-content/plugins/storearmory-waitlist-for-woocommerce`.
2. Activate the plugin through the **Plugins** screen in WordPress.

= After activating =

1. Make sure WooCommerce is installed and active.
2. Visit **WooCommerce → Waitlist → Settings** to set your From name/email and form text.
3. Set a product to "Out of stock" and view it — the sign-up form appears automatically.

== Frequently Asked Questions ==

= Does this require WooCommerce? =

Yes. WooCommerce must be installed and active.

= Where does the sign-up form appear? =

Automatically on the single product page of any out-of-stock simple product. You can also place it anywhere with the shortcode `[bisw_waitlist id="123"]`.

= Do shoppers need an account? =

No. Guests sign up with just an email address. Logged-in customers have their email pre-filled.

= How are restock emails sent? =

WordPress sends them via `wp_mail()`. For reliable delivery we strongly recommend configuring an SMTP plugin or service. (Waitlist Pro includes built-in SMTP and ESP integrations.)

= How does the plugin know a product is back in stock? =

It watches WooCommerce stock changes, so restocks are detected whether you edit stock manually, import a CSV, or sync from an ERP/inventory system.

= Does it support product variations? =

The free version supports simple products. Per-variation waitlists (notify on a specific size or colour) are available in Waitlist Pro.

= Is it GDPR-friendly? =

Yes. Sign-ups use a consent checkbox and the plugin records the consent text, IP address and timestamp. Double opt-in is enabled by default, and every email includes one-click unsubscribe.

= What happens to my data if I uninstall? =

Your collected sign-ups are preserved by default so you do not lose demand data, and so an upgrade to Waitlist Pro keeps everything. You can remove the tables manually if you want a full wipe.

= Is it compatible with HPOS and block checkout? =

Yes. The plugin declares compatibility with WooCommerce High-Performance Order Storage (HPOS) and the block-based cart and checkout.

== Screenshots ==

1. The "Email me when it's back in stock" sign-up form, shown automatically on an out-of-stock product page.
2. The double opt-in confirmation email a shopper receives after signing up.
3. The automatic back-in-stock notification email, with a one-click unsubscribe link.
4. The admin Waitlist dashboard showing confirmed and pending demand for every product.
5. The settings screen: From name/email, double opt-in, and fully customisable form text.

== Changelog ==

= 1.0.0 =
* Initial release: automatic out-of-stock sign-up form, double opt-in, automatic restock emails, GDPR consent capture, one-click unsubscribe, honeypot spam protection, admin waitlist dashboard, shortcode, and HPOS + block cart/checkout compatibility.

== Upgrade Notice ==

= 1.0.0 =
Initial release of StoreArmory Waitlist for WooCommerce.
