From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.png

Release status:Extension status unmaintained

ImplementationTemplate:Extension#type User interface
DescriptionTemplate:Extension#description Shows the users path through the wiki.
Author(s)Template:Extension#username Tony Boyles, Manuel Schneider
Latest versionTemplate:Extension#version 0.4.1 (2016-03-18)
MediaWikiTemplate:Extension#mediawiki 1.19+
Database changesTemplate:Extension#needs-updatephp No
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
  • $wgBreadCrumbsShowAnons
  • $wgBreadCrumbsAllowUPOs
Hooks usedTemplate:Extension#hook

Translate the BreadCrumbs extension if it is available at translatewiki.net

Check usage and version matrix.


Open tasks · Report a bug

The BreadCrumbs extension shows the users paths through the wiki.

This extension creates breadcrumbs in the traditional "How did I get here?" sense; use Extension:BreadCrumbs2 for breadcrumbs in the recently popular category-based "Where am I?" sense.

Installation[edit source]

  • Download and place the file(s) in a directory called BreadCrumbs in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/BreadCrumbs/BreadCrumbs.php";
  • Configure as described below this section.
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration[edit source]

Parameters[edit source]

By default the following options are set by this extension:

$wgDefaultUserOptions['breadcrumbs-showcrumbs'] = true; # Set of the breadcrumbs should be shown or not
$wgBreadCrumbsAllowUPOs = true; # Allow users to edit their BreadCrumbs preferences
$wgBreadCrumbsShowAnons = true; # Show breadcrumbs to anonymous users
$wgDefaultUserOptions['breadcrumbs-preceding-text'] = ''; # Text to appear before breadcrumbs
$wgDefaultUserOptions['breadcrumbs-delimiter'] = '>'; # Set the delimiter between breadcrumbs
$wgDefaultUserOptions['breadcrumbs-numberofcrumbs'] = 5; # Set the number of breadcrumbs to be shown
$wgDefaultUserOptions['breadcrumbs-namespaces'] = true; # Show namespaces in breadcrumbs
$wgDefaultUserOptions['breadcrumbs-filter-duplicates'] = false; # Exclude a page from the breadcrumbs if it's already in the list once.
$wgDefaultUserOptions['breadcrumbs-ignore-refreshes'] = true; # Do not add a page to the breadcrumbs twice in a row

You may change each one of these parameters by including it with your specified value into your "LocalSettings.php" file below the initialisation of this extension.

Styling[edit source]

You can also configure the styling of the breadcrumbs by editing MediaWiki:Common.css. For example, if you wanted to shrink the size of the breadcrumbs text from the default 0.8em to 0.5em, you should add this to MediaWiki:Common.css page:

div#breadcrumbs {

To hide the breadcrumbs from the page's print version add to the MediaWiki:Print.css page:

div#breadcrumbs {
display: none;

As the Common.css page warns, you should perform a browser cache-clearing refresh in order to see the changes!

See also[edit source]