Skip to end of metadata
Go to start of metadata

{blog-archive} Macro

(warning) Under Consruction

Description

The blog-archive macro isused 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

(error)

@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

(error)

n/a

A list of team labels that can be used to filter the list of blog posts

 

3.3.5

author

(error)

n/a

A comma separated list of usernames/group names/@self/@creator/@owner

 

3.3

sort

(error)

creation

The order that the posts should be listed in (creation/modified/recent)

 

3.2

reverse

(error)

true

List the blogposts in reverse order (oldest first)

 

3.2

count

(error)

n/a

The number of posts that should be displayed.

 

3.2

start

(error)

0

Offset from the start for listing the posts.

 

3.2

years

(error)

true

Nest the list of blogposts by year (true/false)

 

3.2

months

(error)

true

Nest the list of blogposts by month (true/false)

 

3.2

days

(error)

true

Nest the list of blogposts by month (true/false)

 

3.2

posts

(error)

true

Display the individual posts (true/false)

 

3.2

excerpt

(error)

true

Display the excerpt of the blogpost (true/false/full)

 

3.2

none

(error)

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:

 

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.

 

 

 

 

  • No labels

9 Comments

  1. Unknown User (davidchapmanattpt)

    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.

    1. Yes, we added this capability to Builder 3.3.5-M3

      1. Unknown User (ville.valtasaari@thl.fi)

        so label(s)=xxx,yyy works?

        r. Ville

        1. Unknown User (ville.valtasaari@thl.fi)

          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

          1. Anything is possible, it's just that some things need to be paid for (wink)

            1. Unknown User (ville.valtasaari@thl.fi)

              That's what the SharePoint people said and it turned out to be only half true (wink)

              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.

  2. Unknown User (aho@qps.nl)

    Is it possible to get the css files to get the same layout as in your first example?

    1. Unknown User (scayla)

      I was wondering the same, but firebug is my friend, just enough (wink)

  3. Unknown User (jnevin)

    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}