PHPackages                             jzubero/silverstripe-sitetree-labels - 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. jzubero/silverstripe-sitetree-labels

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

jzubero/silverstripe-sitetree-labels
====================================

Label your Page items for better orientation in large SiteTrees.

1.1.2(5y ago)41.1k3MITPHPPHP >=5.5.0, <7.2CI failing

Since Oct 15Pushed 5y ago1 watchersCompare

[ Source](https://github.com/JZubero/silverstripe-sitetree-labels)[ Packagist](https://packagist.org/packages/jzubero/silverstripe-sitetree-labels)[ RSS](/packages/jzubero-silverstripe-sitetree-labels/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (3)Versions (9)Used By (0)

SiteTree Labeling
=================

[](#sitetree-labeling)

[![Build Status](https://camo.githubusercontent.com/075d509902e503eaf2e4ef53c03d320dcff1b75e43fe02baca60d595b32c3743/68747470733a2f2f7472617669732d63692e6f72672f4a5a756265726f2f73696c7665727374726970652d73697465747265652d6c6162656c732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/JZubero/silverstripe-sitetree-labels)[![Example SiteTree Label View](docs/demo-shot1.jpg)](docs/demo-shot1.jpg)

Help to enrich your big and messy SiteTrees with some extra top-level information using labels.

Besides your custom labels the module will look for the [Menu Manager](https://github.com/heyday/silverstripe-menumanager) and auto-assign the MenuSet names to the Pages.

Install
-------

[](#install)

`composer require jzubero/silverstripe-sitetree-labels`

Do not forget to `dev/build?flush=all`.

Dependencies
------------

[](#dependencies)

- silverstripe/cms:^3.2
- ryanpotter/silverstripe-color-field:^0.1.0

Features
--------

[](#features)

- GridField in Settings for adding and linking labels
- Integration for Menu Manager Module
- Report for looking up pages linked to a certain label

Configuration
-------------

[](#configuration)

You can adjust the modules' behaviour through the Config API.

```
SiteTree:
  show_labels: true|false
SiteTreeLabel:
  label_color: '#426ef4' # Default label color
  show_menu_labels: true|false # Flag for menu labels generated by HeyDay's Menu Manager Module (if available)
```

Customization
-------------

[](#customization)

If you want to change the label look you can apply your custom style definitions to the class `.sitetree-label`. Default style:

```
.sitetree-label {
    border-radius: 3px;
    font-size: 0.75rem;
    padding: 2px 4px;
    color: #fff;
    text-shadow: none;
}
```

Extending
---------

[](#extending)

You can add extra labels via code by using the `updateSiteTreeLabels` hook method.

```
public function updateSiteTreeLabels(ArrayList &$labels) {
    $labels->add([
        'Title': 'My Custom Label',
        'Color': '#ed135a'
    ]);
}
```

Thanks... 👏
-----------

[](#thanks-clap)

- ...**wmk** for contributing to this module.
- ...**Andreas Spannbauer, Eric Hes** and **Zauberfisch** for discussing the module idea with me at StripeConEU 2017.
- ...**blueskies79** for her [bug tracing](https://github.com/JZubero/silverstripe-sitetree-labels/issues/5) skills.

Maintainer
----------

[](#maintainer)

- JZubero

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 84.6% of commits — single point of failure

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 ~201 days

Recently: every ~297 days

Total

7

Last Release

1977d ago

Major Versions

0.1.2 → 1.0.02017-11-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/441f0e8f95c17048417a33f37e35d5ffdd4c07902cbedaf7f5786f4b7c454284?d=identicon)[JZubero](/maintainers/JZubero)

---

Top Contributors

[![JZubero](https://avatars.githubusercontent.com/u/13751426?v=4)](https://github.com/JZubero "JZubero (22 commits)")[![wernerkrauss](https://avatars.githubusercontent.com/u/1043925?v=4)](https://github.com/wernerkrauss "wernerkrauss (4 commits)")

---

Tags

labelssilverstripesilverstripe-modulesitetreesitetree-labeling

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jzubero-silverstripe-sitetree-labels/health.svg)

```
[![Health](https://phpackages.com/badges/jzubero-silverstripe-sitetree-labels/health.svg)](https://phpackages.com/packages/jzubero-silverstripe-sitetree-labels)
```

###  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)[symbiote/silverstripe-advancedworkflow

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

46302.4k9](/packages/symbiote-silverstripe-advancedworkflow)[silverstripe/sharedraftcontent

Share draft page content with non-CMS users

21424.1k12](/packages/silverstripe-sharedraftcontent)[axllent/silverstripe-cms-tweaks

Several CMS usability improvements

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

Site-wide banners activated through the CMS

1038.7k](/packages/nzta-silverstripe-sitebanner)[dorsetdigital/silverstripe-enhanced-requirements

Enhanced requirements for Silverstripe

118.4k4](/packages/dorsetdigital-silverstripe-enhanced-requirements)

PHPackages © 2026

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