ThemeBuilder for Confluence Server and DC

Breadcrumbs

This macro is used for inserting the breadcrumb target div, and the breadcrumbs.

Root Skin Location

In ThemeBuilder ROOT skin the breadcrumbs are in the 'title' panel.

Storage Format

<ac:macro ac:name="panel-breadcrumbs">
<ac:parameter ac:name="parameter">value</ac:parameter>
</ac:macro>

Wiki Markup

{panel-breadcrumbs:parameter=value}
Parameter Name Description Type Default Required

forceexpansion

Force Expansion

All breadcrumbs will always be visible, ie. the ellipsis is never used

boolean

false

(error)

ancestors

Visible Ancestors

The minimum number of visible ancestors before breadcrumbs are compressed into an ellipsis

int

3

error

legacy

Legacy Mode

Attempt to make breadcrumbs as backwards compatible as possible with older themes

boolean

false

error

flag

Flag

A list of flags, one of which must be defined for the content to be displayed

string

error

notflag

Not Flag

A list of flags which must not be defined for the content to be displayed

string

error

Basic Example

The main difference between ThemeBuilder 'panel-breadcrumbs' and Confluence breadcrumbs is that ThemeBuilder includes the link to the Dashboard by default.

To use 'panel-breadcrumbs' in ThemeBuilder panel you can add the simplest form of the macro.

<ac:macro ac:name="panel-breadcrumbs" />
{panel-breadcrumbs}

Result

Both the Confluence and ThemeBuilder panel-breadcrumbs have been shown here for comparison.

bread 01

HTML Output

ThemeBuilder adds additional classes to the HTML output for custom CSS styling: dashboardbreadcrumb, pagescollectorbreadcrumb, and last pagebreadcrumb.

<div id="breadcrumb-section">
Confluence Breadcrumbs
<ol id="breadcrumbs">
<li class="first">
<span class=""><a href="/confluence/collector/pages.action?key=AD">Pages</a></span>
</li>
<li>
<span class=""><a href="/confluence/display/AD/Adaptavist+Documentation+Home">Adaptavist Documentation
Home</a></span>
</li>
</ol>
Panel Breadcrumbs
<ol id="breadcrumbs">
<li class="first dashboardbreadcrumb">
<span><a href="/confluence/dashboard.action" title="Go to Dashboard">Dashboard</a></span>
</li>
<li class="pagescollectorbreadcrumb">
<span><a href="/confluence/collector/pages.action?key=AD">Pages</a></span>
</li>
<li class="last pagebreadcrumb">
<span><a href="/confluence/display/AD/Adaptavist+Documentation+Home">Adaptavist Documentation Home</a></span>
</li>
</ol>
</div>

Advanced Example

Control the number of levels hidden by the ellipses.

Default 'ancestors' (3)

<ac:macro ac:name="panel-breadcrumbs" />
bread 02

Set 'ancestors' (2)

<ac:macro ac:name="panel-breadcrumbs">
<ac:parameter ac:name="ancestors">2</ac:parameter>
</ac:macro>
bread 03

Set 'ancestors' (4)

<ac:macro ac:name="panel-breadcrumbs">
<ac:parameter ac:name="ancestors">4</ac:parameter>
</ac:macro>
bread 04