This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Blog Posts Macro

Added by Vidya Madabushi, last edited by Sarah Maddox on Jul 30, 2008  (view change) show comment
All Versions
Click for all versions
Confluence 2.9 Documentation

Index

The Blog Posts Macro allows you to display news items within a page. Clicking on a title takes you to the news item.

Blog Posts Macro

What you need to type What you will get
{blog-posts}
Monday, June 25, 2007

To demonstrate linking to a news item.

Posted at Jun 25, 2007 by Rosie Jameson | 6 comments
Sunday, September 25, 2005

Confluence 1.4.4 is a maintenance release that resolves some issues users may have encountered using Confluence 1.4 or higher. It fixes approximately 40 issues, including making the dynamic uploading of plugins significantly more reliable.

1.4.4 is a free upgrade for all customers who purchased their Confluence license after September 23, 2004. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Sep 25, 2005 by Charles Miller | 0 comments
Thursday, June 2, 2005
Last changed Jun 02, 2005 09:00 by Charles Miller

Confluence 1.4.1 is a maintenance release that resolves some issues users may have encountered using Confluence 1.4. Issues include an occasional failure to display Confluence pages, Oracle and MySQL database issues, and a slow memory-leak.

1.4.1 is a free upgrade for all customers who purchased their Confluence license after June 2nd, 2004. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Jun 02, 2005 by Charles Miller | 0 comments
Last changed Jun 02, 2005 08:51 by Charles Miller

Confluence 1.3.6 is a maintenance release which fixes a number of issues users may encounter when using Confluence 1.3 with an Oracle database. It is intended for those customers who are not yet ready to upgrade to Confluence 1.4.

Confluence 1.3.6 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, we recommend you try our free trial of Confluence 1.4.1. Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Jun 02, 2005 by Charles Miller | 0 comments
Monday, May 2, 2005
Last changed May 11, 2005 17:58 by Tom Davies

Confluence 1.4 Release Candidate 2

1.4-RC2 is now available for download here.

Confluence 1.4-RC2 is (barring some absolute disaster) the final public developer build for Confluence 1.4. It incorporates all the changes that were deployed in the private DR7 build, as well as around 60 new bug fixes and improvements.

Confluence 1.4-RC2 is being released to give Confluence customers the opportunity to test the upgrade path for their existing Confluence installation. By testing your migration with this pre-release, you can ensure that any problems you may experience will be fixed before the final 1.4 release, rather than having to rely on ad-hoc patches or wait for 1.4.1.

Who should upgrade?

While 1.4-RC2 is still pre-release software, and we do not recommend upgrading production Confluence sites until the release of 1.4-final, we would recommend any existing Confluence customer install this release on a test server, and try to import their existing Confluence data into it.

Upgrade Procedure

Upgrading Confluence should be pretty easy. If you are upgrading from Confluence 1.3 or higher, you can find instructions here. We strongly recommend that you backup your confluence.home directory and database before upgrading!

If you are upgrading from Confluence 1.2.3 or earlier, be sure to read the upgrade instructions in the Confluence 1.3 release notes.

When you first start Confluence 1.4-RC2 after upgrading, the server may take a few minutes to become fully functional. This is because Confluence is rearranging information in the database so that it can be looked up more efficiently. This will only be done the first time Confluence is started after upgrading.

New Features in Confluence 1.4-RC2

The changes made between DR7 and RC2 are mostly correctness and polish issues - major feature development on Confluence 1.4 has been completed. A few notable changes however are:

  • You can upload attachments while editing a page – from the "Insert Link" popup
  • The dynamic content-tree degrades gracefully on unsupported browsers
  • Many bugs related to PDF export (and images included in PDF exports) have been fixed
  • Ü characters in page titles no longer confuse the database
  • Text properties set via the contentPropertyManager can now be longer than 255 characters, fixing related bugs in the {tasklist} and {excerpt} macros
  • The {attachments} macro can display the list of attachments inline within a page
  • New XML-RPC and SOAP plugin types allow you to deploy web services dynamically into Confluence
  • A potential connection leak that has been causing problems for Oracle users has been fixed.

And much much more.

Posted at May 02, 2005 by Daniel Ostermeier | 0 comments
Tuesday, March 1, 2005
Last changed Mar 01, 2005 21:17 by Charles Miller

Confluence 1.3.5 is a maintenance release which fixes a number of bugs from earlier versions. It is a recommended upgrade for all customers.

Confluence 1.3.5 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Mar 01, 2005 by Charles Miller | 0 comments
Monday, February 14, 2005

Confluence 1.3.4 is a maintenance release which includes a small number of important fixes to Confluence. It is a recommended upgrade for all customers.

