Breadcrumb NavXT

Breadcrumb NavXT, the successor to the popular WordPress plugin Breadcrumb Navigation XT, was written from the ground up to be better than its ancestor.

Table of Contents

1. Purpose
2. Download
3. Installation
4. Basic Usage
5. Advanced Usage
6. Donate
7. Version History and Changelog
8. License

Purpose

Breadcrumb NavXT is a WordPress plugin compatible with WordPress versions 3.1 and up. This plugin generates locational breadcrumb trails for your WordPress blog. These represent the hierarchy leading up to the current page rather than the actual path taken to arrive at the current page.

Breadcrumb trails are a good supplementary navigation system that aid in site usability. This is especially true for sites using WordPress as a CMS. Since Breadcrumb NavXT reveals the page hierarchy in a consistent manner, it can provide SEO benefits. On the right are examples of breadcrumb trails generated by Breadcrumb NavXT. This website runs Breadcrumb NavXT, browse the various sections to see how Breadcrumb NavXT behaves.

Download

Latest Stable Release: Breadcrumb NavXT 4.0.2

Latest Testing Release: Breadcrumb NavXT SVN Trunk

Installation

1. Download the plugin zip archive, see Download section.
2. Disable any previous version of this plugin or Breadcrumb Navigation XT.
3. Extract the contents of the zip archive into your plugins folder (wp-content/plugins).
4. Enable the Breadcrumb NavXT plugin in the administration panel under the Plugins > Installed section.
5. Continue onto the Basic Usage section, or follow instructions given by your theme (if applicable).

Basic Usage

Depending on your theme this section may be unnecessary. If you are using berry as your theme everything is done for you so you have no further steps to take. If you are a theme developer visit the documentation for examples on how to directly access the bcn_breadcrumb_trail class. Otherwise keep reading.

Open the appropriate file for your theme (typically header.php). This can be done within WordPress’ administration panel through Presentation > Theme Editor or through your favorite text editor. Place the following code where you want the breadcrumb trail to appear.

<div class="breadcrumbs">
	<?php if(function_exists('bcn_display'))
	{
		bcn_display();
	}?>
</div>

Save the file (upload if applicable). Now you should have a breadcrumb trail on your WordPress powered site. To customize the breadcrumb trail you may edit the default values for the options in the administrative interface. This is located in your administration panel under Settings > Breadcrumb NavXT.

Advanced Usage

Examples on some advanced usage situations are available in the documentation.

Donate

Love Breadcrumb NavXT? Want to help development? Feel free to make a donation:

Version History and Changelog

• 4.1.0 [5-29-2012]:
  Behavior change: Made the behavior of posts using flat taxonomies match the behavior of using a hierarchical taxonomy when the post is not assigned a taxonomy term.
  New feature: Custom Post Types that are hierarchical can now fall back to a taxonomy if they don’t have a parent.
  New feature: Pretext option for the included Widget, allows ‘You are here: ‘ type messages in the widget.
  Bug fix: Textdomain was changed to the correct one in the widget.
  Bug fix: Textdomain was changed from ‘breadcrumb_navxt’ to ‘breadcrumb-navxt’ for improved compatibility with the new GlotPress translation flow.
  Bug fix: Fixed cause of PHP warnings on empty term archive pages.
  Bug fix: Fixed cause of PHP warnings on term archives restricted to a specified post type.
• 4.0.2 [2-17-2012]:
  New feature: Estonian translation added props to Martin Orn.
  New feature: Azerbaijani translation added props to Zaur Bayramov.
  Bug fix: Replaced deprecated RDFa and Microformat breadcrumbs with Schema.org breadcrumbs support in the included sidebar widget.
  Bug fix: Mainsite breadcrumbs are linked once again.
  Bug fix: Safe default settings for CPTs and taxonomies should work now.
  Bug fix: Updated translations should work, previously the old ones loaded.
• 4.0.1 [1-3-2012]:
  New feature: Norwegian translations added props to Jan Rosvoldsve.
  Bug fix: Fixed line 591 and line 646 errors in multisite installs.
  Bug fix: Attachments will now obey the root page setting for their parent, regardless of the parent’s post type.
• 4.0.0 [12-14-2011]:
  Behavior change: Prefix, suffix, and anchor settings have been replaced with templates for all breadcrumb types.
  Behavior change: bcn_display_nested function was removed from the main plugin. Will appear in a supplementary plugin.
  Behavior change: Import/Export/Reset tab moved under the admin bar Help menu.
  Behavior change: Paged breadcrumbs are enabled in the default settings, among other subtle changes.
  New feature: More useful Help menu, utilizing the new WordPress 3.3 Help menu.
  New feature: True URLs are now generated for current items when link current item is enabled.
  New feature: The display of the custom post type archive breadcrumb for custom post types may now be disabled.
  New feature: Added in fallback functions for PHP’s multibyte character string functions for environments that do not have multibyte character support.
  Bug fix: Custom post type archives now respect the root page setting.
  Bug fix: Custom post types without WordPress post archives enabled will no longer cause a double root page breadcrumb to be generated.
  Bug fix: Tabs on the settings page are now rounded for all “modern” browsers, including Firefox, Chrome, and IE9.
  Bug fix: Tabs on the settings page are now remembered between setting saves (including multiple saves from within the same tab).
  Bug fix: Fixed another cause of the “The following settings were not saved” error message.
• 3.9.0 [5-31-2011]:
  Behavior change: Settings can not be saved, imported, or exported until any necessary settings updates and/or installs are completed.
  New feature: Support for WordPress 3.1 custom post type archives.
  Bug fix: Displays a warning message in the WordPress dashboard if PHP version is too old rather than trying to deactivate and dieing on all pages.
  Bug fix: Fixed a potential cause for the “options not saved” error.
  Bug fix: Fixed bug where the “Blog Breadcrumb” was not obeyed on archives.

To keep this page at a reasonable length, only versions 3.9 and newer are present in this changelog. For the entire changelog, including versions of Breadcrumb Navigation XT, visit the Breadcrumb NavXT Changelog page.

License

Breadcrumb NavXT is released under the GNU GPL 2.0 license and comes with absolutely no warranty. By downloading Breadcrumb NavXT you agree to the terms of the GNU GPL 2.0 license.