This page is a snippet
For full information, see:
Snippet
Macro name: blog-posts
Macro body: None.
| Parameter name | Required | Default | Parameter description and accepted values |
|---|
content | No | entire | Available values: entire – Display the whole content of each blog post.excerpts – Display a short extract from each blog post. If the post contains an Excerpt macro, the Blog Posts macro will display the content defined in the Excerpt macro. If the post does not contain an Excerpt macro, the Blog Posts macro will display the first few sentences of the post.titles – Display a list of blog posts, showing titles only.
|
spaces | No | @self | One or more space keys, separated by a comma or a space.
- To exclude content in a specific space, put a minus sign (-) immediately in front of that space key. For example: If you specify a space key of
-BADSPACE you will get only content which is not in the BADSPACE.
- To indicate that the results must come from a specific space, put a plus sign (+) immediately in front of that space key. For example: If you specify a space key of
+GOODSPACE you will get only content in GOODSPACE. (Note that this is not particularly useful, because each content item belongs to one space only. If you put a plus sign next to one space key and list other space keys too, the other space keys will be ignored.)
Special values: @self — The current space.@personal — All personal spaces.@global — All site spaces.@favorite — The spaces you have marked as favourite.@favourite — The same as @favorite above.@all — All spaces in your Confluence site.* — The same as @all above.
When specifying a personal space, remember to use the tilde (~) sign in front of the username, such as ~jbloggs or ~jbloggs@example.com. |
author | No | (None) | One or more usernames, separated by commas. |
time | No | (None) | Available values:m — Minutesh — Hoursd — Daysw — Weeks
For example, time=12h – Display blog posts created in the last twelve hours.time=7d – Display blog posts created in the last seven days.
|
reverse | No | false | A value of true changes the sort order. |
sort | No | creation | Available values:
- title — Sort alphabetically by title.
- creation — Sort by the date on which the content was added.
- modified — Sort by the date on which the content was last updated.
|
max | No | 15 | The maximum number of results to be displayed. |
label | No | (None) | One or more label values, separated by a comma or a space.
- To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of
-badpage you will get only content which is not labelled with 'badpage'.
- To indicate that the results must match a given label value, put a plus sign (+) immediately in front of that label value. For example: If you specify a label value of
+superpage,+goodpage you will get only content which has at least two labels, being 'superpage' and 'goodpage'.
|
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.