= 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.

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. :) 

== Bugs/Feature Requests == 

Existing bugs and feature requests for BreadCrumbsNavPlugin are 
[report:9?COMPONENT=BreadCrumbsNavPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=BreadCrumbsNavPlugin&owner=ixokai new ticket].

== Installation and Configuration ==

=== Download ===

 * Download the zipped source from [download:breadcrumbsnavplugin here].
 * You can check out BreadCrumbsNavPlugin from [http://trac-hacks.org/svn/breadcrumbsnavplugin here] using Subversion, or [source:breadcrumbsnavplugin 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 two 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.

== Example ==

[[Image(BreadCrumbsNavPlugin:breadcrumbs example.jpg)]]

== Recent Changes ==

[[ChangeLog(breadcrumbsnavplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:ixokai] [[BR]]
'''Contributors:'''