=== Back in Stock for WooCommerce ===
Contributors: mkbplatinum
Tags: woocommerce, back in stock, waitlist, stock notification, restock
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.2.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let customers get an email the moment an out-of-stock WooCommerce product is back. Automatic waitlist and restock notifications. Free.

== Description ==

Every "out of stock" product is a lost sale — unless you can tell the customer when it returns. **Back in Stock for WooCommerce** adds an *"Email me when back in stock"* form to any out-of-stock product, collects the waitlist, and emails everyone automatically the moment you restock.

Unlike most back-in-stock plugins, there is **no cap on notifications** and **no paywall** on the core feature. It is built by [ReadyGo Tools](https://readygotools.com), a division of MKB Platinum.

= Why you'll like it =

* **Zero setup** — the signup form appears automatically on out-of-stock products. Nothing to place, no shortcode required.
* **Automatic restock emails** — set a product back in stock and every waiting customer is emailed. Large waitlists are sent in the background so your store never slows down.
* **Simple and variable products** — works with both. On variable products the form appears for the specific out-of-stock variation, and only those customers are notified.
* **Waitlist dashboard** — see exactly who is waiting for each product (great demand intelligence for restocking decisions), with a one-click Remove for any entry.
* **Fully customizable wording** — edit the form heading, text, button, success message, email subject and email body, with `{product}`, `{url}` and `{site}` tags.
* **Built-in spam protection** — a hidden honeypot field plus per-IP rate limiting, both on by default. No CAPTCHA account needed.
* **Fast & lightweight** — front-end assets load only on product pages that actually show the form.
* **No AI, no scraping, no external services** — everything runs on your own site. Nothing is sent anywhere.

= Works with your theme and builder =

The form attaches to WooCommerce's standard product output, so it works with classic themes (Astra, Neve, GeneratePress, Kadence, OceanWP, Storefront and more) and with builders such as Blocksy, Elementor and the block editor.

= Reliable delivery =

WordPress cannot reliably send email on its own. For dependable restock notifications, pair this plugin with an SMTP mailer such as **ReadyGo SMTP**. The plugin will remind you if a notification fails to send.

== Installation ==

1. Make sure WooCommerce is installed and active.
2. In your WordPress admin, go to **Plugins → Add New**, search for "Back in Stock for WooCommerce", and click **Install** then **Activate**. (Or upload the plugin ZIP under **Plugins → Add New → Upload Plugin**.)
3. That's it. The signup form now appears automatically on any out-of-stock product.
4. Optional: open **RGT Back in Stock → Settings** to customize the wording, the restock email, and spam protection.

To test it: set a product to out of stock (quantity 0 with backorders disabled, or status "Out of stock"), visit the product page, and you'll see the form. Sign up, then set the product back in stock — the waiting email is sent automatically.

== Frequently Asked Questions ==

= The form isn't showing on my out-of-stock product. Why? =
The form only appears when a product is genuinely out of stock. If you manage stock quantity, set it to 0 **and** set "Allow backorders" to "Do not allow" — otherwise the product is "on backorder" (still purchasable) and no form is shown. If you don't manage stock quantity, set the product's stock status to "Out of stock".

= Does it work with variable products? =
Yes. The form appears when a shopper selects an out-of-stock variation, and only that variation's customers are notified when it comes back.

= Does it require any external service, API key, or account? =
No. The waitlist is stored on your own site and emails are sent by WordPress. There is no third-party service and nothing is sent off your site.

= My customers aren't receiving the restock emails. =
This is almost always because WordPress can't send email reliably without SMTP. Install and configure an SMTP mailer such as ReadyGo SMTP. The plugin shows a reminder in the admin if a notification fails to send.

= Where do I see who is waiting? =
Under **RGT Back in Stock → Waitlist**. Each product lists the waiting customers' email addresses, when they signed up, and the current stock status. You can remove any entry.

= Can I change the wording of the form and the email? =
Yes. Everything is editable under **RGT Back in Stock → Settings** — the form heading, text, button, success message, email subject and email body. In the email you can use `{product}`, `{url}` and `{site}` tags.

= How does it stop spam signups? =
Two protections run automatically: a hidden honeypot field that traps bots, and per-IP rate limiting (adjustable under Settings). Neither needs any account or CAPTCHA.

= What happens after a customer is notified? =
Their signup is marked as notified and removed from the active waitlist. If the product later goes out of stock again, they can join the new waitlist to be notified again.

= Is it compatible with High-Performance Order Storage (HPOS)? =
Yes. The plugin declares HPOS compatibility.

== Screenshots ==

1. The "Email me when back in stock" form on an out-of-stock product page.
2. The confirmation shown after a customer joins the waitlist.
3. The Waitlist dashboard: who is waiting for each product, with a one-click Remove.
4. The Settings tab: customizable form wording and restock email with {product}, {url} and {site} tags.
5. The Spam protection tab: honeypot and adjustable per-IP rate limiting, both on by default.
6. The Help & Support tab: quick-start guide, FAQ, and support links.

== Changelog ==

= 0.2.6 =
* Added: Help & Support tab with a quick-start guide, FAQ, and support links.

= 0.2.5 =
* Improved: refreshed Waitlist dashboard with iconed stat cards and a friendlier empty state.

= 0.2.4 =
* Added: dedicated Spam protection tab with detailed documentation.
* Fixed: stat card number/label spacing.

= 0.2.3 =
* Added: "a division of MKB Platinum" attribution in the admin header.

= 0.2.2 =
* Improved: refreshed admin design with a branded header and Waitlist / Settings tabs.

= 0.2.1 =
* Housekeeping: internal code prefix standardized. No change to features.

= 0.2.0 =
* Added: full in-plugin documentation (contextual Help tabs) and field-by-field tooltips on the Settings screen.
* Added: Settings reorganized into clear sections — Signup form, Restock email, Spam protection.
* Changed: authored by MKB Platinum and ReadyGo Tools.

= 0.1.9 =
* Added: visible Spam protection panel in Settings with an adjustable, toggleable rate limit.

= 0.1.8 =
* Added: anti-spam — hidden honeypot field and per-IP rate limiting.

= 0.1.7 =
* Added: customizable restock email subject and message with {product}, {url} and {site} tags.
* Added: Waitlist screen lists each waiting customer's email, grouped and shaded by product, with a per-person Remove action.

= 0.1.2 =
* Fixed: after a restock notification is sent, the signup is consumed — the browser re-checks with the server so a customer can re-join if the product goes out of stock again.

= 0.1.1 =
* Added: returning visitors who already signed up see "You're on the waitlist" instead of the form.

= 0.1.0 =
* Initial release: automatic waitlist form (simple + variable products), automatic restock notifications, waitlist dashboard, customizable text.

== Upgrade Notice ==

= 0.2.0 =
Adds in-plugin documentation and tooltips, and reorganizes the Settings screen. Recommended for everyone.
