ThemeBuilder for Confluence Server and DC

Image Resource

This macro displays a builder resource as an image.

Usage

ThemeBuilder can upload and save a library of resources to use in your skin. The 'image' macro lets you reference an image resource by skin ID and resource name, for inclusion in panels or pages.

Resource Screen

  • Use the 'Browse' button to upload any image from a local folder.

  • The image will start uploading automatically.

  • Once uploaded the image will appear in the Resources list.

image resource 01

Using a Resource with the Image Macro:

Storage Format

<ac:macro ac:name="image">
<ac:parameter ac:name="resource">MYSKIN::chalet.jpg</ac:parameter>
</ac:macro>

Wiki Markup

{image:resource=MYSKIN::chalet.jpg}
Parameter Name Description Type Default Required

resource

Resource

The resource identifier in SKINID::RESOURCE.EXT format

string

error

alt

Alt Tag

HTML Alt tag to show as tooltip on hover

string

error

class

CSS Class

Add a CSS class to the image

string

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

Panel Example

Here’s an example of how to use an image in a ThemeBuilder skin editor panel. Note the two double colons; this tells the image macro that the image is a ThemeBuilder resource.

<ac:macro ac:name="image">
<ac:parameter ac:name="resource">MYSKIN::flying-pig.png</ac:parameter>
<ac:parameter ac:name="alt">Flying Pig</ac:parameter>
</ac:macro>
{image:MYSKIN::flying-pig.png|alt=Flying Pig}

Result

By adding the image macro to the 'login' panel you can customise your login page with an image.

image resource 02

Login now shows an image:

image resource 03

Page Example

On any page use the macro browser to insert the 'image' macro and you will get a popup, with fields to enter the resource skinId and name.

image resource 04

And an image from ThemeBuilder that will be seen on your page.

image resource 05