News Boxes

Content source
contentSource

enum

blog

blog, page, pageblog

Height of the teaser image
height

The height of the displayed teaser image. (In px, example: 150).

int

150

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/pages
max

The maximum number of results

int

3

Sort by
sort

enum

title, creation, modified

Reverse sort
reverse

boolean

false

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

Color
teaserBoxColor

Color of teaser box if no image can be displayed. Default color is the highlight color of the Enterprise Theme.

string

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