Breadcrumb NavXT 6.4.0

Holy incremental improvements Batman! This second feature release of 2019 changes the way private posts and non-hierarchical taxonomies are handled. As part of these changes, a new filter was added bcn_show_post_private. Additionally, the %link% template tag is now allowed in the “unlinked” breadcrumb templates. Lastly, how the Media post type settings are handles changed. Previously, it was referred to as “Attachments” within the Breadcrumb NavXT settings page. Now, this post type is referred to by its actual name (Media) and additional settings are available for it in the settings page.

bcn_show_post_private Filter

Beginning in 6.4.0, the default behavior for private posts has changed. If a parent of a post has the published status of private, it no longer will be included in the breadcrumb trail (Breadcrumb NavXT will skip over it). While this was deemed the most appropriate behavior, some users may want the old behavior. To facilitate that, the bcn_show_post_private filter was added in 6.4.0.

bcn_show_type_term_archive Filter

Since 3.9.0, Breadcrumb NavXT has attempted to associate a taxonomy with a post type to include the type archive in the breadcrumb trail. This was not controllable (if the post type had an archive and it was enabled in the settings for that post type, it would show up in the breadcrumb trails for associated taxonomy terms). To allow users to control this behavior, the bcn_show_type_term_archive filter was added in 6.4.0.

Non-Hierarchical Taxonomies

Previously, the use of non-hierarchical taxonomies as the parent for posts was handled in a very different manner than hierarchical taxonomies. This is quite hacky, and incompatible with the newer bcn_display_json_ld() function. To resolve some of these incompatibilities, when a post has onl only a single non-hierarchical term, the hierarchical term codepath will be used. This will result in the same breadcrumb trial being produced, however, it will no longer cause issues with bcn_display_json_ld.

-John Havlik

4 thoughts on “Breadcrumb NavXT 6.4.0

    • Hi Matt,

      The good news is Breadcrumb NavXT already supports’s BreadcrumbList, and has done so as the default markup since Breadcrumb NavXT 5.3.0. That said, for sites that started using Breadcrumb NavXT prior to 5.3.0, the site administrator will have to manually update a couple of things to migrate to the syntax. I wrote an article back in 2015 that covers what need to be done to move to BreadcrumbList (see ). The gist is you need to update the markup container around your call to bcn_displau() and you will need to change the breadcrumb templates. If you are more-or-less using the default Breadcrumb NavXT settings, then you can use the settings reset form in the help menu on the Breadcrumb NavXT settings page to force an upgrade to the current default values.

      -John Havlik

  1. Hi,
    I’ve was trying to use this plugin on one of my websites. It’s really useful but I wasn’t able to turn off/disable “Place the blog breadcrumb in the trail” feature. It’s kind of freeze. Here’s the image:
    Can you please elaborate on why it’s happening with my website?

    • Not all settings are applicable for all WordPress installs. For cases where the setting does not make sense for your WordPress configuration, the setting will be “greyed out”/disabled. In your case, under the WordPress settings for “Reading” you either have “Your homepage displays” set to “Your latest posts” or the “Post page” is not set. In either case, the blog breadcrumb will never be generated so there is no need to control its display.

      -John Havlik

Comments are closed.