This section describes the simple default workflow available from Crafter CMS.
Workflow and Scheduled Deployments¶
Workflow is the act of moving content through its lifecycle. A simple workflow option that includes submission, review/reject and approve and publish immediate / publish on a schedule options are provided by default. Workflow options are available to specific content, such as pages or static assets, etc. The available workflow options for users depends on the Role the users are assigned with. As the content goes through the workflow options, notification emails are sent out to corresponding users based on the workflow option. To setup the email addresses, please see the section Site Administrators, Configure Simple Workflow Notifications and Dialog Messages and Users/Groups Management. Below is a diagram showing the default workflow steps.
We will be looking at the workflow steps in this section. Workflow is managed through dialogs. Below is a sample dialog:
Submitting Content for Approval¶
After creating/editing content, a request to publish content can be done by clicking on Request Publish. A Request Publish submission can be initiated from a preview screen through the context nav or by right clicking on the article in the Sidebar nav tree (for single items), or from the Dashboard (where items can be batch checked).
Request Publish through the context nav at the top:
Request Publish batch checked through the dashboard:
Request Publish by right clicking on the content from the Sidebar nav tree:
When sending the request for publish, you have the option of requesting to publish your content now, or to schedule publishing of your content at a later time and date.
After clicking on the Submit button, a notification email will be sent to the site’s approvers. Notice also, that the context nav now displays the icon for In Workflow and contains the text Submitted for Publish
You’ll also notice the In Workflow icon is displayed next to the content item in the Sidebar nav tree for the content you just submitted a request for publish.
The In Workflow icon also appears next to the content submitted for publish in the dashboard:
After a request for publish has been sent, the next step in the workflow is for an approver (a user with publishing rights) to approve or reject the request for publishing. Notification emails are sent out when an item has been approved for publish or rejected.
Approve Publish Request¶
To approve content for publishing, there are a few ways to access the Approve & Publish workflow option. One way is by going to the dashboard, then in the Items Waiting For Approval widget, look for the article you want to approve, then put a check mark next to it.
Another way to access the Approve & Publish option is by going to the Sidebar, then navigate to the article you want to approve, then right click on it.
Yet another way to access the Approve & Publish option is by going to the Sidebar and then navigating to the article and opening it for preview. After opening the article for preview, the Approve & Publish option should appear on the context nav.
You can also preview the article that you want to approve by clicking on the link provided in the email sent to the approver, which should give you the Approve & Publish option too in the context nav. Below is a sample notification email sent to the approver when user noobauthor sent a request to publish content. To modify/setup your notification emails, please contact your site administrator. To see more details on how to configure your notification emails, see the section for Site Administrators in Configure Simple Workflow Notifications and Dialog Messages
Below is the dialog that loads after clicking on Approve & Publish*. The item scheduling selected in the dialog depends on what the requester has chosen when the request to publish was sent. In the image below. the selected scheduling for the item is for the Items should go live now. Click on Submit to publish the content now.
In the image below, the requester sent the request to publish with a schedule. Click on the Submit button to schedule the publishing of the item. The dialog with the calendar and time when selecting the publish on a schedule radio button allows the approver to schedule or reschedule the submitted item.
Once an item has been scheduled to be published, notice the workflow icon next to the article in the Sidebar nav tree, the dashboard and in the context nav when you preview the scheduled for publish item.
The dashboard allows batches of scheduled and non-scheduled items to be pushed live at the same time. Clicking on Items should go live now or Items go live on a specific date & time will change the schedule of all items to be pushed live at the same time.
Reject Publish Request¶
To reject a request for publish, open the item for preview, then in the context nav, select Reject. Another way to access the Reject option is by opening the dashboard and placing a check mark next to the item to be rejected, Reject should now be available in the context nav.
Approvers may pick canned rejection reasons from the drop-down menu. Once selected, the editable text area field will be filled with the corresponding rejection notice.
Once an item has been rejected, a notification email will be sent to the requester. Below is an example notification email of rejection: