Part 8 - Creating the project space homepage

Owned by
Li Xuan Liew (Deactivated)
Last updated: Oct 13, 2023 by
Robert Alexander Marshall
30 min read
1 Overview | 2 Homepage creation | 3 Project details structure | 4 Subprojects in this space structure | 5 Project members structure | 6 Full source

Overview

The previous steps have created the sub-projects and we have multiple dashboards built using Reporting, it's time to bring everything together in the homepage.

Homepage creation

In the Confluence editor on the space homepage

  • choose Page Layout

  • select three column section

These sections will be populated as below.

First section

Project Overview

  • create a header called Project Overview

  • insert a text-area block underneath the header

  • edit the text-area block to set

    • Type to area

    • Content Type to richtext

Second section

Project Dashboards

  • create a header called Project Dashboards

  • add the links to Reporting dashboards underneath this header

Project Overview

  • insert a header called Project Details

  • insert a 2 x 5 table

This table will contain information about the project's start and end dates.

For the first three rows in the table

  • name the headers

    • Start Date

    • End Date

    • Launch Date

  • insert a date-data block for each of these first three rows

    • set the Format to dd MMMM yy

In the next row

  • name the header Number of subprojects

  • insert a report-block in this row

  • insert a content-reporter block inside the report-block

    • set Types to page

  • insert a text-filter inside the content-reporter block

    • name the Key content:title

    • set Exact Value Cafe Rockettoria Projects

  • insert a report-body block under content-reporter

  • insert a report-info block under report-body.

  • edit the report-info block

    • name the Key page:children > collection:size

What does this mean?

The content-reporter block returns the page titled Cafe Rockettoria Projects - the name of the parent page for sub-projects.

In report-info the page object returns its children (subprojects) and is paired with a collection:size keychain to determine the number of children (subprojects) under Cafe Rockettoria Projects

In the next row

  • name the header Overall Status

  • insert a list-data block

    • name it Overall Status

Inside the list-data block

  • insert four list-option blocks

  • label these list-options as

    • Unstarted

    • In Progress

    • Awaiting Approval

    • Completed

Recently Updated

  • create a header called Recently Updated

  • insert a Recently Updated macro underneath it.

Third section

Search This Project

  • create a header called Search This Project

  • insert a Livesearch  macro underneath this header

  • edit the Livesearch macro

    • set the Size to medium

Subprojects in This Space

  • create a header called Subprojects in this space

  • insert a report-list block

  • insert a content-reporter block inside report-list

    • edit the content-reporter and set

      • Type to page

      • Labels to subproject

  • insert a text-sort block inside content-reporter

    • name the Key content:title

Underneath this content-reporter block

  • insert a report-body block

  • insert a report-info block inside report-body

  • edit the report-info block

    • name the Key content:title

    • check Link To Item

Project Members 

  • create a header called Project members

  • insert a report-list block

  • insert a user-reporter block inside report-list

  • edit the user-reporter and set

    • Groups to pmd-project-leaders, pmd-project-members

Inside the user-reporter block

  • insert a text-sort block

    • name the Key user:full name

Under the user-reporter block

  • insert a report-body block

  • insert a report-info block

  • edit the report-info block

    • name the Key user:full name

    • check Link To Item

Project details structure

