Skip to content

JZubero/silverstripe-sitetree-labels

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
css
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

SiteTree Labeling

Build Status Example SiteTree Label View

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 and auto-assign the MenuSet names to the Pages.

Install

composer require jzubero/silverstripe-sitetree-labels

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

Dependencies

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

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

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

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

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... πŸ‘

  • ...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 skills.

Maintainer

About

Label your Page items for better orientation in large SiteTrees πŸ”–

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published