This documentation covers version 6.2.12 of the Enterprise Theme.
Parameter
Name | Description | Type | This is a required field | Default | Values |
---|---|---|---|---|---|
Content sourcecontentSource | enum | ![]() | blog | blog, page, pageblog | |
Content type to displaycontent | enum | ![]() | excerpts | titles, excerpts, entire | |
Date formatdateformat | enum | ![]() | date | posted_on, date, datetime, datefull | |
Date Sourcedatesource | Choose which date should be displayed | enum | ![]() | created | created, last_modified |
Timetime | 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 authorsauthor | Separate each author with a comma or use a placeholder like @self, @network, @follower, @following. | string | ![]() | ||
Restrict to these spacesspaces | 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 itemsmax | The maximum number of results | int | ![]() | 10 | |
Paginationusepagination | Shows a pagination, with max items on each page | boolean | ![]() | false | |
Sort bysort | enum | ![]() | title, creation, modified | ||
Reverse sortreverse | boolean | ![]() | false | ||
Maximum number of displayed contentnumWithExcerpt | 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 labelthumbnailLabel | The macro searches for an attachment with the defined label(s) and uses it as thumbnail in the listing. | string | ![]() | ||
Use another image as fallbackthumbnailType | 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 imagethumbnailWidth | The maximum width of the displayed thumbnail. (In px, example: 150) | int | ![]() | 150 | |
Max height of the imagethumbnailHeight | The maximum height of the displayed thumbnail. (In px, example: 100). | int | ![]() | 100 | |
Number of visible labels visibleLabelsCount | int | ![]() | 10 | ||
Show "Not found" messageshowNoEntriesMessage | boolean | ![]() | true | ||
Internationalisation i18n Key for the "Not found" messagenoEntriesMessageI18n | Any available i18n key can be used. | string | ![]() | net.getunik.confluence.skin.core.gu-blog-posts.error.no.content.found | |
Show author avatarshowIconBlock | boolean | ![]() | false | ||
Show the name of the authorshowAuthorName | boolean | ![]() | false | ||
Show the spaceshowSpace | boolean | ![]() | true | ||
Show the edit linkshowEditLink | boolean | ![]() | false | ||
Show the labelsshowLabels | boolean | ![]() | false | ||
Show the comment linkshowComments | boolean | ![]() | false | ||
Force more linkmoreLink | 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 colorbackgroundColor | string | ![]() | |||
CSS styles to apply to titlestitleCSS | string | ![]() | |||
Blog post CSS classclassName | Define a CSS class which is added to all blog post list entries | string | ![]() | ||
Additional Lucene QueryluceneQuery | 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 App from the Atlassian Marketplace or through the Atlassian Universal Plugin Manager.