What are the alternatives and when should you use them?
Confluence has several bundled themes:
If one of them suits your needs, and you don't require any customisation, you might as well use them.
If you need customisation options, however, the bundled themes are very limited in what they can offer - usually changing colours or maybe adding some basic navigation to the left sidebar, not much else.
It should be noted that a growing number of the bundled themes have now been replicated as Theme Builder layouts which allow you to customise them.
The Confluence default theme can be customised by editing the HTML/Velocity templates using the "Layouts" option in Site or Space Administration:
This gives you a fairly high degree of control because you can change the way most things look and work. If you're fairly experienced at using Velocity templates, you can also hard-wire macros in to the theme using this technique.
However, as many of our customers have learnt the hard way, there's a lot of risk involved with customising the default layout...
If you've got Java developers on-hand, and they aren't swamped with business-critical tasks and projects for your customers, you can create your own Java theme plugin:
– pics –
If you need absolute control over every last detail, this is the route that gives you that level of control.
If you later upgrade Confluence, or want to change the theme design, you'll need to get Java developers in to make any required changes to the theme.
There's a growing number of free, open source theme plugins available for Confluence. To review them, visit the Confluence Theme Extensions page.
If there's one that suits your needs, you might as well use it. Just bear the following in mind:
There's a reason thousands of customers worldwide have switched to Theme Builder. Ok, there's lots of reasons! They use Theme Builder because they want to customise Confluence with significantly less pain than the alternatives.
Theme Builder aims to achieve all the benefits of the alternate methods of customisation, and more, whilst avoiding as many of the disadvantages as possible.
The one thing to be careful of is over-customisation - don't go overboard with all that flexibility! If you do, you'll probably need to read our tutorial on Performance Tuning