Confluence 1.3.4 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Feb 14, 2005 by Charles Miller | 0 comments
Friday, January 21, 2005

Confluence 1.3.2 is a maintenance release which includes 30 bug fixes and improvements which users may have noticed or requested.

Confluence 1.3.2 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Jan 21, 2005 by Nick Faiz | 0 comments
Sunday, December 19, 2004

Confluence 1.3.1 is a maintenance release that fixes some bugs that users may have encountered using Confluence 1.3.

Confluence 1.3.1 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Dec 19, 2004 by Charles Miller | 0 comments
Tuesday, November 30, 2004
Last changed Dec 01, 2004 01:39 by Charles Miller

Confluence 1.3 is now available for download. Confluence 1.3 introduces a powerful mail archive to better capture your team's communication. We've also revamped the space summary and administration pages, overhauled content indexing and referrer tracking, enhanced space permissions, and written a whole new setup wizard to make getting Confluence up and running even easier.

Be sure to read the release-notes for upgrade instructions and a detailed run-down of all the new features.

Confluence 1.3 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

More Information

Posted at Nov 30, 2004 by Charles Miller | 0 comments
Friday, October 22, 2004

Confluence 1.3-DR3 is the third of our experimental Development Releases on the road to 1.3. These snapshot builds let us deliver features more regularly to people who don't mind being on the bleeding edge, give customers early access to features they may have been waiting months for, or just let you guys see how the next major Confluence release is shaping up.

While we make an effort to ensure that we're in a stable and releasable state in time for each DR build, development releases may contain unfinished features, or interesting bugs. If you don't want to follow the development releases yourself, we'll be running the most recent DR build on on http://confluence.atlassian.com/. (We're also running our private extranet on DR3. We don't release anything we wouldn't run ourselves.)

More Information

Posted at Oct 22, 2004 by Mike Cannon-Brookes | 0 comments
Friday, September 24, 2004

Confluence 1.3-DR1 is the first of our experimental Development Releases on the road to 1.3. These snapshot builds let us deliver features more regularly to people who don't mind being on the bleeding edge, give customers early access to features they may have been waiting months for, or just let you guys see how the next major Confluence release is shaping up.

While we make an effort to ensure that we're in a stable and releasable state in time for each DR build, development releases may contain unfinished features, or interesting bugs. If you don't want to follow the development releases yourself, we'll be running the most recent DR build on on http://confluence.atlassian.com/. (We're also running our private extranet on DR1. We don't release anything we wouldn't run ourselves.)

More Information

Posted at Sep 24, 2004 by Charles Miller | 0 comments
Thursday, September 23, 2004

Confluence 1.2.2 is a maintenance release that fixes some bugs that users may have encountered using Confluence 1.2 or 1.2.1. It fixes problems with attachment downloading, text file imports and text-only emails.

Confluence 1.2.2 is a recommended upgrade for all Confluence customers, as it fixes a serious bug that can cause corrupted attachment downloads.

Confluence 1.2.2 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Sep 23, 2004 by Charles Miller | 0 comments
Thursday, September 9, 2004

It has been pointed out to us that the bicubic image scaling hint that we use in Confluence 1.2.1 is in fact ignored by all JDK's prior to version 5.0. The sole exception is Mac OS X. As such, customers upgrading to 1.2.1 will only see increased thumbnail quality if:

  1. You are running Confluence on JDK 5.0 (not recommended, since it's still a pre-release, and we haven't tested Confluence in this configuration)
  2. You are running Confluence on JDK 1.4.2 on Mac OS X

We apologise for the error.

Posted at Sep 09, 2004 by Charles Miller | 0 comments
Last changed Sep 09, 2004 20:21 by Charles Miller

Confluence 1.2.1 is a maintenance release that fixes some bugs that users may have encountered using Confluence 1.2. It incorporates improvements to performance for large Confluence installations; and fixes bugs related to the remote API, over-use of disk space, and a few annoying errors users were experiencing when setting up a new Confluence instance.

Confluence 1.2.1 is a free upgrade for any existing Confluence customer. If you're not a Confluence customer, you can download a fully functional 30-day trial, Also don't forget we offer free licenses to registered non-profit organisations and qualifying open source projects.

Further Reading

Posted at Sep 09, 2004 by Charles Miller | 0 comments

Optional Parameters

Parameter name Default Description
default parameter 15 Specify the number of posts you want to display.
content entire Specify 'content=excerpts' to display short excerpts, or 'content=titles' to display a list of posts.
time no limit
Specify from how far back in time you want items displayed, using 'h' (hours) or 'd' (days).
labels none Display posts that match the specified label(s).
spaces The current space Display posts from the specified space(s). Specify '@all' for all spaces, the space key for a global space, or '~username' for a personal space. Separate multiple space keys with commas.

