The Blog Archive macro creates a nested list of blog posts.

Usage

Storage Format

<ac:macro ac:name="blog-archive">
<ac:parameter ac:name="parameter">value</ac:parameter>
</ac:macro>

Wiki Markup

{blog-archive:parameter=value}
ParameterNameDescriptionTypeDefaultRequired

space

Space

The space (or list of spaces) whose posts should be listed (SPACEKEY/@all/@current/@favourite/@global/@personal/@children) NB: the @all parameter must be used on it’s own, other macro parameters may be used in a list. Space keys are case-sensitive.

spacekey


label

Label

Only display posts with one of the listed labels

string


author

Author

Only display posts by the named authors - usernames/group names/@self/@creator/@owner

string


sort

Sort Order

The order that the posts are listed in

enum

creation

reverse

Reverse

Reverse the list sort order

boolean

true

count

Count

The number of posts to display

string


years

Years

Display nesting by year

boolean

true

months

Months

Display nesting by months

boolean

true

days

Days

Display nesting by days

boolean

false

posts

Posts

Display posts

boolean

true

excerpt

Excerpt

Display post excerpts

boolean

true

none

None

The text to display when no posts are found

string


flag

Flag

A list of flags, one of which must be defined for the content to be displayed

string


notflag

Not Flag

A list of flags which must not be defined for the content to be displayed

string


Basic Example

Display a nested list of blog posts from the space Builder. The blogs will appear grouped by Year, Month, and Date.

<ac:macro ac:name="blog-archive">
<ac:parameter ac:name="space">Builder</ac:parameter>
<ac:parameter ac:name="count">10</ac:parameter>
<ac:parameter ac:name="reverse">false</ac:parameter>
</ac:macro>
{blog-archive:space=Builder|count=10}

Result

Advanced Example

This is an example of how to display a list of blog posts from the space Builder, without nesting on years/months/days, and prevent the list from being reversed.

<ac:macro ac:name="blog-archive"
<ac:parameter ac:name="space">Builder</ac:parameter>
<ac:parameter ac:name="count">10</ac:parameter>
<ac:parameter ac:name="years">false</ac:parameter>
<ac:parameter ac:name="months">false</ac:parameter>
<ac:parameter ac:name="days">false</ac:parameter>
<ac:parameter ac:name="reverse">false</ac:parameter>
</ac:macro>
{blog-archive:space=Builder|count=10|years=false|months=false|days=false|reverse=false}

Result