=== Instant Breadcrumbs ===
Contributors: loseyourmarbles
Donate link: http://loseyourmarbles.co/
Tags: breadcrumbs, navigation, links, menu
Requires at least: 3.0.0
Tested up to: 3.8
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Instant Breadcrumbs adds a breadcrumb trail to your WordPress blog's primary navigation menu. No theme editing required!

== Description ==

Including a breadcrumb trail on your site not only makes it easier for visitors to navigate your site, but also allows
search engines to better explore your blog and include the breadcrumb information in rich snippet data in search
results. Many breadcrumb plugins exist, but normally require either theme editing, or use of a theme that is already
customized to include the breadcrumb function. In addition, editing the theme is usually followed by some CSS
styling to make the breadcrumb trail match the overall 'look' of the site.

Instant Breadcrumbs takes a different approach. Since breadcrumbs are a navigation aid, the generated trail is
automatically added to the front of your existing primary navigation menu. This allows it to not only function
straight out of the box with a large number of themes, but also use the existing styling of your primary navigation
menu.

A quick overview of Instant Breadcrumbs features:

* Works with both custom primary menus and the default 'page' menu generated by WordPress;
* Produces RDFa-compliant breadcrumb trails that may be used by Google and others in search results;
* Supports customization of the breadcrumb titles for pages such as the front page, archives, and search;
* Re-uses existing top-level entries in the primary menu to avoid repeated links;
* Includes CSS classes for added breadcrumbs for optional further styling if desired.

== Installation ==

1. Unzip and upload the `instant-breadcrumbs` directory to the `/wp-content/plugins/` directory;
1. Activate the plugin through the 'Plugins' menu in WordPress;
1. Optionally change settings values in the 'Breadcrumbs' settings page, listed under 'Appearance';
1. Optionally add custom CSS, although the plugin is designed to work without theme editing.

== Frequently Asked Questions ==

= My home page appears twice in the modified menu? =

Instant Breadcrumbs will reuse menu items wherever possible, for example when viewing a page that is
already in the top-level menu. However it cannot reuse a menu item link if doing so would mean the
generated breadcrumbs are no longer in order. The usual example of this is if the home page already
appears in the primary menu. The generated breadcrumb trail requires the home link to be first. The
easiest workaround for this is simply to customize your menu so the home page is not included a
second time.

= How can I apply custom CSS to the added breadcrumbs? =

The Instant Breadcrumbs plugin adds the CSS class `ib-crumb` to the `li` element of any breadcrumbs in
the menu, and `ib-lastcrumb` to the last link in the breadcrumb trail representing the current page.
Furthermore, the class `ib-added` is added to the `li` element of new menu items created by the plugin,
and `ib-edited` to existing menu items. These may be styled in your theme's `style.css` should for
instance you would like breadcrumb items to be highlighted in a different color.

== Screenshots ==

1. A screenshot of Instant Breadcrumbs generated on a blog post in TwentyFourteen, showing the
breadcrumb trail for the current post, including the post category. This is without any theme editing.
2. The exact same blog in TwentyTwelve, no theme editing...
3. ... and in TwentyThirteen, again without theme editing.
4. The same page in TwentyFourteen on a smaller display, showing the breadcrumb trail automatically
styles with the navigation menu.
5. The breadcrumb trail for a page that already appears in the nav menu, reusing the existing link.

== Changelog ==

= 1.0 =
* Initial release.

== Upgrade Notice ==

= 1.0 =
Initial release.