Breadcrumb NavXT 4.4.0

Holy API improvements Batman! As with 4.3.0, this release contains several smaller improvements rather than a single, or handful of ‘block buster’ new features. The largest set of these improvements is the addition, and improvement of several filters within Breadcrumb NavXT.

Of the new filters, bcn_template_tags has one of the larger impacts. It allows the addition of custom breadcrumb template tags. Other new filters include bcn_allowed_html, bcn_breadcrumb_template, and bcn_breadcrumb_url. For more information on these filters, please checkout the Breadcrumb NavXT Filters section of the documentation.

Additionally, the set of valid HTML for breadcrumb templates was revised and expanded. The basic set should now include a, img, span, h1, and h2 HTML tags. Added valid properties include:

  • aria-hidden
  • data-icon
  • itemprop
  • itemscope
  • itemtype

With the bcn_allowed_html filter the list of valid HTML tags and associated properties can be expanded upon without modification of the plugin.

The Translation Team:


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]

11 thoughts on “Breadcrumb NavXT 4.4.0

  1. Hi John,

    first of all I would like to thank you for the great plugin.

    I’m having a bit of trouble – I just upgraded NavXT to 4.4.0, and suddenly I get the following error in my pages and posts:

    Fatal error: Call to undefined function wp_kses_allowed_html() in /public_html/wp-content/plugins/breadcrumb-navxt/includes/mtekk_adminkit.php on line 52


    • Hi Jonatan,

      Well, it looks like that function requires WordPress 3.5. If you can update your site to use WordPress 3.5.2, that would be the preferred method of resolving this. I have updated the version requirements in the readme file to alert others who are just upgrading. I may do an update to support 3.4.0, but the best path is to move to the latest WordPress.

      -John Havlik

  2. Hello,
    First of all, thank you for this plugin!
    I wanted to notice that you use the “home” class for the homepage link of the breadcrumb, but WP uses it also. For me it resulted of a jquery “conflict” and my breadcrumb was the same on every page because I used this code: if ( $('.home').length ) { //do something... }

    I’ve had to insert a new class in the body classes to make my code work again. So maybe it would be a good idea not to use the same class that WP uses ?

    Anyway thanks again ;-)

    • You should be a bit more specific when selecting items with jQuery (Also within WordPress you should not be using $ unless you’re reassigning it locally within a function). A specific class may be applied to multiple elements within a HTML document, it is the developer’s job to be aware of all areas where this class may be applied.

      If you don’t want classes to be applied to breadcrumbs within your breadcrumb trail, remove or modify the class="%type%" portion within your breadcrumb templates.

      -John Havlik

  3. I am using version 4.4.0 of the plug-in and having some issues. I have used the plug-in on 4 very similar/but different/ sites I have either completed or pretty much completed using Thesis 2.0 / Agility Nude. I am using WP 3.5.2.

    The plug-in – Breadcrumb NavXT – from everything I can see, after reviewing the set ups many times, the plug-in settings on all 4 of the sites looks the same to me.

    But on 2 of the sites the “home page reference” that is part of the breadcrumb trail is called “Home” and on the other 2 sites the reference to the homepage is called the actual name of the website. What might I be missing in setting up that would keep the home page reference from being called “Home” on the sites where the full site name is referenced?

    Then another issue is that on the 2 sites where home is actually being called “Home”, I have issues with child-pages in the breadcrumb trail not showing up, or I should say a middle page in the child-page trail not showing up – the breadcrumb trail just misses a page and goes to the 2nd level child-page in the trail.

    But on the sites where I can’t seem to get the home page to be called “Home” in the breadcrumb trail – but it is called the name of the website —- on these sites, the issues of child-pages showing up properly in the breadcrumb trail does not exist — they show up fine.

    One person much smarter about issues than me said that the plug-in worked without issues, but he was using version 4.2 of the plug-in. (And he was using the same sort of site configs that I am in terms of theme and skin.)

    Might you be able to e-mail me a copy of version 4.2 so I can use it — or perhaps you know about the issues I am having problems with and there is a new version coming out shortly?? I would be happy to revert back to 4.2 since it is said to work on similar sites to the ones I have problems with but don’t know where to get that version and think you might need to e-mail it to me.

    Thanks for your help on this.

    I have looked at the plug-in website for any documentation about how to correct these issues, but there is really very little there and nothing that applies to my issues it seems.

    Likely my issue is something pretty simple of some setting I don’t have properly checked or something — but as said – on all 4 sites it seems they are all set up the same.

    • I downgraded to the older 4.2 version and now have all 4 sites referencing “Home” instead of the actual name of the page — so that is good.

      But the issue of the 2 sites missing a page in the breadcrumb trail persists. The downgrade did not correct that at all. And BTW, the other 2 sites which have the plug-in installed and set up the same way , show the breadcrumb trail properly, picking up all the pages in the trail. But these are the same sites that showed the trail properly with the latest version also- so basically no change for this issue regardless of the plug-in version being used.

      I would like the sites to pick up all the pages in the breadcrumb trail and not miss pages.
      In an example of
      Sub Page
      Sub Sub page
      the sites with the problem are missing the reference to Sub Page in the trail and the trail goes from “Page” to “Sub Sub page”.
      However the sites that are correct pick up “Page” “Sub page” “Sub Sub page” in the breadcrumb trail.

      Any ideas how I can correct this?

  4. Ps – posted this issue on the WP site also – not sure of the best place to post the issue – here or there – sorry for being redundant.

  5. Hi,

    In my wordpress installation I’ve posts under multiple categories so for example I’ve 3 categories cat1,cat2 and cat3. Post1 is under all three categories. When you access Post1 through cat1, the menu trail shows Home=>Cat1=>Post1 which is fine but when you access Post1 through cat2, the breadcrumbs shows are Home=>Cat1=>Post1 instead of Home=>Cat2=>Post1. Same goes for cat3. So basically, post breadcrumb doesn’t show the referral category name instead it’s showing the 1st matching category name, how can I fix this?

    • Breadcrumb NavXT currently does not know how a user arrived at a location, and therefore it just picks a category when a post is a member of multiple categories. In Breadcrumb NavXT 5.1 I plan on adding a “Contextually Aware Taxonomy Term Selection” which should do what you want.

      In the mean time, it should be possible to exploit the behavior of Breadcrumb NavXT the same way Order Bender does to achieve this result.

      -John Havlik

  6. Hello,
    I’m having an issue with the Blog category not appearing in the breadcrumbs even though the option is enabled (checked) in the settings. I’ve toggled the settings to see if it fixes it, but no luck.

    Example you can see here, the category shows up (General), however the root blog category does not appear (Design Blog).

    All the other sections with categories appears properly. Just not the blog. Any insight or help would be greatly appreciated. Thanks.

Comments are closed.