ThemeBuilder for Confluence Server and DC

Blog Archive

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}
Parameter Name Description Type Default Required

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

error

label

Label

Only display posts with one of the listed labels

string

error

author

Author

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

string

error

sort

Sort Order

The order that the posts are listed in

enum

creation

error

reverse

Reverse

Reverse the list sort order

boolean

true

error

count

Count

The number of posts to display

string

error

years

Years

Display nesting by year

boolean

true

error

months

Months

Display nesting by months

boolean

true

error

days

Days

Display nesting by days

boolean

false

error

posts

Posts

Display posts

boolean

true

error

excerpt

Excerpt

Display post excerpts

boolean

true

error

none

None

The text to display when no posts are found

string

error

flag

Flag

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

string

error

notflag

Not Flag

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

string

error

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

blog arch 01

Advanced Example

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

blog arch 02