This module allows you to group CMS menu items into nested lists which expand when hovered over. This is useful when
there are so many CMS menu items that screen space becomes an issue.
Previous versions are available through the appropriate branch.
In order to group CMS menu items together, define your menu groups in a
In the example below, CMSMain (Pages) and AssetAdmin (Files & Images) are grouped
together under a "Content" heading.
LeftAndMain: menu_groups: Content: - CMSPagesController - AssetAdmin
The items in each grouped menu will follow the order you set in your YML. The groups
themselves will be inserted in the menu with a priority of 0, with other menu items
appearing above or below depending on their existing priority.
You can change the priority of a menu group like this:
LeftAndMain: menu_groups: Other: priority: -500 - ReportAdmin - SecurityAdmin
Or you can "group" items by themselves to make any menu item follow the order you set in your configuration:
LeftAndMain: menu_groups: CMSPagesController: - CMSPagesController Other: - ReportAdmin - AssetAdmin
When you have larger menus, and/or multiple modules combining to the same menu, this may require something more consistent. In which case, you may sort your grouped menus alphabetically.
LeftAndMain: menu_groups: CMSPagesController: - CMSPagesController Other: - ReportAdmin - AssetAdmin menu_groups_alphabetical_sorting: true
You can add a CSS class to groups for the purpose of adding an icon. The class name will be prefixed with 'icon-'.
In the example below the same icon used for the Pages menu item will be used for the Content group.
LeftAndMain: menu_groups: Content: icon: 'cmspagescontroller' - CMSPagesController - AssetAdmin
A group label may be translated by providing a translation key as below (using
the 'Other' group from above as an example)
langcode: GroupedCmsMenuLabel: Other: 'translated text'
If the group label has spaces, these will be converted to underscores for the
langcode: GroupedCmsMenuLabel: Other_Label: 'translated text'
Module rating system helping users find modules that are well supported. For more on how the rating system works visit Module standards
Score not correct? Let us know there is a problem