Oli Back in Stock Notifications for WooCommerce

WordPress plugin that lets customers join a waitlist for out-of-stock WooCommerce products and receive an email when stock returns.

• Display name: Oli Back in Stock Notifications for WooCommerce
• Slug / text domain: oli-back-in-stock-notifications
• Author: Olivier Bigras (bigrat95)
• Repository: https://github.com/olivierbigras/Oli-Back-in-Stock-Notifications
• License: GPLv2 or later
• Requires: WordPress 6.5+, WooCommerce 9.0+, PHP 7.4+
• Tested: WordPress 7.1, WooCommerce 11.2

Install the plugin at the repository root (this folder is the plugin).

Features

• Notify-me form on out-of-stock simple and variable products (per variation)
• Optional form on backorder
• Guests and logged-in users
• GDPR consent checkbox (optional)
• Double opt-in (optional)
• Honeypot + rate limiting
• Admin subscriptions: filter, search, CSV export, delete, manual notify
• Per-product subscriber count column
• Automatic restock emails (WooCommerce email classes, customizable templates, FR/EN)
• Action Scheduler batching
• One-click unsubscribe with signed tokens
• My Account tab Stock notifications
• Signup confirmation email
• Optional admin notification of new signups
• Dashboard stats (signups, notifications sent, conversions via order attribution)
• Shortcode [oli_bis_notify_form] and block oli-bis/notify-form
• Generic legacy import (filter-based; dry-run; source data is never deleted)
• Optional custom email bodies and auto-cleanup of sent notifications
• TranslatePress: store language at signup and send email in that locale
• HPOS declared; classic and block product templates

Prefix: oli_bis_ / Oli_BIS. No external HTTP calls, tracking, or upsells.

Legacy data migration

This plugin does not ship mappings for any third-party waitlist plugin. The oli_bis_legacy_map filter is empty by default.

Subscriptions already imported on a site keep working. Stored legacy_source / legacy_id values are left as-is. A later import still skips those rows (unique key email + product_id + variation_id, plus every stored legacy_id). Source tables, options, and metas are never deleted.

add_filter(
    'oli_bis_legacy_map',
    static function ( $map ) {
        $map['options'] = array(
            'old_email_template'  => 'notification_body',
            'old_signup_template' => 'signup_body',
            'old_auto_cleanup'    => 'auto_cleanup_notified',
        );
        $map['metas'] = array(
            'old_enabled_meta' => '_oli_bis_enabled',
        );
        $map['shortcodes'] = array(
            'old_notify_form' => 'oli_bis_notify_form',
        );
        $map['tables'] = array(
            'old_waitlist_subscribers',
        );
        $map['source'] = 'legacy';

        return $map;
    }
);

• options: old wp_options key => this plugin’s settings key
• metas: old post meta key => new post meta key (copied only when the destination is empty)
• shortcodes: old shortcode tag => oli_bis_notify_form
• tables: optional table suffixes without $wpdb->prefix
• source: slug stored on newly imported rows (default legacy)

When a table or option map is present, WooCommerce → Stock dashboard shows dry-run and import buttons.

Shortcode aliases

The built-in shortcode is [oli_bis_notify_form]. No other tags are registered unless you add them. Aliases are registered on init (priority 20), so a filter in the theme functions.php is picked up. A mapped tag is skipped when shortcode_exists() is already true:

add_filter(
    'oli_bis_legacy_map',
    static function ( $map ) {
        $map['shortcodes']['old_notify_form'] = 'oli_bis_notify_form';
        return $map;
    }
);

[oli_bis_notify_form] uses the current product. [oli_bis_notify_form product_id="123"] targets a specific product. show_only_out_of_stock="false" shows the form even when the product is in stock.

Gaps vs the official WooCommerce Back In Stock Notifications extension

Implemented at parity for the core waitlist flow. Intentionally not included:

Development

composer install
composer lint
composer phpcs
composer test

GitHub Actions runs PHP syntax checks (7.4 / 8.1 / 8.3), PHPCS WordPress, and PHPUnit.

Manual test steps

1. Activate on WordPress 7.x with WooCommerce 11.x. Confirm no admin error and HPOS remains compatible.
2. Create a simple product, set it out of stock, view it while catalog hiding of out-of-stock items is off.
3. Sign up as a guest. Confirm the row in WooCommerce → Stock Notifications (status active, or pending if double opt-in is on).
4. Confirm the signup or verification email (WooCommerce → Settings → Emails).
5. Restock the product. Run Action Scheduler / WP-Cron. Confirm the customer receives the restock email and status becomes notified.
6. Click the email product link, place an order, and confirm the dashboard conversion counter increments.
7. Repeat for a variable product, signing up on one out-of-stock variation only.
8. Open My Account → Stock notifications while logged in and unsubscribe.
9. Use the signed unsubscribe link from an email as a guest.
10. Export CSV, delete a row, and send a manual notification from the admin list.
11. Place [oli_bis_notify_form] on a page and the block in the editor.
12. Switch the store to French (or TranslatePress fr) and confirm the form/email strings are translated.
13. Confirm WooCommerce → Stock dashboard hides the import tools when oli_bis_legacy_map is empty.
14. Add a temporary map (options / metas / shortcodes / tables), reload the dashboard, run Dry-run import, then Import subscribers. Confirm counts, that source data is unchanged, and that a second import reports only skips.
15. Confirm imported is_sent rows are notified and pending rows are active. For a stored variation ID, confirm parent + variation columns.
16. Register an old shortcode tag through oli_bis_legacy_map['shortcodes'] in the theme functions.php and confirm it renders the same form on init. Confirm a tag already registered by another plugin is left unchanged.
17. In a custom email body, confirm {site_name} and {site_title} both resolve to the site title.

Verified locally

On WordPress 7.1.3 + WooCommerce 11.2.1 (PHP 8.3):

• Plugin activates and creates wp_oli_bis_subscriptions + wp_oli_bis_stats_daily
• Guest signup → restock → Action Scheduler queue → notification email class → status notified
• Variation IDs, double-opt-in confirm, signed unsubscribe URL, shortcode, and block registration