Overview

The {state-selection} macro adds one or more direct state transition buttons to the Workflow Popup.

Where to use it?

Optional.

One {state-selection} can be put in a {state} macro

Can not be used if the {state} includes an {approval} macro.

Parameters

Parameter

Required

Default

Notes

states

(tick)


Comma-delimited list of states to display in the current state. All states listed must be defined with a {state} macro in the current workflow.

There is no content with the specified labels

Conditions


 

Sets the conditions that have to be met in order to change the state. If no conditions are set, then any user who has permission to see draft versions can change the state.

There is no content with the specified labels

Events

The following Events arise from state transitions:

  • statechanged
  • pagestatechanged
  • newsstatechanged

Example

{workflow:name=Example}
   {state:In Progress}
      {state-selection:states=Review,Cancelled}
   {state}
   {state:Cancelled}
   {state}
   {state:Review}
   {state}
   {state:Published}
   {state}
{workflow}

All examples

There is no content with the specified labels

See also

Workflow Authoring Guide:

User Guide:

Reporting Guide: