Loading...
Area: Episerver Commerce
Applies to versions: 10 and higher
Other versions:

Customizing the left menu

Any application may extend the left menu navigation. You also can add, delete, or change an existing tab by creating the LeftMenu.xml file.

Linking to an existing tab

The following example shows how to add a link (Countries) to an existing tab in left menu.

Adding a tab to the left menu

The following example shows how to add an empty tab within Order Management.

Removing tabs

The following example shows how to remove a tab within Order Management.

Modifying a link in a tab

The following example shows how to remove the Core_CountriesDictionary link from the Order Management tab.

XML description

The Tab element can contain the following attributes:

  • id (text). Unique identifier within xml file.
  • text (text). Text displayed by the tab. Can contain a resource string with the following format: {ResourceName:ResourceKey}.
  • order (int). Weight, which determines the location of the tab.
  • imageUrl (text). Relative image path for the tab.
  • enableHandler (text). Fully qualified class name for the tab EnableHandler (if EnableHandler returns false, the tab is not displayed in the left menu). The class must implement the ICommandEnableHandler interface.
  • permissions (text). Parameter passed as a CommandParameter value to the EnableHandler.

The following example shows how to retrieve permissions in the EnableHandler class:

The Link element can contain the following attributes:
  • id (text). Unique identifier within XML file.
  • text (text). Text displayed by the element. It can contain a resource string with the following format: {ResourceName:ResourceKey}.
  • order (int). Weight, which determines the location of the element.
  • imageUrl (text). Relative image path for the element.
  • enableHandler (text). Fully qualified class name for the element EnableHandler (if EnableHandler returns false, the element is not displayed in the left menu). The class must implement the ICommandEnableHandler interface.
  • iconCss (text). Css class for the menu image.

Last updated: Oct 24, 2016