Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article provides you with information on the following topics:

Table of Contents

Features

  • Display optional thumbnails with a single click.

...

...

  • Use the native Confluence comments to display captions for each image:

...

  • Use the Image Slider macro on a page to display selected image attachments from any space or page in a nice-looking image slider.

  • Use attachment comments as image captions to display more information in the image slider. You can even link the images to the pages or they are attached. There are also multiple transition effects you can choose from and lots of configuration options like image fitting, responsive or static width and height, gallery mode with thumbnails, different navigation types, etc. to adjust the image slider to your needs.

Parameters

Configuration flexibility lets users decide the rate of transitions, the footprint on the page, and more:

Parameter

Default

Description

Width

None - the size of the first image will be used

Width of the slider in pixels or percents. Leave blank to let the slider automatically choose the best size. e.g. 100%, 500px

Height

None - the size of the first image will be used

Height of the slider in pixels. Leave blank to let the slider automatically choose the best size.

Image Fitting

Stretch

Choose whether images should be stretched to fit or scaled from the centre and cropped to fit. Values are:

  • Stretch - Stretch images to fit the slider.

  • Scale and Crop - Scale the width of images from the centre to fit the slider, then crop height accordingly.

Sort Images By

Creation Date

The order of images should be sorted by. Values are:

  • Creation Date - Sort by the creation date of the attachment.

  • File Name - Sort by the file name of the attachment.

  • Comment - Sort by attachment comment.

  • Random - Sort randomly.

Note: By default, sort is applied in ascending order. If you wish to change the order to descending choose the Reverse Order check box.

Reverse Order

Not Selected

Choose to sort images in descending order.

Filter Images By Date Range

Not Selected

Choose to filter the images based on a specific date range.

Select the check box, and a calendar is displayed. Choose the start and end dates from the calendar to apply the filter.

Use attachment comments as

Caption

Choose whether attachment comments should be used as image captions or external links. Values are:

  • None - Caption is not displayed

  • Caption - Comments are displayed as captions

  • Link - Comments are used as external links

  • Caption and Link - Comments are used as captions and external links. Use a vertical bar "|" in the comment to separate the caption from the link.
    Example: Caption|http://xyz.com

Slider Effect

Fade

Choose between multiple transition effects. Valid values are:

  • Fade

  • Slide

Auto Slide Display Time

3000

Time (ms) how long each image will be shown. 0 value turns the auto slider off.

Link Images

Not Selected

Choose to link images to either the pages they are attached to or URLs specified in the Attachment Comments.

Use Attachment comments as must be set to Link or Caption and Link to link theĀ URLs specified in attachment comments.

Show Navigation

Selected

Choose to show the prev/next navigation.

Show Thumbnails

Not Selected

Choose to show thumbnails of the images at the bottom of the slider.

Show Bullets

Selected (if thumbnails are disabled)

When thumbnails are disabled, choose to show bullets at the bottom of the slider.

Creating Image Slider Macro

  1. Go to the page where you want to slide the images and click edit.

  2. Click the + icon. Search for the Image Slider macro.
    (or) you can type { lmage, the list with image macro suggestions is displayed, select the Image Slider macro.

  3. Select Image Slider macro. The Image Slider macro is displayed.

  4. Click the macro body and select Edit. The Image Slider macro is displayed.

    Image Added
  5. Click the Select Images Locations button. The Select Individual Images window is displayed.

    Image Added

    Image Added

  6. Choose the Space and Page name from where you want to pull images from.

  7. (Optional) To pull images based on the labels specify Attachment Labels.

  8. (Optional) You also select images by location. To select images by location perform the following:

    1. Go to Select Image Location tab.

      Image Added
    2. Choose the Space and Page name from where you want to pull images from.

    3. (Optional) To pull images based on the labels specify Attachment Labels.

    4. Click Add Location. The images are loaded.

  9. Click Get Images. The images are loaded.

  10. Select the images that you want to use in the image slider.

  11. Click View Selected. The images selected are displayed.

  12. Click Close.

  13. Customize the way the image slider you want to view the slider. For more information, see Parameters.

  14. Click Apply.

  15. Publish the page. The Image slider is rendered on to your page.