wiki:BreadCrumbsNavPlugin

Version 7 (modified by Ryan J Ollos, 14 years ago) (diff)

Add maintainer and page outline.

Recently visited pages as navigational bread crumbs

Notice: This plugin is unmaintained and available for adoption.

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

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

18167 by Cinc-th on 2021-04-08 14:23:16
BreadCrumbsNavPlugin: added classifiers to setup.py.
18166 by Cinc-th on 2021-04-08 14:15:56
BreadCrumbsNavPlugin: fixed pickling for Python 3. Save breadcrumbs as base64 encoded ascii string in session to prevent string/bytes problems.
18165 by Cinc-th on 2021-04-08 12:51:06
BreadCrumbsNavPlugin: no longer use ITemplateStreamFilter and Geshi Transformer. Added COPYING file. Bumped version to 0.5.0.
(more)

Author/Contributors

Author: ixokai
Maintainer: ixokai
Contributors:

Attachments (1)

Download all attachments as: .zip