Stereotype Extension

About

An extension by Aissac that adds templating support to Radiant CMS.

Tested on Radiant 0.7.1, 0.8 and 0.9 RC1.

Features

  • Define named templates (stereotypes) for Pages;
  • Templates are assigned per-parent Page, making all children have the defined ‘stereotype’ by their parent;
  • You can specify the new page’s parts, filters, layout, page type, status or stereotype.

Instalation

Stereotype Extension has one dependency, the Radiant Custom Fields Extension.

1
2

git clone git://github.com/Aissac/radiant-custom-fields-extension.git\
 vendor/extensions/custom_fields

Because Stereotype Extension keeps the settings in the Radiant::Config table it is highly recommended to install the Settings Extension

1
2

git clone git://github.com/Squeegy/radiant-settings.git\
 vendor/extensions/settings

Finally, install the Stereotype Extension

1
2

git clone git://github.com/Aissac/radiant-stereotype-extension.git\
 vendor/extensions/stereotype

Note

The git branches hold stable versions of the extension for older version of Radiant CMS. To checkout one of these branches:

1
2
3
4

git clone git://github.com/Aissac/radiant-stereotype-extension.git\
 vendor/extensions/stereotype
cd vendor/extensions/stereotype
git checkout -b <branch-name> origin/<remote-branch-name>

Configuration

To add stereotypes you need to add fields to the Radiant::Config table. There are five types of settings for each stereotype:

  1. Page Parts (and filters)

    The key has to look like: stereotype.<name_of_the_stereotype>.parts and the value body:markdown,sidebar:textile.

  2. Layout

    The key has to look like: stereotype.<name_of_the_stereotype>.layout and the value has to be the name of a layout (case sensitive)

  3. Page type

    The key should look like: stereotype.<name_of_the_stereotype>.page_type and the value has to be a valid class_name attribute of the Page class. (Examples: ArchivePage, FileNotFoundPage or ArchiveMonthIndexPage)

  4. Status

    The key should look like: stereotype.<name_of_the_stereotype>.status and the value has to be a valid status attribute of the Page class: draft, hidden, reviewed, published

  5. Stereotype

    The key should look like: stereotype.<name_of_the_stereotype>.stereotype and the value has to be a valid stereotype

    6. Usage

    1. Add stereotypes as described in the configuration section.

    2. Edit/create a new page that has children and select a stereotype from the dropdown labeled “Stereotype”. Child pages added to this page will be created with their attributes set by default to the fields you configured.

    3. …

    4. Profit!

    Contributors