{{#getTags}} helper

{{getTags}} is a helper used to retrieve tags data regardless of the current context. To get a single tag, use getTag.

Syntax:

{{#getTags "TAG_ID1,TAG_ID2,TAG_ID3" "before" "after"}}
...
{{/getTags}}

Example:

{{#getTags "1,2,3" "<ul>" "</ul>"}}
<li>
    {{ name }} ({{postsNumber}})
</li>
{{/getTags}}

Tags are ordered by the ID order in the string.

You can also use the @index variable to detect the tag number in the specified collection:

{{#getTags "1,2,3" "<ul>" "</ul>"}}
<li>
    {{ name }} ({{postsNumber}}) 
    {{#checkIf @index '==' 0}} 
    <small>IT'S THE FIRST ELEMENT!</small> 
    {{/checkIf}} 
</li> 
{{/getTags}}

The second parameter creates HTML prefix, the third parameter creates HTML suffix for the generated output.

IMPORTANT: It requires availability of the @website.contentStructure global variable

It is possible to combine querystring options with theme option values using the concatenate helper:

{{#getTags (concatenate @config.custom.TagsDropdown) "<ul>" "</ul>"}}

Create your first website with Publii

Join thousands of creators who chose independence. Create content locally and publish lightning-fast, secure websites on your own terms.

Download Publii

Free and open source. Windows, macOS and Linux.

Read the getting started guide