Basic

Last updated: April 6th 2021

This is one line of easy to add code. Synax is {exp:super_navigation:breadcrumbs)

You can't use custom variables in basic tag. For any kind of changes you have to use custom tag.

Parameters

To identify which navigation to call, this is required parameter. (you can also use nav_short_name parameter in place of nav_id)

nav_id="1"

To identify which navigation to call, this is required parameter. (you can also use nav_id parameter in place of nav_short_name)

nav_short_name="header_navigation"

site_id

If you are using MSM and wants to show site 1 menu in site 2, you can use this parameter to tell plugin to bring MSM site menu.

wrap

You can wrap basic navigation with either <ul> or <ol>. Default is <ul>

wrap="ul"
wrap="ol"

disable

For categories and entries URL patterns, We gives facility to bring categories and entries with category parents. That runs extra queries in backend, If you not wish to run those queries and not wish you to bring parent categories to be added into URL, You can pass this parameter.

disable="parent_uri|custom_fields"
// OLD output
http://example.com/blog/category1/category2/blog-url-title

// New output with disable="parent_uri"
http://example.com/blog/category2/blog-url-title

include_self (yes/no)

If you dont wish to return active nav item in breadcrumbs, you can pass this variable to "no". Default behaviour of this variable is "yes".

include_self="no"

self_title

If you want to change title of active entry, You can change with this variable.

self_title="HERE"

reverse (yes/no)

With this parameter you can loop through navigation breadcrumbs in reverse mode.

ul_class

If you wish to add classes to all the wrapper, you can add it here. In basic navigation, all your wrapper can be either <ul> or <ol>.

ul_class="nav"
// All wrapper will assign this class.

li_class

If you wish to add classes to all the <li>, you can add it here.

li_class="nav-li"
// All <li> will assign this class.

active_li_class

If you wish to add a class to all the active <li>, you can add it here.

If you wish to add classes to all the <a> tag, you can add it here.

link_class="nav-link"
// All <a> will assign this class.

If you wish to add a class to all the active <a>, you can add it here.

passive_tag

Only title nodes can be set to a specfic tags like em, span or div instead of <a> by using this parameter.

passive_tag="span"
// Before
<a href="">Passive Link</a>

// After
<span>Passive Link</span>

remove_passive (yes/no)

If you want to remove all Passive (Title only) nodes from breadcrumbs, You can do that with this variable. Default behaviour of this parameter is "no".

remove_passive="yes"

Examples

Here is few examples of basic breadcrumbs tag.

Simple Breadcrumbs with nav_id
{exp:super_navigation:breadcrumbs nav_id="1" disable="parent_uri|custom_fields"}
Simple breascrumbs with nav short name
{exp:super_navigation:breadcrumbs nav_short_name="header_navigation" disable="parent_uri|custom_fields"}
Breascrumbs with classes
{exp:super_navigation:basic
	nav_short_name="header_navigation"
	ul_class="ul_class"
	li_class="li_class"
	link_class="link_class"
	active_li_class="active_li"
	disable="parent_uri|custom_fields"
}
Large Example
{exp:super_navigation:breadcrumbs
	disable="parent_uri|custom_fields"
	nav_short_name="header_navigation"
	ul_class="ul_class"
	li_class="li_class"
	link_class="link_class"
	active_li_class="active_li"
	self_title="Here"
	passive_tag="em"
}