Customizing the Menu

The top navigation menu can be customized. Once customized, the default menu installed with your system will no longer be applicable.

Step-by-step Guide

To customize the menu, 

1. Go to Site Administration > Appearance > Themes > English (or French) > Settings
2. Go to the "Other" tab
3. Define your own custom menu (see the "Structure of the Menu Entries" below).
4. Click on the "Save changes" button at the bottom of the page

Structure of the Menu Entries

Each line consists of required and optional parameters separated by the pipe “|” character. The parameters include:

• The menu text
• A link URL (optional)
• A tooltip title (optional)
• A language code (en or fr_ca) or comma-separated list of both codes for displaying the menu entry to users of the specified language only (optional)
• A capability or comma-separated list of capabilities for displaying the menu entry to users with the specified system capability only (optional).

Following is an example of a menu entry with all available options.

FAQ|/our-lms-faq |FAQ|en|local/dualcode:authenticated

In this example, a menu entry named "FAQ" will display HTML page called “our-lms-faq” when the site is viewed in English and the user is logged in.

Restricting Access to a Menu

Custom menus items will be visible to all users, including users who haven't logged in, unless you restrict access to them by specifying required capabilities.

A common requirement is to show different menus to authenticated users and non-authenticated users.  To facilitate this requirement, you should be aware of the following common capabilities:

Note:

• When a custom menu item is associated with local/dualcode:authenticated, users will need to log into the system to see it.  
• Any capability in the system can be used to restrict access to a menu item as long as it's assigned to a user in the context of the system.  For an exhaustive list of capabilities, see https://docs.moodle.org/39/en/Category:Capabilities

Creating Submenus

Submenu entries are created by putting a dash “-“ at the start of the line. For example:

FAQ
-Standard Topics|/standard_topics
-Special Topics|/special_topics

In this case, FAQ would be the main menu entry and “Standard Topics” and “Special Topics” would appear in the drop-down menu when you click FAQ. 

Default Menu

The following is the default menu installed on your system as a reference. Note that this menu may vary depending on your version of the software.

Course Catalogue|#|Course Catalogue
-By title (A to Z)|/local/coursecatalog/index.php?catalog=1|By title (A to Z)
-By theme|/local/coursecatalog/index.php?catalog=2|By theme
-By delivery|/local/coursecatalog/index.php?catalog=3|By delivery
-By date|/local/coursecatalog/index.php?catalog=4|By date
-By keyword|/local/coursecatalog/index.php?catalog=5|By keyword
-OCI Marketplace|/local/oci/marketplace.php|OCI Marketplace|en|local/oci:viewmarketplace

My Progress|/local/program/progressreport.php|My Progress|en|local/dualcode:authenticated

[[mycourses]]

My Team|#|My Team|en|report/courses:viewreport
-Compliance Summary|/report/compliance/summary.php|Compliance Summary|en|report/compliance:view
-Learning Records|/report/lrsdata/index.php|Learning Records|en|local/lrsdata:view
-Program Completion|/local/program/report.php|Program Completion|en|report/courses:viewreport

Contact Us|/contactus|Contact Us

FAQ|/faq|FAQ|en|moodle/site:uploadcourses