Comala Workflows is now Comala Document Management. Click here for the latest documentation.

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).