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 List

blog-list

Creates a list of blogposts and excerpts

Categories: navigation

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)

 

Basic 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