Template documentation

Shortcodes and usage patterns

Home
Shortcode guide

This page documents the public shortcodes available in the visual layer. Use them in webroot/content, in templates from webroot/templates or in HTML content managed from the panel, depending on the module.

Examples are escaped as documentation, so you see the shortcode code instead of its rendered output.

Database pages

The page shortcodes are available for pages created in the Pages module. They are usually used inside templates from webroot/templates.

The Pages listing includes default fields for new language versions: page type, template, name, breadcrumb name, description and H1. The Insert defaults button in the language-version form applies the saved pattern. Text fields may use {name}, {city} or {miasto}, replaced with the current page name.

Shortcode	Description
`__LEFT__page:id__RIGHT__`	Page translation ID.
`__LEFT__page:item_id__RIGHT__`	Base page item ID.
`__LEFT__page:panel_title__RIGHT__`	Working title visible in the admin panel.
`__LEFT__page:name__RIGHT__`	Public page name, used for title fallback.
`__LEFT__page:breadcrumb_name__RIGHT__`	Name used in breadcrumbs.
`__LEFT__page:h1__RIGHT__`	Page H1. Falls back to the page name when empty.
`__LEFT__page:url__RIGHT__`	Public page URL.
`__LEFT__page:image__RIGHT__`	SEO/OG image or the default SEO image.
`__LEFT__page:description__RIGHT__`	Meta description.
`__LEFT__page:body__RIGHT__`	Escaped page body.
`__LEFT__page:body:raw__RIGHT__`	Raw HTML page body. This is the main content placeholder.

Page template example

<section class="page-content">
  <h1>__LEFT__page:h1__RIGHT__</h1>
  __LEFT__page:if:image__RIGHT__
  <img src="__LEFT__page:image__RIGHT__" alt="__LEFT__page:h1__RIGHT__">
  __LEFT__/page:if:image__RIGHT__
  <div class="content">__LEFT__page:body:raw__RIGHT__</div>
</section>

Breadcrumbs

__LEFT__breadcrumbs__RIGHT__ generates breadcrumb <li> items for the current page. Place it inside a list.

<ul class="breadcrumbs-link">
  __LEFT__breadcrumbs__RIGHT__
</ul>

Shortcode / placeholder	Description
`__LEFT__menu:main__RIGHT__`	Renders the menu with shortcode `main`.
`__LEFT__menu-name:token__RIGHT__`	Returns a single menu item label.
`__LEFT__menu-link-token__RIGHT__`	Returns a single menu item URL.
`__LEFT__items__RIGHT__`	Placeholder for all menu items in the full menu matrix.
`__LEFT__children__RIGHT__`	Placeholder for child items.
`__LEFT__url__RIGHT__`	Item URL in the item matrix.
`__LEFT__label__RIGHT__`	Item label in the item matrix.
`__LEFT__active_class__RIGHT__`	Active item class.

List matrices

List matrices render repeated data records without JavaScript. You save one row matrix and column names in the panel, while the actual data stays directly on the page.

Shortcode / placeholder	Description
`__LEFT__matrix-list:shortcode__RIGHT__...__LEFT__/matrix-list__RIGHT__`	Renders rows written between the tags using the matrix from the panel.
`__LEFT__matrix-json:shortcode:/js/file.json__RIGHT__`	Renders records from a local JSON file using the same matrix from the panel. The page source contains normal HTML instead of a list built by JavaScript.
`__LEFT__matrix-json:shortcode:/js/file.json:shuffle__RIGHT__`	Renders JSON with random ordering. Records with `priority` greater than zero are shown before the rest, and both groups are shuffled separately.
`__LEFT__large__RIGHT__`, `__LEFT__thumb__RIGHT__`, `__LEFT__alt__RIGHT__`	Example placeholders based on matrix column names.
`__LEFT__thumb-width__RIGHT__`, `__LEFT__thumb-height__RIGHT__`	Automatically detected dimensions of the local image from the `thumb` column.
`__LEFT__image-width__RIGHT__`, `__LEFT__image-height__RIGHT__`	Automatically detected dimensions of the local image from the JSON `image` field.

Columns in the panel

large;thumb;alt;title;description

Single row matrix

<div class="gallery-photo col-xs-12 col-sm-6 col-md-4">
  <a href="__LEFT__large__RIGHT__" class="gallery-single-item lightbox-item lg-trigger" data-exthumbnail="__LEFT__thumb__RIGHT__">
    <img loading="lazy" src="__LEFT__thumb__RIGHT__" width="__LEFT__thumb-width__RIGHT__" height="__LEFT__thumb-height__RIGHT__" alt="__LEFT__alt__RIGHT__ / __LEFT__title__RIGHT__">
  </a>
</div>

Page data

