Listing Blog Post Summaries

Scenario

There may be cases where you may want to aggregate blogposts on a Confluence instance in a page. By using the Content Reporter, you can do exactly that.

This recipe lists all blog posts from all spaces together with their summaries.

Result

Recipe

Apps	Reporting for Confluence Server & Data Center
Level	Easy
Estimated time	10 minutes
Macros	Content Reporter, Report Column, Report Info, Report Table
Suppliers	Content Supplier

Storage format

You can copy and paste this code into the Confluence Source Editor:

<p class="auto-cursor-target">
  <br />
</p>
<ac:structured-macro ac:macro-id="0b2be6c8-38eb-4af6-abb6-012725a2f155" ac:name="report-table" ac:schema-version="1">
  <ac:rich-text-body>
    <p class="auto-cursor-target">
      <br />
    </p>
    <ac:structured-macro ac:macro-id="b6cfc5f2-c305-41b5-ad70-e34cd24e9945" ac:name="content-reporter" ac:schema-version="1">
      <ac:parameter ac:name="type">news</ac:parameter>
      <ac:parameter ac:name="space">
        <ri:space ri:space-key="@all" />
      </ac:parameter>
      <ac:rich-text-body>
        <p>
          <br />
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <p class="auto-cursor-target">
      <br />
    </p>
    <ac:structured-macro ac:macro-id="4f26c099-76b6-48b7-9895-1cbd9ae29341" ac:name="report-column" ac:schema-version="1">
      <ac:parameter ac:name="title">Blog Posts</ac:parameter>
      <ac:rich-text-body>
        <p>
          <ac:structured-macro ac:macro-id="815283b4-ec94-470a-83c0-4455a25d47a0" ac:name="report-info" ac:schema-version="1">
            <ac:parameter ac:name="">content:title</ac:parameter>
          </ac:structured-macro>
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <p class="auto-cursor-target">
      <br />
    </p>
    <ac:structured-macro ac:macro-id="00b2b5ba-dd44-47bb-91f2-cfd0d8710b82" ac:name="report-column" ac:schema-version="1">
      <ac:parameter ac:name="title">Summaries</ac:parameter>
      <ac:rich-text-body>
        <p>
          <ac:structured-macro ac:macro-id="43389236-d09a-4cc3-83e9-d47c90f5acf7" ac:name="report-info" ac:schema-version="1">
            <ac:parameter ac:name="">content:summary</ac:parameter>
          </ac:structured-macro>
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <p class="auto-cursor-target">
      <br />
    </p>
  </ac:rich-text-body>
</ac:structured-macro>
<p class="auto-cursor-target">
  <br />
</p>

Macro structure

You can recreate the example in the editor view:

Steps

Line	Description
1	The report will be formatted as a table with Report Table.
2	Content Reporter is used retrieve all blogs from all spaces, with spaces parameter is set to '@all', and type parameter set to 'news'.
3	Two columns is created Report Column, with title set accordingly.
4	Name of each blog retrieved from Content Reporter is displayed via Report Info, setting supplier key to 'Content Supplier'.
5	Summary of each blog retrieved from Content Reporter is displayed via Report Info, setting supplier key to 'Content Supplier'

Line-by-Line Explanation

N/A