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 |
|
space | Space | A comma-separated list of spaces whose posts should be listed (SPACEKEY/@all/@current/@favourite/@global/@personal) | spacekey | @current |
|
label | Labels | A comma-separated list of labels that are used to filter the list of blogposts | string |
| |
author | Authors | A comma-separated list of authors that are used to filter the list of blogposts - usernames/group names/@self/@creator/@owner | string |
| |
sort | Sort Order | The order that the posts should be listed in (creation/modified/recent - default creation) | enum | recent |
|
reverse | Reverse | List the blogposts in reverse order (default=true - oldest first) | boolean | true |
|
count | Count | The number of posts that should be displayed (default = all) | string |
| |
title | Show Title | Display the blog titles | boolean | false |
|
linktitle | Link Title | Link the titles to the blog post | boolean | false |
|
excerpt | Excerpt | Display the post excerpt | boolean | false |
|
fullExcerpt | Full Excerpt | Display the full content of the post | boolean | false |
|
showDate | Show Date | Display the date that the post was made | boolean | false |
|
showPostedBy | Show Posted-by | Show the postedby details | boolean | false |
|
showPostedByDate | Show Posted-by date | Include the date in the postedby details | boolean | false |
|
permalink | Permalink | Show a permalink | boolean | false |
|
postedByCaption | Posted By Caption | The caption for the postedby details | boolean | false |
|
comment | Comment Count | The text prefixing the comment count | string |
| |
none | None | Text to display when no posts have been 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 |
|
Example
Below is an example of showing 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
