README.textile

Chronicle

In an enterprise production environment, it’s critical that content editors, designers, and developers be able to edit pages and preview their changes without affecting the live version and that site administrators be able to see who changed what and roll back if necessary.

This extension adds versioning to pages, snippets, and layouts and uses their status to determine its visibility. The most recent published or hidden version is visible in live mode and the most recent version, a.k.a. the “current version,” is visible in dev mode regardless of its status. Thus, you can work on a draft in dev mode, preview exactly how it will look, and then make it live when you are ready by changing its status to published.

An example

If you went to example.com/ you would see version 24. If you went to dev.example.com/ you would see version 25.

Many people overlook the dev mode feature of Radiant. If you don’t know about it, see How to Setup Dev Mode on the Radiant wiki. You can also set a live.host configuration option if you don’t access Radiant admin at the live host.

Some terminology used in the specs:

The “current version” is the highest-numbered version, a.k.a. the “current dev” version.

The “current live” version is the most recent Published or Hidden page.

A page “is a draft” when its status is set to Draft.

A page “has a draft” when its current version is a draft.

When a page’s current version is Published, the page “does not have a draft”.

Features:

Simple graph showing the change history of pages, snippets, and layouts

Check a box to view the page in a new window/tab after saving

See what changed in a given version

Control how many versions are shown in the history by setting Radiant::Config[‘chronicle.history.per_page’]

TODO Roll back to a previous version by creating a new one based on it

TODO Integration with the Dashboard extension so you can see what has changed recently and what pages have unpublished changes (drafts ahead of published versions)

TODO Lines in the change graph showing ancestry when a page is rolled back

TODO Versioning including page attachments

Should be compatible with (and version the extra page attributes of) most extensions!