orchardcore-menus

Orchard Core Menus

Enable OrchardCore.Menu. A menu is a Menu content item with MenuItemsListPart; its entries are nested content items such as LinkMenuItem, ContentMenuItem, or HtmlMenuItem.

Menu Item Types

Type	Purpose	URL source
LinkMenuItem	Static navigation link	Hardcoded LinkMenuItemPart.Url
ContentMenuItem	Link derived from a referenced content item	Resolved from the referenced item's route
HtmlMenuItem	Custom markup inside a menu	HTML stored on HtmlMenuItemPart

See orchardcore-navigation for ContentMenuItem recipe examples and for registering menus from a code-first INavigationProvider.

Recipe

Wrap every menu item in a complete root recipe document:

{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.Menu",
        "OrchardCore.Widgets",
        "OrchardCore.Layers"
      ]
    },
    {
      "name": "content",
      "data": [
        {
          "ContentItemId": "4j42fxryjcpqkkacmg6cwz3pr5",
          "ContentType": "Menu",
          "DisplayText": "Main Menu",
          "Latest": true,
          "Published": true,
          "MenuPart": {},
          "TitlePart": {
            "Title": "Main Menu"
          },
          "AliasPart": {
            "Alias": "main-menu"
          },
          "MenuItemsListPart": {
            "MenuItems": [
              {
                "ContentItemId": "4j42fxryjcpqkkacmg6cwz3pr6",
                "ContentType": "LinkMenuItem",
                "DisplayText": "Home",
                "LinkMenuItemPart": {
                  "Url": "~/"
                }
              }
            ]
          }
        }
      ]
    }
  ]
}

Render a menu directly from a Liquid theme layout with its alias handle:

{% shape "menu", alias: "alias:main-menu", cache_id: "main-menu", cache_fixed_duration: "00:05:00", cache_tag: "alias:main-menu", cache_context: "user.roles" %}

Menus can be permission-based. Configure permissions on menu items when a link must be visible only to users who can perform the related action. When the menu is cached, include user.roles in cache_context so the output is varied by the current user's roles.