FluentCart Wishlist Documentation

Requirements

• WordPress 6.0 or newer
  Tested with WordPress 7.0.
• PHP 7.4 or newer
  OpenSSL is required for encrypted license-key storage.
• FluentCart active and configured
  Products, cart, checkout, and the customer portal should already work.
• Working WP-Cron and email delivery
  Required for reminders, stock notices, price-drop notices, and license checks.
• Bricks Builder is optional
  It is only needed when using the two native Wishlist elements.

Installation

1. In WordPress, go to Plugins > Add New > Upload Plugin.
2. Select the FluentCart Wishlist ZIP and choose Install Now.
3. Activate FluentCart Wishlist.
4. Open FluentCart > Wishlist.
5. On the License tab, enter your license key and choose Activate license.
6. Review the automatically created Wishlist page and add it to your site navigation if appropriate.

First test checklist

• Open a FluentCart product archive in a private browser window.
• Save one simple product and one variation.
• Refresh the page and confirm both controls remain in the saved state.
• Open the Wishlist page and verify image, title, variation, price, and cart action.
• Log in and confirm the guest list merges into the customer account.
• Open the FluentCart customer portal and test remove, move, and add-to-cart actions.

Automatic placement

• Product cards: a circular heart badge appears at the top-right of FluentCart cards.
• Single products: a full-width action appears below the product buy area.
• Related products and quick view: controls are discovered when FluentCart renders the card or price block.
• AJAX pagination: newly inserted controls are scanned and synchronized automatically.

Save behavior

When customer list creation is enabled, logged-in customers see a Save to a list dialog where they can select an existing list or create a new one. Guests use the default list and are not shown a new-list form.

Variation handling

Wishlist records store both the product ID and the selected variation ID. Advanced variation changes update the button before saving. Wishlist displays use the selected variation title, price, and image when available, then fall back to the main product image.

Visibility modes

• Private: intended for the list owner. Do not distribute its share link.
• Unlisted: accessible through its unique share URL but not intended for public discovery.
• Public: designed for sharing through the generated URL.

Shared list views are read-only. Visitors can view product information without receiving the list owner's management controls.

Automatic page creation

On activation, the plugin looks for a page at the wishlist slug. If none exists, it creates and publishes a Wishlist page containing the primary shortcode.

[fluentcart_wishlist]

[fc_wishlist]

What customers see

• Tabs for every available list.
• A visual marker on the default list.
• FluentCart product image, title, variation label, price, and cart action.
• A floating saved-state heart that removes the item when selected.
• The selected variation image, with the main product image as fallback.

Available customer actions

• Switch between all owned lists using list tabs.
• Select one, multiple, or all saved items.
• Remove selected items in one bulk operation.
• Add selected items or every item in the active list to the cart.
• Move a product from the current list to another list.
• Edit list title, visibility, default status, and sharing.
• Opt in or out of each wishlist notification type.

Guest-to-customer merge

When a guest logs in, the plugin reads the guest token, merges guest lists and items into the WordPress user identity, protects duplicate product/variation combinations, and clears the guest cookie.

Email templates

Each notification has an editable subject and message. Available placeholders are:

• {product_name}
• {variation_name}
• {product_url}
• {old_price}
• {new_price}
• {unsubscribe_url}

The price of {product_name} dropped from {old_price} to {new_price}.

View product: {product_url}
Manage notifications: {unsubscribe_url}

Scheduling and delivery

The plugin schedules an hourly WordPress cron event, processes eligible wishlist items in batches, queues notifications, and retries failed deliveries up to three times. FluentCart's mailer is used when available; otherwise the plugin falls back to wp_mail().

Opt-out controls

Customers can disable back-in-stock, price-drop, or reminder emails from the customer portal. Every template can include the secure {unsubscribe_url} value for direct opt-out.

Date filters and CSV export

Choose From and To dates, select Apply, then use Export CSV to download the same period. The export contains product ID, product name, saves, current saves, unique wishers, removals, conversions, conversion rate, and attributed revenue.

Wishlist for Loop

1. Edit a Bricks template that loops FluentCart products.
2. Add Wishlist for Loop inside the product loop item.
3. Choose Badge for the circular absolute-position control or Button for icon and text.
4. Configure the controls shown for the selected display type.

Wishlist for Single Product

1. Edit a Bricks FluentCart single-product template.
2. Add Wishlist for Single Product near the buy section.
3. Style typography, icon size, background, border, and box shadow under the Content tab.
4. Configure independent active and hover colors, backgrounds, borders, and shadows.

Wishlist Counter

1. Add Wishlist Counter to a Bricks header, menu, or other global template.
2. The element displays a heart icon with the total number of items across the visitor's wishlist lists.
3. Selecting the element opens the plugin's Wishlist page.
4. The bubble refreshes automatically after save, remove, and bulk-remove actions.

Activate a license

1. Open FluentCart > Wishlist > License.
2. Paste the license key received after purchase.
3. Select Activate license.
4. Confirm the status changes to Active.

Use Check license to refresh the current status, or Deactivate before moving an activation when required.

Automatic updates

The plugin checks the BricksUltimate EDD endpoint daily and integrates available releases with the standard WordPress Plugins update screen. A valid license is required to download premium updates.

Purchase terms

• $59 one-time purchase.
• Lifetime plugin updates and support.
• Use on unlimited websites.
• 14-day refund policy. PayPal processing fees are non-refundable.

Guest cookie

Stored data

• WordPress user ID or FluentCart customer ID for account-owned lists.
• Guest token for anonymous list ownership.
• Product IDs, variation IDs, list titles, visibility, share tokens, and timestamps.
• Notification email and per-event preferences for eligible customers.
• Queued email payloads, delivery status, and retry information.
• Save, remove, and conversion events with order attribution and event value.

External communication

License activation, status, and update requests communicate with https://bricksultimate.com and can include the license key, site URL, plugin version, and EDD item ID. Notification emails use FluentCart's mailer when available or the site's WordPress mail configuration.

Default retention behavior

When Clear all data on uninstall is disabled, the wishlist, automation, and analytics tables remain. License information, migration metadata, and scheduled plugin events are removed.

Complete deletion

Enable FluentCart > Wishlist > General > Clear all data on uninstall, save the setting, and then uninstall the plugin. The plugin permanently removes:

• Wishlist lists and items.
• Automation preferences and queue entries.
• Analytics events.
• Plugin settings and license data.
• The automatically created Wishlist page.
• Wishlist automation and license-check cron events.

Useful WordPress checks

wp plugin status fluentcart-wishlist
wp cron event list --fields=hook,next_run_relative
wp option get fluentcart_wishlist_settings --format=json

When contacting support, include the plugin version, WordPress version, PHP version, FluentCart version, active theme/builder, exact product type, steps to reproduce, and relevant browser or PHP errors. Never send a full unmasked license key in a screenshot.

add_filter('fluentcart_wishlist/guest_cookie_ttl', function ($seconds, $days) {
    return 90 * DAY_IN_SECONDS;
}, 10, 2);

add_filter('fluentcart_wishlist/is_customer_portal_page', function ($is_portal) {
    return $is_portal || is_page('my-custom-account');
});

Database tables

• {prefix}fct_wishlist_lists
• {prefix}fct_wishlist_items
• {prefix}fct_wishlist_automation_preferences
• {prefix}fct_wishlist_automation_queue
• {prefix}fct_wishlist_analytics_events