Version 13 (modified by hasienda, 5 years ago) (diff)

document just the new activation string after breadcrumbs-0.2 release

Recently visited pages as navigational bread crumbs


This relatively simple plug-in will inject a list of recently visited pages just above the main navigational bar, as 'bread crumbs' that you can follow home.

See also: BreadcrumbTrailsScript, TracTrailPlugin

Bugs/Feature Requests

Existing bugs and feature requests for BreadCrumbsNavPlugin are here.

If you have any issues, create a new ticket.


  • short-term: work on pending feature requests


Maintenance release breadcrumbs-0.2 in 0.11 branch with various fixes (open: 4)
Official maintainer change (open: 10)
Starting ticket list cleanup and triage (open: 9)

Installation and Configuration


Requires Trac >= 0.11 and Genshi >= 0.5 .

Release Status, Downloads and Source

While in general the branch name suggests the corresponding Trac version, 0.11 should work equally well for Trac 0.11 (old stable), 0.12 (current stable) and Trac 0.13dev (development).

Stable Version easy_install [download:breadcrumbsnavplugin/0.11 download] subversion
Under Development easy_install [download:breadcrumbsnavplugin/trunk download] subversion

For Subversion checkout use svn co <url> with URL depending on your Trac version and target release (see links above).

Other alternatives:

  • Download the zipped source of all branches from [download:breadcrumbsnavplugin here].
  • You can browse the source with Trac.


The easiest way to install the BreadCrumbsNavPlugin is to simply point easy_install at the t-h.o SVN repository, a la:


Alternatively, you may download the source, go into the directory containing and run:

 python install

or prepare a packaged version and move that into the plugin directory inside your Trac environment:

 python bdist_egg
 cp ./dist/BreadCrumbsNav-<version> <path-to-trac-env>/plugins/

Hint: Using tracd standalone server or another webserver you will most probably need to restart it to detect the plugin.

Depending on your configuration you may still need to enable the plugin explicitly. You can do so in the Administration panel of Trac, or in trac.ini by adding:

breadcrumbsnav.* = enabled

In Trac applications, where you disabled breadcrumbs-0.1 or required explicit activation, a different line starting with breadcrumbsnavplugin. is already present that is now obsolete and could be deleted safely.


There are four options you may set in trac.ini:

A regular expression pattern that can be applied to the name of the resource; if it matches the resource will not be added to the user's breadcrumbs. Defaults to nothing.
A custom label to replace the implicite "Breadcrumbs:" default value. Beware that this will interfere with i18n, maybe even depreciated by it.
The maximum total of crumbs that should be kept per-user. Defaults to 6.
A comma-separated list of regular expressions, one of which should match the beginning of the url to include the resource in the path. Defaults to /wiki*,/ticket*,/milestone* Note that these really are interpreted as regular expressions, even though the default values look more like shell globs. It seems these default values also match /wik/foo or /tickebar, which might not be the authors intention.

The config entry would look something like the following:

ignore_pattern =
label =
max_crumbs = 6
paths = /wiki/,/ticket/,/milestone/

Recent Changes

15913 by rjollos on 2016-10-12 22:29:12
0.3dev: Show resource summary in title if realm is milestone

Refs #12896.

15912 by rjollos on 2016-10-12 22:19:52
0.3dev: Show resource summary if realm is ticket or wiki

Refs #12896.

10902 by hasienda on 2011-11-11 19:39:33
BreadCrumbsNavPlugin: Hide currently viewed page/resource from list, refs #9529.


Author: ixokai
Maintainer: hasienda

Attachments (1)

Download all attachments as: .zip