Crumbs
I bet you thought NavEE was a one trick pony. Well you are sorely mistaken! Not only is NavEE great for building your navigations and sitemaps, but it can also create your breadcrumbs for you! NavEE searches through your navigation tree to find a match for the page you are on. If it finds one, it will dynamically build breadcrumbs leading back to the top of your navigation.
Much like building your navigation, there is a really easy way, and an easy way to add breadcrumbs to your templates. Here is the really easy way. Or you can find out more about the NavEE Custom Crumbs Tag.
{exp:navee:crumbs nav_title="main-nav"}Parameters
- class (optional)
-
The class parameter will add a class of your choice to the list container (ul or ol). Useful for styling your breadcrumbs using CSS. Check out some great examples of breadcrumb CSS.
class="main-nav" - entry_id (optional)
-
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 (for example) something like channel entries tags, or search results tags. It is important to note, this method will only find items which are created using the Guided or Pages methods.
entry_id="5" - id (optional)
-
The id parameter will add an id of your choice to the list container (ul or ol). Useful for styling your breadcrumbs using CSS. Check out some great examples of breadcrumb CSS.
id="sub-nav" - ignore_include_in_nav (optional)
-
You'll notice in Control Panel that one of the optionals for each navigation node is "Include In Navigation". This is useful if you want to build breadcrumbs items for use in your sitemap, but not show them in actual navigation.
ignore_include_in_nav="true" - last_item (optional)
-
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 (optional)
-
Exactly the same as last_item (see above), except for the link that will be added to that item.
last_item_link="/news/" - nav_title (optional)
-
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 it's nav_title as a parameter.
nav_title="main-nav" - no_last_spacer (optional)
-
If you have set the spacer (see above) parameter, this will remove it from the very last item in your breadcrumbs.
no_last_spacer="true" - reverse (optional)
-
The reverse parameter reverses the order of all items in your crumbs.
reverse="true" - spacer (optional)
-
You can pass the spacer anything you would like to be assigned to the spacer variable. This parameter is mostly useful when used in conjunction with the no_last_spacer parameter (see below).
spacer="|" - wrap_type (optional)
-
By default, NavEE uses nested unordered lists. You can override this functionality, which will make NavEE wrap any grouping of nav items in an opening/closing pair of whatever you pass here. Wrap type optionally will also accept a parameter of "none" which will output no wrap tags.
wrap_type="ol"