Download the PHP package goldfinch/silverstripe-grouped-cms-menu without Composer
On this page you can find all versions of the php package goldfinch/silverstripe-grouped-cms-menu. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download goldfinch/silverstripe-grouped-cms-menu
More information about goldfinch/silverstripe-grouped-cms-menu
Files in goldfinch/silverstripe-grouped-cms-menu
Package silverstripe-grouped-cms-menu
Short Description Allows you to group CMS menu items.
License BSD-3-Clause
Homepage https://github.com/goldfinch/silverstripe-grouped-cms-menu
Informations about the package silverstripe-grouped-cms-menu
SilverStripe Grouped CMS Menu
- This is fork of symbiote/silverstripe-grouped-cms-menu
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.
Basic Usage
In order to group CMS menu items together, define your menu groups in a config.yml
file.
In the example below, CMSMain (Pages) and AssetAdmin (Files & Images) are grouped together under a "Content" heading.
Sort order
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:
Or you can "group" items by themselves to make any menu item follow the order you set in your configuration:
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.
Group icons
You can add a CSS class to groups for the purpose of adding an icon. The class name will be prefixed with 'font-icon-'. In the example below the same icon used for the Pages menu item will be used for the Content group:
Translating group labels
A group label may be translated by providing a translation key as below (using the 'Other' group from above as an example)
If the group label has spaces, these will be converted to underscores for the key
Requirements
- SilverStripe 4+ and 5+ (See other branches for compatibility with older versions)
Project Links
Credits
- A massive thanks to Russ Michell (phptek) for upgrading this module to be SS4 compatible!