Version 5 (modified by 15 years ago) (diff) | ,
---|
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.
There's also BreadcrumbTrailsScript, but it's idea of breadcrumbs is not what I'm used to, so I went and made this one to scratch my itch. :)
Version: If this runs on anything before 0.11b1, it's a miracle that is completely unsupported by me :) Don't ask me if something goes wrong there :)
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
You probably need to install Genshi from the trunk before this will work (>=0.5dev), at least until 0.11 comes out final.
Download
- Download the zipped source from [download:breadcrumbsnavplugin 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_crubs = 6 paths = /wiki*,/ticket*,/milestone*
Example
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
Contributors:
Attachments (1)
-
breadcrumbsnav.png (52.5 KB) - added by 7 years ago.
Breadcrumbsnav example
Download all attachments as: .zip