Iain Urquhart

Taxonomy 3

taxonomy:breadcrumbs

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

Variable Example 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

Want to say 'thank you'?

If you find any of my work useful, feel free to make a donation amount of your choosing via PayPal — or if you like, purchase a copy of Introvert from Devot-EE and you'll get something in return :)

↑ Back to top