Blog Posts & Pages

Content source
cotentSource

enum

blog

blog, page, pageblog

Content type to display
content

enum

excerpts

titles, excerpts, entire

Date format
dateformat

enum

date

posted_on, date, datetime, datefull

Date Source
datesource

Choose which date should be displayed

enum

created

created, last_modified

Time
time

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

relativedate

Restrict to these labels (OR)
labels

Separate each label with a comma or single space.

string

Must have labels (AND)
mustHaveLabels

A list of labels, that a result must have. For multiple labels separate each label with a comma.

string

Exclude these labels (NOT)
excludeLabels

Separate each label with a comma or single space.

string

Restrict to these authors
author

Separate each author with a comma or use a 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. Specify space categories with #category. If not specified, the current space is searched.

spacekey

Maximum number of items
max

The maximum number of results

int

10

Pagination
usepagination

Shows a pagination, with max items on each page

boolean

false

Sort by
sort

enum

title, creation, modified

Reverse sort
reverse

boolean

false

Maximum number of displayed content
numWithExcerpt

The number of list entries, where the full content or the excerpt is displayed. All the following entries only show the title.

int

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

Max width of the image
thumbnailWidth

The maximum width of the displayed thumbnail. (In px, example: 150)

int

150

Max height of the image
thumbnailHeight

The maximum height of the displayed thumbnail. (In px, example: 100).

int

100

Number of visible labels
visibleLabelsCount

int

10

Show "Not found" message
showNoEntriesMessage

boolean

true

Internationalisation i18n Key for the "Not found" message
noEntriesMessageI18n

Any available i18n key can be used.

string

net.getunik.confluence.skin.core.gu-blog-posts.error.no.content.found

Show author avatar
showIconBlock

boolean

false

Show the name of the author
showAuthorName

boolean

false

Show the space
showSpace

boolean

true

Show the edit link
showEditLink

boolean

false

Show the labels
showLabels

boolean

false

Show the comment link
showComments

boolean

false

Force more link
moreLink

Show a "more..." link every time (doesnt hide the link if the complete news text is already displayed - this is default Confluence behaviour)

boolean

false

Background color
backgroundColor

string

CSS styles to apply to titles
titleCSS

string

Blog post CSS class
className

Define a CSS class which is added to all blog post list entries

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