[All Adaptavist Apps]
Installing and upgrading the Builder theme...
theme requires Confluence 2.1.1 or above.
If you are upgrading from an earlier version of Builder, please see the important notes on upgrading Builder later in this tutorial.
Take a full backup of Confluence then follow the instructions applicable to the [version of the Builder theme] you are using as shown below:
For best results, we recomment using Builder 1.6 or above.
Builder 1.5.x and 1.6.x:
Upload the .jar file using the [Plugin Manager] in the [Administration Console] and restart
Builder 1.4.x: (this version is deprecated)
Copy the .jar file in to your WEB-INF/lib folder and restart
.
We strongly advise you to create a test space in order to ensure that the theme is working correctly. You will also be able to test out various configuration options and style sheets within the test space which can then be copied over to "live" spaces as and when required.
To apply the theme to a space, please see our tutorial on setting the [Space Theme].
When the theme is first installed, it will look ugly - you'll need to apply the relevant customisation to make it meet your requirements. For more details, please see Theme Configuration.
Always take a full backup of Confluence or we'll come round and get you! In addition, manually copy the settings from the theme configuration screen as some versions of Confluence will not include theme settings in the backup.
Before upgrading Builder, please 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.
Theme plugins are a tad more complex than your average plugin. Adaptavist are actively working on enhancements that will eventually allow the theme to be uploaded and upgraded just like a normal plugin, however some changes to the core
codebase will be required along the way so it's going to take a little while longer.
In partcular,
caches the velocity templates that themes use and doesn't actively clear down those caches when a new version of the theme is uploaded.
Our tutorial on [Bug Reports and Feature Requests] explains the process for informing us of bugs or ideas for new features for the