[All Adaptavist Apps]

Page tree

Versions Compared

Key

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

{builder-logo} Macro

Description

This macro

Excerpt

displays the logo applicable to the location being viewed

:

  • If used within a Space, the Space logo is shown
  • If used anywhere else, the Global logo is shown
  • If no logo has been defined for a Space, the Global logo is shown
  • If the Space logo has been switched off, no logo is shown in the Space
  • If the global logo has been switched off, no logo is shown in other locations (and also in any spaces that were using the default Global logo)

Usage

Code Block
{builder-logo}

Parameters

The "Ver" column shows which version of Theme Builder the parameter became available in.

Property

Required

Default

Notes

global

(error)

n/a

Display the global logo regardless of which space is the local context.

Examples

Basic Use

Simply add the macro to any panel in theme configuration to display the logo in that panel:

Code Block
{builder-logo}

To link the logo to the home page, wrap it in the menulink macro as shown below:

Code Block
{menulink:home}{builder-logo}{menulink}

If viewed within a Space, the logo will be linked to the Space home page. If viewed anywhere else, it will link to either:

  • The user home page if defined in that users' preferences
  • The site home page if defined in General Configuration
  • The Dashboard (default)

CSS Customisation

To follow.

Hints and Tips

The Space logo is uploaded using the "Space Logo" option in Space Admin. You can also choose to use the default logo (i.e. the Global logo) or even switch off the logo within the space.

Similarly, the Global logo is uploaded using the "Global Logo" option in the Adminisration Console. If you turn off the Global logo, then any Spaces that are set to use the default logo will no longer display a logo.

Frequently Asked Questions

None at present.