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.