Beltoft In-Stock Notifier for WooCommerce

Beltoft In-Stock Notifier for WooCommerce adds a subscription form to out-of-stock products so customers can leave their email and get notified when the product is restocked. Emails are sent using WooCommerce’s email template so they match your store’s design.

Key Features

1. Subscription form on out-of-stock products — works with simple, variable, grouped, and external products.
2. Variable products: form shows/hides automatically when selecting out-of-stock variations.
3. Notifications sent via WooCommerce email templates — same look as your order emails.
4. Email settings (subject, heading, on/off) under WooCommerce > Settings > Emails.
5. Batch sending via Action Scheduler — handles thousands of subscribers without slowing down.
6. Detects stock changes from admin, REST API, CLI, and ERP systems.
7. Admin dashboard with stats and a manual “Send Notifications” button per product.
8. Subscription list with search, filters, pagination, and bulk actions.
9. One-click unsubscribe link in every email.
10. Optional GDPR checkbox, honeypot spam protection, and rate limiting.
11. Shortcode [bisn_form] for custom placement.
12. Activity logging via WooCommerce logger.

How It Works

1. Customer visits an out-of-stock product and enters their email.
2. When the product comes back in stock, the plugin picks it up via WooCommerce hooks.
3. Emails are queued and sent in batches — each one includes the product image, a “Shop Now” button, and an unsubscribe link.
4. Custom hook available for CDN/Varnish cache purging if needed.

Configuration

Form Placement

• The form shows automatically on out-of-stock product pages.
• To place it yourself, disable auto-placement in settings and use [bisn_form] or [bisn_form product_id="123"].

Email Template

• Uses WooCommerce’s email system — same header, footer, and colours as your other store emails.
• Customise subject, heading, body text, button text, and footer text under WooCommerce > Settings > Emails > Back In Stock.
• Use {product_name} and {site_title} placeholders in any of these fields.
• Override the template by copying templates/emails/back-in-stock.php to your theme’s woocommerce/emails/ folder for more complex customisations.

Batch Sending

• Configurable batch size (default 50) and throttle between emails.
• If there are more subscribers than one batch, the next batch runs 60 seconds later.
• For low-traffic sites, set up a real system cron for reliable scheduling.

Hooks & Filters

Developers can extend the plugin:

• bisn_form_html / bisn_form_fields / bisn_form_heading_text
• bisn_before_subscription / bisn_after_subscription
• bisn_validate_subscription
• bisn_before_notification_sent / bisn_after_notification_sent / bisn_after_batch_sent
• bisn_stock_status_triggers — customise which statuses trigger notifications (default: instock, onbackorder)
• bisn_cache_purge_product — fire custom cache purge logic (e.g. Varnish, CDN)

REST API (read-only)

For purchasing and demand-planning integrations, the plugin exposes one read-only endpoint that returns aggregate counts per product — never e-mail addresses or other personal data:

GET /wp-json/beltoft-in-stock-notifier/v1/subscribers?page=1&per_page=200

• Authentication: WooCommerce REST API consumer key/secret (the same scheme as wc/v3, key needs Read permission) or any logged-in WordPress user. The user must have the manage_woocommerce capability. Unauthenticated requests receive HTTP 401.
• per_page defaults to 200, maximum 500. Products with no waiting subscribers, no notifications in the last 30 days and no signups in the last 365 days are omitted.
• Each item contains sku, product_id, variation_id (0 for simple products; for variations sku is the variation’s own SKU), waiting (subscribers not yet notified — identical to the “Active Subscribers” count in the admin dashboard), notified_30d (subscribers notified in the last 30 days) and signups (signup counts per UTC calendar day for the last 365 days, days with zero signups omitted).