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 Insert More Content from the drop-down menu and choose Other Macros.

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

    The Use Skin option in the Macro Browser.
  4. Fill in the desired parameters, and click Insert to save.

    The Insert Use Skin Macro screen, with example configuration.

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


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

flagLogic

Render Flag-Logic

Use the flagLogic from the target skin instead of this skin

boolean

false

flag

Flag

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

string


notflag

Not Flag

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

string


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 more on 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.