Recently visited pages as navigational bread crumbs

Description

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.

Installation and Configuration

Prerequisites

Requires Trac >= 0.11.

Download

• Download the zipped source from here.
• You can check out BreadCrumbsNavPlugin from here using Subversion, or browse the source with Trac.

Installation

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

 easy_install http://trac-hacks.org/svn/breadcrumbsnavplugin/0.11

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

 python setup.py install

After you have installed the BreadCrumbsNavPlugin, you must enable it. You can do so in the Administration panel of Trac, or in trac.ini by adding:

[components]
breadcrumbsnavplugin.* = enabled

Configuration

There are three options you may set into the trac.ini:

ignore_pattern

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.

max_crumbs

The maximum total of crumbs that should be kept per-user. Defaults to 6.

paths

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:

[breadcrumbs]
ignore_pattern =
max_crumbs = 6
paths = /wiki*,/ticket*,/milestone*

Recent Changes

[3065] by ixokai on 01/16/08 03:34:48

Cleaned it up, in general; also added the ability to configure what resources you want to be bread-crumb-trackable.

[3050] by ixokai on 01/14/08 03:37:46

Making ignore_pattern optional.

[3049] by ixokai on 01/14/08 02:57:29

Initial commit, although 'finished' unless bug reports appear.

[3048] by ixokai on 01/14/08 02:48:01

New hack BreadCrumbsNavPlugin, created by ixokai

Author/Contributors

Author: ixokai
Maintainer: ixokai
Contributors: