Version 21 (modified by 8 years ago) (diff) | ,
---|
Contents
Recently visited pages as navigational bread crumbs
Notice: This plugin is unmaintained and available for adoption.
Description
This plugin will inject a list of recently visited pages just above the main navigational bar, as bread crumbs that you can follow home.
Bugs/Feature Requests
Existing bugs and feature requests for BreadCrumbsNavPlugin are here.
If you have any issues, create a new ticket.
defect |
13 / 13 |
||
---|---|---|---|
enhancement |
4 / 6 |
||
task |
2 / 2 |
Download and Source
While 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 https://trac-hacks.org/svn/breadcrumbsnavplugin/0.11 | download | subversion |
Under Development | easy_install https://trac-hacks.org/svn/breadcrumbsnavplugin/trunk | download | subversion |
For Subversion checkout use svn co <url>
with URL depending on your Trac version and target release (see links above).
Alternatives:
- Download the zipped source of all branches from here.
- You can browse the source with Trac.
Installation
This plugin requires Trac >= 0.11 and Genshi >= 0.5 .
The easiest way to install this plugin is to point easy_install at the t-h.o SVN repository:
easy_install http://trac-hacks.org/svn/breadcrumbsnavplugin/0.11
Alternatively, you may download the source, go into the directory containing setup.py
and run:
python setup.py install
or prepare a packaged version and move that into the plugin
directory inside your Trac environment:
python setup.py bdist_egg cp ./dist/BreadCrumbsNav-<version> <path-to-trac-env>/plugins/
If you are using tracd
standalone server or another webserver, you will 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 the trac.ini
file by adding:
[components] 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 can be safely deleted.
Configuration
There are four options you may set in trac.ini
:
- ignore_pattern
- A regular expression pattern that can be applied to the name of the resource; if it matches the resource, it will not be added to the user's breadcrumbs. Defaults to nothing.
- label
- A custom label to replace the implicit "Breadcrumbs:" default value. Beware that this will interfere with i18n, maybe even deprecated by it.
- max_crumbs
- The maximum number 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 intent.
These options can be set as follows in your trac.ini
file:
[breadcrumbs] ignore_pattern = label = 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: none (needsadoption)
Contributors:
Attachments (1)
-
breadcrumbsnav.png (52.5 KB) - added by 7 years ago.
Breadcrumbsnav example
Download all attachments as: .zip