Custom Crumbs

No need to use our simple little crumbs functionality. Feel free to make it as confusing as you want! To build crumbs similar to what the {exp:navee:crumbs} would output, you might do something like this:

{exp:navee:custom_crumbs wrap_type="ul"}
  <li><a href="{link}">{text}</a></li>
{/exp:navee:custom_crumbs}

Parameters

All crumb parameters are optional unless otherwise mentioned.

class

The class parameter will add a class of your choice to the list container (ul or ol). Useful for styling your breadcrumbs using CSS.

class="main-nav"

entry_id

The entry_id parameter will override any dynamic identification of the page you are on. This is useful if you want to include your crumbs tag within something like channel entries tags, or search results tags. It is important to note that this method will only find items which are created using the Guided or Pages methods.

entry_id="5"

id

The id parameter will add an id of your choice to the list container (ul or ol). Useful for styling your breadcrumbs using CSS.

id="sub-nav"

ignore_include_in_nav

You’ll notice in the control panel that one of the options for each navigation node is Include In Navigation. This is useful if you want to build navigation items for use in your sitemap, but not show them in actual navigation.

ignore_include_in_nav="true"

last_item

This parameter allows you to dynamically set the last item item in your breadcrumbs. This would be useful, for example, if you were on a page that does not exist in the navigation. You would need to utilize the regular expression functionality to match the section you are in, but then you could dynamically pass this parameter the title of the page you are on. This will simply push one more item onto the end of your breadcrumbs.

last_item=""

last_item_link

Exactly the same as last_item above, except for the link that will be added to that item.

last_item_link="/news/"

nav_title

By default, {exp:navee:crumbs_custom} will search all of your navigation groups until it finds a match. If you would rather limit your breadcrumbs to a single navigation group, just pass its nav_title as a parameter.

nav_title="main-nav"

no_last_spacer

If you have set the spacer parameter, this will remove it from the very last item in your breadcrumbs.

no_last_spacer="true"

reverse

The reverse parameter reverses the order of all items in your crumbs.

reverse="true"

spacer

You can pass the spacer anything you would like to be assigned to the spacer variable. This parameter is useful when used in conjunction with the no_last_spacer parameter.

spacer="|"

wrap_type

By default, NavEE uses nested unordered lists. You can override this functionality, which will make NavEE wrap any grouping of navigation items in an opening/closing pair of whatever you pass here. wrap_type will also accept a parameter of none which will output no wrapping tags.

wrap_type="ol"

Variables for {exp:navee:custom_crumbs}

class

The class variable outputs any specific class you have associated with a NavEE item.

count

The count variable outputs a running count for your breadcrumbs.

custom

The custom variable outputs what you have entered in the Include additional html in li section for each NavEE item.

custom_kids

The custom_kids variable outputs what you have entered in the Include additional html in ul of children section for each NavEE item.

id

The id variable outputs the id associated with each NavEE item.

is_last_item

Returns true for the last item in your breadcrumb trail.

link

The link variable outputs the link associated with each NavEE item.

name

The name variable outputs the name attribute associated with each NavEE item (for use in an anchor tag).

navee_id

Each NavEE item has a unique identifier. The navee_id variable outputs this identifier.

navigation_id

Each NavEE navigation group has a unique identifier. The navigation_id variable outputs this identifier.

rel

The rel variable outputs the rel attribute associated with each NavEE item (for use in an anchor tag).

spacer

Outputs the optionally assigned spacer parameter value.

target

The target variable outputs the target attribute associated with each NavEE item (for use in an anchor tag).

text

The text variable outputs the text associated with each NavEE item.