Overview

Panelboxes are useful to structure text on a wiki-page and are very easy to use. Confluence Administrators configure a set of panelboxes in the plugin configuration. The user then just picks a pre-defined box without having to deal with half a dozen macro parameters and their values in order to match the cooperate identity, like it is the case with the Confluence {panel} macro.

Panelbox Macro

The panelbox macro has the following advantages over normal Confluence panels:

  • The layout of the panelboxes are defined in the plugin configuration
  • Only Confluence administrators have access to the panelbox configuration
  • In order to style a panelbox the author doesn't have to use any additional macro parameters
  • More uniformity throughout the site. The user just chooses from a set of pre-defined panelboxes
  • If a style of panelbox needs to be changed, for example when the colour scheme of the cooperate identity changes, those changes are made once in the plugin configuration. All the corresponding panelboxes are changed immediately throughout the whole Confluence instance without having to edit hundreds of pages.
  • The header of a panelbox can not only contain normal text but also wiki-syntax.

 

Panelbox{panelbox}
formatting

Parameter

NameDescriptionTypeThis is a required fieldDefaultValues
Name
name
The name of your configured panelboxenum
Title
title
The title to display in header (wiki markup supported)
=> leave blank for no header
string

Examples

Screenshots

 

Panelboxlist Macro

This macro can be used to create a list of all the available panelboxes. This is very useful for normal Confluence users when they have no access to the panelbox plugin configuration.

panelboxlist
formatting

Parameter

This macro has no parameters

Examples

Screenshots

Configuration

In the configuration of the Panelbox plugin, which is in the Administration Console, you can configure the panelboxes:

  1. In the add-on management section in the administration console of Confluence, select the Panelbox plugin and click on "Configure":
  2. Configure the panelboxes:

 

FAQ

 I'm using Internet Explorer 8 and I can't see the rounded corners I have configured for my panelboxes. Is this a bug?

No. Neither Internet Explorer 7 nor 8 do support round corners as specified in the W3C CSS3 standard. If you configured panelboxes with round corners and you are using Internet Explorer, please make sure you test your panelboxes with a recent version of Firefox, Chrome or Safari.

Support