Examples of Optional Parameters

1. Specify the number of posts you want displayed

{blog-posts:1}

2. Display the content in its entirety, as short excerpts, or as a list of titles

Excerpts

{blog-posts:content=excerpts}

Titles

{blog-posts:content=titles}

3. Choose from how far back in time you want items displayed

For example, "time=12h" would display those items created in the last twelve hours, and "time=7d" would show items made in the last week. (The default is no limit)

Hours

{blog-posts:time=12h}

Days

{blog-posts:time=7d}

4. Filter items using labels

  • To display content with any of the specified labels:

The following code will display items that contain either of the labels, 'atlassian' or 'confluence'

{blog-posts:labels=atlassian,confluence|}
  • To display content with all of the specified labels:

The following code will display content with both labels 'atlassian' and 'confluence'

{blog-posts:labels=atlassian,confluence|match-labels=all}

5. Filter items using spaces

  • The following code will display items from the 'Marketing' space (whose key is 'MKTG') and Joe Smith's personal space:
    {blog-posts:spaces=MKTG,~jsmith}


6. Filter items by combining parameters

The following code will display the latest 10 items in the 'Marketing' space with the label 'logo'. The items will be displayed as a list.

{blog-posts:10|labels=logo|spaces=MKT|content=titles}
RELATED TOPICS

Working with Macros
Working with News Overview

Take me back to Confluence User Guide

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.

Comments (53)

 

  1. Dec 26, 2005

    doggy mcdog says:

    Is there any way to constrain the formating of the display for this macro? It's ...

    Is there any way to constrain the formating of the display for this macro? It's pretty messy if you've got it in a list. The title, for example is huge.

    1. Jan 15, 2007

      Peter Hilton says:

      I noticed that the HTML for the Title column's heading specifies {{width="70%"}}...

      I noticed that the HTML for the Title column's heading specifies width="70%" (Confluence 2.3). This is not appropriate when the Author and Date posted column values are about the same length as the title. Web browsers are perfectly good at table layout so I don't see the point of this.

      1. Jun 15, 2007

        David Saia says:

        You can modify the width of that table header row in line 3 of \confluence\WEBIN...

        You can modify the width of that table header row in line 3 of \confluence\WEB-INF\classes\templates\macros\lastblogtitles.vm:

        <table width="99%" cellspacing="0" class="grid">
    <tr>
        <th width="70%">$action.getText("title.name")</th>
        <th>$action.getText("author.name")</th>
        <th>$action.getText("macros.blogpost.date.posted")</th>
    </tr>

        Just be sure to save the file and restart your Confluence server after making the change.

  2. Aug 15, 2006

    Thomas Crowder says:

    Hi, This macro doesnt appear to be working correctly\ it doesnt update with the ...

    Hi,

    This macro doesnt appear to be working correctly- it doesnt update with the latest posts, and sometimes skips some old ones too. It is very random in this behaviour. Any ideas?

    1. Aug 16, 2006

      Matt Ryall says:

      Thomas, that sounds like an unusual problem. Could you please raise a support re...

      Thomas, that sounds like an unusual problem. Could you please raise a support request with some screenshots and details of your problem?

      1. Aug 16, 2006

        Guy Fraser says:

        It's overcaching we've noticed the same sort of thing and so have our clients, e...

        It's over-caching - we've noticed the same sort of thing and so have our clients, eg:

        • add a new post and it doesn't show up for an hour or so
        • delete a post and it's still shown

        When the cache eventually clears down, it obviously shows the correct information, but while that cache is in place people get confused because the blog-posts macro is not accurately reflecting the actual blog posts.

    2. Apr 13, 2007

      Frederico Guth says:

      I think the reason for this random behavior is that blogpost posts news in order...

      I think the reason for this random behavior is that blog-post posts news in order of last edited... so if I edit a post of yesterday (to correct a minor error) it appears in the beggining of the list...

  3. Jan 16, 2007

    Christian Løverås says:

    Feature request: New parameter for specifying start (and stop) times,...

    Feature request: New parameter for specifying start (and stop) times, so it will be possible to list the most recent posts with excerpts and the older ones with just titles:

    h2. News the last 7 days
{blog-posts:15|time=7d|content=excerpts}

