Breadcrumb NavXT 5.4.0

Holy new filters Batman! Breadcrumb NavXT 5.4.0 features several new filters and many bug fixes. Several fixes focus on strings and translations, including the addition of translation context for some strings. Additionally, date format strings for date breadcrumbs are now translatable. Two potential sources for PHP errors/warnings were mitigated. Lastly, the “Your settings are out of date” message no longer appears on fresh installs of Breadcrumb NavXT.

New Filters

Three new filters were added to Breadcrumb NavXT for 5.4.0. These are: bcn_post_terms, bcn_pick_post_term, and bcn_add_post_type_arg.


Previously, it was not easy to to control the number of terms, or what terms, were displayed when the hierarchy for a post was set to a flat taxonomy type. The bcn_post_terms filter provides a method for modifying what terms are displayed in this situation.


For posts belonging to multiple terms from a hierarchical taxonomy, Breadcrumb NavXT has, since 3.0, picked the first term with a parent, or the last term if none of the terms have parents. While this is an efficient method of picking the term, it is not applicable for all use cases. In the past, it was not easy to override this decision. There are ways to influence the selection based on the rule outlined above. But, this was not precise. The bcn_pick_post_term filter allows complete control over what term is selected by Breadcrumb NavXT.


Introduced in Breadcrumb NavXT 5.3.0, the post_type query argument was added to archive URLs when it was determined that the current post type was not the native type for that archive (e.g. for date archives and some taxonomy archives). While this behavior is correct, it may not be desired for every site. In 5.4.0 the bcn_add_post_type_arg filter was added to provide a way to override the decision Breadcrumb NavXT makes in regards to adding the post_type query argument to a URL. See How to Remove post_type From Breadcrumb NavXT URLs for an example of how to use this new filter.

As always, checkout the Breadcrumb NavXT Documentation’s Filter Reference for more details on these filters, and the other filters in Breadcrumb NavXT.


As explained in the Breadcrumb NavXT Translations Moving to Language Packs article, Breadcrumb NavXT has moved away from shipping translations with the plugin. This is the first release to ship without any included translations, all translations are available via language packs, or from the Breadcrumb NavXT Translation Project.

If you would like to contribute to translating Breadcrumb NavXT, please visit the Breadcrumb NavXT Translation Project. A big thanks to all of the translators that have contributed to the translations in the past and continue to contribute.

As always, you can grab the latest version of Breadcrumb NavXT from the Breadcrumb NavXT page. If you experience any issues with this version of Breadcrumb NavXT, please leave a comment on this post detailing the issue.

-John Havlik

[end of transmission, stay tuned]


Breadcrumb NavXT and BuddyPress Compatibility

While developing Breadcrumb NavXT 5.4, I spent some time investigating the compatibility issues between Breadcrumb NavXT and BuddyPress. Within Breadcrumb NavXT, every attempt is made to use the WordPress API, when possible, to maximize the compatibility with other plugins such as BuddyPress. However, this is not always enough, and the findings of this investigation are presented in this article.

What You Need

These are the plugins and versions used when performing the testing reported on within this article:

  • BuddyPress – At the time this article was written, 2.5.0 was the latest available version and was the version tested against.
  • Breadcrumb NavXT – Tested against a development release of 5.4.0.

What Works

Out of the box, group and user/member archives work in Breadcrumb NavXT 5.4.0.Unfortunately, the design of BuddyPress does not incorporate much of the standard WordPress content organization facilities. Hence, out of the box support for BuddyPress in Breadcrumb NavXT leaves much to be desired.

What Doesn’t Work

While user/member and group pages are detected correctly, the breadcrumb for the user and group archives/directory is missing. Additionally, none of the sub-components of the user/member and group pages are represented in the breadcrumb trail.

The Solution

Breadcrumb NavXT BuddyPress Extensions is a free, add on plugin for Breadcrumb NavXT that fixes many of the shortfalls in BuddyPress support. It will fill in the missing breadcrumb to the group and user/member archives/directories when on a group or user/member page. Additionally, it will fill in the correct breadcrumb trail when in a sub-component of a user/member or group page. It is a simple activate and you’re good to go plugin—no configuration required. For non-English language sites, note that you will need to use the included .POT file in the languages directory to create your own translation set to get ‘Members’ and ‘Groups’ to translate to your language.

-John Havlik

[end of transmission, stay tuned]

WP Lynx 1.1.1

What’s this? A bugfix release for WP Lynx? That’s right, announcing the immediate availability of the first bug fix release for WP Lynx 1.1. Three bugs were squashed in this release. In 1.1, the uninstaller was moved to a newer uninstaller akin to what Breadcrumb NavXT received in 5.3.0. However, the wrong class was instantiated, causing uninstalls to not work, this has been fixed in 1.1.1. Additionally, a bug in the settings page content alignment in WordPress 4.4 was fixed. Lastly, the Lynx Print adding interface now handles server side errors more gracefully.

You can grab the latest WP Lynx on the WP Lynx plugin page.

-John Havlik

[end of transmission, stay tuned]

Breadcrumb NavXT 5.3.1

This is the first, and hopefully only, bug fix release of the 5.3 branch of Breadcrumb NavXT. Three bugs were mercilessly squashed in this release. These bugs were: a bug that occurred when upgrading settings, a bug that caused a PHP error when the post_type query variable was an array, and an issue with alignment of the settings page content on WordPress 4.4.

In previous versions, a bug in the options migration script prevented new CPTs and custom taxonomies settings, or settings added by extension plugins from being instantiated properly. This manifested itself as undefined index PHP warnings/errors.

In instances where the post_query query variable is an array (set by another plugin), previous versions of Breadcrumb NavXT would throw PHP errors. bcn_breadcrumb_trail::get_type_string_query_var() has been updated to return the default type string when the post_query variable is an array.

Lastly, WordPress 4.4 introduced a slight styling bug in the settings page. In this bug, the content under the settings tabs would be misaligned (fall off to the right edge of the screen). This release introduces a fix to this bug.

As always, you can grab the latest version of Breadcrumb NavXT from the Breadcrumb NavXT page. If you experience any issues with this version of Breadcrumb NavXT, please leave a comment on this post detailing the issue.

-John Havlik

[end of transmission, stay tuned]

Breadcrumb NavXT Multidimension Extensions 2.0.0

It was not too long ago the last release was announced, and now a new version of Breadcrumb NavXT Multidimension Extensions is available. Breadcrumb NavXT Multidimension Extensions 2.0.0 adds three new features; two new filters and one setting.

The two new filters, bcn_multidim_term_children and bcn_multidim_post_children, are in response to a need to filter the taxonomy terms and posts (pages) included in the second dimension of the breadcrumb trail. They filter the arguments string passed into wp_list_categories() and wp_list_pages() respectively. See the Breadcrumb NavXT Multidimension Extensions Filter Reference for more details on these two filters.

Additionally, a setting was added to control the display of the second dimension breadcrumbs of the home breadcrumb when on the home page. This only applies to when children are displayed in the second dimension (either via the widget, or calling bcn_display_list_multidim_children()). This setting is available on the Breadcrumb NavXT settings page under the Extensions tab.

You can grab Breadcrumb NavXT Multidimension Extensions from the plugin repository.

-John Havlik

[end of transmission, stay tuned]