HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket


Note

This content does not apply to Commerce versions 14+.

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

## Link to an existing tab

The following image and code sample show how to add a link (**Countries**) to an existing tab in left menu.

200



## Add a tab to the left menu

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



## Remove tabs

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



## Modify 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) – displayed by the element. It can contain a resource string with the following format: {ResourceName:ResourceKey}.

  • **order** (int) –, 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.