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.

Where are the items of the Browse menu displayed?

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 Theme Displayed Screenshot
system.browse All In the Help menu.
system.space With Space sidebar In the contextual navigation of the Advanced section
system.space

Without Space sidebar

(Example: Documentation Theme)

In the Browse menu

(error) 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:

<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.

Related topics

Writing a Confluence Theme

Was this page helpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport