Visualize
...
Your Confluence Page Tree with Ease
Our app provides a simple and effective way to create a diagram or
...
process map
...
of your Confluence page tree hierarchy
...
This app contains a macro, which can be inserted into a page.
The macro only shows the “page” content type in a diagram.
...
. By placing our macro on a page, you can quickly generate a visual representation of your page tree.
Our macro can be used with all content types, including comments, blogs, and space home pages, making it a versatile tool for all your Confluence needs.
Side note: As blogs and comments do not have a hierarchy, the macro can
...
be configured to display external page tree hierarchy
...
The macro can be included in all content types (comments, blogs, space home…).
...
Usage
...
Page Tree Visualization diagram
Usage
To add the Page Tree Visualization macro into your Confluence pages, you can insert it via the macro browser, which can be opened by clicking the + (Insert
...
) button > View more option in the main toolbar or by typing a forward slash “/“and
...
selecting the macro from the dropdown.
You can also type a few letters of the macro’s name after the slash to quickly search for it.
...
After inserting the macro,
...
you can click its containing box to reveal its floating toolbar. The toolbar contains buttons which will allow you to Edit the macro's configuration, change its size or remove it from the page. The Edit button will expand the macro configuration drawer, where you will be able to customize many aspects of your diagram's appearance, which will be discussed in the following sections.
To preview your changes, press the Preview button. To save your changes, press the Save button and save your Confluence page. To discard all changes, click the Cancel button.
Data sources
The macro can accept data from several sources.
Current page
By default, the macro uses the page where it is inserted and its subpages to display a diagram.
Excluding pages
Pages excluded by being labelled with an “exclude” label or by being children of a page with an “exclude-children” label will not be displayed in the final result.
Children of pages with the “children-verticaI” label follow these rules when being shown in a merged diagram:
If none or only some parents have the label, the result won’t be displayed vertically
If all parents have the label, the result will be displayed vertically
Ordering of cells
You can change the order of cells in a diagram by reordering them within your page tree. However, pages with subpages will always be displayed after pages which have none. Also, please be aware that the diagram can only show up to 3 levels of page tree. The 4th and below levels can have subpages, but they will not be displayed. To overcome this, you can place another macro on the 3rd level to display the subpages of levels below.
...
Excluding pages
You can exclude pages from a diagram in two ways:
...
By adding an “exclude” label to a page to be excluded
...
Changes in the macro configuration drawer will be automatically applied and saved as you make them. Changes to text fields will only register after the field loses focus (i.e. when you click anywhere outside of it). Hitting Publish before all settings are saved may cause you to lose your last change.
Inserting the macro
How to Select Pages Displayed in Page Tree Visualization Macro
The children of the root page will be used to construct the visualization. You may leave this field empty to use the current page or enter the ID of any other page.
Macro automatically visualize subpages of the page where it is placed. Maximum subpages depth is 3.
Customizing the Layout
By default, children will be displayed in rows. To display them in a column, you can add a “children-vertical” label to their parent page.
Horizontal layout:
Vertical layout:
Order of Visualized Pages
The order of cells in the diagram follows the order of the pages in the confluence page tree.
Display Options
The left side of the macro configuration window contains all available options for customization.
Predefined color themes
Predefined color theme enable you to add Page tree visualization macro easily as there is no need to define colors for each page level. Color themes ensure consistency in the use throughout your Confluence Space.
You can create your own space-specific color themes directly within the Space tools administration page. For detailed guidance on creating color templates, please refer to the Space tools administration section for more information.
Predefined color themes preview:
Summer Sky
Deep Dive
Firestorm
Zen Garden
Color customization
On the top of predefined color themes, you can customize the colors used in your diagram by Customize option and selecting colors. Selecting the Customize option in the Theme field will reveal fields which can be used to choose colors for the macro. The fields accept valid color names, hex color codes or colors using the rgb() notation.
Custom colors configuration:
Chevrons
You can choose to display the third level of subpages
...
with chevrons by using
...
the checkbox in the macro configuration
...
panel.
...
Labels
You may add labels to the left and right sides of the diagram by filling in the Start Label (left) and Goal Label (right) fields in the macro configuration dialog.
Color customization
You can customize the colors used in your diagram by checking the Use Custom Theme checkbox and selecting colors in the input fields below. Fill in the hex color codes. Hex color codes can be found for example on W3Schools website.
Please refer to the following image to see which settings affect which parts of the diagram.
...
Additional features
Toolbar
Hovering your mouse pointer above a diagram will reveal a toolbar below it. The toolbar contains several useful functions.
...
Toolbar lock
Toggling the toolbar lock will cause toolbars of all diagrams to be revealed until it's disabled.
Clicking the print button will bring up the browser print dialog, enabling you to print the diagram.
Fullscreen
Clicking the
...
fullscreen button will display your diagram in
...
fullscreen mode. To exit, press
...
the Esc key or click within the body of the diagram.
Space Tools Administration
On this page, Space administrator can adjust setting for Page Tree Visualization macro. There are two options availible: Set default theme for space and Create custom color theme.
Clicking the print button will bring up the browser print dialog, enabling you to print the diagram.
Toolbar lock
Toggling the toolbar lock will cause toolbars of all diagrams to be revealed until it's disabled.
Check out all of our apps https://marketplace.atlassian.com/vendors/22964/eea-communication-solutions
Find out more about us on our website https://www.eea.sk/en/abou-us/
...
Theme administration
You can find the Theme administration by going to your Space settings and clicking Page Tree Visualization in the Integrations section.
Default Space theme
In the theme administration, you may choose predefined or one of your custom themes as the space's default theme. All newly inserted macros will use this theme as a default, but you may still choose other themes in the macro configuration panel.
Custom themes
Theme administration also allows you to create, modify and delete custom themes.
To create a new theme select the New custom theme option from the Select a theme to edit dropdown. Choose a name and colors for your new theme and click the Save button.
After your theme has been saved, it will become available to be chosen as the space default theme or in any macro within the same space.
To edit or delete your custom theme, select it from the Select a theme to edit dropdown, then make any necessary changes and save it, or delete it by pressing the Delete button.
