GitHub Download

{{#getPostsByTags}} helper

{{getPostsByTags}} is a helper used to retrieve post data regardless of the current context and filter them to posts which uses a specific tag.

Syntax:

{{#getPostsByTags NUMBER_OF_POSTS TAG_ID "EXCLUDED_POST_ID_1,EXCLUDED_POST_ID_2"}}
...
{{/getPostsByTags}}

Example:

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

Above example will show up to 5 posts, 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:

{{#getPostsByTags 5 "lorem,ipsum" ""}}
<li>
    <h2>{{ title }}</h2>
    <div>{{{ excerpt }}}</div>
</li>
{{/getPosts}}

In the above example, code will show up to 5 posts, 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.