GitHub

{{#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.

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

Subscribe

Get the latest Publii news, updates and more delivered directly to your email inbox

You can change your mind at any time by clicking the unsubscribe link in the footer of any email you receive from us, or by contacting us at contact@tidycustoms.net. By clicking below, you agree that we may process your information in accordance with our Privacy Policy.