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.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 global 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'.
|