Breadcrumb NavXT Multidimension Extensions

In the Vista-Like Breadcrumbs for WordPress guide, code was presented for recreating the breadcrumb style featured in Windows Vista and Windows 7. That code eventually was updated and placed into a plugin to ease implementation. This is that plugin.

Installation

  1. Download the plugin zip archive.
  2. In your WordPress Dashboard navigate to the plugin uploader (Plugins > Add New > Upload).
  3. Upload the zip archive.
  4. Activate.

Basic Usage

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 one of the following code snippets where you want the breadcrumb trail to appear.

Siblings in the Second Dimension

The following code will produce a multidimensional breadcrumb trail with the siblings of a breadcrumb in it’s second dimension:

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

Children in the Second Dimension

The following code will produce a multidimensional breadcrumb trail with the children of a breadcrumb in it’s second dimension:

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

Filter Reference

bcn_multidim_term_children

This filter is applied to the arguments to be passed into wp_list_categories() within the bcn_breadcrumb_trail_multidim and bcn_breadcrumb_trail_multidim_children classes. Three parameters are available to filters for this hook, the first is the argument string for wp_list_categories(), which is the item being filtered. The second is the id of the term that the first dimension breadcrumb represents. The third is the taxonomy name of the term that the first dimension breadcrumb represents. This filter was introduced in version 2.0.

bcn_multidim_post_children

This filter is applied to the arguments to be passed into wp_list_pages() within the bcn_breadcrumb_trail_multidim and bcn_breadcrumb_trail_multidim_children classes. Two parameters are available to filters for this hook, the first is the argument string for wp_list_pages(), which is the item being filtered. The second is the id of the post that the first dimension breadcrumb represents. This filter was introduced in version 2.0.

Version History and Changelog

  • 2.5.0 [11-8-2017]:
    New feature: Added support for Breadcrumb NavXT 6.0.0.
  • 2.1.0 [12-27-2016]:
    New feature: Added support for Breadcrumb NavXT 5.6.0’s force parameter in the display functions.
  • 2.0.0 [12-3-2015]:
    New feature: Added setting for controlling the display of children of the home page while on the homepage.
    New feature: Added bcn_multidim_term_children filter.
    New feature: Added bcn_multidim_post_children filter.
  • 1.9.0 [8-21-2015]:
    New feature: Added new bcn_display_list_multidim_children() function which places the children of a breadcrumb into the second dimension
    New feature: Support for the Breadcrumb NavXT widget, requires Breadcrumb NavXT 5.3.0 or newer
    Bug fix: Fixed issue where the second dimension would not be populated for the current item if the current item was linked
    Bug fix: Fixed issue where an “Empty Category” message would appear in the second dimension for terms without children or siblings
  • 1.8.1 [7-30-2014]:
    Behavior Change: Dropped support for Breadcrumb NavXT 5.1.0
    Bug fix: Fixed issues relating to support for Breadcrumb NavXT 5.1.1
  • 1.8.0 [6-6-2014]:
    Behavior Change: Refactored entire plugin
    Bug fix: Fixed issues relating to support for Breadcrumb NavXT 5.1.x
  • 1.7.0 [4-5-2014]:
    Behavior Change: Dropped support of version of Breadcrumb NavXT prior to 5.0.x
    Bug fix: Updated to be compatible with Breadcrumb NavXT 5.0.
  • 1.6.0 [1-12-2013]:
    Initial Release

License

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