Extend Navigation Menu

Estimated reading: 4 minutes

New Main Menu Item

If you want to extend the main menus you first have to create an new Menu item at admin->setup->menu functions. This item must be in the main category “Main menu” and in the sub category “Main menu”. Beside the name no other parameter is neccessary.

The ID of this new menue item is needed to to extend the left navigation menue. After a reset and a reload of the page the new menue item is shown next to the existing items in the top main menue. If there is nothing written in the column “URL” the navigation menue with the new menue ID is shown. (Menu Points)

New Navigation Menu

The own navigation menue must be created in the extension file “ext_nav.inc” in the extension directory. To do this a blank file with the name “ext_nav.inc” is created in the EXTENSION directory or in a subdirectory. There the existing menue array can be extended (Script Extensions).. The own menue array is inserted by its ID. The used IDs are arbitrary but they should begin at 1000 so they don’t override a limbas menue. A good way to do is to create ID blocks for the group containers and the corresponding menues. The range of these ID blocks should be wide enough to allow additional menue items.

$menu[1000] = $meinmenue1;
$menu[1001] = $meinmenue2;

A new menu item must be created for each sub-item in the navigation menu, which should have its own extension (admin-> setup-> menu items).
This must be under the main category “extensions” and must also have a unique action name.

Parameters

  • id : unique number
  • name: text for the name of the menu
  • bg: background color
  • link_url: ClickEvent of the menu item (URL Syntax)
  • gicon: displayed image before naming the group container
  • icon_url: displayed image before naming the menu