This documentation covers version 5.2.7 of the Enterprise Theme plugin.

Blog Posts & Pages{gu-blog-posts}Documentation
View, summarize or list the most recent blog posts and/or pages.
confluence-content

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Content source
contentSource
enumblogblog, page, pageblog
Content type to display
content
enumexcerptstitles, excerpts, entire
Date format
dateformat
enumdateposted_on, date, datetime, datefull
Time
time
Specify how far back to display blog posts. Example: 12hrelativedate
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 resultsint10
Pagination
usepagination
Shows a pagination, with max items on each pagebooleanfalse
Sort by
sort
enum title, creation, modified
Reverse sort
reverse
booleanfalse
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.enumfirstAttachmentnoFallback, firstAttachment, spaceLogo, spaceLogoIfCustom, firstAttachmentOrspaceLogoIfCustom
Max width of the image
thumbnailWidth
The maximum width of the displayed thumbnail. (In px, example: 150)int150
Max height of the image
thumbnailHeight
The maximum height of the displayed thumbnail. (In px, example: 100).int100
Number of visible labels
visibleLabelsCount
int10
Show "Not found" message
showNoEntriesMessage
booleantrue
Internationalisation i18n Key for the "Not found" message
noEntriesMessageI18n
Any available i18n key can be used.stringnet.getunik.confluence.skin.core.gu-blog-posts.error.no.content.found
Show author avatar
showIconBlock
booleanfalse
Show the name of the author
showAuthorName
booleanfalse
Show the space
showSpace
booleantrue
Place a more link at the end of the text
moreLinkInText
booleanfalse
Show the edit link
showEditLink
booleanfalse
Show the labels
showLabels
booleanfalse
Show the comment link
showComments
booleanfalse
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)booleanfalse
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 entriesstring
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

Examples

Example 1

{gu-blog-posts:theme=newslist|content=excerpts|spaces=News|showIconBlock=false|showEditLink=false}

Example 2

{gu-blog-posts:theme=newslist|content=excerpts|spaces=News}

Example 3

{gu-blog-posts:theme=newslist|excludeLabels=gu-exclude|content=excerpts|spaces=News|showThumbnail=true|showIconBlock=false|showEditLink=false}

Example 4

{gu-blog-posts:theme=newslist|content=excerpts|spaces=News|showIconBlock=true|showEditLink=true|showThumbnail=false}

Mobile Mode

In the mobile mode, this macros is rendered in the same way like the Top Stories Slider Macro.

 

Related articles

There is no content with the specified labels


Download and install the Enterprise Theme Plugin from the Atlassian Marketplace or through the Atlassian Universal Plugin Manager.

  Download

 

 

 

 

Labels (1)

Comments  (0)

Attachments  (4)

Add Attachment
  File Modified
PNG File gu-blog-post1.png 28. Feb. 2013 by Martin Wulff
PNG File gu-blog-post2.png 28. Feb. 2013 by Martin Wulff
PNG File gu-blog-post3.png 28. Feb. 2013 by Martin Wulff
PNG File gu-blog-post4.png 28. Feb. 2013 by Martin Wulff