Primary navigation

Primary navigation (also referred to as site navigation) is main navigation element appearing at the top of every page that allows visitor to explore the various areas of your site.

To modify the contents of the primary navigation, locate and edit:
Base Folder/inc/nav-primary

Below are the elements of the primary navigation used to add items to the primary nav. You will need to publish the navigation for changes to take effect.

Datadef element

Description

Nav widget

This option adds extra content to the right side of the navigation bar. Available options are:

None - nothing is added.
Date - displays the current date.
Weather - displays the current weather (updated hourly).

Nav item

This represents a single item in the navigation. You can add and remove instances of this field group using the + and - toggles.

Nav item > Item type

Defines the characteristics of the nav item.

link - defines the nav item as a simple link.
dropdown - defines the nav item as a button that toggles a dropdown menu.
link and dropdown - defines the nav item as a link with a dropdown menu toggle button next to it.

Nav item types

Below are the available primary nav item types, selectable via the 'Item type' datadef element (see above).

Link

Setting 'Item type' to 'link' adds a simple link to the primary nav and reveals the following datadef elements:

Datadef element	Description
Nav item > Link	Only appears if 'Item type' is set to 'link'. Refer to 'Working with links'.

Setting 'Item type' to 'Dropdown' adds a dropdown menu to the primary nav and reveals the following datadef elements:

Datadef element	Description
Nav item > Text	Required. Defines the text label for the nav item dropdown toggle.
Nav item > Set internationalization	Used to apply internationalization to dropdown toggle labels. Refer to 'Internationalization '.
Nav item > Dropdown > Dropdown item	Represents an item in the dropdown menu. You can add and remove instances of this field group using the + and - toggles.
Nav item > Dropdown > Dropdown item > Item type	Indicated what is added to the dropdown menu. Available options are: link - adds a link. heading - adds a heading, useful if your have multiple categorizable groups of links in the dropdown menu. Note that headings are not linkable. divider - adds a divider, useful for separating groups of links in the dropdown menu.
Nav item > Dropdown > Dropdown item > Text	Required. Only appears if 'Item type' is set to 'heading'. Defines the text used for the heading.
Nav item > Dropdown > Dropdown item > Set internationalization	Used to apply internationalization options for dropdown menu headings. Refer to 'Internationalization'.
Nav item > Dropdown > Dropdown item > Link	Refer to 'Working with links'.

Link and dropdown

Setting 'Item type' to 'link and dropdown' adds a link to the primary nav with an associated dropdown menu. The datadef element reference tables for Link and Dropdown above apply.