SilverStripe PageHolder Module

Hide children from the CMS sitetree and allow management through a Versioned GridField. Think BlogHolder but flexible and for any page type.

Features

• Automatically appends GridField(s) for managing children to the extended object
• Supports the CMS history view on manages pages.

Requirements

ExcludeChildren https://github.com/micschk/silverstripe-excludechildren

Tested in SilverStripe 3.0, 3.1

Screenshots

Usage

• Add the PageHolderExtension to Pages you want to use as holder pages.
• Specify the child classes to hide from SiteTree and manage with GridField with the $excluded_children static.

class AttorneysPage extends Page {

    private static $extensions = array(
       'PageHolderExtension'
    );
    
    private static $excluded_children = array('Attorney');
 
}    

• Flush the cache and run /dev/build, you will now see Attorney management under AttorneysPage types.

Configuration

Placing the GridField

By default, PageHolderExtension will add GridField(s) to Root.Main, before the Metadata field. Override this behavior through the $pageholder_tab and $pageholder_insertBefore statics.

class AttorneysPage extends Page {
  private static $pageholder_tab = 'Root.Attorneys';
  private static $pageholder_insertBefore = 'settings';
  ...
}

Or, through YAML Configuration

---

AttorneysPage:
  pageholder_tab: Root.Attorneys
  pageholder_insertBefore: settings

Changing the GridField Title

PageHolderExtension infers the GridField title from the plural name of the child class. Set with the $plural_name static.

class Attorney extends ChildPage
{
    private static $plural_name = 'Attorneys';
    ...    
}

Or, through YAML Configuration

---

Attorney:
  plural_name: Attorneys

Credits

PageHolder provides an enhanced turn-key implementation of

• ExcludeChildren Module
• Versioned GridField Module