This documentation has moved. For the most recent documentation, check out https://docs.adaptavist.com. Please update your bookmarks and links.

Skip to end of metadata
Go to start of metadata

ThemeBuilder Macro - Image Resource

image

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.

To use 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)

altAlt TagHTML Alt tag to show as tooltip on hoverstring 

(error)

classCSS ClassAdd a CSS class to the imagestring 

(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

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.

Login now shows an image.

 

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.

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