[All Adaptavist Apps]
Page History
...
The blog-archive macro is
| Excerpt |
|---|
used to display a nested list of blog posts and optionally excerpts. |
Usage
| Code Block |
|---|
{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
Wiki Markup Add the \{blog-archive} macro to a page or panel where you want to display a list of blog posts {code} {blog-archive:count=7} {code} Which gives: {blog-archive:count=7}
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
...
| Code Block |
|---|
{blog-archive:count=7|years=false|months=false|days=false|reverse=false}
|
...
Which
...
gives:
CSS Customisation
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.
Frequently Asked Questions
...
Overview
Community Forums
Content Tools
Apps