Project Details source
<div class="content-wrapper"> <p> <ac:structured-macro ac:macro-id="3a3d79d7-e240-46f2-8ff1-a73bf1534537" ac:name="list-data" ac:schema-version="1"> <ac:parameter ac:name="name">Overall Status</ac:parameter> <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter> <ac:rich-text-body> <ac:structured-macro ac:macro-id="bc5aef71-f6de-4cf3-8099-86feccbbea00" ac:name="list-option" ac:schema-version="1"> <ac:parameter ac:name="sortValue">1</ac:parameter> <ac:parameter ac:name="label">Unstarted</ac:parameter> <ac:parameter ac:name="value">Unstarted</ac:parameter> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="1dc308a4-d0b0-4611-a03a-87fa7f8141ce" ac:name="status" ac:schema-version="1"> <ac:parameter ac:name="colour">Grey</ac:parameter> <ac:parameter ac:name="title">Unstarted</ac:parameter> <ac:parameter ac:name=""/> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> <ac:structured-macro ac:macro-id="5053a7df-450f-4b38-ad46-bad0111b4186" ac:name="list-option" ac:schema-version="1"> <ac:parameter ac:name="sortValue">2</ac:parameter> <ac:parameter ac:name="label">In progress</ac:parameter> <ac:parameter ac:name="value">In progress</ac:parameter> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="27c86cda-4642-4289-b044-05efd23bcd3f" ac:name="status" ac:schema-version="1"> <ac:parameter ac:name="colour">Yellow</ac:parameter> <ac:parameter ac:name="title">In Progress</ac:parameter> <ac:parameter ac:name=""/> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> <ac:structured-macro ac:macro-id="d9124413-7181-4b77-ac38-3e72539eb4d2" ac:name="list-option" ac:schema-version="1"> <ac:parameter ac:name="sortValue">3</ac:parameter> <ac:parameter ac:name="label">Awaiting approval</ac:parameter> <ac:parameter ac:name="value">Awaiting approval</ac:parameter> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="e8fa6644-a9fe-486e-9973-47d3ba0f1b1f" ac:name="status" ac:schema-version="1"> <ac:parameter ac:name="colour">Blue</ac:parameter> <ac:parameter ac:name="title">Awaiting Approval</ac:parameter> <ac:parameter ac:name=""/> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> <ac:structured-macro ac:macro-id="d401ff0b-6e1e-4e8d-85a8-f79c9dc53a79" ac:name="list-option" ac:schema-version="1"> <ac:parameter ac:name="sortValue">4</ac:parameter> <ac:parameter ac:name="label">Completed</ac:parameter> <ac:parameter ac:name="value">Completed</ac:parameter> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="18c4d013-92c7-4465-99b0-ac373d968a5c" ac:name="status" ac:schema-version="1"> <ac:parameter ac:name="colour">Green</ac:parameter> <ac:parameter ac:name="title">Completed</ac:parameter> <ac:parameter ac:name=""/> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> </ac:rich-text-body> </ac:structured-macro> </p> </div>

 

Subprojects in this space structure

Subprojects in this space source
<div class="content-wrapper"> <p> <ac:structured-macro ac:macro-id="fe320223-7bb7-4119-bded-8770260e9b67" ac:name="report-block" ac:schema-version="1"> <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter> <ac:rich-text-body> <ac:structured-macro ac:macro-id="21c856ca-3d77-45f5-8806-6eaef43b90b3" ac:name="content-reporter" ac:schema-version="1"> <ac:parameter ac:name="types">page</ac:parameter> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="bd79874b-a5e2-4eaa-890e-c7746396a761" ac:name="text-filter" ac:schema-version="1"> <ac:parameter ac:name="value">Cafe Rockettoria Projects</ac:parameter> <ac:parameter ac:name="">content:title</ac:parameter> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> <ac:structured-macro ac:macro-id="ee86ee1d-5e5d-4c2b-83c9-d962f6427792" ac:name="report-body" ac:schema-version="1"> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="b4f1590b-0f22-4563-a846-96ffc095bf5f" ac:name="report-info" ac:schema-version="1"> <ac:parameter ac:name="">page:children &gt; collection:size</ac:parameter> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> </ac:rich-text-body> </ac:structured-macro> </p> </div> 

 

Project members structure

Project Members source
<ac:structured-macro ac:macro-id="34e4560b-12e7-431f-bca8-e684092dd74f" ac:name="report-list" ac:schema-version="1"> <ac:rich-text-body> <ac:structured-macro ac:macro-id="c414d93c-c493-466f-913c-7c1346ad0ab5" ac:name="user-reporter" ac:schema-version="1"> <ac:parameter ac:name="groups">pmd-project-members, pmd-project-leaders</ac:parameter> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="d1f96720-3838-476b-9cd7-c15e433a1209" ac:name="text-sort" ac:schema-version="1"> <ac:parameter ac:name="">user:full name</ac:parameter> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> <ac:structured-macro ac:macro-id="039e4743-db18-45fb-80f4-248f0b5537c1" ac:name="report-body" ac:schema-version="1"> <ac:rich-text-body> <p> <ac:structured-macro ac:macro-id="eb5bd370-be14-4535-8584-e046e0c667a6" ac:name="report-info" ac:schema-version="1"> <ac:parameter ac:name="link">true</ac:parameter> <ac:parameter ac:name="">user:full name</ac:parameter> </ac:structured-macro> </p> </ac:rich-text-body> </ac:structured-macro> </ac:rich-text-body> </ac:structured-macro> 

 

Full source

Project Space homepage source

Â