Similar to a state selection transition, but the focus is on reviewing content rather than choosing a state (the workflow determines which state to go to depending on outcome of the review).
The user chooses to Approve or Reject, and the workflow transitions to the appropriate state (as defined in the approved
and rejected
parameters). Approve and Reject buttons in the Workflow Popup.
{workflow:name=Content review} {state:A|approved=C|rejected=B} {approval:Review} {state} {state:B} {state} {state:C} {state} {workflow}
In workflow builder the approved and rejected transitions for the content review are only available when a content review (aopproval) has been added to the state.
If the approval is added to the state but the Approved and Rejected transitions are not added
- the workflow popup will still display the Approve and Reject buttons
- if a user rejects or approves the content the workflow will simply remain in the current state
- no transition will occur
- any approval decision will still be recorded in the page activity report
You do not need to add both the Approved and the Rejected transition.
Note that a content review transition may also occur when a trigger listens for an event and uses one of the following action macros to approve or reject the content.
Action macros: {approve-page}
, {reject-page}
, {approve-children}
, {reject-children}
The following events are related to approvals.
Events: pageapproved
, newsapproved
, pagerejected
, newsrejected
, pageapprovalassigned
, newsapprovalassigned
, approvalunassigned
See also: Reviews, Content reviews, Customise Approval Buttons
Content expiry transition
States can be given an expiry date, after which a transition can occur.
If the state expires whilst it is active
- the
duedate
parameter determines the expiry date - the
expired
parameter specifies which state to transition to
An expiry indicator appears in the workflow popup.
{workflow:name=State expiry} {state:A|duedate=P1W|expired=C} {state} {state:B} {state} {state:C} {state} {workflow}
The state expiry transition can be added to the state in the transition editor using workflow builder.
The transition will only occur if a due date has been added to the state and the Expired transition was added before the due date.
Any other of the state transitions can be added with the Expired transition.
Macros: {state}
, {set-state-expiry}
Events: stateexpired
See also: Expiry Dates, State expiry date, State expiry dates
Updated content transition
States can automatically transition should content be updated (edited).
The updated
parameter specifies the state to transition to if the content is updated.
If used on a state that has final=true
parameter, the workflow popup will show a message about the publishing process, otherwise it will be empty.
{workflow:name=Content update} {state:A|updated=C|final=true} {state} {state:B} {state} {state:C} {state} {workflow}
The state Updated transition can be added to the state in the transition editor using workflow builder.
The transition will occur when the content is edited and the changes saved.
Any other of the state transitions can be added with the Updated transition.
Events: pageupdated
, newsupdated
, pagemoved
, attachmentschanged
, attachmentadded
, attachmentupdated
, attachmentremoved,attachmentversionremoved
See also: Publishing
Tasks completed transition
States can automatically transition should all workflow tasks be completed.
The completed
parameter specifies the state to transition to when all tasks are completed. Tasks are listed in the Tasks popup.
{workflow:name=Task completion} {state:A} {state} {state:B|completed=C} {task:name=Complete this task|note=Task completion will cause transition to state C.} {state} {state:C} {state} {workflow}
The task popup will need to be accessed to complete one or more workflow assigned tasks.
On completion of the task(s) the workflow will transition from state B to state C.
The state Tasks Completed transition can be added to the state in the transition editor using workflow builder.
Before the transition occurs all tasks must be completed - workflow added tasks and user added tasks.
This includes any uncompleted tasks added in other workflow states and still awaiting completion when the workflow transitions into this state.
Any other of the state transitions can be added with the Tasks Completed transition.
Macros: {task}
, {complete-task}
Events: taskcreated
, taskassigned
, taskcompleted
, taskexpired
See also: Tasks, Tasks Popup, Make tasks disable a review