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

Ingredients

Add-ons	Reporting
Platform
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'