Favourite / Wishlist
Let visitors save posts, custom-post-type records, or WooCommerce products for later. The feature includes add/remove controls, counters, a saved-item query, and related wishlist tools.
Setup and First Use
Before starting, enable the relevant element or feature family under Bricks → BricksUltimate → General Elements, save, and reopen the Bricks editor. Integrations also require their corresponding plugin to be active.
- Enable the Favourite/Wishlist feature in General Elements and save.
- Add (BU)Add To Wishlist inside the source post/product loop or single-record template.
- Set Post type consistently, for example post for articles or product for products.
- Configure default, added, and loading icons; set labels, Aria label, hover states, and optional tooltip.
- Create a saved-items page using Ultimate Query Builder → Wishlist Items with the matching post type. Build one repeated card using current-item dynamic fields.
- Add a Wishlist Counter and optional Clean All control, then test add/remove and empty states as a guest and logged-in user.
Controls and Settings
| Control | Purpose and usage |
|---|---|
| Post type | Controls which saved list the action belongs to. Match the source buttons, listing, counter, and clear action. |
| Disable remove action | Changes the behavior of an already-added item. Use an explicit remove control elsewhere if customers still need to remove it. |
| Link to URL | Can direct visitors to the saved-items destination. Verify its interaction with the desired add/remove workflow. |
| Icons / Text | Set meaningful default, added, and loading feedback without shifting the layout. |
| Notifications / Tooltip | Choose add/remove notification templates and tooltip wording/appearance where configured. |
| Sync with variable products | For products, test variation selection with the configured Single Add To Cart button selector and the saved record behavior. |
Saved Lists, Storage, and Privacy
The implementation separates lists by post type, uses cookies for guest state, and can use account metadata for logged-in state. Configure cache variation or dynamic rendering so personalized lists and counts are not shared between visitors. Verify cookie-consent behavior and do not promise cross-browser guest persistence.
Complete Wishlist Workflow
The existing Wishlist documentation covers loop setup, removal, the wishlist page, counters, and WooCommerce-specific actions in more detail. Favourite/Wishlist is not restricted to products, but cart actions require valid WooCommerce product data. Use saved-item dynamic context, not the original listing's fixed product IDs.
Practical Example
Create Save Article buttons in a blog loop and a Saved Articles page using the post list. Keep product wishlists separate with Post type set to product on every related control.
Troubleshooting
- Count changes but list stays empty: check post-type consistency and the saved-item query.
- Wrong visitor list: check shared page caching immediately.
- Toggle appears unresponsive: inspect AJAX requests, nonce freshness, and overlapping click handlers.
- Variation saves incorrectly: verify variation-sync options and the add-to-cart selector.