dnadesign / silverstripe-setmenu
A SilverStripe module for managing configurable and orderable menu sets.
Installs: 26
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 6
Forks: 0
Open Issues: 0
Type:silverstripe-vendormodule
Requires
- php: ^8
- silverstripe/cms: ^5
- symbiote/silverstripe-gridfieldextensions: ^4
This package is auto-updated.
Last update: 2024-10-14 21:31:59 UTC
README
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 4 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.
DNADesign\SetMenu\Model\MenuSet:
default_sets:
Main nav: Main
Main footer: Footer
Secondary footer: Footer
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.
DNADesign\SetMenu\Model\MenuSet:
default_sets:
Main nav: Main
Main footer: Footer
subsitetheme:
Primary: Main
Auxilliary: Secondary
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:
<% loop $MenuType('Footer') %>
<p>$Name</p>
<% loop $MenuItems %>
<a href="{$Link}" class="{$LinkingMode}"
<% if $NewWindow %>
target="_blank"
rel="noopener"
<% end_if %>
>
{$Title}
</a>
<% end_loop %>
<% end_loop %>
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.
DNADesign\SetMenu\Model\MenuSet:
prod_truncate_permission: true
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