[All Adaptavist Apps]
Should you encounter any problems, please see our Troubleshooting Guide which lists all common problems and how to fix them.
Confluence Version | Plugin Repository | Theme Builder | Content Formatting Macros | Page Information Tools |
---|---|---|---|---|
1.4.x | n/a | 1.4 | n/a | n/a |
2.0.x – 2.1.x | 2.0.3 | |||
2.2.x | 1.2 | 2.0.3-conf22 | ||
2.3.x - 2.4.x | Pre-installed | 2.0.4 | ||
2.5.x | Pre-installed | 2.0.9 or above | ||
2.6.x | Pre-installed | 2.0.9 or above, 3.x for best results | ||
2.7.x | Pre-installed | 3.1.4 or above | ||
2.8.x | Pre-installed | 3.1.4 or above |
Confluence 1.4.x is no longer supported - you can try Builder 1.4 or 1.5 if desired. The Content Formatting and Page Information Tools plugins were not required for Builder 1.x.
If you are upgrading from an earlier version of Builder, please see the important notes on upgrading Builder later in this tutorial.
When manually downloading plugins using Internet Explorer, make sure the file extension isn't changed to ".zip" - if it is, change it back to ".jar" before installing the plugin.
Theme Builder requires two open source plugins, both developed by Adaptavist, to be installed:
The easiest way to install these plugins is via the Plugin Repository. Alternatively you can download these plugins manually and install via the Plugin Manager or "Uploads" tab on the Plugin Repository.
Note: These plugins are only required for the navigation and title panels default settings - if you don't want to use tables or display page information in your customised theme design, you will not require these plugins.
...or "incompatibility nightmares" as Adaptavist lovingly refer to them!
In the Plugin Manager, you'll see a plugin called "Compatibility Macros" - it's developed by Atlassian and is bundled with Confluence. It's enabled by default and sometimes also gets enabled after doing a Confluence upgrade in some circumstances, even if you've previously disabled or uninstalled it.
Unfortunately, the macros in this plugin break stuff - especially the table macro. Very few wikis actually need the plugin so generally we recommend disabling it completely. The main culprit is the table macro which can be disabled in isolation if desired.
If you have one of the very rare wikis that need the plugin, specifically the table macro, then you won't be able to use the macro of the same name from Adaptavist's free Content Formatting Macros plugin. The table macro is used primarily in the Header, Navigation and Title panels of the DEFAULT layout so you'd have to find some alternate way of arranging the content in those panels if you're unable to disable Atlassian's bundled Compatibility Macros plugin.
Take a full backup of Confluence then follow the instructions applicable to the version of the Builder theme you are using as shown below:
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Once the theme is installed, you need to apply it to spaces (or globally) for it to take effect. For more information, please see: Enabling the Theme.
Before your first use of the theme, you will have to accept the End User License Agreement - if you do not, most of the themes features will be disabled.
To customise the theme to your requirements, please see Theme Configuration.
Take a full backup of Confluence before upgrading Theme Builder or Confluence.
Before installing a new version of Theme Builder, the old version must first be uninstalled:
Footnotes Display |
---|
Specific notes for various upgrade scenarios are shown below - click all that apply:
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
|
Expand | ||||
---|---|---|---|---|
| ||||
All currently known issues relating to upgrades of Theme Builder or Confluence are covered by our Builder Troubleshooting Guide.
Before reporting a bug, please check our Builder Troubleshooting Guide and Release Notes - it's possible a solution already exists or a recent version of the theme already resolves the issue you have
...
.