OMA Keystone CMS

Our Keystone CMS "plug-in" provides very basic contextual editing features such as object model property editing and a simple templated page system. It is dependent on use of Keystone using the Swig templating engine. The contextual front end UI is currently written in AngularJS. It is a work in progress that is not intended for public use, but is nonetheless published as a public package for our own purposes. Use at your own risk.

Installation Instructions

• In your Keystone project:

npm install @offmadisonave/oma-keystone-cms --save

• Add the following code to the top of the Keystone project /routes/index.js module body

require('@offmadisonave/oma-keystone-cms')(app, {
	indexIsPage: true // If you intend to use the pages feature at the default route
});

• Add the following just before the closing body tag of all of your Keystone project layout SWIG files...

{{CMS.admin()}}

• To make a model object editable...

{{CMS.objectHtml('KeystoneListName', listObject, 'editablePropertyName')}}

If you intend to use the pages feature:

• Create at least one SWIG template that you intend to use for the CMS and register it in the Keystone Admin UI at http://{yourdomain.com}/keystone/cmstemplates

• To make a page block editable...

{{CMS.pageHtml('content_block_name')}}

Creating a page is as simple as navigating to /page/{the_slug_you_want} and clicking the Create Page in the CMS footer toolbar.