Under Consruction
Under Consruction
The blog-archive macro is
used to display a nested list of blog posts and optionally excerpts. |
{blog-archive}
|
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 |
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:
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:
To follow
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.
None at present.
