web_favorite_posts Shortcode

The web_favorite_posts shortcode provides an initially empty feed that the theme's favorites runtime fills with the visitor's saved items. It supports a regular grid or a Masonry layout.

The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.

Usage

[web_favorite_posts]

Attributes

Attribute Default Accepted values Purpose
no_favorite_message You have not marked any product as a favourite. Plain text Sets the message used when the visitor has no saved items.
style default default, masonry Selects the regular row or Isotope-powered Masonry container.
columns 4 12, 6, 4, 3, 2, 1 Grid spans corresponding to 1, 2, 3, 4, 6 or 12 desktop columns, respectively, for either layout.
exclude_images — yes or empty; existing nonempty values other than 0 are also supported Requests favorite cards without their images.
device_visibility — Comma-separated web-hide-on-xs, web-hide-on-sm, web-hide-on-md, web-hide-on-lg Hides the feed in the selected theme device ranges.
el_id — Valid unique HTML ID Enter section ID (Note: make sure it is unique and valid according to w3c specification).
el_class — String unless stated otherwise If you wish to style particular content element differently, then use this field to add a class name and then refer to it in your css file.

Verification

Test in the same browser with no favorites, one favorite and enough favorites to span several rows. Verify the empty message, image choice and columns are respected; for Masonry, confirm items settle without overlap after their content loads.

The shortcode and the Favorite Posts block use the same player. Add the add_to_favorite merge tag to source feed cards to provide the save action. Favorites are browser-local and require JavaScript/storage; they are not an account-synchronized wishlist. Large saved lists are resolved in ordered batches of up to 100 IDs per request, rather than limiting the complete collection to 100.

Cards show current public, password-free and permitted content: title, link, featured image, explicit excerpt and removal action. Products also require current catalogue visibility. Unavailable IDs remain saved but are omitted. Old saved IDs are readable. Where a custom archive template is configured for the content type, cards use that current server-owned template, including current prices and actions. Otherwise the basic card above is used. Stored HTML is never replayed; an old card from a different list-specific template may use the current archive design. New selections contain IDs only. Image exclusion affects this feed, not the saved selection.