WPWing Smart Wishlist & Product Waitlist for WooCommerce

Quick Start

Both features are live immediately after activation. No configuration is required.

1. Go to Plugins → Add New → Upload Plugin, upload the ZIP, and click Activate.
2. Visit any product page — the wishlist button and (on out-of-stock products) the waitlist form are already there.
3. Optional: Create a page, paste the [wpwing_wishlist] shortcode, and publish it. Then go to WPWing → Settings and select that page as the Wishlist Page so the nav count badge links to it.

Wishlist

Shoppers can save any product with a single click. The toggle button appears on every product page and switches between Add to wishlist and Remove from wishlist via AJAX — no page reload.

How the nav badge works

The plugin scans your active nav menus and injects a small count span automatically. No theme edits required. If you want to disable this, add the following to your theme's functions.php:

add_filter( 'wpwing_wl_show_count_in_nav', '__return_false' );

Guest wishlist retention

Guest wishlist items are kept for 30 days by default. This is configurable under WPWing → Settings → Guest Retention. A weekly background job clears expired guest rows automatically.

Back-in-Stock Waitlist

When a product is out of stock, an email capture form appears on the product page automatically. When stock is restored, subscribers receive a notification email and can return to buy.

How restock notifications work

1. WooCommerce updates stock — the plugin detects the stock change immediately.
2. A background job is scheduled via Action Scheduler to process the subscriber list in batches of 50.
3. Each subscriber receives a notification email with a one-click unsubscribe link.
4. The subscriber's row is marked notified with a timestamp. Clicking unsubscribe marks it unsubscribed.

Guest signups

Guests sign up using only their email address. The plugin sets a cookie per product/variation so the shopper sees the "You're on the list" state if they return to the page before the cookie expires.

One-click unsubscribe

Every notification email includes an unsubscribe link unique to that subscriber. Clicking it immediately removes them from future notifications for that product. The plugin also sends the RFC 8058 List-Unsubscribe header so Gmail and Outlook display a native unsubscribe button in the email client.

Shortcodes

[wpwing_wishlist]

Renders the current shopper's saved products as a table with product image, name, price, an Add to Cart button, and an inline Remove button. Shows an empty-state message when the list is empty.

Place this shortcode on a dedicated My Wishlist page, then select that page under WPWing → Settings → Wishlist Page so the nav count badge links to it correctly.

[wpwing_wishlist_count]

Renders a small count badge showing the number of products in the current shopper's wishlist. Links to the configured Wishlist Page when one is set. Useful if you want to place the badge manually — for example, in a header widget or a custom menu item.

<!-- Example: add to a Custom HTML widget -->
[wpwing_wishlist_count]

Settings

All settings live under WPWing → Settings. Every field has a sensible default — you only need to change what you want to customise.

Admin Pages

WPWing → Waitlist

A paginated table of all waitlist signups. You can:

• Filter by product and status (Active, Notified, Unsubscribed)
• Delete individual entries or bulk-delete selected rows
• Export the current filtered view to CSV
• Click Resend Notifications to retry sending for entries that may have failed

WPWing → Wishlist

A ranked table of the 50 most-wishlisted products, ordered by the number of times each product has been saved. This gives you a live demand signal — you can see what shoppers want before it shows up in sales. You can also:

• Filter by product
• Delete individual entries or bulk-delete selected rows
• Export the full wishlist table to CSV

Hooks & Filters

Every meaningful step fires an action or filter so you can customise behaviour without modifying plugin files.

Actions

Filters

add_filter( 'wpwing_wl_restock_queue_entries', function( $entries, $product_id, $variation_id ) {
    // Remove entries matching a suppression list.
    return array_filter( $entries, fn( $e ) => ! in_suppression_list( $e->email ) );
}, 10, 3 );

add_filter( 'wpwing_wl_restock_email_message', function( $message, $entry, $product ) {
    // Replace with your own HTML template.
    return my_custom_email_template( $product, $entry->email );
}, 10, 3 );

add_filter( 'wpwing_wl_show_count_in_nav', '__return_false' );

FAQ