Theme Builder Plugin

[All Adaptavist Apps]

Page tree

Versions Compared

Old Version 46

changes.mady.by.user Unknown User (gwilson)

Saved on

compared with

New Version 47

changes.mady.by.user Unknown User (gwilson)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

Excerpt

The theme is configured from a single configuration

...

screen...

Note

The details on this page are specific to Builder

{excerpt}* {note}The details on this page are specific to *Builder

1.6.0

*

.

If

you

are

using

*

Builder

1.5.x

*

,

please

refer

to

[

Theme

Configuration

1.5.x

].{note} h2. Requirements In order to configure the theme: * Builder must have been installed (see [Installing Builder]) * You must have Space Administrator privileges for the Space (or Site Administrator privileges) * Builder must have been enabled within a Space (see [Enabling the Theme]) 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. Space Home Page This setting defines which page within a space should be used as the homepage for the space

.

Requirements

In order to configure the theme:

  • Builder must have been installed (see Installing Builder)
  • You must have Space Administrator privileges for the Space (or Site Administrator privileges)
  • Builder must have been enabled within a Space (see Enabling the Theme)

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:

Image Added

Configuration Options

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

Space Home Page

This setting defines which page within a space should be used as the homepage for the space

Wiki Markup
{footnote}Clicking the logo banner will also take you to the space homepage.{footnote}

...

 and 
...
 defaults 
...
 to 
...
Home
...
:
Image Added
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.
 Wiki Markup
{display-footnotes}
Menu Settings 
 Wiki Markup
{span:class=smalltext}(New in Builder 1.6!){span}
...
This 
...
 panel 
...
 allows 
...
 you 
...
 to 
...
 choose 
...
 from 
...
 the 
...
 various 
...
Menu 
...
 Styles
...
 and 
...
 alter 
...
 various 
...
Menu 
...
 Settings
...
:
Image Added
You can use these options to tailor the design and operation of the menu to your exact needs.
Should you experience any performance issues (eg. menus loading slowly), you can use these settings for Performance Tuning.
Page Settings 
 Wiki Markup
{span:class=smalltext}(Upgraded in Builder 1.6!){span}
...
This 
...
 panel 
...
 allows 
...
 you 
...
 to 
...
 set 
...
 various 
...
Page 
...
 Settings
...
 that 
...
 affect 
...
 all 
...
 pages 
...
 within 
...
 the 
...
 space:
Image Added
Please note that if you want to use PNG icons in the menus, you must enable PNG alpha-transparency support.
 Wiki Markup


!builder_page_settings.gif|align=center!

Please note that if you want to use PNG icons in the menus, you must enable PNG alpha-transparency support.

{display-footnotes}

h3. 
Custom 
...
 Menus
...
This 
...
 panel 
...
 allows 
...
 you 
...
 to 
...
 define 
...
 your 
...
 own 
...
 custom 
...
 menus, 
...
 either 
...
 side 
...
 of 
...
 the 
...
 inbuilt 
...
View
...
 and 
...
Edit
...
 menus
 Wiki Markup
{footnote}You can also customise the in-built View and Edit menus - for more information, please see our tutorial on [View and Edit Menus].{footnote}
:
Image Added
To learn how to create your own custom menus, please see Menus.
 Wiki Markup
:

!builder_custom_menus.gif|align=center!

To learn how to create your own custom menus, 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:
Image Added
For more information on setting custom style sheets, please see our tutorial on CSS Custom Styles.
Custom Footer
This section allows you to define the contents of the footer that appears at the bottom of all pages within the space:
Image Added
For more information on customising the footer, please see our tutorial on the Custom Footer.
Saving Settings
When you have finished making changes, click the Save button.
 Warning
Some versions of 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 . If you copy the settings in to a page within , enclose them in the noformat macro to ensure they don't get misinterpreted as wiki markup.


!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 [AtlassianConfluence:noformat macro] to ensure they don't get misinterpreted as [wiki markup|AtlassianConfluence:Wiki Markup Editor#What is Wiki Notation?].{warning}