TagModel

This document is for a version of Craft CMS that is no longer supported. Please refer to the latest version →

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 %}