Custom Fields Extension

About

An extension by Aissac that allows you to add custom fields to Radiant CMS pages.

Tested on Radiant 0.7.1, 0.8 and 0.9 RC1

Features

  • Provides the ability to add custom fields to a Page;
  • The Page model is not changed: custom_fields are added as a belongs_to association;
  • Admin interface for managing assigned custom fields;
  • Radius tags for accessing custom fields.

Installation

The Custom Fields Extension has no dependencies, so all you have to do is install it:

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

Then run the migration and the update:

1
2
rake radiant:extensions:custom_fields:migrate
rake radiant:extensions:custom_fields:update

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-custom-fields-extension.git\
 vendor/extensions/custom_fields
cd vendor/extensions/custom_fields
git checkout -b <branch-name> origin/<remote-branch-name>

Usage

Available Tags

  • See the “available tags” documentation built into the Radiant page admin for more details.
  • Use the <r:custom_field:value /> tag to render the value of a custom field.
  • Use the <r:custom_field:each /> tag to iterate over the assigned custom fields of a page.
  • Use the <r:custom_fields:if_matches /> and <r:custom_field:unless_matches> tags to filter the custom fields.

Contributors

TODO

  • AJAX-ify admin interface.