Annual Documentation Survey

Do you have 4 minutes to help us improve our documentation? Please take our annual survey!

Skip to end of metadata
Go to start of metadata

ThemeBuilder Macro - Blog Roll

blog-roll

Displays a list of spaces that contain blog-posts

Usage

Storage Format

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

Wiki Markup

{blog-roll:parameter=value}

Parameter

Name

Description

Type

Default

Required

space

Space

The list of spaces to search for posts in

spacekey

 

(error)

label

Label

Only display posts with one of the listed labels

string

 

(error)

author

Author

Only display posts by the named authors

string

 

(error)

ount

Count

The number of posts to display

string

 

(error)

none

None

The text to display when no posts are found

string

 

(error)

class

CSS Class

The css class to add to the outer list

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 list of all spaces that have blog posts.

<ac:macro ac:name="blog-roll" />
{blog-roll}

Result

 

Advanced Example

Display a list of spaces that have blog posts by a certain author

<ac:macro ac:name="blog-roll">
  <ac:parameter ac:name="author">felix</ac:parameter>
</ac:macro>
{blog-roll:author=felix}

 

Result