Builder 2.x Release Notes

Summary

Builder 2.x introduced a visual layout editor and a vast array of new customisation options.

• Builder 2.0.0 - 2.0.3-conf22 were developed for Confluence 2.1.5a-2.2.x
• Builder 2.0.4-2.0.6 were developed for Confluence 2.3.x-2.5.x
• Builder 2.0.7 fixes a page-level permissions bug in Confluence 2.5.x

Important Notes

An upgrade from Builder 1.x to 2.x will lose some settings due to significant architectural changes. Clients upgrading from 1.x to 2.x should contact Adaptavist Support prior to performing the upgrade or alternatively start with a fresh theme layout.

Please note that Builder 2.0.x does not support clustered Confluence environments.
If you are require clustering, please use Builder 2.1 or above.

When upgrading from Confluence 2.1.x or 2.2.x to 2.3.x or above, all your theme settings will appear to be lost! Don't panic! Simply copy the "/config" folder from your old Confluence installation across to your new Confluence installation and they'll reappear

Requirements

Builder 2.0.x and above require that you install two additional open source plugins (developed by Adaptavist) for correct operation:

• Page Information Tools plugin:
  • Use Version 1.2.2 for Confluence 2.0.x-2.2.x
  • Use the latest version for Confluence 2.3.x and above
• Content Formatting Macros plugin:
  • Use latest version for all Confluence versions

Release Notes

Frequently Asked Questions

I've set the theme at global level, why aren't spaces inheriting the theme settings?

Theme Builder versions 1.x - 2.x customise global and space level pages separately. You can copy the global customisations to spaces by entering the global theme configuration screen and choosing "File > Download Settings" then uploading the settings file to any number of spaces by using the "File > Upload Settings..." option.

Tip: Builder 2.1 and above allows the global theme settings to be automatically applied to global and personal spaces.

When I click "Upload Settings..." nothing happens - why?

It's a known bug in Theme Builder 2.x - choose the option twice and the upload panel will appear.

Where is the documentation for the Builder-specific macros?

It's under the Builder Macros section in our user guides. You can also find notation and examples in the "Full Notation Guide" when editing pages using the "Wiki Markup" editor.

I've upgraded from Confluence 2.2 (or earlier) to 2.3 (or later) - where have my theme settings gone?

The Confluence upgrade process doesn't import the Theme Builder configuration files. To resolve this issue, manually copy the "/config" folder from your backup of the previous installation to the new installation and everything should return to normal.

Installation Guide

We've got a part-finished installation guide (sorry, been really busy!) that contains some additional information and trouble shooting: