Slider Macros for Confluence Cloud



This is the documentation for the Cloud version of the application. To learn more about the Server version, see here.

The Image Slider plugin for Confluence lets you auto-scroll multiple images in a simple and beautiful display frame. 



>>> Macro Demo Page <<<

Available macros

  • Image Slider macro
    Use the Image Slider macro to display multiple images in a simple and beautiful image slider.

    • Automatic (timed) or manual slider transitions.

    • Customizable timing.

    • Thumbnail navigation

    • Fade or slide transitions.


  • Content Slider macro
    Use the Content Slider macro to slide through page content like text, links or even charts instead of just images.

    • Use as a news-ticker or a tutorial presenter with any content form any page.

    • Maintain content without re-configuring the macro.

All macros are fully responsive, mobile compatible, touch-enabled and support keyboard navigation.

Feature highlights

  • Display all image attachments of a wiki page in a beautiful image slider.

  • Image picker to select images that you want to be displayed.

  • Collect images from any space, page, filter by labels.

  • Use attachment comments as image captions.

  • Link images to the pages or blog posts they are attached to. For example, to create a blogpost teaser on your dashboard.

  • Set responsive width to let the slider adapt to the available space automatically.

  • Choose from different transition effects, image fitting options.

Image Slider macro 

Display optional thumb nails 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 to. 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.

Image Slider configurable parameters

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

Parameter

Default

Description

Parameter

Default

Description

Width

Blank

(Size of the first image is used.)

Enter the width of the slider in pixels or percents. Leave blank to let the slider automatically choose the best size.

Example: 100%, 500px

Height

Blank

(Size of the first image is used.)

Enter the 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 center and cropped to fit. Values are:

  • Stretch - Stretch images to fit slider.

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

Sort Images By

Creation Date

Choose the order in which the images must be sorted. Values are:

  • Creation Date - Sort by creation date of attachment.

  • File Name - Sort by file name of attachment.

  • Comment - Sort by attachment comment.

  • Random - Sort randomly.

Reverse Order

Not selected

Choose to sort the images in the reverse order depending on the Sort Images By parameter value.

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 are to 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

Enter the time in milliseconds (ms) to specify how long each image must be shown. 0 value turns auto slider off.

Show Navigation

Selected

Choose to show previous or next navigation.

Show Thumbnails

Not selected

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



Content Slider macro

The Content Slider macro lets you create slides, separated by <mohami-slider-entry> as the delimiter, with full Confluence editing and formatting functionality:

Use the Content Slider macro to slide through page content like text, links or even charts instead of just images. You can create interactive step-by-step guides or just a simple news ticker using the Content Slider macro.

Place as many entries as needed separating each with the <mohami-slider-entry> delimiter.

Content Slider configurable parameters

Parameter

Default

Description

Parameter

Default

Description

Width

500px

Enter the width of the slider in pixels or percents. Leave blank to let the slider automatically choose the best size.

Example: 100%, 500px

Height

300px

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

Background Color

whiteSmoke

Enter the background color of the content slider. Use hexadecimal notation or HTML color name.

Slider Effect


Fade

Choose between multiple transition effects. Valid values are:

  • Fade

  • Slide

Auto Slide Display Time

3000

Enter the time in milliseconds (ms) to specify how long each image must be shown. 0 value turns auto slider off.

Content Padding

selected

Enable to add padding to the slide content.

Show Navigation

selected

Choose to show previous or next navigation.

Show Bullets

selected

Choose to show bullets at the bottom of the slider.



To add slides, enter the required content in the macro body and end the content of each slide with the <mohami-slider-entry> delimiter. You can use the usual formatting styles as suitable to your needs.