See [Them...
{blog-list} Macro
Description
The blog-list macro is used to display a list of blog posts and excerpts....
Usage
{blog-list}
Parameters
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.2 | ||
| label | n/a | A list of team labels that can be used to filter the list of blog posts | 3.3.5 | ||
| author | n/a | A comma 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
{blog-list}Which gives:
These releases (4.1.3 for Confluence 3.3 and 4.0.4 for Confluence 3.1 - 3.2.1) introduce an update to the administration pages. A much cleaner look and feel, and massive speed and browser compatibility improvements to the Manage Spaces and Link Aliases tables.Posted by Mark GibsonThe Builder 4.1.1 release is now available for download. This release fixes a bug with viewing the manage layouts and builder admin interface in Confluence 3.3.Posted by Shannon KrebsBuilder 3.3.6 has been released and is available here: DownloadsMore information can be found on the Builder 3.3.6 release notes paqe.
Posted by Alain Moran
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
{blog-list:multispace|space=@all}Which gives:
Collaboration is working together to achieve a goal and sharing knowledge, learning and building consensus achieve it. Confluence helps with this as it makes creating rich, informative content easy. However, just creating content isn't enough on its own, in order to improve collaboration this content must be available to the right people at the right time. In short, it must be discoverable. Confluence has a number of ways in which it helps you with this and here are a few tips on how to make the most of them for you and your users.Posted by Gareth Wilson in Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support services
*As I mentioned recently about HipChat, developers love their Keyboard shortcuts. JIRA has its own fair share too to speed up the routine tasks within JIRA. Here's the ten JIRA keyboard shortc...
Posted by Gareth Wilson in Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support servicesAfter Atlassian's recent acquisition of HipChat, the hosted private group chat service, we have been using it internally and I wanted to share a few top tips to help you get the most out of it.Posted by Gareth Wilson in Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support services
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
{blog-list:multispace|space=@global}Which gives:
Collaboration is working together to achieve a goal and sharing knowledge, learning and building consensus achieve it. Confluence helps with this as it makes creating rich, informative content easy. However, just creating content isn't enough on its own, in order to improve collaboration this content must be available to the right people at the right time. In short, it must be discoverable. Confluence has a number of ways in which it helps you with this and here are a few tips on how to make the most of them for you and your users.Posted by Gareth Wilson in Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support services
*As I mentioned recently about HipChat, developers love their Keyboard shortcuts. JIRA has its own fair share too to speed up the routine tasks within JIRA. Here's the ten JIRA keyboard shortc...
Posted by Gareth Wilson in Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support servicesAfter Atlassian's recent acquisition of HipChat, the hosted private group chat service, we have been using it internally and I wanted to share a few top tips to help you get the most out of it.Posted by Gareth Wilson in Adaptavist - Atlassian consultants specialising in Confluence and JIRA plugins, training, hosting and support services
Display title, excerpt & date
{blog-list:count=3|postedby=date|permalink=}Which gives:
These releases (4.1.3 for Confluence 3.3 and 4.0.4 for Confluence 3.1 - 3.2.1) introduce an update to the administration pages. A much cleaner look and feel, and massive speed and browser compatibility improvements to the Manage Spaces and Link Aliases tables.See [Them...
Posted by Mark Gibson on Aug 18, 2010 09:36The Builder 4.1.1 release is now available for download. This release fixes a bug with viewing the manage layouts and builder admin interface in Confluence 3.3.Posted by Shannon Krebs on Jul 14, 2010 00:17Builder 3.3.6 has been released and is available here: DownloadsMore information can be found on the Builder 3.3.6 release notes paqe.
Posted by Alain Moran on Dec 11, 2009 15:49
Only display titles
{blog-list:count=3|postedby=false|excerpt=false|permalink=}Which gives:
Just remove the permalink
{blog-list:count=3|permalink=}Which gives:
These releases (4.1.3 for Confluence 3.3 and 4.0.4 for Confluence 3.1 - 3.2.1) introduce an update to the administration pages. A much cleaner look and feel, and massive speed and browser compatibility improvements to the Manage Spaces and Link Aliases tables.See [Them...
Posted by Mark GibsonThe Builder 4.1.1 release is now available for download. This release fixes a bug with viewing the manage layouts and builder admin interface in Confluence 3.3.Posted by Shannon KrebsBuilder 3.3.6 has been released and is available here: DownloadsMore information can be found on the Builder 3.3.6 release notes paqe.
Posted by Alain Moran
Show the date the post was made
{blog-list:count=3|date=true}Which gives:
Aug 18, 2010 09:36These releases (4.1.3 for Confluence 3.3 and 4.0.4 for Confluence 3.1 - 3.2.1) introduce an update to the administration pages. A much cleaner look and feel, and massive speed and browser compatibility improvements to the Manage Spaces and Link Aliases tables.See [Them...
Posted by Mark GibsonJul 14, 2010 00:17The Builder 4.1.1 release is now available for download. This release fixes a bug with viewing the manage layouts and builder admin interface in Confluence 3.3.Posted by Shannon KrebsDec 11, 2009 15:49Builder 3.3.6 has been released and is available here: DownloadsMore information can be found on the Builder 3.3.6 release notes paqe.
Posted by Alain Moran
CSS Customisation
The standard output follows this structure
<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 macro.
Frequently Asked Questions
None at present.
.png)








Comments (14)
Sep 18, 2008
Guy Fraser says:
@Emma - check with Alain which version of Builder this macro was added in - it c...@Emma - check with Alain which version of Builder this macro was added in - it certainly wasn't 3.0, it was 3.2 or something like that.
Sep 17, 2009
Ville Valtasaari says:
The blog-calendar, -list and -archive macros would be just perfect if they inclu...The blog-calendar, -list and -archive macros would be just perfect if they included the labels option with boolean AND and OR. That would allow us to have blogs/news of several categories in a single space.
r. Ville
Sep 24, 2009
Chas Emerick says:
A couple things: postedby's default value of true doesn't seem to do anything...A couple things:
It's great to have proper permalinks on the blog post listings now!
Thanks,
Sep 30, 2009
Chas Emerick says:
It appears that blog-list does not hide posts whose published date is in the fut...It appears that blog-list does not hide posts whose published date is in the future. I'd assume that that's a bug...
Sep 30, 2009
Guy Fraser says:
I didn't think Confluence allowed blog posts dates set in the future?I didn't think Confluence allowed blog posts dates set in the future?
Sep 30, 2009
Chas Emerick says:
Interesting...apparently, no, it's not supposed to (though I didn't know that 10...Interesting...apparently, no, it's not supposed to (though I didn't know that 10 min ago). If you choose a date in the past (say, Sept. 1st), and then click over to the next month, the month will be changed, leaving the day in place (giving us a publish date of Oct 1st).
So, an issue with Confluence's date picker, rather than with blog-list.
Sep 30, 2009
Alain Moran says:
Interesting ... so the door is open for me to create an action which abuses the ...Interesting ... so the door is open for me to create an action which abuses the API and allows you to pick dates in the future to use the blog functionality for planning meetings
Oct 01, 2009
Ville Valtasaari says:
Abuse it some more to allow for scheduled publishing r. VilleAbuse it some more to allow for scheduled publishing
r. Ville
Jun 02, 2010
James Nevin says:
Note that the Parameters documentation is incorrect: To filter by regular label...Note that the Parameters documentation is incorrect:
To filter by regular label(s), use the parameter "label", eg
{blog-list:date=true|label=case-studies,strategy-pov|permalink=Bookmark Link}Jun 03, 2010
Alain Moran says:
The confluence notation guide is always your most upto date reference, this html...The confluence notation guide is always your most upto date reference, this html documentation tends to lag a little behind the current state of play.
Jan 28, 2011
Andrew says:
The documentation lacks an example for author, and I'm not sure what it means by...The documentation lacks an example for author, and I'm not sure what it means by "username". I have users whose full name includes ", Administrator" (dunno why), and it seems to ignore the author parameter entirely.
Jan 30, 2011
Alain Moran says:
Your username is abarnes, does that help at all?Your username is abarnes, does that help at all?
Jan 31, 2011
Andrew says:
How are you, as a unprivileged user, retrieving that username?How are you, as a unprivileged user, retrieving that username?
Jan 31, 2011
Sharon Hinde says:
If you hover over your name Andrew it will show as the link url .../~abarnes as ...If you hover over your name Andrew it will show as the link url .../~abarnes as it goes to your profile. This is your username (unique name reference) within Confluence, the one you use to sign in if needed.