Page History

{scrollbar:no-css=true}
h1. Theme Configuration

*{excerpt}The theme is configured from a single configuration screen...{excerpt}*

h2. AccessingSelecting the Configuration Screen

When you first select {builder} as Theme

The Builder theme is *not* designed for use at "Global" level:

!not_global_theme.gif|align=center!

It is designed for use at Space level:

!theme_configuration_link.gif|align=center!

From the [Space Theme]{footnote}You must confirm the theme change _before_ clicking settings, select the ??Site Builder Theme?? and click on the *??ConfigurationConfirm??* linkbutton.{footnote}, youThis canwill clickactivate the *??Configuration??* link as shown below:

!theme_configuration_link.gif|align=center!

{display-footnotes} Builder theme for the space, using default settings.

h2. Accessing the Configuration Screen

Once the theme is in use, you can access the configuration screen at any time by choosing *??Theme Config??* from the *??Edit > Administration??* menu:

!configure_theme_menu.gif|align=center!

h2. Configuration Options

The configuration screen contains the following options (from top to bottom)...

h3. Navigation Page

The navigation page defines which page should be used as the space homepage{footnote}Clicking the logo banner will also take you to the space homepage.{footnote} and defaults to ??Home??:

!builder_navigation_page.gif|align=center!

If you have set an alternate page to be the homepage for the space, simply enter the title of that page in the space provided.

{display-footnotes}

h3. Display Page Information Bar

Added in {builder} version 1.5, this setting allows you to show or hide the page information bar:

!builder_display_pageinfo.gif|align=center!

The page information bar appears at the top of all pages and news items when viewed normally and includes:

* Page author and most recent editor (including dates and times)
* An option to display comments (if specified) from the last edit to the page
* Icons for adding the page to favoruites and watching the page
* Label display (and editor if the user has sufficient privileges)

For corporate websites, intranets and portals, this information and related options is usually not required. You can remove it all by un-ticking the box.

h3. Menu Style

Added in {builder} version 1.5, this setting allows you to choose from a selection of inbuilt menu designs:

!builder_menu_style.gif|align=center!

For more information, and examples of each style, please see our tutorial on [Menu Styles].

h3. Page Width

This setting allows you to set the width of pages within the space. It defaults to 750px{footnote}Other Confluence themes use a default of 100% width.{footnote} as shown below:

!builder_page_width.gif|align=center!

The width should be specified as either pixels (eg. ??750px??) or as a percentage of the browser window width (eg. ??100%??).

Although you can set any value, please take in to account the screen resolutions of other people who will view the space - although you might have a large screen resolution, some of the other visitors may only have 800x600 pixel resolution and some of the space will be taken up with scrollbars and "quick launch" bars, etc.

{display-footnotes}

h3. Custom Pre-Menu Lists

This section allows you to define the menu items that appear _before_ the standard ??View?? and ??Edit?? {footnote}You can configure various aspects of the standard menus - for more information, please see our tutorial on [Customising the View and Edit Menus].{footnote} menus:

!builder_pre_menu.gif|align=center!

For more information, please see [Menus].

h3. Custom Post-Menu Lists

This section allows you to define the menu items that appear _after_ the standard ??View?? and ??Edit?? menus:

!builder_post_menu.gif|align=center!

For more information, please see [Menus].

{display-footnotes}

h3. CSS Custom Styles

This section allows you to define style sheets to be injected in to all pages within the space:

!builder_custom_css.gif|align=center!

For more information on setting custom style sheets, please see our tutorial on [CSS Custom Styles].

h3. Custom Footer

This section allows you to define the contents of the footer that appears at the bottom of all pages within the space:

!builder_custom_footer.gif|align=center!

For more information on customising the footer, please see our tutorial on the [Custom Footer].

h3. Saving Settings

When you have finished making changes, click the *??Save??* button.

{warning}Some versions of {confluence} do not properly back-up the theme configuration. You should always make manual copies of your theme configuration by copying and pasting the various settings in to a text document or a page within {confluence}. If you copy the settings in to a page within {confluence}, enclose them in the [noformat macro] to ensure they don't get misinterpreted as [wiki markup|Wiki Markup Editor#What is Wiki Notation?].{warning}

h2. Customisation Service

If you don't want to customise {builder} yourself, Adaptavist offer a customisation service. For more details, please see [Builder - Specialist Solutions|ADAPTAVIST:Builder - Specialist Solutions].