Articles in this section

See more

Create Custom Main Menu Entries

  • Updated

Add custom entries to your Main Menu, including non-default entries or external URLs that are displayed in the Main Menu.

To add a custom entry:

  1. Select Domain Settings from the Header menu.
  2. On the Menus card, select ADD. (If you want to edit an existing menu entry, select Override.)
  1. Provide:
    • The ID associated with the entry.
    • The entry's desired placement Order in the Main Menu ("0" = top placement).
    • The entry Title as you want it to appear in the Main Menu.
    • The entry's URL if necessary. You can use the replacement variables defined below to customize this URL further.
    • The desired Icon; review your icon options.
    • An indication about whether you want to the entry Enabled, to Open URL in external window, to Require the user to choose a course, or Do not allow the user to choose a course.
    • The Applications (Admin, Parent, Student, or Teacher) for which the entry should appear (optional).
    • The Rights users need to access the entry (optional).
    • The Userspaces in which the entry should appear (optional).
  2. Select Done.
  3. Select Save.  

Replacement variables for custom Main Menu entries

Custom Main Menu URLs allow for dynamic replacement variables that automatically replace a variable code (options listed below) with a desired value drawn from user, course, and/or domain information.

Use any of the following replacement variables by enclosing them with double curly brackets (e.g., {{TOKEN}}, {{USERID}}, {{ADMINDOMAINID}}):

  • TOKEN: The xLi authentication token for the currently logged in user. When using this variable, the URL must be secure, starting with https.
  • USERID: The ID for the currently logged in user.
  • USERDOMAINID: The domain ID for the currently logged in user.
  • USERSPACE: The userspace for the customization domain, or the domain userspace visible in the top level URL.
  • ENROLLMENTID: The ID of the currently selected enrollment.
  • COURSEID: The ID of the course associated with the currently selected enrollment.
  • ADMINDOMAINID: The currently selected domain ID in the admin app.
  • QUERY-<param>: The value of the top page's query parameter with the case-sensitive name of <param>. The application only replaces this variable if external is not set to true.
  • USERFIRSTNAME: The firstname of the currently logged-in user, or empty-string if the user has specified hidefullname from external web sites.
  • USERLASTNAME: The lastname of the currently logged-in user, or empty-string if the user has specified hidefullname from external web sites.
  • USEREMAIL: The email address of the currently logged-in user, or empty-string if the user has specified hideemailfrom external web sites.
  • USERNOTIFYSMSPHONE: The phone number (not the provider) the current user has specified in their notification preference for SMS messages, or empty-string if the user has specified hideemail from external web sites
Was this article helpful?
0 out of 0 found this helpful
Return to top

Related articles