This macro is used for inserting the breadcrumb target div, and 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}
ParameterNameDescriptionTypeDefaultRequired

forceexpansion

Force Expansion

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

boolean

false

ancestors

Visible Ancestors

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

int

3

legacy

Legacy Mode

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

boolean

false

flag

Flag

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

string


notflag

Not Flag

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

string


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

HTML Output

ThemeBuilder adds additional classes to the HTML output for custom CSS styling:

  • dashboardbreadcrumb

  • pagescollectorbreadcrumb

  • 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

Follow this example and learn to control the number of levels hidden by the ellipses.

Default 'ancestors' (3)

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


Set 'ancestors' (2)

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


Set 'ancestors' (4)

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