This page is a snippet

For full information, see:

Snippet

 

Macro name: blog-posts

Macro body: None.

Parameter nameRequiredDefaultParameter description and accepted values
contentNoentire

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.
spacesNo@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.

authorNo(None)One or more usernames, separated by commas.
timeNo(None)Available values:
  • m — Minutes
  • h — Hours
  • d — Days
  • w — 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.
reverseNofalseA value of true changes the sort order.
sortNocreation

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.

maxNo15The maximum number of results to be displayed.
labelNo(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'.

 

 

 

 

 

  • No labels