Advanced Panelboxes for Confluence

Panel boxes are useful to structure text on a Confluence page and are very easy to use. Confluence Administrators can configure a set of Panelboxes in the app settings.

The user can simply pick a predefined box - no need to deal with macro parameters to match the corporate design. These are Advanced Panelboxes, unlike the standard Confluence {panel} macro.

On Advanced Panelboxes

Working with Advanced Panelboxes has the following advantages over standard Confluence panels:

The Panelboxes' layout is defined in the Advanced Panelboxes' configuration.
Only Confluence administrators have access to the Advanced Panelboxes' configuration.
In order to style a Panelbox, an editor doesn't have to use any additional macro parameters.
More uniformity throughout the site: The editor just picks from a set of predefined Panelboxes.
If the style of a Panelbox needs to be changed (for example, when the colour scheme of the corporate design changes), those changes are made once in the app configuration. All the corresponding Panelboxes are changed immediately throughout the whole Confluence instance. No need to edit hundreds of pages!

Using the Panelbox Macro

In the editor, type "{panelbox" and choose "Advanced Panelbox".
In the overlay, select a predefined Panelbox in the dropdown (for example: "red").
You may give the panel a title and decide on its alignment. You may also select a title icon or insert an image URL.
If you like the preview of the Panelbox, click "Insert".
Back in the editor, fill the Panelbox with content.
Publish/update the page when you are done.
The Panelbox "red" is now part of your page.

Configuring Advanced Panelboxes

In the configuration of the Advanceded Panelboxes (in the Administration Console) you can configure the Panelboxes:

In the app management section, select "Advanced Panelboxes for Confluence" and click on "Configure":
You will now see a list of your individual Panelboxes.

Configuring an existing Panelbox

Click on the "Edit" link on the right side of the Panelbox you want to edit:
Change any settings you like, then click the "Save" button.
The new settings will now be applied to all Panelboxes with the name "blue". No need to edit dozens of pages once a setting changes!

Adding a new Panelbox

To create a new Panelbox, click on "+ Add Panelbox".
Scroll down the list until the last entry. This is your new Panelbox. Edit the Panelbox, assign it a new name and new properties.
When you are happy with the preview, click the "Save" button.
Your new Panelbox may now be used anywhere on your Confluence.

Parameters of the Panelbox Macro

Name	Description	Type	Default	Values
Name `id`	The name of your configured Panelbox	string
Title `title`	The title to display in header (leave blank for no header)	string
Apply panel title if title is left empty `usePanelTitleAsTitle`		boolean	false
Title alignment `titleAlignment`		enum	center	center, left, right
Title icon `titleIcon`	The title icon to display in header.	string
Title image URL `externalTitleImgUrl`	The URL of title image.	string

Panelboxlist Macro

This macro can be used to create a list of all the available Panelboxes. This is very useful for normal Confluence users without access to the Advanced Panelboxes app configuration.

Normal mode

Mobile mode