Adapting a theme for Confluence 5.0

Applicable:

This note applies to Confluence 5.0.

As described in Preparing for Confluence 5.0, a new sidebar is introduced for spaces.

Themes can choose whether the sidebar is visible.

As explained in Preparing for Confluence 5.0, the Browse menu was replaced by the Advanced links in the space sidebar.

For legacy reasons, it is still displayed in some situations:

Location:

system.browse

Theme:

All

Displayed:

In the Help menu.

Location:

system.space

Theme:

With Space sidebar

Displayed:

In the contextual navigation of the Advanced section

Location:

system.space

Theme:

Without Space sidebar

(Example: Documentation Theme)

Displayed:

In the Browse menu

WARNING: Deprecated. Themes will need to handle it in future versions. Themes which do not use the sidebar can define their own way of displaying navigation elements.

(Deprecated)

Themes which do not override decorators (page.vmd, blogpost.vmd, space.vmd)

If you want to display the sidebar in your theme, you only need to declare <space-ia value="true"/> in your theme definition:

1
2
<theme key="simpletheme" name="Simple Theme" class="com.atlassian.confluence.themes.BasicTheme">
    <description>A simple custom theme</description>
    <param name="includeClassicStyles" value="false"/>
    <resource type="download" name="default-theme.css" location="/includes/css/default-theme.css">
        <param name="source" value="webContext"/>
    </resource>
    <space-ia value="true"/>
</theme>

Themes which override decorators

If a theme overrides space.vmd, page.vmd or blogpost.vmd, it redefines the way a space is displayed. It is the theme's responsibility to display the appropriate navigation. Refer to the file space.vmd in the source of Confluence to update your template.

Writing a Confluence Theme