[All Adaptavist Apps]
Page History
{blog-list} Macro
Under Construction
Description
The blog-list macro is
| Excerpt |
|---|
used to display a list of blog posts and excerpts. |
Usage
| Code Block |
|---|
{blog-list}
|
Parameters
he The "Ver" column shows which version of Theme Builder the parameter became available in.
Property | Required | Default | Notes | Theme Panels Only | Ver |
|---|---|---|---|---|---|
default |
| singlespace | Display mode. (singlespace/multispace) |
| 3.2 |
space |
| @current | 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. |
| 3.02 |
teamslabel |
| n/a | A list of team labels that can be used to filter the list of spacesblog posts |
| 3.23.5 |
author |
| n/a | A list of authors that can be used to filter the list of blog postscomma separated list of usernames/group names/@self/@creator/@owner |
| 3.3 |
sort |
| creation | The order that the posts should be listed in (creation/modified/recent) |
| 3.2 |
reverse |
| false | List the blogposts in reverse order |
| 3.2 |
count |
| 9 | The number of posts that should be displayed. |
| 3.2 |
start |
| 0 | Offset from the start for listing the posts. |
| 3.2 |
dateFormat |
| defined by confluence settings | Format that dates should be displayed in |
| 3.2 |
date |
| false | Show the Date of the blogpost. |
| 3.2 |
title |
| true | Show the Title of the blogpost. |
| 3.2 |
linktitle |
| true | Link the title to the blogpost |
| 3.2 |
excerpt |
| true | Display the excerpt of the blogpost (true/false/full) |
| 3.2 |
postedby |
| true | Display the date that the post was created (true/false/date). |
| 3.2 |
permalink |
| n/a | Text to use for posted by |
| 3.2 |
postedByCaption |
| n/a | Text to use for posted by. |
| 3.2 |
none |
| n/a | Text to display when no posts have been found |
| 3.2 |
Examples
Basic Use
...
Add
the
\{blog-list}
macro
to
a
page
or
panel
where
you
want
to
display
a
list
of
blog
posts
{
Code Block
Display blog posts for the whole site
...
(including personal spaces)
To display blogs for all spaces set the display mode to multispace (so that the space the blog originated in is displayed), and set the spaces parameter to @all
Code Block {Wiki Markup
Display blog posts for
...
just global spaces
...
(whole site, no personal spaces)
To display blogs for global spaces set the display mode to multispace (so that the space the blog originated in is displayed), and set the spaces parameter to @global
Code Block Wiki Markup
Display title, excerpt & date
Code Block
Display just the blog titles
Only display titles
Code Block {Wiki Markup
Just remove the permalink
Code Block {blog-list:count=3|postedby=false|excerpt=false|permalink=}
CSS Customisation
To follow
Hints and Tips
permalink=}
Show the date the post was made
Code Block {blog-list:count=3|date=true}
CSS Customisation
The standard output follows this structure
| Code Block |
|---|
<div class="bloglist default">
<div class="post">
<div class="date"><span>Jun 01, 2009 23:30</span></div>
<div class="permalink"><a href="$bloglisthelper.getTinyURL($post)">Permalink</a></div>
<div class="title">
<a href="http://www.mysite.com/x/Goy9Ag">This is the blogpost title</a>
</div>
<div class="excerpt"><span>The excerpt of the blogpost will be shown here</span></div>
<div class="postedby">Posted by Test User on Jun 01, 2009 23:30 </div>
<div class="commentcount">Comments (5)</div>
</div>
</div>
|
Hints and Tips
When excepts are enabled, the macro will output a block of content taken from the top of your blog posts. If you need more control over the excerpts, consider using the excerpt macroNone at present.
Frequently Asked Questions
None at present.
Overview
Community Forums
Content Tools
Apps