.png)
{blog-archive} Macro
Under Consruction
Description
The blog-archive macro is used to display a nested list of blog posts and optionally excerpts....
Usage
{blog-archive}
Parameters
he "Ver" column shows which version of Theme Builder the parameter became available in.
| Property | Required | Default | Notes | Theme Panels Only | Ver |
|---|---|---|---|---|---|
| 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.0 | |
| 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 | |
true | List the blogposts in reverse order (oldest first) | 3.2 | |
| count | |
n/a | The number of posts that should be displayed. | 3.2 | |
| start | |
0 | Offset from the start for listing the posts. | 3.2 | |
| years | |
true | Nest the list of blogposts by year (true/false) | 3.2 | |
| months | |
true | Nest the list of blogposts by month (true/false) | 3.2 | |
| days | |
true | Nest the list of blogposts by month (true/false) | 3.2 | |
| posts | |
true | Display the individual posts (true/false) | 3.2 | |
| excerpt | |
true | Display the excerpt of the blogpost (true/false/full) | 3.2 | |
| none | |
n/a | Text to display when no posts have been found | 3.2 |
Examples
Basic Use
Add the {blog-archive} macro to a page or panel where you want to display a list of blog posts
{blog-archive:count=7}Which gives:
- 2007
- December
2008
- January
February
Just list the blog posts, most recent first
To display A list of blog posts without the nesting, set the years/months/days to false and revent the list from being reversed
{blog-archive:count=7|years=false|months=false|days=false|reverse=false}Which gives:
CSS Customisation
To follow
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.
Comments (9)
Jul 18, 2009
David Chapman says:
Are there any plans to allow using labels for filtering? We're looking at pulli...Are there any plans to allow using labels for filtering?
We're looking at pulling all spaces down but filtering by a label for the front page blog on our intranet. This macro displays it how we would like but can't currently use it because of this limitation.
Jul 19, 2009
Alain Moran says:
Yes, we added this capability to Builder 3.3.5-M3Yes, we added this capability to Builder 3.3.5-M3
Sep 09, 2009
Ville Valtasaari says:
so label(s)=xxx,yyy works? r. Villeso label(s)=xxx,yyy works?
r. Ville
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 17, 2009
Alain Moran says:
Anything is possible, it's just that some things need to be paid forAnything is possible, it's just that some things need to be paid for
Sep 18, 2009
Ville Valtasaari says:
That's what the SharePoint people said and it turned out to be only half true ...That's what the SharePoint people said and it turned out to be only half true
But seriously, point taken. Shouldn't be ungrateful. I think we'll be able to do wonderful things for our Intranet with Builder and Bubbles. Good of you to give them out for free.
Paying might not be out of the question if we run into something we want/need bad enough. Depends on whether we have the resources to do it ourselves.
The label functionality in this macro is actually ok for us for now as it allows multiple labels and defaults to OR. The one thing I would characterise as bug is that each of the specified labels has to represented, otherwise you get a message about missing labels instead of the listing.
I'd be interested in css-customisation instructions.
Nov 12, 2009
Almar Hollaar says:
Is it possible to get the css files to get the same layout as in your first exam...Is it possible to get the css files to get the same layout as in your first example?
Nov 25, 2009
Steeve Cayla says:
I was wondering the same, but firebug is my friend, just enoughI was wondering the same, but firebug is my friend, just enough
Jun 02, 2010
James Nevin says:
Note: as with the blog-list macro, the blog-archive macro now takes the "label" ...Note: as with the blog-list macro, the blog-archive macro now takes the "label" parameter for filtering by regular labels. The parameter is "label" - singular, not plural. It will take multiple labels separated by a comma, as in:
{blog-archive:label=case-studies,strategy-pov}