{"id":336596,"date":"2026-09-28T13:09:17","date_gmt":"2026-09-28T13:09:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/smart-waitlist-for-woocommerce\/"},"modified":"2026-09-28T12:13:09","modified_gmt":"2026-09-28T12:13:09","slug":"smart-waitlist-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/fuc.wordpress.org\/plugins\/smart-waitlist-for-woocommerce\/","author":23519266,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.0.0","stable_tag":"trunk","tested":"7.1.2","requires":"6.0","requires_php":"8.0","requires_plugins":null,"header_name":"Smart Waitlist for WooCommerce","header_author":"Abdennour Laoubi","header_description":"Automatically notifies customers via email when out-of-stock products become available again.","assets_banners_color":"","last_updated":"2026-09-28 12:13:09","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/smart-waitlist-for-woocommerce\/","header_author_uri":"https:\/\/profiles.wordpress.org\/abdennourlaoubi\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":33,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"2.0.0":"

Internal identifier rename for WordPress.org compliance (SWW \u2192 SWFWC prefix). All existing data migrates automatically. Max Subscribers per Product is now a free, configurable setting.<\/p>","1.1.2":"

Critical compatibility and stability update. Fixes database activation and deactivation hooks, and upgrades double opt-in controls. Highly recommended.<\/p>","1.1.1":"

Security and reliability update. Fixes a critical bug where re-subscribing after unsubscribing silently failed to send the confirmation email. Adds GDPR personal data export\/erasure hooks. Upgrades the database schema (adds user_id<\/code> index). Recommended for all users.<\/p>","1.0.0":"

Initial release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Waitlist signup form on an out-of-stock product page.","2":"Restock notification email received by a subscriber.","3":"Admin subscribers dashboard with search, filters, and bulk actions.","4":"Waitlist panel on the product edit page.","5":"Plugin settings page (WooCommerce \u2192 Settings \u2192 Products \u2192 Waitlist)."}},"plugin_section":[],"plugin_tags":[155593,916,4423,4422,286],"plugin_category":[45],"plugin_contributors":[283182],"plugin_business_model":[],"class_list":["post-336596","plugin","type-plugin","status-publish","hentry","plugin_tags-back-in-stock","plugin_tags-notify","plugin_tags-out-of-stock","plugin_tags-waitlist","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-abdennourlaoubi","plugin_committers-abdennourlaoubi"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/smart-waitlist-for-woocommerce.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n

Smart Waitlist for WooCommerce<\/strong> automatically notifies customers when an out-of-stock product is back in stock.<\/p>\n\n

When a product runs out of stock, a \"Notify Me When Available\" form appears on the product page. Customers enter their name and email to join the waitlist. The moment you restock the product, every pending subscriber receives a personalized notification email \u2014 automatically.<\/p>\n\n

