=== AmR Breadcrumb Navigation ===
Contributors: anmari
Donate link: http://webdesign.anmari.com/web-tools/donate/
Tags: breadcrumb, breadtrail, navigation, menu, pages
Requires at least: 2.5 (not tested on earlier versions)
Tested up to: 2.6
Stable tag: /trunk/

Produces a breadcrumb trail through the page tree - a single page from each level of the page hierarchy (no nesting, no indenting).  

== Description ==

The widget produces a breadcrumb trail through the page tree - a single page from each level of the page hierarchy (no nesting, no indenting).  This widget is useful for website that may  have fairly deep menu`s and a risk of the user getting "lost".  Nothing is shown when at home page level (there is no trail then) and the list ends at current page level.A Default CSS styling is provided, however this can be switched off.  It is also possible to add a separator in the HTML markup (instead of just using CSS to style the menu).

Features:

*	Uses listed items with minimal markup. The markup is designed to be compatible with the sandbox theme html markup and wordpress delivered markup. (Ie: it expects to be surrounded by a UL or OL, and thus starts with <li>)
*	Provides default css styling (no spans for separators), with the option to switch the default styling off to use your own. Depending on your existing theme, you may need to adjust your theme`s css. See below.
*	Uses wordpress sandboxplus flavoured css tags, so will pickup any general styling too, as well as allowing you to style the breadcrumb trail yourself.
*	Intended to be inserted into the sandboxplus header or branding div (horizontal)
*	Allows specification of a separator if you really wish one. This will be inserted into a span within the link text, so the whole area is clickable. If there is no separator (default) then no span html is issued.
*	Package consists of one plugin file and a default styling background image

Tested and Validated

The plugin has been tested on wordpress 2.5 and 2.6. The Css and the html produced have been validated by the w3c validator. The CSS has been tested on IE 7 and Firefox 2. It is fairly standard CSS. Please let me know if any problems are experienced.

CSS variations

Alternate CSS possibilities are demonstrated here.[Breadcrumb Examples](http://webdesign.anmari.com/wp-content/uploads/2008/07/breadcrumb.html)

If you have just widgetized your theme`s header, you may need to also switch off the list style for the high level ul. eg: div.sidebar ul { list-style-type: none; }. If your theme already allowed for widgets then hopefully it`s styling already provided a suitable style for all div`s of a class sidebar.

== Installation ==

1. Unzip the folder into your wordpress plugins folder.
2. Activate the plugin through the `Plugins` menu in WordPress
3. Add the widget to the chosen sidebar. EG: In Sandbox plus, this would probably be the sidebar 3. (Note many themes do not allow for this possibility, however you can add an additional sidebar to your header see [WordPress Stepping_Into_Templates](http://codex.wordpress.org/Stepping_Into_Templates) or [Anmari`s widgetising headers](http://webdesign.anmari.com/widgetized-headers-and-footers/)
4. That`s it - customise the css and background image to taste.
 
== Frequently Asked Questions ==

= No breadcrumb menu produced on top level pages =

A menu or breadcrumb trail will only be produced if there are at least to levels to the travelled hierarchy - ie a "trail".  thus top level pages do not produce a "trail".  To test your new widget, drill down within your page tree to a second or third level.

== Screenshots ==

1. Screenshot of a breadcrumb navigation with minimal styling in the default wordpress theme.
2. Widget configuration menu 
3. Screenshot of another variation