Top Stories Slider{top-stories}Documentation
Display a slider with an image and a summary of the most recent blog posts and/or pages.
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Title
title
string
Internationalization i18n key for the title
i18n
Any available i18n key can be used.string
Display option
display
Either the slider shows blog posts image and text side-by-side or blog posts image in full width.enumsidebysideimage-text-slider, full-image-slider
Width
width
string
Height of the slider
sliderHeight
The height of the displayed slider and image. (In px, example: 250).int250
Content type to display
content
enum titles, excerpts
Content source
contentSource
enumblogblog, page, pageblog
Time frame
time
Specify how far back to display blog posts. Example: 12hrelativedate
Restrict to these labels (OR)
labels
Separate each label with a comma.string
Must have labels (AND)
mustHaveLabels
A list of labels, that a result must have. Separate each label with a comma.string
Exclude these labels (NOT)
excludeLabels
Separate each label with a comma.string
Restrict to these authors
author
Separate each author with a comma or use placeholder like @self, @network, @follower, @following..string
Restrict to these spaces
spaces
These are case-sensitive. Separate each item with a comma or single space. Example: SPACEKEY, @favorite, @personal, @all. If not specified, the current space is searched.spacekey
Maximum Number of blog posts
max
The maximum number of resultsint100
Reverse sort
reverse
booleanfalse
Auto slide (display duration)
autoSlide
Seconds before the Top Stories slides to the next entry. Enter 0 to disable auto slide. Attention: The time has to include the sliding effect duration.int4
Slide duration
duration
Seconds for the slide effect durationint1
Random start slide
randomInitSlide
Show a random selected slide of the slider, as start slide.booleantrue
Thumbnail - image label
thumbnailLabel
The macro searches for an attachment with the defined label(s) and uses it as thumbnail in the listing.string
Use another image as fallback
thumbnailType
If no image with the correct label could be found, you can define a fallback to use another image as thumbnail.enumfirstAttachmentnoFallback, firstAttachment, spaceLogo, spaceLogoIfCustom, firstAttachmentOrspaceLogoIfCustom
Additional Lucene Query
luceneQuery
This is a very advanced and powerfull parameter, which you can use for additional content selection by lucene.
This paramter supports the Metadata Add-on and the User Profile Add-on by Communardo. Please find more information and examples in our documentation.
string

Mobile Mode

In the mobile mode, this macros is rendered in the same way like the Blog Posts & Pages Macro.

Related articles

There is no content with the specified labels

Labels (1)

Comments  (0)

Attachments  (1)

Add Attachment
  File Modified
PNG File image2015-7-29 16:10:34.png 29. Jul. 2015 by Oliver Sträßer