if we have content authors with the same role as admin, we don\u2019t need to configure workflow\/content moderation. In this case, the publishing process will slow down. The publishing process includes a node in the draft reviewed by another or the same user and, after the review, approved by another user and then published.<\/p>\n
So here, one node is going through different states before getting published. We can say below are the states of this node.<\/p>\n
- \n
- Draft<\/li>\n
- Review<\/li>\n
- Ready to Publish<\/li>\n
- Published<\/li>\n
- Archive<\/li>\n<\/ul>\n
In order to achieve content moderation in Drupal 9, Drupal 9 has a core Content Moderation module that works in conjunction with the Workflows module to easily create and manage an editorial workflow using different states and transitions.<\/p>\n
The Content moderation module allows you to:<\/p>\n
- \n
- Create a Draft (The first state is not published)<\/li>\n
- Have different states than just published and unpublished.<\/li>\n
- Change the states.<\/li>\n
- Have granular permission control for every transition and state.<\/li>\n
- Select the content types that you want to apply to the workflow.<\/li>\n<\/ul>\n
The Workflows module defines a set of states and transitions that are then attached to content by the Content moderation module. A \u201cstate\u201d is the current condition that your content is in (Draft, Unpublished, Review, Ready To Publish, Published, Archive). A \u201ctransition\u201d is the process of moving content from one state to another (Needs work, Needs review, Publish).<\/p>\n
Configuring Content Moderation<\/strong><\/h2>\n
First, enable your core modules, Content moderation module, and Workflow module. To enable the module, go to Extend, select modules, and Click on Install.
\n![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/1.WorkflowModule-1-1024x252.png\")
\n![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/2.CMmodule-1024x249.png\")
\nOnce the module has been enabled, You will find a view “Moderated content view” to check and edit the status of all your content – moderation state, content revisions, author, content type, etc. To find it, go to Content -> Moderated Content tab.<\/p>\nNow go to Configuration -> Workflow -> Workflows.<\/p>\n
Here, a default workflow called \u201cEditorial\u201d gets created when you enable the module. You can edit the existing \u201cEditorial\u201d workflow or create a new workflow by clicking on Add Workflow.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/3-2.png\")
<\/p>\nCreating a new workflow<\/strong><\/h3>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/4-2.png\")
<\/p>\nOnce you have created a new workflow, you will see various states and transitions that you can configure and edit. You can also create your own state or transition if your team requires more flexibility or steps. There\u2019s also the option for you to choose the content type to which you want to apply this workflow.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/Edit-notification-_-Demo-Application-Drupal-950x1024.png\")
<\/p>\nDefining a new Workflow
\nLabel:<\/strong> The name of the Workflow.
\nStates:<\/strong> You can add a new state by clicking on the \u201cAdd a new state\u201d button like “Review”, or \u201cReady to Publish\u201d. You can also edit an existing state. You can add multiple states in states section.<\/p>\n![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/6.States-1024x319.png\")
<\/p>\n![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/7.AddStates-1024x545.png\")
<\/p>\nTransitions:<\/strong> You can add a new transition by clicking on the \u201cAdd a new transition\u201d button. For Example Transition from Ready to Review, Ready to Publish<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/8.Transitions-1024x395.png\")
<\/p>\nWhile adding a new transition, you can provide a label for each transition and decide from state to state. See below how a transition add screen looks.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/9.Addtransition-1024x545.png\")
<\/p>\nHere you can see you can select multiple states for transition. Click the save button. So this transition will be listed in your transitions section.<\/p>\n
This workflow applies to:<\/strong> You can choose to which entity types the workflow should apply. For example, Block types, Media types, Content, etc.
\nAssign to content type
\n![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/10.Assign-1024x195.png\")
<\/p>\nClick select button and add content types\/or custom blocks.
\n![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/11.SelectContentPopUp-824x1024.png\")
<\/p>\nDefault Moderation State:<\/strong> Here, you can choose the default moderation state when we create new content.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/12.Default-1024x545.png\")
<\/p>\nUsers & Permissions<\/h3>\n
You will probably allow people with roles other than administrator to participate in the workflow. To achieve this, you will need to set up the proper permission schema at People > Permissions.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/13.UserPermission-1024x649.png\")
<\/p>\nPermission control example for a Workflow content type<\/p>\n
The schema in the image above is centered around three roles; Content Editor, Reviewer, and Publisher.<\/p>\n
In this example,
\n* Content Editor<\/strong> can create, edit, and save content in the draft<\/strong> state<\/strong> or send for review in the review state<\/strong>, but not publish content.<\/p>\n* Reviewer<\/strong> can review content and have two options
\n1. Can change the state from Review<\/strong> state<\/strong> to Ready To Publish<\/strong>\u00a0state<\/strong>
\n2 Can change state from Review state<\/strong> to Draft state<\/strong> for improvement<\/p>\nNow, if content in “Ready to Publish<\/strong>” state<\/strong> then Publisher<\/strong> will change its state to Published<\/strong>.<\/p>\n
Be sure to grant ‘View the latest version’ and subsequently ‘View own unpublished content’ and ‘View any unpublished content’ to Content Editor, Reviewer, and Publisher. Otherwise, these roles will not be able to view their latest changes.<\/p>\n
Email Notification<\/h3>\n
Now on each step or transition, you need an email notification. For that, we have to install contribute module “Content Moderation Notifications<\/strong>.”
\nhttps:\/\/www.drupal.org\/project\/content_moderation_notifications<\/p>\nContent Moderation Notifications modules allow notifications to be sent to all users of a particular role or to the content’s author when a piece of content is transitioned from one state to another via the core’s content_moderation module.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/14.Email-Notification-1024x337.png\")
<\/p>\nEnable the module and Go to the configuration link – \/admin\/config\/workflow\/notifications<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/15.AddEmailNotification-917x1024.png\")
<\/p>\nYou can add notifications by following the steps:<\/p>\n
1. Label:<\/strong> The label for this notification.
\n2. Workflow:<\/strong> Select the workflow on which you want to apply notifications.
\n3. Transitions:<\/strong> Select transitions on which you need to trigger a notification.
\n4. Roles:<\/strong> Selecting roles will send notifications to all users with selected roles. This is not mandatory.
\n5. Email the author:<\/strong> Send notifications to the current author of the content. This is not mandatory.
\n6. Disable the site email address:<\/strong> Do not send notifications to the site email address. This is not mandatory.
\n7. Adhoc email addresses:<\/strong> Send notifications to these email addresses. Extra emails. This is not mandatory.
\n8. Email Subject:<\/strong> You can set the proper subjects of each mail by using Twig Templating codes.
\n9. Email Body:<\/strong> You can set the body of the email by using Twig Templating codes.<\/p>\nAfter setting notifications on each transition, your list will be like the below screenshot.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/16.FinalNotifications-1024x511.png\")
<\/p>\nExample of Content Moderation through Workflow Content Type<\/h3>\n
The steps are as follows:<\/p>\n
1. Author creates a new node of workflow content type.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/17-1.png\")
<\/p>\n2. Author saves the content in Draft because the article is not ready to be published yet.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/18-1-300x127.png\")
<\/p>\n3. Once the Author completes writing the article, they will change the state from Draft to Review. Notification mail will be trigger.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/19-1.png\")
<\/p>\n4. The Content Reviewer reviews the content; if everything is okay, they will change the state from “Ready for Review” to “Ready to Publish”. Notification mail will be triggered.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/20-1.png\")
<\/p>\n5. If the Content needs work and is not ready to be published, he will change the state from Review to Draft. Notification mail will be triggered.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/21-1.png\")
<\/p>\n6. The Publisher publishes the content. They change the moderation state of the content from Ready To Publish to Published. Notification mail will be triggered.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/22-1.png\")
<\/p>\n7. If the content is no longer to use, then the Publisher can also change the state of published content from Published state to Archive state. Notification mail will be triggered.<\/p>\n
![\"\"](\"\/blog\/wp-ttn-blog\/uploads\/2022\/12\/23-1-300x127.png\")
<\/p>\nThis example shows a simple editorial workflow of a workflow content type. You can also have a more complex and rich workflow based on your business requirements.<\/p>\n
<\/div>","protected":false},"excerpt":{"rendered":"Creating editorial workflow using content moderation is used to speed up the publishing process. Imagine a website has 10 content types, hundreds of contents for each content type, and daily contents are updated or added by a single admin user who has the publish and unpublish permission. So admin user can verify and publish each […]<\/p>\n","protected":false},"author":1511,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":352},"categories":[3602],"tags":[4862],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/56264"}],"collection":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/users\/1511"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/comments?post=56264"}],"version-history":[{"count":5,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/56264\/revisions"}],"predecessor-version":[{"id":56310,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/56264\/revisions\/56310"}],"wp:attachment":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/media?parent=56264"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/categories?post=56264"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/tags?post=56264"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}