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 cooperate 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 chooses from a set of predefined Panelboxes.

  • If the style of a Panelbox needs to be changed (for example, when the colour scheme of the cooperate 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

  1. In the editor, type "{panelbox" and choose "Advanced Panelbox".

  2. In the overlay, choose a predefined Panelbox in the dropdown, for example "red".

  3. You may give the panel a title and decide on its alignment. You may also choose a title icon or insert an image URL.

     

  4. If you like the preview of the Panelbox, click "Insert".

  5. Back in the editor, fill the Panelbox with content.

  6. Publish/update the page when you are done.

  7. 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:

  1. In the app management section , select "Advanced Panelboxes for Confluence" and click on "Configure":

  2. You will now see a list of your individual Panelboxes.

 

 

Configuring an existing Panelbox

  1. Click on the "Edit" link on the right side of the Panelbox you want to edit:

  2. Change any settings you like, then click the "Save" button.

  3. 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

  1. To create a new Panelbox, click on "+ Add Panelbox".

  2. Scroll down the list until the last entry. This is your new Panelbox. Edit the Panelbox, assign it a new name and new properties.

  3. When you are happy with the preview, click the "Save" button.

  4. Your new Panelbox may now be used anywhere on your Confluence.

 


Parameters of the Panelbox Macro

 

Name

Description

Type

This is a required field

Default

Values

Name

Description

Type

This is a required field

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