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]