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

Release status: stable

Implementation User interface
Description Shows the users path through the wiki.
Author(s) Tony Boyles, Manuel Schneider
Latest version 0.4.0 (2014-04-22)
MediaWiki 1.19+
Database changes No
License GNU General Public License 2.0
  • $wgBreadCrumbsShowAnons
  • $wgBreadCrumbsAllowUPOs
Hooks used


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

Check usage and version matrix; code metrics
Bugs: list open list all report

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 | edit source]

  • Download and extract the file(s) in a directory called BreadCrumbs in your extensions/ folder. If you're a developer and this extension is in a Git repository, then instead you should clone the repository using:
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/BreadCrumbs.git
  • Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/BreadCrumbs/BreadCrumbs.php";
  • Configure as described below this section.
  • Done! Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.

Configuration[edit | 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 below the initialisation of this extension.

You can also configure the styling of the breadcrumbs by editing your Manual:Common.css page. 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 Manual:Common.css:

div#breadcrumbs {

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

Development[edit | edit source]

If you'd like to help develop this extension, clone a copy of this extension. Navigate to your $IP/extensions/ directory in shell and type:

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/BreadCrumbs.git

The next big step in the development of this Extension is storage of BreadCrumbs in the Database. If you have any thoughts on the matter, please drop a line on the Discussion Page.

Thanks[edit | edit source]

This extension is being maintained by Tony Boyles through a project of Milcord llc.

Are you using this Extension?[edit | edit source]

If you're using BreadCrumbs on a public wiki, please add your link here:

See also[edit | edit source]