[All Adaptavist Apps]
Installing and upgrading the Builder theme...
Should you encounter any problems, please see our [Troubleshooting Guide] which lists all common problems and how to fix them.
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.
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 |
Latest |
|
2.5.x |
Pre-installed |
2.0.9 or above |
Latest |
|
2.6.x |
Pre-installed |
2.0.9 or above, 3.x for best results |
Latest |
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.
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.
Take a full backup of Confluence then follow the instructions applicable to the [version of the Builder theme] you are using as shown below:
Before upgrading Builder, please take a full backup and ensure that you have uninstalled any previous versions:
On some occasions, you may get an error message stating that the plugin could not be uninstalled. Should this happen, restart Confluence and try again.
After uninstalling any previous versions, you can install the new version as described earlier in this tutorial.
Before reporting a bug, please check our [Builder Release Notes] - it's possible a recent version of the theme already resolves the issue you have.
Our tutorial on [Reporting Bugs] explains the process for informing us of bugs or ideas for new features for the
theme. It also lists all currently reported items and has a link to our development roadmap.