=== AmR Breadcrumb Navigation === Contributors: anmari Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=anmari%40anmari%2ecom&item_name=AmRBreadcrumb Tags: breadcrumb, breadtrail, navigation, menu, pages Requires at least: 2.5 (not tested on earlier versions) Tested up to: 2.9-rare Stable tag: /trunk/ Version: 1.2 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
  • ) * 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 Css and the html produced have been validated by the w3c validator. The CSS has been tested on IE 8 and Firefox 3.55, and safari 4.0.3. 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. Install and activate plugin 2. Add the widget to the chosen sidebar. 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. Note: On the home page you will not see anything, you must drill down the navigation to see the breadcrumb. == Changelog == = Version 1.2 = * Added html classes so that successive levels can be styled by the depth of the page. First lvl li will have a css class of lvl1, then lvl2 etc. = Version 1.1 = * Fixed some minor css errors * Added option to not have the background image, while still having the plugin style - this helps if using the default theme on Safari - somehow it is hard in safari to get rid of the li:before content that the default theme uses to style the bullets. So in that case, one could just work with it. == 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 4. Widget with separator with spaces 5. In the default theme sidebar with separators 6. With background-image 7. No background image and no separator in default theme in safari 8. Best configuration for default theme in Safari - no background image, some styling