Core Features<\/h4>\n\n
    \n
  • Automatic restock detection<\/strong> \u2014 hooks directly into WooCommerce stock management; no manual steps required.<\/li>\n
  • Variable product support<\/strong> \u2014 per-variation waitlists, so customers subscribe to the exact variant they want.<\/li>\n
  • Double opt-in support<\/strong> \u2014 require email confirmation before users are added to the waitlist (now a core free feature).<\/li>\n
  • Smart form display<\/strong> \u2014 form appears only on out-of-stock products; hidden when stock is available.<\/li>\n
  • Duplicate prevention<\/strong> \u2014 customers cannot accidentally subscribe twice.<\/li>\n
  • Honeypot spam protection<\/strong> \u2014 invisible field blocks automated spam submissions.<\/li>\n
  • HMAC-signed unsubscribe links<\/strong> \u2014 every notification email contains a secure, one-click unsubscribe link.<\/li>\n
  • Batch notifications<\/strong> \u2014 large waitlists are processed in background batches via WP-Cron to avoid timeouts.<\/li>\n
  • Admin dashboard<\/strong> \u2014 searchable, filterable, sortable subscriber list with bulk actions (delete, mark as notified).<\/li>\n
  • Per-product settings<\/strong> \u2014 enable or disable the waitlist individually for any product.<\/li>\n
  • Waitlist capacity limits<\/strong> \u2014 optionally cap the number of subscribers per product (or per variation) to control stock flow.<\/li>\n
  • WooCommerce Settings integration<\/strong> \u2014 configure waitlist emails under WooCommerce > Settings > Emails and waitlist behavior under WooCommerce > Settings > Products > Waitlist.<\/li>\n
  • Theme-overridable templates<\/strong> \u2014 copy templates to your theme for complete HTML customisation.<\/li>\n
  • GDPR tools<\/strong> \u2014 personal data export and erasure via WordPress Privacy Tools (Tools \u2192 Erase Personal Data).<\/li>\n
  • Developer-friendly<\/strong> \u2014 action and filter hooks throughout; documented phpdoc on every method.<\/li>\n
  • WPCS-compliant<\/strong> \u2014 all database queries use $wpdb->prepare()<\/code>; all output is escaped; nonces on every form.<\/li>\n
  • HPOS compatible<\/strong> \u2014 declared compatible with WooCommerce High-Performance Order Storage.<\/li>\n<\/ul>\n\n

    Pro Version<\/h4>\n\n

    Upgrade to the Pro Version (available at https:\/\/payhip.com\/b\/aH2Oq ) for advanced features:<\/p>\n\n

      \n
    • WhatsApp Business API notifications<\/li>\n
    • Coupon-with-notification (send discount codes alongside the restock alert)<\/li>\n<\/ul>\n\n

      Privacy<\/h4>\n\n

      This plugin stores subscriber names, email addresses, and optionally phone numbers in a dedicated database table ({prefix}swfwc_waitlist<\/code>). Data is retained until manually deleted by the site administrator or until the subscriber unsubscribes. No data is shared with third parties. Plugin data is fully removed on uninstall.<\/p>\n\n

      Personal data can be exported and erased via Tools \u2192 Erase Personal Data<\/strong> in compliance with GDPR Article 17 and Article 20.<\/p>\n\n

      Consider updating your site's Privacy Policy to reflect this data collection.<\/p>\n\n

      Email Setup Guide<\/h3>\n\n

      Email Configuration<\/h4>\n\n
        \n
      1. Configure a reliable SMTP or transactional email plugin first.<\/li>\n
      2. Send a test email from the SMTP plugin and confirm it arrives.<\/li>\n
      3. Go to WooCommerce \u2192 Settings \u2192 Emails<\/strong>.<\/li>\n
      4. Enable and review Waitlist Signup Confirmation<\/strong>.<\/li>\n
      5. Enable and review Waitlist Restock Notification<\/strong>.<\/li>\n
      6. Test the waitlist flow with one out-of-stock product and one real email address.<\/li>\n<\/ol>\n\n

        Email Production Checklist<\/h4>\n\n
          \n
        • SMTP or transactional email test succeeds.<\/li>\n
        • SPF, DKIM, and DMARC are configured for the sending domain.<\/li>\n
        • Signup confirmation email arrives.<\/li>\n
        • Restock notification email arrives after stock changes to instock<\/code>.<\/li>\n
        • Unsubscribe links work.<\/li>\n
        • Emails are not consistently landing in spam.<\/li>\n<\/ul>\n\n

          Pro Version Features Setup<\/h4>\n\n

          If you upgrade to the Pro version, you will get access to:\n* WhatsApp Cloud API Integration<\/strong> for template-based restock messages.\n* Auto-generated WooCommerce Coupons<\/strong> sent directly inside email alerts.<\/p>\n\n

          License<\/h3>\n\n

          Smart Waitlist for WooCommerce is free software: you can redistribute it and\/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or any later version.<\/p>\n\n

          Smart Waitlist for WooCommerce is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.<\/p>\n\n\n

          Upload Installation<\/h4>\n\n
            \n
          1. Download the plugin ZIP file.<\/li>\n
          2. Log in to your WordPress admin panel.<\/li>\n
          3. Go to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n
          4. Choose the ZIP file and click Install Now<\/strong>, then Activate<\/strong>.<\/li>\n<\/ol>\n\n

            After Activation<\/h4>\n\n
              \n
            1. Go to WooCommerce \u2192 Settings \u2192 Products \u2192 Waitlist<\/strong> to configure the plugin.<\/li>\n
            2. Review the waitlist emails under WooCommerce > Settings > Emails<\/strong>.<\/li>\n
            3. Customise email subjects, headings, and email types from WooCommerce's email settings.<\/li>\n
            4. The waitlist form will automatically appear on any out-of-stock product.<\/li>\n<\/ol>\n\n\n
              \n

              Does this work with variable products?<\/h3><\/dt>\n

              Yes. The form appears when a customer selects a specific variation that is out of stock. Subscribers are tracked per variation, so notifications are only sent when that exact variation comes back in stock.<\/p><\/dd>\n

              Can I customise the form appearance?<\/h3><\/dt>\n

              Yes. Copy templates\/notify-form.php<\/code> from the plugin folder to {your-theme}\/smart-waitlist-for-woocommerce\/notify-form.php<\/code> and modify it freely. CSS custom properties in public\/css\/swfwc-public.css<\/code> make colour\/spacing changes easy without overriding templates.<\/p><\/dd>\n

              Can I customise the notification email?<\/h3><\/dt>\n

              Yes. Go to WooCommerce > Settings > Emails<\/strong> and update the waitlist email subjects, headings, and email types. You can also customise the HTML template by copying templates\/emails\/email-notification.php<\/code> to your theme.<\/p><\/dd>\n

              What merge tags are available in the email?<\/h3><\/dt>\n

              {product_name}, {product_url}<\/code>, {customer_name}<\/code>, {site_name}<\/code>, {unsubscribe_url}<\/code><\/p><\/dd>\n

              How do customers unsubscribe?<\/h3><\/dt>\n

              Every notification email contains a signed unsubscribe link. Clicking it marks the subscriber as unsubscribed immediately \u2014 no login required.<\/p><\/dd>\n

              Is the unsubscribe link secure?<\/h3><\/dt>\n

              Yes. Each link contains an HMAC-SHA256 token signed with your site's WordPress auth salt. Tokens expire after 90 days and cannot be guessed or forged.<\/p><\/dd>\n

              Does it work with WooCommerce HPOS?<\/h3><\/dt>\n

              Yes. The plugin declares compatibility with WooCommerce High-Performance Order Storage (HPOS \/ custom order tables).<\/p><\/dd>\n

              What happens if I have thousands of subscribers?<\/h3><\/dt>\n

              For waitlists with more than 50 subscribers, notifications are automatically queued in batches of 25 via WP-Cron, with 30 seconds between batches. This prevents PHP timeouts and server overload.<\/p><\/dd>\n

              Will my data be deleted if I uninstall the plugin?<\/h3><\/dt>\n

              Yes. The uninstall routine drops the swfwc_waitlist<\/code> table and removes all plugin options. This action is irreversible.<\/p><\/dd>\n

              Can I disable the waitlist for specific products?<\/h3><\/dt>\n

              Yes. Each product has a \"Waitlist\" meta box in the product editor where you can set it to Enabled, Disabled, or \"Inherit global setting\".<\/p><\/dd>\n

              Does the plugin support GDPR right-to-erasure requests?<\/h3><\/dt>\n

              Yes. The plugin integrates with WordPress Privacy Tools (Tools \u2192 Erase Personal Data). Submitting an erasure request for a customer's email will permanently delete all their waitlist records.<\/p><\/dd>\n

              Can I limit how many people join a single product's waitlist?<\/h3><\/dt>\n

              Yes. Go to WooCommerce \u2192 Settings \u2192 Products \u2192 Waitlist<\/strong> and set Max Subscribers per Product<\/strong>. Leave it at 0<\/code> for unlimited (the default).<\/p><\/dd>\n

              Can I use the plugin behind a reverse proxy or load balancer?<\/h3><\/dt>\n

              Yes. Define your trusted proxy IP addresses using the swfwc_trusted_proxy_ips<\/code> filter or the SWFWC_TRUSTED_PROXY_IPS<\/code> constant, and the plugin will correctly identify real client IPs from the X-Forwarded-For<\/code> header. Without this configuration the direct connection IP is used, which is the safe default.<\/p><\/dd>\n\n<\/dl>\n\n\n

              2.0.0<\/h4>\n\n
                \n
              • Breaking (internal only):<\/strong> Renamed every internal identifier \u2014 classes, functions, hooks, options, the custom database table, post meta, cron hooks, nonces, and asset handles \u2014 from the \"SWW\"\/\"sww_\" prefix to \"SWFWC\"\/\"swfwc_\". The old prefix was too short and collision-prone for the WordPress.org Plugin Directory. A one-time, automatic migration preserves all existing waitlist data, settings, and per-product toggles on upgrade; no action needed.<\/li>\n
              • Fix: \"Max Subscribers per Product\" is now a free, fully configurable setting under WooCommerce \u2192 Settings \u2192 Products \u2192 Waitlist. The subscriber-cap enforcement was already active in the free plugin; only the control to configure it was previously (incorrectly) hidden.<\/li>\n
              • Fix: Removed all inline <style><\/code>\/<script><\/code> blocks from PHP templates. CSS moved into admin\/css\/swfwc-admin.css<\/code>; JS moved into admin\/js\/swfwc-admin.js<\/code> using wp_localize_script()<\/code> for nonces\/strings.<\/li>\n
              • Fix: Plain-text double opt-in confirmation email now escapes the confirmation link with esc_url()<\/code> instead of esc_url_raw()<\/code> at the point of output.<\/li>\n
              • Fix: Corrected Plugin URI and Author URI to resolve correctly; corrected the readme Contributors field.<\/li>\n
              • Fix: Added Requires Plugins: woocommerce<\/code> header plus a defensive activation-time WooCommerce check for older WordPress versions.<\/li>\n
              • Housekeeping: Text domain corrected to smart-waitlist-for-woocommerce<\/code> (matching the plugin slug) throughout.<\/li>\n<\/ul>\n\n

                1.1.2<\/h4>\n\n
                  \n
                • Critical fix: Bulk status updates now pass dynamic parameters to $wpdb->prepare()<\/code> with variadic binding, restoring bulk mark-as-notified compatibility.<\/li>\n
                • Email: Double opt-in confirmation now uses a dedicated WooCommerce email class with HTML\/plain-text templates and WooCommerce Settings > Emails controls.<\/li>\n
                • Cleanup: Removed legacy Gumroad license code and Pro features to focus on a lightweight freemium-first build.<\/li>\n
                • Fix: Addressed casing issues in activation and deactivation hooks.<\/li>\n
                • Documentation: Updated plugin version and compatibility metadata.<\/li>\n<\/ul>\n\n

                  1.1.1<\/h4>\n\n
                    \n
                  • Security: Rate limiter now only trusts X-Forwarded-For headers from configured trusted proxy IPs (SEC-02).<\/li>\n
                  • Security: Removed SWFWC_get_pending_subscribers_extra_where<\/code> filter to eliminate SQL injection surface (SEC-01). Replaced with typed $confirmed_only<\/code> boolean parameter.<\/li>\n
                  • Security: Unsubscribe tokens now include a 90-day expiry timestamp with backwards compatibility for existing tokens (SEC-06).<\/li>\n
                  • Bug fix: Re-subscribing after unsubscribing no longer silently fails to send the confirmation email. MySQL's insert_id=0<\/code> on ON DUPLICATE KEY UPDATE<\/code> is now handled by re-fetching the row ID (BUG-01).<\/li>\n
                  • Performance: Removed blocking sleep()<\/code> call inside the WhatsApp cron worker. Retries are now scheduled as async events to avoid blocking the cron queue (PERF-01).<\/li>\n
                  • Performance: Batch processing now fetches all subscriber rows in a single IN()<\/code> query instead of N individual SELECTs (BUG-02).<\/li>\n
                  • Performance: Admin list table status counts now use a single GROUP BY<\/code> query instead of four separate COUNT(*)<\/code> queries (WC-04).<\/li>\n
                  • Reliability: Notification lock transient prevents duplicate batches when the stock-change hook fires more than once in quick succession (WC-01).<\/li>\n
                  • Database: Added user_id<\/code> index to swfwc_waitlist<\/code> table schema (DB-01).<\/li>\n
                  • Database: delete_by_product()<\/code> now busts caches for all variation IDs, not only variation 0 (DB-04).<\/li>\n
                  • GDPR: Added personal data exporter (wp_privacy_personal_data_exporters<\/code>) hook for data portability compliance.<\/li>\n
                  • GDPR: Added personal data eraser (wp_privacy_personal_data_erasers<\/code>) hook for right-to-erasure compliance.<\/li>\n
                  • GDPR: Added optional GDPR consent checkbox (disabled by default; enable via SWFWC_show_consent_checkbox<\/code> filter).<\/li>\n
                  • GDPR: Privacy policy URL appended to form privacy note via wp_get_privacy_policy_url()<\/code>.<\/li>\n
                  • Architecture: SWFWC_Email_Confirmation<\/code> now accepts SWFWC_Database<\/code> via constructor, restoring the DI contract (ARCH-01).<\/li>\n
                  • Architecture: Button position option is now read at render-time instead of at hook-registration time (ARCH-02).<\/li>\n
                  • Architecture: Singleton __clone()<\/code> now throws an exception instead of silently succeeding (ARCH-03).<\/li>\n
                  • Compatibility: Bumped DB schema version to 1.2.0 to trigger dbDelta<\/code> on existing installs for the new index.<\/li>\n<\/ul>\n\n

                    1.0.0<\/h4>\n\n
                      \n
                    • Initial release.<\/li>\n
                    • Core waitlist functionality: subscribe, notify on restock, unsubscribe via link.<\/li>\n
                    • Variable product \/ variation support.<\/li>\n
                    • Admin dashboard with WP_List_Table (search, filter, bulk actions).<\/li>\n
                    • WooCommerce email class integration.<\/li>\n
                    • Async batch processing via WP-Cron.<\/li>\n
                    • HMAC-signed unsubscribe URLs.<\/li>\n
                    • Honeypot spam protection.<\/li>\n
                    • WooCommerce HPOS compatibility declaration.<\/li>\n
                    • Theme-overridable templates.<\/li>\n
                    • Full uninstall cleanup.<\/li>\n<\/ul>","raw_excerpt":"Let customers join a waitlist for out-of-stock products and receive automatic email notifications when stock is restored.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/336596","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=336596"}],"author":[{"embeddable":true,"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/abdennourlaoubi"}],"wp:attachment":[{"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=336596"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=336596"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=336596"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=336596"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=336596"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/fuc.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=336596"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}