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

This guide is out of date.

Please check with Adaptavist support for current integration guidelines.


This guide provides instructions for integrating Adaptavist Theme Builder with Comalatech Workflows Plugin.

Workflow Icon and Status

User Macros

To display the  Adhoc Workflows icon and status message on each page add the following user macros in Confluence > Admin > User Macros

workflow-button
<a id="adhocWorkflowsPopupLink" href="#" class="adhocworkflows4" title="Workflow"><span></span></a>
workflow-status
<span id="title-heading"></span>

These macros will be used to change the layout Theme Builder layout.

Theme Builder Layout

Modify the layout to include the user macros in Confluence > Admin > Manage Builder Layouts

....
{td:valign=middle}
{builder-show:context=page,blogpost|mode=view}
{workflow-button}
{builder-show}
{td}
{td:valign=middle}
{builder-show:context=page,blogpost|mode=view}
{workflow-status}
{builder-show}
{td}
....

 

This will add add the workflow icon and the status lozenge to every page.

We recommend to add the 'Edit Workflow' link to the 'Edit' dropdown menu item in case users have added an ad hoc workflow to the page. The 'Edit Workflow' menu link will not be shown if the page is not associated with a workflow.

Theme Builder Layout

Modify the layout to include the user macros in Confluence > Admin > Manage Builder Layouts > Layout > Menus > Menu Shortcut Macros > Edit

In the 'Edit Menu' tab insert the following line

 {compound-menuitem:webui|location=system.content.action/primary|key=editPageWorkflow.primary|caption=Edit Workflow}