Download the PHP package dnadesign/silverstripe-setmenu without Composer
On this page you can find all versions of the php package dnadesign/silverstripe-setmenu. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dnadesign/silverstripe-setmenu
More information about dnadesign/silverstripe-setmenu
Files in dnadesign/silverstripe-setmenu
Package silverstripe-setmenu
Short Description A SilverStripe module for managing configurable and orderable menu sets.
License BSD-3-Clause
Informations about the package silverstripe-setmenu
Silverstripe Set Menu
A Silverstripe module to define menu sets for different purposes.
Credit
This module was inspired by the following modules, but modified for our tastes:
Requirements
This module is baked for Silverstripe 5 and Php 8
Installation
composer require dnadesign/silverstripe-setmenu
Configuration
Define the MenuSets and the group they belong to in .yml configuration by setting default_sets
.
- Key: Initial name of the MenuSet.
- Value: Group the MenuSet belongs to.
Additionally, subsite menusets can be configured. Currently the mechanism to do this is to match the theme name to the menu definition. This would also require a template to be copied to the subsite theme to override it and make use of the different menu sets. i.e.
On /dev/build
they will be created automatically.
Migration from MenuManager
The classes in this module are namespaced, and the table names are plural, so this module is able to be installed without removing MenuManager first.
The intent for this is to allow a migration from MenuManager to Set Menu other by first deploying the module, creating the menus in the production environment, then later, deploying the template changes.
This avoids a state where the content must be hurriedly created after deployment.
Usage
Use the $MenuType('Name')
template function to retrieve the MenuSet DataList:
Permissions
In /admin/security/
, add the Access to 'Menus' section and Manage Menus permissions to a group to view and edit the menu objects.
Subsites
This module is configured to operate with or without the Subsites module.
Tasks
The module comes with a task to truncate the MenuSets, which may be helpful for development purposes. This can be enabled on PROD if required.
TODO
- Currently, when using Subsites, the same MenuSets will be created for each subsite.
- Update the configuration documentation and
requireDefaultRecords()
functionality inMenuSetSubsiteExtension
to allow different configuration per Subsite.
- Update the configuration documentation and
All versions of silverstripe-setmenu with dependencies
silverstripe/cms Version ^5
symbiote/silverstripe-gridfieldextensions Version ^4