ThemeBuilder for Confluence Server and DC

Use Skin

The Use Skin Macro sets the skin used for the current page.

Usage

Follow the steps below to insert a Use Skin Macro in your page:

  1. Go to a page in which you want to add the Set Flag Macro.

  2. Click the Insert More Content dropdown menu and choose Other Macros.

  3. Type use skin in the search bar and select Use Skin from the results.

    use skin macro
  4. Fill in the desired parameters, and click Insert to save the macro.

    insert use skin macro 2

Storage Format

<ac:macro ac:name="use-skin">
<ac:parameter ac:name="parameter">value</ac:parameter>
</ac:macro>

Wiki Markup

{use-skin:parameter=value}

Parameter

Name

Description

Type

Default

Required

skin

Skin

The ID of the skin to use

string

tick

latch

Latch

Latch the use of this skin for the remainder of the session

  • false – only change the layout for this page

  • true – change the layout for all pages

boolean

false

error

flagLogic

Render Flag-Logic

Use the flagLogic from the target skin instead of this skin

boolean

false

error

flag

Flag

A list of flags, one of which must be defined for the content to be displayed

string

error

notflag

Not Flag

A list of flags which must not be defined for the content to be displayed

string

error

Basic Example

Set the skin to be MYSKIN.

<ac:macro ac:name="use-skin">
<ac:parameter ac:name="skin">MYSKIN</ac:parameter>
</ac:macro>
{use-skin:skin=MYSKIN}

This results in the skin being switched from the default to the one named in the macro, overriding anything set by ThemeBuilder.

Advanced Example

Use a previously set flag to switch the skin in edit mode. See Set Flag for how to set a flag.

<ac:macro ac:name="use-skin">
<ac:parameter ac:name="skin">MYSKIN</ac:parameter>
<ac:parameter ac:name="flag">edit</ac:parameter>
</ac:macro>
{use-skin:skin=MYSKIN|flag=edit}

This results in the skin being switched from the default to the one named in the macro if the flag 'edit' is true, overriding anything set by ThemeBuilder.