Confluence 4.1 : Troubleshooting the Gallery Macro

Gallery Macro

The full list of parameters is shown in the following table.

Parameter

Default

Description

Gallery Title

Nothing

Specify a title for your gallery.

Number of Columns

4

Specify the number of columns for your table.

Images to Exclude

No exclusions i.e. include all the pictures on the page.

The gallery will ignore any pictures specified. You can specify more than one picture, separated by commas.
Please note, the filename and filetype for this parameter are case-sensitive, i.e. 'my picture.PNG' will not be recognised as 'my picture.png'.

Include these Images Only

Include all the pictures on the page.

If you specifically include one or more pictures, the gallery will show only those pictures. You can specify more than one picture, separated by commas.
Please note, the filename and filetype for this parameter are case-sensitive, i.e. 'my picture.PNG' will not be recognised as 'my picture.png'.

Use Images in these Pages

If no page is specified, the gallery macro displays the images attached to the page on which the macro is used.

Specify the title of the page which contains the images you want displayed. To specify a page in a different space, use the SPACEKEY:Page Title syntax.

Sort Images By

None, i.e. the sort order is unspecified and therefore unpredictable.

Specify an attribute to sort the images by. Sort order is ascending, unless you select the Reverse Sort parameter (see below). Options are:

  • name – file name.
  • comment – comment linked to the attached file.
  • date – date/time last modified.
  • size – size of the attached file.

Reverse Sort

Off, i.e. sort order is ascending

Used in conjunction with the Sort Images By parameter above. Use Reverse Sort to reverse the sort order, from ascending to descending.

If the name of an attached file or page contains a comma, you can refer to it in the relevant parameters above by enclosing it in single or double quotes, for example "this,that.jpg", theother.png.

For more information, refer to Gallery Macro.

 

(warning) The information on this page does not apply to Confluence OnDemand.

Troubleshooting

If you encounter the following error message: System does not support thumbnails: no JDK image support then ensure that you have following system property available for your JVM:

JAVA_OPTS=-Djava.awt.headless=true

Also see CONF-1737

Please note that gallery-ext.jar is available at CONF-6620