Modern Campus CMS Training
Menus
Navigational menus received what is likely the biggest overhaul of all of our design elements.
In the old design, menu items are typically edited via files typically found in the config folder (site_config,pcf, section_config.pcf, callout.pcf, etc.). However, in the new design, there is no config folder.
To update your navigational menus in the new design, you will need to edit one of two files: _nav.ounav or _callout.ounav.
During the file migration process, all links that are currently located in site_config.pcf (Horizontal Menu) and/or section_config.pcf (Sidebar Menu) files, will be placed in the _nav.ounav file, while all links in the callout.pcf (Take Action) file will be placed in the _callout.ounav file.
All pages will have a third horizontal menu that can be found directly below the new hero image/video section on most sites.
Pages that use a two column layout will have two side navigation menus.
Editing your ounav file
The editing process for both ounav files is the same, so we will condense the process for editing it here.
To begin editing it, click on it, you will automatically enter 'Edit' mode.
Adding New Menu Item
To add a new menu item, select the '+ ADD NEW' button (pictured below)
From here, you'll want to focus on the form on the right side of the screen:
Text to Display: What will be displayed in the menu once the file has been published
URL Options: You have three options for this menu item, it can either:
- Not include a link
- Link to a file within the CMS
- Link to an external source
NOTE: Your remaining available options in the form will change depending on which of these options you select.
File: This field appears if you select option 2 (Link to File). Here, you can either add the URL of the page you'd like to include or use the file explorer icon at the end of the field to manually search for the page.
External URL: This field appears if you select option 3 (Link To External Source). Here, you can add the URL of the site you'd like to include in this menu file.
It is recommended that you always open External URLs in a new tab.
Class (optional): Allows you to add some customization to your menu item using classes. There are currently three classes that the ounav file supports: top-navigation & no-dropdown
- top-navigation-only: This class will add a menu item to the tertiary horizontal menu It will not appear in the side navigation.
- no-dropdown: This class will remove dropdown behavior from a menu item, if one is not desired
When you are done applying your changes, save, then publish the _nav.ounav file.
In order for changes made here to apply to your website, the folder will need to be republished. Please submit a ticket via our Helpdesk Ticketing system to request a folder republish.
Removing a menu item
To remove a menu item, simply select the trash can icon at the end of the menu item.
Rearranging menu items
To move a menu item, simply drag and drop the menu item on the left side of the screen to its new location.
Understanding ounav Behavior
By default, all newly created sections will come with its own _nav.ounav file. The _callout.ounav file will only be available at the root level and will not be found in any of the subfolders for a given website.
One major change from the previous design is that there is no limit to the number of links that you can include in these navigation files.
Tertiary Horizontal Menu
If you would like a menu item to appear in this menu, add the top-navigation-only class to the menu item in the ounav file.
It will display just below the hero image/video for pages.
However, if there are no images/videos, it will instead display just below the Page Heading banner.
Nested Side Menu
A nested side menu will be created by default if you add a sub-folder's index file to the root folder's _nav.ounav file.
Let's take a look at our training website (/modern_campus_cms_training). If I add the New Design User Training page (/modern_campus_cms_training/new_design_user_training/index.php), to the _nav.ounav file that's in the /modern_campus_cms_training/ folder, that will generate a drop-down that includes any links from the _nav.ounav file in the /modern_campus_cms_training/new_design_user_training/ folder.
If you want an index page to appear in the side navigation, but don't want a drop-down, please add the no-dropdown class to that menu item in the ounav file.
If you would like a nested side menu, but would like to include links to pages from other directories, you will need to manually drag the menu item in the ounav file so that there is a natural indent underneath the parent menu item.
See example below:
In the new design, the parent menu item for nested menus can now include a link to a page without losing its functionality.
Take Action Menu
The callout.ounav file behaves the same way the original callout.pcf file behaved. It is an additional menu that will display just below the side navigation.