state-selection macro

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.

Filter by label

There are no items with the selected labels at this time.

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.

Filter by label

There are no items with the selected labels at this time.

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

Filter by label

There are no items with the selected labels at this time.

See also

Workflow Authoring Guide:

User Guide:

Reporting Guide: