Blog Posts & Pages
This documentation covers version of the Enterprise Theme.
Parameter
Name | Description | Type | This is a required field | Default | Values |
---|---|---|---|---|---|
Content source | enum | blog | blog, page, pageblog | ||
Content type to display | enum | excerpts | titles, excerpts, entire | ||
Date format | enum | date | posted_on, date, datetime, datefull | ||
Date Source | Choose which date should be displayed | enum | created | created, last_modified | |
Time | Specify how far back to display blog posts. Example: 12h | relativedate | |||
Restrict to these labels (OR) | Separate each label with a comma or single space. | string | |||
Must have labels (AND) | A list of labels, that a result must have. For multiple labels separate each label with a comma. | string | |||
Exclude these labels (NOT) | Separate each label with a comma or single space. | string | |||
Restrict to these authors | Separate each author with a comma or use a placeholder like @self, @network, @follower, @following. | string | |||
Restrict to these 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 | The maximum number of results | int | 10 | ||
Pagination | Shows a pagination, with max items on each page | boolean | false | ||
Sort by | enum | title, creation, modified | |||
Reverse sort | boolean | false | |||
Maximum number of displayed content | 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 | 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 | 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 | The maximum width of the displayed thumbnail. (In px, example: 150) | int | 150 | ||
Max height of the image | The maximum height of the displayed thumbnail. (In px, example: 100). | int | 100 | ||
Number of visible labels | int | 10 | |||
Show "Not found" message | boolean | true | |||
Internationalisation i18n Key for the "Not found" message | Any available i18n key can be used. | string | net.getunik.confluence.skin.core.gu-blog-posts.error.no.content.found | ||
Show author avatar | boolean | false | |||
Show the name of the author | boolean | false | |||
Show the space | boolean | true | |||
Show the edit link | boolean | false | |||
Show the labels | boolean | false | |||
Show the comment link | boolean | false | |||
Force more link | 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 | string | ||||
CSS styles to apply to titles | string | ||||
Blog post CSS class | Define a CSS class which is added to all blog post list entries | string | |||
Additional Lucene Query | This is a very advanced and powerfull parameter, which you can use for additional content selection by lucene. | string |
Examples
Example 1
{gu-blog-posts:theme=newslist|content=excerpts|spaces=News|showIconBlock=false|showEditLink=false}
![](../__attachments/12336791623/gu-blog-post1.png?inst-v=ac9b5293-2833-46d1-b363-44b92ea1bd93)
gu-blog-post1.png
Example 2
{gu-blog-posts:theme=newslist|content=excerpts|spaces=News}
![](../__attachments/12336791623/gu-blog-post2.png?inst-v=ac9b5293-2833-46d1-b363-44b92ea1bd93)
gu-blog-post2.png
Example 3
{gu-blog-posts:theme=newslist|excludeLabels=gu-exclude|content=excerpts|spaces=News|showThumbnail=true|showIconBlock=false|showEditLink=false}
![](../__attachments/12336791623/gu-blog-post3.png?inst-v=ac9b5293-2833-46d1-b363-44b92ea1bd93)
gu-blog-post3.png
Example 4
{gu-blog-posts:theme=newslist|content=excerpts|spaces=News|showIconBlock=true|showEditLink=true|showThumbnail=false}
![](../__attachments/12336791623/gu-blog-post4.png?inst-v=ac9b5293-2833-46d1-b363-44b92ea1bd93)
gu-blog-post4.png
Mobile Mode
In the mobile mode, this macros is rendered in the same way like the Top Stories Slider Macro.
![](../__attachments/12336791690/image2015-7-29%2016:10:34.png?inst-v=ac9b5293-2833-46d1-b363-44b92ea1bd93)