ThemeBuilder for Confluence Server and DC

Blog List

This macro is used to create a list of blog posts and excerpts.

Usage

Storage Format

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

Wiki Markup

{blog-list:parameter=value}
Parameter Name Description Type Default Required

display

Display mode

Select either singlespace or multispace (default - singlespace)

enum

singlespace

error

space

Space

A comma separated list of spaces whose posts should be listed (SPACEKEY/@all/@current/@favourite/@global/@personal)

spacekey

@current

error

label

Labels

A comma separated list of labels that are used to filter the list of blogposts

string

error

author

Authors

A comma separated list of authors that are used to filter the list of blogposts - usernames/group names/@self/@creator/@owner

string

error

sort

Sort Order

The order that the posts should be listed in (creation/modified/recent - default creation)

enum

recent

error

reverse

Reverse

List the blogposts in reverse order (default=true - oldest first)

boolean

true

error

count

Count

The number of posts that should be displayed (default = all)

string

error

title

Show Title

Display the blog titles

boolean

false

error

linktitle

Link Title

Link the titles to the blog post

boolean

false

error

excerpt

Excerpt

Display the post excerpt

boolean

false

error

fullExcerpt

Full Excerpt

Display the full content of the post

boolean

false

error

showDate

Show Date

Display the date that the post was made

boolean

false

error

showPostedBy

Show Posted-by

Show the postedby details

boolean

false

error

showPostedByDate

Show Posted-by date

Include the date in the postedby details

boolean

false

error

permalink

Permalink

Show a permalink

boolean

false

error

postedByCaption

Posted By Caption

The caption for the postedby details

boolean

false

error

comment

Comment Count

The text prefixing the comment count

string

error

none

None

Text to display when no posts have been 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

Example

Show a list of blog posts from all spaces.

<ac:macro ac:name="blog-list">
<ac:parameter ac:name="display">singlespace</ac:parameter>
<ac:parameter ac:name="space">@all</ac:parameter>
</ac:macro>
{blog-list:singlespace|space=@all}

Result

blog list 01