Two- and three-step approval workflow for page content in SilverStripe CMS
- Mark Stephens <mark (at) silverstripe (dot) com>
- Rainer Spittel <rainer (at) silverstripe (dot) com>
- SilverStripe 2.4 or newer
legacydatetimefieldsmodule (see http://silverstripe.org/legacydatetimefields-module)
You need to choose an 'approval path'. This details the actual process a request goes through before it gets published to the live site.
There are two approval paths supplied: "Two Step" and "Three Step".
Author submits a request. Publisher approves it change is pushed live immediately.
This workflow is automatically set up for you and doesn't need any configuration.
Author submits a request. Approver approves it. Publisher publishes it at a later date.
Attach the following decorators in your
// remove two-step decorators Object::remove_extension('WorkflowRequest', 'WorkflowTwoStepRequest'); Object::remove_extension('SiteTree', 'SiteTreeCMSTwoStepWorkflow'); Object::remove_extension('SiteConfig', 'SiteConfigTwoStepWorkflow'); // add three-step decorators Object::add_extension('WorkflowRequest', 'WorkflowThreeStepRequest'); Object::add_extension('SiteTree', 'SiteTreeCMSThreeStepWorkflow'); Object::add_extension('LeftAndMain', 'LeftAndMainCMSThreeStepWorkflow'); Object::add_extension('SiteConfig', 'SiteConfigThreeStepWorkflow');
Refresh your database schema through
Based on your permission levels, authors in the CMS will see different actions on a page, and a new "Workflow" tab listing open requests.
You can allow Administrator users to Publish without giving a comment. by placing the following in your mysite/_config.php file: This will disable the popup for this situation.
Email alerts are configurable by the developer.
The following line sets a config option
WorkflowRequest::set_alert(CLASS, EVENT, GROUP, NOTIFY);
CLASS is one of either WorkflowPublicationRequest or WorkflowDeletionRequest
EVENT is one of
- publish (3 step only)
GROUP is either author or publisher or approver
NOTIFY is either true or false
The cmsworkflow uses the translation facilities of SilverStripe extensively. This allows us to support the module in different languages, with many languages available out of the box.
If you want to customise these strings further, there is another module called customtranslation that allows you to override the strings provided in the lang files, without changing the lang files. The module can override strings across the whole site, not just cmsworkflow. customtranslation will be supported for SilverStripe 2.4.1 and up.