silverstripe-australia / metadata
Allows the ability to annotate objects with metadata, according to a CMS defined schema.
Installs: 10 005
Dependents: 0
Suggesters: 0
Security: 0
Stars: 10
Watchers: 8
Forks: 13
Type:silverstripe-module
Requires
- mustangostang/spyc: ^0.6.2
- silverstripe/cms: ~3.1
- silverstripe/framework: ~3.1
- symbiote/silverstripe-gridfieldextensions: ~2.0
Replaces
README
Maintainer Contacts
- Marcus Nyeholt (marcus@symbiote.com.au)
Requirements
- SilverStripe 3+
- The SilverStripe Orderable module.
Getting started
- Add the extension to your data class, eg
Object::add_extension('Page', 'MetadataExtension');
- Navigate to the Metadata section of the CMS (/admin/metadata)
- Create a new Metadata Schema. Note that the 'Title' is what is used to refer to the item from templates, so try and limit this to a-z0-9_-. characters - eg test_schema
- Add a few metadata fields - some usual ones are
- Title (title)
- Keywords (keywords)
- Description (description)
- Set the 'Default' value for each of these to $Title. Leave the 'cascade' setting blank for now, as you're providing a default already
- Navigate to a top level page and on its Metadata tab, select the schema you just created; click save
- Enter metadata values
- In your Page.ss template, add the following to output all metadata fields
$MetadataMetaTags
- To output just the values for a particular applied schema, use
$MetadataMetaTags(SchemaName)
- To access raw metadata values directly, use
$Metadata(SchemaName,FieldName)
eg$Metadata(test_schema,keywords)