PHPackages                             heyday/silverstripe-menumanager - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. heyday/silverstripe-menumanager

ActiveSilverstripe-vendormodule[Utility & Helpers](/categories/utility)

heyday/silverstripe-menumanager
===============================

Allows complex menu management to be handled through the CMS when a simple tree structure is not enough.

5.0.2(11mo ago)35314.2k↓31.1%41[1 issues](https://github.com/WPP-Public/akqa-nz-silverstripe-menumanager/issues)8MITPHPCI failing

Since Nov 20Pushed 2w ago25 watchersCompare

[ Source](https://github.com/WPP-Public/akqa-nz-silverstripe-menumanager)[ Packagist](https://packagist.org/packages/heyday/silverstripe-menumanager)[ RSS](/packages/heyday-silverstripe-menumanager/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (5)Versions (45)Used By (8)

Silverstripe Menu Manager
=========================

[](#silverstripe-menu-manager)

The menu management module is for creating custom menu structures when the site tree hierarchy just won't do.

Installation
------------

[](#installation)

```
composer require heyday/silverstripe-menumanager
```

After completing this step, navigate in Terminal or similar to the SilverStripe root directory and run `composer install` or `composer update` depending on whether or not you have composer already in use.

Usage
-----

[](#usage)

There are 2 main steps to creating a menu using menu management.

1. Create a new MenuSet
2. Add MenuItems to that MenuSet

### Creating a MenuSet

[](#creating-a-menuset)

Login to the CMS and open the `Menus` admin, give the MenuSet a Name (which is what you reference in the templates when controlling the menu).

As it is common to reference MenuSets by name in templates, you can configure sets to be created automatically during the /dev/build task. These sets cannot be deleted through the CMS.

```
Heyday\MenuManager\MenuSet:
    default_sets:
        - Main
        - Footer
```

### Creating MenuItems

[](#creating-menuitems)

Once you have saved your `MenuSet` you can add `MenuItems`.

MenuItems have 4 important fields:

1. Page
2. MenuTitle
3. Link
4. IsNewWindow

#### Page

[](#page)

A page to associate your MenuItem with.

#### MenuTitle

[](#menutitle)

This field can be left blank if you link the menu item with a page. If not fill with the title you want to display in the template.

#### Link

[](#link)

This field can be left blank unless you want to link to an external website. When left blank using $Link in templates will automatically pull the link from the MenuItems associated Page. If you enter a link in this field and then pick a Page as well the link will be overwritten by the Page you chose.

#### IsNewWindow

[](#isnewwindow)

Can be used as a check to see if 'target="\_blank"' should be added to links.

### Disable creating Menu Sets in the CMS

[](#disable-creating-menu-sets-in-the-cms)

Sometimes the defined `default_sets` are all the menu's a project needs. You can disable the ability to create new Menu Sets in the CMS:

```
Heyday\MenuManager\MenuAdmin:
    enable_cms_create: false
```

*Note: Non-default Menu Sets can still be deleted, to help tidy unwanted CMS content.*

### Usage in template

[](#usage-in-template)

```

{$MenuTitle}

```

To loop through *all* MenuSets and their items:

```

{$MenuTitle}

```

Optionally you can also limit the number of MenuSets and MenuItems that are looped through.

The example below will fetch the top 4 MenuSets (as seen in Menu Management), and the top 5 MenuItems for each:

```

{$MenuTitle}

```

#### Enabling partial caching

[](#enabling-partial-caching)

[Partial caching](https://docs.silverstripe.org/en/4/developer_guides/performance/partial_caching/)can be enabled with your menu to speed up rendering of your templates.

```

     $MenuTitle.XML

```

### Allow sorting of MenuSets

[](#allow-sorting-of-menusets)

By default menu sets cannot be sorted, however, you can set your configuration to allow it.

```
Heyday\MenuManager\MenuSet:
    allow_sorting: true
```

Subsite Support
---------------

[](#subsite-support)

If you're using SilverStripe Subsites, you can make MenuManager subsite aware via applying an extension to the MenuSet.

*app/\_config/menus.yml*

```
Heyday\MenuManager\MenuSet:
    create_menu_sets_per_subsite: true
    extensions:
        - Heyday\MenuManager\Extensions\MenuSubsiteExtension
Heyday\MenuManager\MenuItem:
    extensions:
        - Heyday\MenuManager\Extensions\MenuSubsiteExtension
```

License
-------

[](#license)

Menu Manager is licensed under an [MIT license](http://heyday.mit-license.org/)

###  Health Score

62

—

FairBetter than 99% of packages

Maintenance76

Regular maintenance activity

Popularity48

Moderate usage in the ecosystem

Community36

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~107 days

Recently: every ~72 days

Total

44

Last Release

345d ago

Major Versions

2.2.1 → 3.0.0-alpha2017-07-09

2.2.2 → 3.0.42018-09-09

3.4.0 → 4.0.02023-07-05

3.x-dev → 4.1.02023-08-10

4.x-dev → 5.0.02025-07-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/de4d8d61f202a03e88c3ed30cce3bfedbc6f56a16e3f3b25546c61aadc51bca2?d=identicon)[heyday](/maintainers/heyday)

---

Top Contributors

[![wilr](https://avatars.githubusercontent.com/u/101629?v=4)](https://github.com/wilr "wilr (33 commits)")[![camspiers](https://avatars.githubusercontent.com/u/51294?v=4)](https://github.com/camspiers "camspiers (11 commits)")[![glenn-bautista](https://avatars.githubusercontent.com/u/375172?v=4)](https://github.com/glenn-bautista "glenn-bautista (6 commits)")[![lozcalver](https://avatars.githubusercontent.com/u/1655548?v=4)](https://github.com/lozcalver "lozcalver (4 commits)")[![jakxnz](https://avatars.githubusercontent.com/u/1634995?v=4)](https://github.com/jakxnz "jakxnz (3 commits)")[![bendubuisson](https://avatars.githubusercontent.com/u/3079189?v=4)](https://github.com/bendubuisson "bendubuisson (3 commits)")[![stecman](https://avatars.githubusercontent.com/u/2230769?v=4)](https://github.com/stecman "stecman (3 commits)")[![stevie-mayhew](https://avatars.githubusercontent.com/u/1953220?v=4)](https://github.com/stevie-mayhew "stevie-mayhew (3 commits)")[![HJGreen](https://avatars.githubusercontent.com/u/2873649?v=4)](https://github.com/HJGreen "HJGreen (2 commits)")[![lucasfrey](https://avatars.githubusercontent.com/u/7697132?v=4)](https://github.com/lucasfrey "lucasfrey (2 commits)")[![purplespider](https://avatars.githubusercontent.com/u/329880?v=4)](https://github.com/purplespider "purplespider (2 commits)")[![DevKCode](https://avatars.githubusercontent.com/u/365647?v=4)](https://github.com/DevKCode "DevKCode (1 commits)")[![djmattski](https://avatars.githubusercontent.com/u/3836638?v=4)](https://github.com/djmattski "djmattski (1 commits)")[![hdpero](https://avatars.githubusercontent.com/u/13778690?v=4)](https://github.com/hdpero "hdpero (1 commits)")[![satrun77](https://avatars.githubusercontent.com/u/166450?v=4)](https://github.com/satrun77 "satrun77 (1 commits)")[![alex-dna](https://avatars.githubusercontent.com/u/6982515?v=4)](https://github.com/alex-dna "alex-dna (1 commits)")[![3Dgoo](https://avatars.githubusercontent.com/u/2616373?v=4)](https://github.com/3Dgoo "3Dgoo (1 commits)")[![lhalaa](https://avatars.githubusercontent.com/u/340514?v=4)](https://github.com/lhalaa "lhalaa (1 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/heyday-silverstripe-menumanager/health.svg)

```
[![Health](https://phpackages.com/badges/heyday-silverstripe-menumanager/health.svg)](https://phpackages.com/packages/heyday-silverstripe-menumanager)
```

###  Alternatives

[silverstripe/userforms

UserForms enables CMS users to create dynamic forms via a drag and drop interface and without getting involved in any PHP code

1371.1M85](/packages/silverstripe-userforms)[silvershop/core

Provides an ecommerce product catalog, shopping cart, and order management system

11341.0k50](/packages/silvershop-core)[dnadesign/silverstripe-elemental

Elemental pagetype and collection of Elements

1141.1M309](/packages/dnadesign-silverstripe-elemental)[symbiote/silverstripe-advancedworkflow

Adds configurable workflow support to the CMS, with a GUI for creating custom workflow definitions.

46302.4k9](/packages/symbiote-silverstripe-advancedworkflow)[axllent/silverstripe-cms-tweaks

Several CMS usability improvements

1726.4k1](/packages/axllent-silverstripe-cms-tweaks)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)