{{#getPostByTags}} helper

{{getPostByTags}} is a helper used to retrieve single post data regardless of the current context with use of specific tag ID or tag slugs. To get several posts, use getPostsByTags.

Syntax:

{{#getPostByTags TAG_ID "EXCLUDED_POST_ID_1,EXCLUDED_POST_ID_2"}}
...
{{/getPostByTags}}

Example:

{{#getPostByTags 1 "3,4"}}
<li>
    <h2>{{ title }}</h2>
    <div>{{{ excerpt }}}</div>
</li>
{{/getPostByTags}}

Above example will show a post, which uses tag with ID = 1, excluding posts with post ID equal to 3 or 4.

Posts are ordered by the same order as specified in the site settings.

You can also use tag slugs:

{{#getPostByTags "lorem,ipsum" ""}}
<li>
    <h2>{{ title }}</h2>
    <div>{{{ excerpt }}}</div>
</li>
{{/getPostByTags}}

In the above example, code will show a post, which uses tags with slug equal to "lorem" or "ipsum". No posts will be excluded.

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

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