Overview
In Space Mode, an enabled workflow will be applied to all content in the space unless it is filtered to specific labels and/or content types by the {workflow}
macro.
Require labels
To apply a workflow only to content with one or more specified labels, use the label
parameter:
{workflow:name=Require labels|label=process,procedure} {state:Test} {state} {workflow}
The workflow above will only be applied to content that has one or more of the specified labels – process
and/or procedure
.
Sticky labels
To ensure that one or more labels aren't changed once the workflow is applied, you can use the stickylabels
parameter:
{workflow:name=Sticky labels|label=process,procedure|stickylabels=process,procedure} {state:Test} {state} {workflow}
The workflow above will not allow either the process
and/or procedure
labels to be removed if they are already present.
Note: Admins and adminusers
can remove stickylabels.
Exclude labels
If you want the opposite effect, where the workflow will only be applied to content that doesn't have any of the specified labels, add the invertlabel=true
parameter:
{workflow:name=Exclude labels|label=process,procedure|invertlabel=true} {state:Test} {state} {workflow}
The workflow above will be applied to all content which does not have either of the specified labels – process
and/or procedure
.
Prevent addition of labels
If you have a workflow which is using the invertlabel=true
parameter, you can ensure those labels are not added by using Events to Trigger Actions:
{workflow:name=Exclude labels|label=process,procedure|invertlabel=true} {state:Test} {state} {trigger:labeladded|label=process} {remove-label:@label@} {trigger} {trigger:labeladded|label=procedure} {remove-label:@label@} {trigger} {workflow}
In the example above, adding the labels process
or procedure
will trigger an action which removes them again.
Filter by content type
Workflows will be applied to both pages and news (blog posts) by default. If you want to limit to one type or the other, use the content
parameter:
{workflow:Filter to pages|content=pages} {state:Must be a page} {state} {workflow}
{workflow:Filter to news (blog posts)|content=news} {state:Must be a blog post} {state} {workflow}
The first workflow will only be applied to pages
, while the second will only be applied to news
(blog posts).