Tags
Sub Navigation
{exp:structure:nav_sub}
The nav_sub tag is intended for sub-navigation and will show up to two levels of <ul>s at a time. It dynamically shows pages at the same level and jumps to a child’s level if it has children itself. The tag will automatically add class="here" to the current page’s <li> and class="last" to the last <li>. Automatically excludes entries marked with the "closed" status.
Add Span
add_span="yes"
Adds a span tag around the navigation element.
Add Unique Entry ID
add_unique_entry_id="yes"
Format = nav_sub_8291 (where 8291 = the current entry_id)
Add Unique ID
add_unique_id="yes"
Format = toplevelparentfirstsegment_current_page_uri
CSS Class
css_class="sub_navigation"
Assigns a class to the ul.
CSS ID
css_id="sub_navigation", defaults to nav(current EE separator)sub
Assigns an ID to the ul. You can add "none" to optionally display no ID.
Current Class
current_class="active", defaults to here
Change the class name added to the current page
Exclude Entries
exclude="26|76"
The parameter "exclude=" can be used to hide any single or multiple user defined entry numbers using the pipe character.
Exclude Status (Depracted, use the status parameter)
exclude_status="status1|status2"
The parameter "exclude_status=" can be used to hide any single or multiple user defined statuses using the pipe character. This is useful for form confirmation or non-structural pages you don't want to appear in the sub-navigation. If a page is excluded all of it's children will be removed from being displayed as well.
Hide If No Children
hide_if_no_children="yes"
Conditional output display for nav_sub.
Include Status (Depracted, use the status parameter)
include_status="Special"
The parameter "include_status=" can be used to add any single or multiple user defined statuses using the pipe character.
Include ul
include_ul="yes|no"
Conditionally output the surrounding ul tag
Limit Depth
limit_depth="2"
Limits how deep children pages are shown with the start_from parameter.
Rename Overview Link
rename_overview="Another Name"
Use a different word or term when using the show_overview_link parameter.
Separator
separator="-", defaults to EE Global Weblog Setting
Change the default separator used in classes and IDs from something different than the your EE preference setting.
Show Level Classes
show_level_classes="yes|no", defaults to yes
Displays class="sub_level_0", class="sub_level_1", etc on lis
Show Overview Link
show_overview_link="yes|no", defaults to no
Displays a link for "Overview" as the first subnav point in a section's landing page to designate where you are in the subnav hierarchy right away.
Start From
start_from="/about" or start_from ="/{segment_1}/{segment_2}"
The parameter "start_from=" can be used to display a different page's children. Defaults to the current page's children and the logic above if not set. This is useful for pages outside of Structure to mimic the same hierarchy. This mode switches the tag to "fixed" mode, where it will show ALL levels of children as you drill down instead of just children pages. The "start_from" parameter MUST BE FULL URI! Example: start_from="/about/company" or start_from="/{segment_1}/{segment_2}". This parameter can be used to switch certain pages back to the alternate mode if required.
Show Depth
show_depth="2"
Always show children pages up to a specified depth. Designed to work with the start_from parameter.
Status
status="Radical|Whatever|not Bogus", defaults to Open
Add or restrict pages by status, using normal EE syntax.
