Adding a Menu Link - Documentation topics on: adding a menu link,navigation,.

Adding a Menu Link

Navigation Macro

The example HTML page navigation menu (shown right), utilizes a Template that has a left hand navigation menu that is controlled by a Navigation Macro.  The Macro code being used in the Template is shown here:  


For more information on how navigation menus are built, please see the Navigation and Menus documentation section.

If there is an HTML page or document that lies outside the parameters of the navigation menu, creating a Menu Link will allow that page or document to be displayed on the navigation menu(s) of other HTML pages created in the same directory. Changing the scope of the navigation menu used by the template might cause other unwanted items to display on our current page and would effect all of the other pages using that template. In this case, the best option is to add a menu link to the desired "Registration Form"

Creating a Menu Link will allow the desired "Registration Form" HTML page to display in ALL of the web pages that share the same directory as the Menu Link. To create a Menu Link, simply locate the folder in the Site Browser where you would like to place the Menu Link, right-click that folder --> New --> Menu Link.

Add Menu Link

The following fields are displayed when creating a new menu link:

  • Title - text that will display in the navigation menu on HTML page(s)
  • Folder - the folder location where the menu link is located
  • Type - "Internal Link" refers to a dotCMS page or document; "External Link" refers to an HTML Page outside the current domain; "Code Link" refers to programming code that will be run when the menu link is selected on an HTML page.
  • Target - select "Same Window", "New Window", or "Parent Window" to determine how the browser will open and display the Menu Link URL in the browser
  • Sort Order - This is the numeric value that will be used by navigation menu to sort the order of objects that have the "Show On Menu" property
  • Show on Menu - Checking this option allows the Menu Link to appear in the navigation menus that display the current directory
Create a Menu Link

The Menu Link can also be configured to open in the same or an alternate window. Click "save and publish" to finish creating the Menu Link. Clicking on the Menu Link takes the user to the associated page/document.

As in the example to the left, the Menu Link now exists on the navigation menu of all HTML pages that share the directory with the newly created Menu Link.