This documentation has moved. For the most recent documentation, check out https://docs.adaptavist.com. Please update your bookmarks and links.

Skip to end of metadata
Go to start of metadata

ThemeBuilder Macro - Blog Archive

blog-archive

Creates a nested list of blogposts

Categories: navigation

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

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