h3. News the last month (excluding the last 7 days which are listed above)
{blog-posts:15|starttime=7d|time=30d|content=excerpts}

    http://jira.atlassian.com/browse/CONF-7672

  4. Mar 22, 2007

    Christopher Christophorou says:

    Hi, is there a way to disable the link from the title of a news post when showin...

    Hi,

    is there a way to disable the link from the title of a news post when showing news with excerpts?

     Thanks,

    Chris

    1. Jun 15, 2007

      David Saia says:

      Yes. In the following file: \confluence\WEBINF\classes\templates\macros\lastblo...

      Yes. In the following file:

      \confluence\WEB-INF\classes\templates\macros\lastblogs.vm

      Comment out line 19, as follows:

      ## <div class="blogHeading"><a href="$req.contextPath$generalUtil.getPageUrl($blog)">$blog.title</a></div>

      and add the following line after it:

      <div class="blogHeading">$blog.title</div>

      Save the file and restart your Confluence server.

  5. May 22, 2007

    Ken Hancock says:

    Ditto on the request to be able to control formatting.&nbsp; I'm trying to fit t...

    Ditto on the request to be able to control formatting.  I'm trying to fit the last n blog posts in a smaller, righthand column and the title is way too large.

    1. Jun 15, 2007

      David Saia says:

      The class of the div containing the title is "blogHeading." You can redefine th...

      The class of the div containing the title is "blogHeading."

      You can redefine that CSS tag in your "Custom HTML before end of Head" at Administration ("Look and Feel" section) > Custom HTML > At end of the HEAD

      For example, if you wanted the title to appear in 11pt. Arial bold, you could redefine the title style as:

      <style type="text/css">

.blogHeading {
font-family:Arial,Helvetica,Verdana,sans-serif;
font-weight:bold;
font-size:11pt;
}

</style>

      There are other ways to tinker with the CSS, but this seems to be the simplest.

      1. Nov 28, 2007

        Mika Zeng says:

        Hi, that custom html worked fine with ver.2.5.7 , but i just upgraded ver 2.6.2 ...

        Hi, that custom html worked fine with ver.2.5.7 , but i just upgraded ver 2.6.2 and seems like that dont work any more, any ideas? 

        1. Nov 28, 2007

          Choy Li Tham says:

          Hi Mika, I would suggest you to raise a support ticket at our support system: h...

          Hi Mika,

          I would suggest you to raise a support ticket at our support system: https://support.atlassian.com so that we can follow up the issue from there. Thanks.

          Regards,
          Choy Li

          1. Nov 29, 2007

            Mika Zeng says:

            I will.\\ Thanks \MZ

            I will.

            Thanks

            -MZ

            1. Jul 08

              Anonymous says:

              Stumbled on this old problem and the answer. You need to define additional style...

              Stumbled on this old problem and the answer. You need to define additional styles:   (Not sure which ones are absolutely required yet)

               Works for ver 2.8

              .blogpost {
              font-family:Arial,Helvetica,Verdana,sans-serif;
              font-weight:bold;
              font-size:11pt;
              }

              .blogHeading {
              font-family:Arial,Helvetica,Verdana,sans-serif;
              font-weight:bold;
              font-size:11pt;
              }

              .blogpost .blogHeading {
              font-family:Arial,Helvetica,Verdana,sans-serif;
              font-weight:bold;
              font-size:11pt;
              }

  6. Jun 18, 2007

    Rosie Jameson says:

    Perhaps you might like to log your suggestions in the Confluence project at

    Perhaps you might like to log your suggestions in the Confluence project at http://jira.atlassian.com, and/or vote for the following issue? http://jira.atlassian.com/browse/CONF-4740; -- Many thanks.

  7. Nov 24, 2007

    Anonymous says:

    Can someone please tell me how to modify the format of news in 2.6.0? &nbsp;I se...

    Can someone please tell me how to modify the format of news in 2.6.0?

     I see the \confluence\WEB-INF\classes\templates\macros\lastblogs.vm file in my older version of Confluence, but in the newest version, this is all that's in the \confluence\WEB-INF\classes directory:

    -rw-r-r-  1 lsnaphilly vuser 2326 Sep 26 21:04 atlassian-user.xml
    drwxr-xr-x  3 lsnaphilly vuser 4096 Sep 26 21:04 com
    -rw-r-r-  1 lsnaphilly vuser 1024 Oct 23 20:37 confluence-init.properties
    -rw-r-r-  1 lsnaphilly vuser 2856 Sep 26 21:04 crowd-ehcache.xml
    -rw-r-r-  1 lsnaphilly vuser  344 Sep 26 21:04 crowd.properties
    -rw-r-r-  1 lsnaphilly vuser 8833 Sep 26 21:04 log4j.properties
    -rw-r-r-  1 lsnaphilly vuser 2741 Sep 26 21:04 osuser.xml
    -rw-r-r-  1 lsnaphilly vuser 1577 Sep 26 21:04 seraph-config.xml
    -rw-r-r-  1 lsnaphilly vuser  165 Sep 26 21:04 seraph-paths.xml

    I've looked everywhere and I'm completely stumped on how to do this now.

    Thanks,
    Mark