This documentation relates to the 5.2 release of Comala Workflows

 Documentation for other versions of Comala Workflows is available too.

Overview

With same-space publishing, each piece of content (page or blog post) can have concurrent draft and published versions.

Activating same-space publishing

To use same-space publishing, just add the final=true parameter to one or more of the {state} macros in your workflow – this marks them as final, Published states.


{workflow:name=In-space Publishing}
   {state:Editing|submit=Review}
   {state}
   {state:Review|approved=Published|rejected=Editing}
      {approval:Review|assignable=true}
   {state}
   {state:Published|final=true|updated=Editing}
   {state}
{workflow}

Subsequent drafts

The updated parameter can be applied to published states to ensure that any subsequent edits are pushed to a draft state.

In the example markup above, editing the Published state content will result in the new version being in the Editing state.

State colours

By default, draft (unpublished) states will have an  orange circle and published (final=true) states will have a  green circle.

For more information, see Status Indicator Circles.

Note: Since v5.0.8, colours can be customised on state-by-state basis via the colour parameter on the {state} macro.

Permissions

If a workflow has one or more published (final=true) states, then all other states in that workflow will be considered draft (unpublished) states.

 Editing – draft

 Review – draft

 Published – published

By default, users who only have View content permission can only see the most recently published version of each page or blog post. If they try to view draft (unpublished) versions, they will see an error like this:

Users with Edit and Admin permissions can see all versions of content, and can switch between the latest draft and published versions via the Workflow Status Bar.

Notifications

The {set-message} macro can differentiate between draft and published versions of content.

PDF and Word export

When exporting content as PDF or Word using native Confluence features, either as individual pages or an entire space, the distinction between Published vs. Draft content will be respected.

For more information, see: Confluence PDF and Word Export.

App configuration

SettingWhereNotes
Workflow Activity and Drafts Visibility
Determines which users can see unpublished drafts.
Default ViewDetermines whether Published content is seen by default.
Published View Macro Transform
Determines whether {include} and {excerpt-include} macros display most recently Published version or, regardless of workflow state, the latest version of content.

See also