{builder-logo} Macro

Description

This macro 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

{builder-logo}

Parameters

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

Property	Required	Default	Notes
global		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:

{builder-logo}

Linked Logo

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

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