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 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 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 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