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 design, 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 design 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 (leave blank for no header)string

Examples

{panelbox:name=blue|title=Please read the documentation}
Wiki syntax in panelbox titles will be rendered by Confluence. Give it a try!
{panelbox}

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

{panelboxlist}

Screenshots

Normal mode

 

Mobile mode

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

Related articles

Support

 

Comments  (0)

Attachments  (9)

Add Attachment
  File Modified
PNG File panelbox-screenshot-3.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-logo.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-screenshot-2.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-screenshot-1.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-plugin-config-1.png 03. Mar. 2014 by Remo Siegwart
PNG File panelbox-plugin-config-2.png 03. Mar. 2014 by Remo Siegwart
PNG File image2015-7-31 10:6:45.png 31. Jul. 2015 by Oliver Sträßer
PNG File image2015-7-31 10:8:16.png 31. Jul. 2015 by Oliver Sträßer
PNG File image2015-7-31 10:9:7.png 31. Jul. 2015 by Oliver Sträßer