__LEFT__matrix-list:photo-gallery__RIGHT__
/photos/large/1.webp;/photos/thumbs/1.webp;Baku;Azerbaijan;9274
/photos/large/2.webp;/photos/thumbs/2.webp;Baku;Azerbaijan;6166
__LEFT__/matrix-list__RIGHT__

Local JSON data

__LEFT__matrix-json:home-gallery:/js/home-street-en.json__RIGHT__

Local JSON data with shuffle and priorities

__LEFT__matrix-json:home-gallery:/js/home-street-en.json:shuffle__RIGHT__

The JSON file may contain fields such as image, image_full, alt, link, title, number and priority. Field names become matrix placeholders, for example __LEFT__image__RIGHT__, __LEFT__alt__RIGHT__, __LEFT__link__RIGHT__.

News

News shortcodes work on the listing page and on the detail page. The module has its own name, URL segment and title suffix per language.

Shortcode	Description
`__LEFT__news:name__RIGHT__`	News section name.
`__LEFT__news:listing_url__RIGHT__`	News listing URL.
`__LEFT__news:loop__RIGHT__...__LEFT__/news:loop__RIGHT__`	Loop over news entries.
`__LEFT__news:loop:3__RIGHT__...__LEFT__/news:loop__RIGHT__`	Loop limited to 3 entries.
`__LEFT__news:pagination__RIGHT__`	News listing pagination.
`__LEFT__news:title__RIGHT__`	Entry title.
`__LEFT__news:lead__RIGHT__`	Entry lead.
`__LEFT__news:body:raw__RIGHT__`	Entry HTML body.
`__LEFT__news:image__RIGHT__`	Main image.
`__LEFT__news:url__RIGHT__`	Entry URL.
`__LEFT__news:date__RIGHT__`	Publication date.

Blog

The blog supports post listings, post detail pages, categories, tags and taxonomy index views.

Shortcode	Description
`__LEFT__blog:name__RIGHT__`	Blog section name.
`__LEFT__blog:heading__RIGHT__`	Current blog view heading.
`__LEFT__blog:loop__RIGHT__...__LEFT__/blog:loop__RIGHT__`	Loop over blog posts.
`__LEFT__blog:empty__RIGHT__`	Empty listing message.
`__LEFT__blog:categories__RIGHT__`	Category links.
`__LEFT__blog:tags__RIGHT__`	Tag links.
`__LEFT__blog:taxonomy_items__RIGHT__`	Items on a category/tag index page.
`__LEFT__blog:category__RIGHT__`	Current post category.
`__LEFT__blog:tag__RIGHT__`	Current post tags.
`__LEFT__blog:pagination__RIGHT__`	Pagination for blog listing, categories and tags.
`__LEFT__blog:title__RIGHT__`	Post title.
`__LEFT__blog:body:raw__RIGHT__`	Post HTML body.
`__LEFT__blog:url__RIGHT__`	Post URL.

Search

The public search page can use the following shortcodes.

The default English search address is /en/search. The language-specific segment is configured in Settings - Basic - Page.

Shortcode	Description
`__LEFT__search:query__RIGHT__`	Current search query.
`__LEFT__search:results__RIGHT__`	Search results: linked title plus matched word.
`__LEFT__search:pagination__RIGHT__`	Search result pagination.

<h1>Results for: __LEFT__search:query__RIGHT__</h1>
__LEFT__search:results__RIGHT__
__LEFT__search:pagination__RIGHT__

FAQ

__LEFT__faq:shortcode__RIGHT__ inserts only the accordion content, without a section heading. Build the wrapper and title manually in the template.

<section class="faq-section">
  <div class="container">
    <h1>Frequently asked questions</h1>
    __LEFT__faq:strona-glowna__RIGHT__
  </div>
</section>

Photos and files

Photo shortcodes come from the photo library. File shortcodes come from the Files module.

Shortcode	Description
`__LEFT__photo-large-token__RIGHT__`	Large image path.
`__LEFT__photo-thumb-token__RIGHT__`	Thumbnail path.
`__LEFT__photo-alt-token__RIGHT__`	Alternative text.
`__LEFT__photo-title-token__RIGHT__`	Photo title.
`__LEFT__photo-description-token__RIGHT__`	Photo description.
`__LEFT__file:token__RIGHT__`	Public file URL.

Forms

Forms can be rendered as one ready block or composed manually from field shortcodes.

Shortcode	Description
`__LEFT__form:contact__RIGHT__`	Ready form.
`__LEFT__form:contact:open__RIGHT__`	Opens the form and adds technical fields.
`__LEFT__form:contact:messages__RIGHT__`	Success and error messages.
`__LEFT__form:contact:field:email__RIGHT__`	A single form field.
`__LEFT__form:contact:error:email__RIGHT__`	Field validation error.
`__LEFT__form:contact:recaptcha__RIGHT__`	reCAPTCHA v3.
`__LEFT__form:contact:submit__RIGHT__`	Submit button.
`__LEFT__form:contact:close__RIGHT__`	Closes the form.