Top Stories Slider

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.

enum

sidebyside

image-text-slider, full-image-slider

Width
width

Define the width of the macro. Examples: 300px or 30%.

string

Height of the slider
sliderHeight

The height of the displayed slider and image. (In px, example: 250).

int

250

Content type to display
content

enum

titles, excerpts

Content source
contentSource

enum

blog

blog, page, pageblog

Time frame
time

Specify how far back to display blog posts. Example: 12h

relativedate

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 results

int

100

Reverse sort
reverse

boolean

false

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.

int

4

Slide duration
duration

Seconds for the slide effect duration

int

1

Random start slide
randomInitSlide

Show a random selected slide of the slider, as start slide.

boolean

true

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.

enum

firstAttachment

noFallback, 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

The color of the navigation arrows
navigationArrowsColor

string

The color of the navigation dots
navigationDotsColor

string

The color of the textbox background
textboxBackgroundColor

string