a wee weblog, since 2006

taxonomy:
breadcrumbs

20Jul
2013

Builds a breadcrumb trail from the current node to the root node.

The tag can operate as a tag pair:

Or a single tag:

{exp:taxonomy:breadcrumbs tree_id="1" entry_id="{entry_id}"}

Example output:

<a href="/">Home</a> →
<a href="http://example.com/page/about_us">About Us</a> →
History


Breadcrumbs Tag Parameters

tree_id=

tree_id="1"

The tree_id of the tree you want to fetch. This is a required parameter.

entry_id=

entry_id="{entry_id}"

The entry_id of the node being viewed. This is a required parameter if the node_id parameter is not set.

node_id=

node_id="2"

The node_id of the node being viewed. This is a required parameter if the entry_id parameter is not set.

display_root=

display_root="no"

Don't display the root node, default is 'yes'

delimiter=

delimiter="&rarr;"

Entity you want seperating each crumb. Default is "→".

include_here=

include_here="no"

Prevent the 'here' or 'current' node from appearing in the output so you can append your own crumb items (categories for example). Default is yes.

reverse=

reverse="yes"

Output the items/nodes in reverse order from a traditional breadcrumbs trail

Navigation Tag Variables

These varables are available between the tag pair

VariableExample Output / Notes
{node_id}22 The ID for this node
{node_title}About Us Node label/title according to Taxonomy
{node_url}http://example.com/about The url of the node
{node_lft}6 The 'lft' value of the node
{node_rgt}4 The 'rgt' value of the node
{node_entry_id}22 The entry_id associated with the node
{node_custom_url}http://google.com The custom url if it has been entered (node_url will return this value if it has been set)
{node_entry_title}About Foo Corporation The title of the entry associated with the node
{node_entry_url_title}about-us The url_title of the entry associated with the node
{node_entry_status}closed The status of the entry associated with the node
{node_entry_entry_date}1310087884 The entry_date of the entry associated with the node
{node_entry_expiration_date}1310087884 The expiration_date of the entry associated with the node
{here}1 Returns true if the node is the current node
{not_here}1 Returns true if the node is not the current node
{node_count}3 Essentially an incremental {count} but prefixed to avoid variable clashing
{node_total_count}4 A total count of the nodes returned
{node_level}2 The level of the current node
{node_delimiter}→ The delimiter if using the single tag not the tag pair
{my_custom_taxonomy_field}Bonjour Output any custom taxonomy field by calling it's short name

As captured 18 February 2021 · The archived original