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
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 its 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 should be listed in (creation/modified/recent/title - default creation)	enum	creation
reverse	Reverse	Reverse the list sort order	boolean	true
count	Count	The number of posts to display (default = 10)	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 that 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 displaying a list of blog posts from the space Builder without nesting on years/months/days and preventing 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