TagModel

Whenever you’re dealing with a tag in your template, you’re actually working with a TagModel object.

Simple Output #

Outputting a TagModel object without attaching a property or method will return the tag’s title:

<li>{{ tag }}</li>

Properties #

TagModel objects have the following properties:

group #

Alias of getGroup().

groupId #

The tag’s group ID.

id #

The tag’s ID.

locale #

The locale the tag was fetched in.

next #

Alias of getNext().

prev #

Alias of getPrev().

slug #

The tag’s slug.

title #

The tag’s title.

Methods #

TagModel objects have the following methods:

getGroup() #

Returns a TagGroupModel object representing the tag group that the tag belongs to.

getNext( params ) #

Returns the next tag that should show up in a list based on the parameters entered. This function accepts either a craft.tags variable (sans output function), or a parameter array.

getPrev( params ) #

Returns the previous tag that would have shown up in a list based on the parameters entered. This function accepts either a craft.tags variable (sans output function), or a parameter array.

Here’s an example of the getPrev() and getNext() methods in action:

{% set params = {
    setId: 3
} %}

{% set prevTag = entry.getPrev(params) %}
{% set nextTag = entry.getNext(params) %}

{% if prevTag %}
    <p>Previous: <a href="/tags/{{ prevTag | url_encode }}">{{ prevTag }}</a></p>
{% endif %}

{% if nextTag %}
    <p>Next: <a href="/tags/{{ nextTag | url_encode }}">{{ nextTag }}</a></p>
{% endif %}