This is the full changelog for all releases of Breadcrumb NavXT. It is here for reference purposes and it was getting too long to present in full on the main Breadcrumb NavXT page.

  • 7.3.0 [2-9-2024]:
    Behavior change: bcn_display_json_ld() now returns unescaped Unicode characters.
    Behavior change: $force parameter in bcn_display*() functions is now passed to bcn_breadcrumb_trail::fill() allowing generation of trails within the loop for the current loop item instead of the parent page/resource.
    New feature: Breadcrumb Trail block rewritten to have feature parity with Breadcrumb NavXT Widget.
    New feature: Breadcrumb Trail block supports basic styling within block editor.
    Bug fix: Fixed error where $outer_template argument was dropped within breadcrumb_navxt::display().
    Bug fix: Fixed issue where boolean settings were not exported/imported properly.
    Bug fix: Fixed cause of PHP error in bcn_breadcrumb_trail::maybe_add_post_type_arg() when 3rd party code breaks the WP API.
    Bug fix: Added check for proper queried object type for author archives.
  • 7.2.0 [2-9-2023]:
    Behavior change: Settings reset sets option entry to blank array, consistent with the change to only storing non-default values in the database.
    New feature: Added bcn_display_separator filter.
    New feature: Add per setting indication if Network wide settings are overriding the local setting.
    Bug fix: Improved compatibility with PHP8.1.
    Bug fix: Fixed PHP errors caused by unexpected entries in WP Post Types array.
    Bug fix: Settings help menu now shows up in the network settings page.
    Bug fix: Fixed cause of ‘file not found’ error on the import/export/reset form in the network settings page.
  • 7.1.0 [7-17-2022]:
    Behavior change: BCN_SETTINGS_FAVOR_* constant behavior changed to take advantage of settings changes in 7.0.
    Behavior change: Settings page now warns if it detected CPTs that were added too late.
    New feature: Added bcn_before_loop filter which runs at the top of bcn_breadcrumb_trail::display_loop().
    New feature: Added JSON formatted settings import and export (successor to the old XML settings import/export format).
    Bug fix: Fixed PHP error caused by term archives that don’t know the active term.
    Bug fix: Fixed PHP error caused by introduction of namespacing in the legacy XML settings importer and exporter.
    Bug fix: Explicitly set option autoload values, avoiding inappropriate default autoload values being used.
  • 7.0.2 [1-4-2022]:
    Behavior change: Allow value of Hhome_template, Hhome_template_unlinked, hseparator, and hseparator_higher_dim to be overridden via bcn_settings_init.
    Bug fix: Fixed cause of “Sorry, you are not allowed to access this page.” message when attempting to visit the settings page.
  • 7.0.1 [12-27-2021]:
    Behavior change: Moved bcn_settings_init filter to before establishing default setting values. This filter is no longer capable of changing the default values of settings.
    Behavior change: Moved setup of defaults to 9000 priority, intending to cover the majority of plugins that add CPTs.
    Bug fix: Fixed compatibility issues with PHP5.6.
    Bug fix: Fixed PHP error caused by some return value of page_ settings.
    Bug fix: Fixed PHP error caused by non settings settings in array passed into adminKit::settings_to_opts.
    Bug fix: Fixed issue with bcn_allowed_html not covering admin interface elements (mapped bcn_allowed_html to mtekk_adminkit_allowed_html).
  • 7.0.0 [12-17-2021]:
    Behavior change: Within the bcn_breadcrumb_trail object instead of passing term id and taxonomy, a WP_Term object is passed instead.
    Behavior change: Attachments now use parent post type for post type argument.
    New feature: Moved to adminKit 3.0
    New feature: Core bcn_breadcrumb_trail object now supports multi dimensional trails.
    New feature: Added bcn_opts_update_to_save filter.
    Bug fix: Fixed parameter order issue in REST controller that resulted in PHP Deprecated message in PHP8.
    Bug fix: Updated REST controller endpoint registration for better WordPress 5.5+ compatibility.
    Bug fix: Fixed compatibility issue with Widget settings not saving properly in WordPress 5.8.
    Bug fix: Fixed issue with the position count parameter within bcn_display when outputting a trail in reverse order.
  • 6.6.0 [10-31-2020]:
    Behavior change: Moved to using the post type of the parent post for the type archive rather than that of the current item.
    Bug fix: Fixed error thrown when a site does not have an administrator role.
  • 6.5.0 [06-12-2020]:
    Behavior change: Moved to using the taxonomy of the term rather than passed in taxonomy in various functions. As a consequence, this allows bcn_pick_post_term to override the taxonomy selection.
    Behavior change: Default template for unlinked breadcrumbs now includes breadcrumbList markup.
    New feature: Added new filter bcn_breadcrumb_linked.
    New feature: Introduced new WordPress capability: bnc_manage_options.
    Bug fix: Fixed XML settings exporter so that it no longer creates malformed files that cannot be imported when settings contain special HTML entities.
  • 6.4.0 [12-31-2019]:
    Behavior change: Attachment post type settings moved to Media, additional post type options made available.
    Behavior change: Privately published parent posts are now, by default, skipped over in breadcrumb trails.
    Behavior change: On single post breadcrumb trails, the hierarchical term code path is now used in cases where only a single term from a non-hierarchical taxonomy is present for the current post.
    New feature: Allow %link% tag in unlinked breadcrumb templates.
    New feature: Added bcn_show_post_private filter.
    New feature: Added bcn_show_type_term_archive filter.
  • 6.3.0 [5-3-2019]:
    New feature: Added Gutenberg block for displaying breadcrumb trails.
    New feature: Added bcn_display_attribute_array filter.
    New feature: Added bcn-aria-current template tag to facilitate WAI-ARIA Breadcrumb support.
    Bug Fix: Updated settings page to follow WP core standards for header structure.
    Bug Fix: Updated checkbox in adminKit to eliminate multiple labels to follow WCAG 2.0.
    Bug Fix: Fixed PHP error in circumstances of bcn_breadcrumb_trail::fill() falling back on treating an unknown item as a taxonomy.
  • 6.2.1 [10-26-2018]:
    Behavior change: Added span element wrapping the breadcrumb title in the default unlinked breadcrumb template.
    Bug fix: Fixed issue that caused PHP warnings and “the following settings were not saved” messages for hierarchical CPTs.
  • 6.2.0 [9-24-2018]:
    Behavior change: Cleaned up translations for default templates, simplifying and clarifying the translatable content.
    Behavior change: Default unlinked breadcrumb templates no longer contain BreadcrumbList markup.
    Behavior change: Breadcrumb NavXT REST API endpoints are no longer enabled by default.
    New feature: Added bcn_register_rest_endpoint filter.
    New feature: Added bcn_breadcrumb_assembled_json_ld_array filter.
    New feature: Added support for following the post parent hierarchy first then falling back to a secondary hierarchy.
    Bug fix: Fixed issue where on loading the settings page immediately after migrating settings causes PHP warnings on CPT and custom taxonomy settings.
    Bug fix: Fixed issue that caused the settings reset option under the help drop down to not work.
  • 6.1.0 [6-1-2018]:
    Behavior change: Links to generate support requests migrated to the forums.
    New feature: Added support for BreadcrumbList (microdata format) in the included widget.
    New feature: Added new Root Page support for author archives.
    New feature: Added REST API endpoint for posts, terms, and author archives.
    Bug fix: Corrected label for the BreadcrumbList (RDFa format) option in the included widget.
    Bug fix: Fixed issue where a PHP warning would be thrown due to get_term() returning something other than an instance of WP_Term.
  • 6.0.4 [1-26-2018]:
    Behavior change: Added auto migration of post type hierarchy settings to bcn_display*() functions.
    Bug fix: Fixed issue where a PHP notice would be generated on the page for posts when the blog breadcrumb display option is set to false.
    Bug fix: Fixed issue where a PHP notice would be generated on archive pages where attachments were included in the wp_query results.
  • 6.0.3 [1-1-2018]:
    Bug fix: Fixed issue where an improper breadcrumb would be generated in the trail for pages under some circumstances.
    Bug fix: Fixed issue where the post and page roots were not updating to track user changes in Settings > Reading.
  • 6.0.2 [12-30-2017]:
    Behavior change: Added warning alerting that bcn_breadcrumb::type must be an array.
    Bug fix: Changed Breadcrumb Separator and Paged Template from an input field to a textbox to reduce confusion caused by HTML entities.
    Bug fix: Fixed issue where the parents of a page may not show up in the breadcrumb trail.
    Bug fix: Fixed issue where the $reverse parameter for bcn_display and bcn_display_list did not work properly.
    Bug fix: Fixed issue where the bcn_display_list function did not include the li elements.
  • 6.0.1 [12-28-2017]:
    Behavior change: Removed unused Blog Template and Blog Template (Unlinked) from settings page.
    Bug fix: Fixed issue where changes to the hierarchy type for any post type would not save.
    Bug fix: Fixed issue where the blog display setting was ignored.
  • 6.0.0 [12-26-2017]:
    Behavior change: bcn_breadcrumb_trail::display_list() deprecated in favor of using the $template parameter in bcn_breadcrumb_trail::display().
    Behavior change: bcn_breadcrumb_trail::do_attachment() deprecated in favor of calling bcn_breadcrumb_trail::do_post().
    Behavior change: bcn_breadcrumb_trail::do_front_page() deprecated in favor of calling bcn_breadcrumb_trail::do_home().
    Behavior change: bcn_li_attributes filter was deprecated in favor of bcn_display_attributes.
    Behavior change: bcn_breadcrumb_trail::do_archive_by_date() deprecated in favor of calling bcn_breadcrumb_trail::do_day(), bcn_breadcrumb_trail::do_month(), andy/or bcn_breadcrumb_trail::do_year().
    Behavior change: bcn_breadcrumb_trail::find_type() deprecated and removed from bcn_breadcrumb_trail.
    Behavior change: Breadcrumb for 404 error pages changed to be a child of the front page.
    New feature: Added support for various HTML tags in the widget’s pretext field.
    New feature: Added bcn_default_hierarchy_display filter.
    New feature: Added bcn_default_hierarchy_type filter.
    New feature: Added $posttype_name as the third parameter to bcn_show_tax_private.
    Bug fix: Fixed UI/UX issue in the settings screen where enabling/disabling settings groups for the Home, Blog, and Mainsite breadcrumb settings did not work.
    Bug fix: Fixed UI/UX issue in the settings screen where not including the paged breadcrumb still allowed the paged breadcrumb template to be edited.
    Bug fix: Removed use of create_function in registering the widget as it was deprecated in PHP7.2.
  • 5.7.1 [6-30-2017]:
    Bug fix: Fixed erroneous use of $linked that caused a PHP warning in bcn_display_json_ld().
    Bug fix: Fixed issue where removing a breadcrumb from the trail could cause one or more breadcrumb separators to inappropriately disappear.
  • 5.7.0 [4-21-2017]:
    New feature: Added bcn_display_json_ld() function for producing BreadcrumbList compliant JSON-LD markup.
    Bug fix: Fixed issue where the uninstaller caused PHP Errors when ran from WP CLI.
    Bug fix: Fixed issue where bcn_breadcrumb_trail::find_type() caused a PHP Warnings in certain circumstances.
    Bug fix: Fixed typo in the administrative interface.
  • 5.6.0 [12-23-2016]:
    New feature: Added fourth parameter, $force, to bcn_display(), and bcn_display_list() allowing the internal caching mechanism to be bypassed.
    New feature: Moved to multiple line text boxes rather than regular single line text inputs for the breadcrumb templates in the settings page to enhance visibility.
    Bug fix: Fixed issue where general searches had the blog breadcrumb in the breadcrumb trail.
    Bug fix: Fixed issue where the blog breadcrumb options were erroneously made available when a Posts Page was not set.
  • 5.5.2 [9-30-2016]:
    Bug fix: Fixed issue where the “blog breadcrumb” setting does not affect the inclusion of the blog breadcrumb in the breadcrumb trail.
  • 5.5.1 [8-13-2016]:
    Bug fix: Fixed issue in bcn_breadcrumb_trail::find_type() that identified pages as posts, causing the erroneous inclusion of the post root in the breadcrumb trail for pages.
  • 5.5.0 [8-12-2016]:
    Behavior change: Internal mechanics to handle post parents as the hierarchy for a post (of any post type) has changed to use ‘BCN_POST_PARENT’ rather than ‘page’ for the taxonomy_type.
    Behavior change: Internal mechanics to handle dates as the hierarchy for a post (of any post type) has changed to use ‘BCN_DATE’ rather than ‘date’ for the taxonomy_type.
    Behavior change: Taxonomy term hierarchy selection logic in bcn_breadcrumb_trail::pick_post_term() has changed to picking the deepest known child of the first hierarchy found in the list of terms returned by get_the_terms() rather than the first term with a child.
    New feature: Added support for referer influenced taxonomy selection for a post’s (any post type) breadcrumb trail.
    New feature: Added translate and lang as valid attributes for tags within breadcrumb templates.
    New feature: Added srcset and sizes as valid attributes for img tags within breadcrumb templates.
    New feature: Added itemprop as a valid attribute for the meta tags within breadcrumb templates.
    Bug fix: Fixed various issues caused by other plugins/themes modifying the $post global.
    Bug fix: Fixed issue where WPML Extensions would cause a CPT without a set root page to use the Post post type’s root page.
  • 5.4.0 [03-18-2016]:
    Behavior change: Migrated to new adminKit version, some functions previously in the admin classes are now handled upstream.
    New feature: Added bcn_post_terms filter to bcn_breadcrumb_trail::post_terms() to control the terms included in a non-hierarchical term breadcrumb for a post.
    New feature: Added bcn_add_post_type_arg filter to bcn_breadcrumb_trail::maybe_add_post_type_arg() to control when the post_type argument is added to URLs for archives.
    New feature: Added bcn_pick_post_term filter to bcn_breadcrumb_trail::post_hierarchy() to allow overriding Breadcrumb NavXT’s default term selection behavior.
    Bug fix: Fixed issue with untranslatable title on the settings page.
    Bug fix: Cleanup of several trivial differences between bcn_admin and bcn_network_admin.
    Bug fix: Fixed improper display of “Your settings are out of date. Migrate now.” message on fresh installs.
    Bug fix: Clarified verbiage in regards to the paged breadcrumb.
    Bug fix: Added translation wrappers for date format strings in bcn_breadcrumb_trail::do_archive_by_date().
    Bug fix: Fixed issue where bcn_breadcrumb_trail::is_builtin() would cause PHP warnings when the passed in post type was not an actual post type.
    Bug fix: Fixed issue that would cause a PHP error if WP_Widget is unavailable.
  • 5.3.1 [12-14-2015]:
    Bug fix: Fixed alignment issue of the main content of the settings page on WordPress 4.4.
    Bug fix: Fixed error caused by options upgrading not re-establishing new settings.
    Bug fix: Fixed PHP error caused by bcn_breadcrumb_trail::get_type_string_query_var() returning an array when the post_type query variable is an array.
  • 5.3.0 [11-12-2015]:
    Behavior change: Breadcrumb NavXT will no longer default to setting the root page for CPTs.
    Behavior change: Breadcrumb NavXT will no longer inject a breadcrumb for a CPT archive page if a root page is set for that CPT.
    Behavior change: Breadcrumb NavXT now defaults to BCN_SETTINGS_USE_LOCAL rather than BCN_SETTINGS_USE_NETWORK if all of the BCN_SETTINGS_* globals are not defined.
    Behavior change: The included widget now supports RDFA style, BreadcrumbList format rather than the deprecated Google Breadcrumbs format.
    Behavior change: Default settings for breadcrumb templates now conform to RDFA style, BreadcrumbList format rather than the deprecated Google Breadcrumbs format.
    New feature: Added bcn_widget_display_trail action to enhance the included widget’s extensibility.
    New feature: Added bcn_widget_display_types action to enhance the included widget’s extensibility.
    New feature: The plugin uninstaller has been re-factored, includes support for uninstalling in PHP5.2.
    New feature: Unit tests added for all non-deprecated features in bcn_breadcrumb.
    New feature: Unit tests added for the uninstaller.
    New feature: Date based hierarchies are now available for CPTs.
    New feature: Date archives restricted by CPT are now supported.
    New feature: Taxonomy archives restricted by CPT are now supported.
    Bug fix: Fixed issue where the multibyte supplicant functions were not always being included due to WordPress shipping with its own subset of theses functions.
    Bug fix: Fixed issue where on an archive for a post type the archive breadcrumb would appear twice.
  • 5.2.2 [6-1-2015]:
    Bug fix: Fixed issue where the current item would use a built in default template rather than the breadcrumb template in the settings.
    Bug fix: Updated currently distributed translations set and list to match the current set of translations that achieve the 90% completeness threshold for inclusion.
    Bug fix: Fixed issue where a PHP warning would be displayed when BCN_SETTINGS_USE_NETWORK is defined.
  • 5.2.1 [5-25-2015]:
    Bug fix: Added additional checks for empty URLs and templates within bcn_breadcrumb to prevent various bugs when empty URLs and/or templates are passed in.
    Bug fix: Move away from building URLs for search breadcrumbs and instead using get_search_link() to fix support for pretty permalinks.
    Bug fix: Fixed issue where media items (attachments) that have not been attached to a post yet would cause an incorrect breadcrumb trail to be generated.
    Bug fix: Fixed issue where attachments of the front page would cause PHP Warnings.
    Bug fix: Fixed issue where attachments of the front page would have duplicate breadcrumbs for the home page.
    Bug fix: Fixed issue where attachments of pages would have an extraneous breadcrumb relating to the page for posts.
    Bug fix: Fixed issue with the text domain/domain path in the plugin header.
  • 5.2.0 [1-9-2015]:
    Deprecated: The Max Breadcrumb Length setting has been deprecated in favor of using CSS styling to perform the length limiting.
    Behavior change: The archive page for a post type is now generated for the top ancestor post rather than for the current page when “post parent” is used as the post’s hierarchy.
    Behavior change: Now requires PHP5.3 or newer.
    New feature: Added bcn_type_archive_post_type filter.
    New feature: Settings depending on another setting to be enabled are disabled when the dependency setting is disabled.
    New feature: More descriptive messages on settings saving (notify user on success, failure, and no changes to save).
    Bug fix: Fixed awkward wording in the settings page for post hierarchy settings.
    Bug fix: Fixed missed default templates for post formats when all taxonomy settings had the tax_ prefix added in 5.1.
    Bug fix: Fixed bulk of compatibility issues with bbPress.
  • 5.1.1 [7-29-2014]:
    Bug fix: Fixed issue where attachments and their parents have the same link when ‘link current item’ is enabled.
    Bug fix: Pass the same parameters into the widget title and (pre) text filters as the default WordPress widgets.
    Bug fix: Fixed issue where PHP warnings would be thrown on author pages for authors that do not have any posts.
    Bug fix: Reduced severity of $post global not being of type WP_Post, will silently exit on non-WP_DEBUG enabled sites.
  • 5.1.0 [6-9-2014]:
    Behavior change: bcn_breadcrumb_trail::do_post()) now expects to be passed in a valid WP_Post object.
    Behavior change: breadcrumb_navxt::version changed to a constant to allow uninstantiated access of the plugin version.
    New feature: Support Google’s RDFa Breadcrumbs microformat by default.
    New feature: Added bcn_opts_update_prebk filter.
    Bug fix: Validate HTML5 options on tab traversal.
    Bug fix: Fixed issue where the settings importer parsed the version string incorrectly.
    Bug fix: Added ‘typeof’ to list of valid HTML tag attributes.
    Bug fix: Prefixed all taxonomies with ‘tax_’ to prevent name collisions.
    Bug fix: Added ID to Post and Taxonomy Term Elements in bcn_breadcrumb_trail::do_root() as is done everywhere else.
    Bug fix: Fixed issue with bcn_breadcrumb_trail::do_author() returning the incorrect user under some circumstances.
    Bug fix: Fixed issue where saving twice on a tab in the settings page would cause the next page load to open the general tab rather than the current tab.
    Bug fix: Added bcn_breadcrumb_template filter back into bcn_breadcrumb::set_template(), was a regression in 5.0 from 4.4.
    Bug fix: Fixed issue where the included widget did not check against default settings, causing PHP Warnings to show up on the frontend under some circumstances.
    Bug fix: Fixed issue where we didn’t handle WP_POST::has_archive correctly when it was a string, causing issues with CPTs generated by some plugins.
    Bug fix: Fixed issue where the default taxonomy selected for a CPT could be a non-public taxonomy.
    Bug fix: Attachments get their own title within the settings page now.
    Bug fix: Filter the title and pre text in the widget.
  • 5.0.1 [12-31-2013]:
    Behavior Change: Notify multisite users when settings may be overridden by the network settings and vice versa.
    Bug fix: Updated tab style to match WordPress 3.8 look and feel.
    Bug fix: Fixed issue where bcn_breadcrumb_trail::display_list() would produce multiple instances of the class attribute.
    Bug fix: Fixed several issues with the uninstaller.
  • 5.0.0 [11-2-2013]:
    Behavior Change: Moved bcn_breadcrumb_trail::trail to bcn_breadcrumb_trail::breadcrumbs
    New feature: Added bcn_breadcrumb_trail_object filter.
    New feature: Added bcn_li_attributes filter.
    New feature: Added bcn_breadcrumb_types filter.
    New feature: Added Network Admin Settings page.
    New feature: Added xmlns:v and property to the valid tag attributes.
    Bug fix: The current_item breadcrumb for search results should result in a valid HTTPS link when appropriate.
  • 4.4.0 [6-21-2013]:
    New feature: Added bcn_breadcrumb_url filter.
    New feature: Add resource ID to the bcn_breadcrumb_title filter.
    New feature: Added bcn_breadcrumb_template filter.
    New feature: Added bcn_allowed_html filter.
    New feature: Added bcn_template_tags filter.
    Bug fix: Fixed issue where invalid characters could end up in URLs due to other plugins.
    Bug fix: Revise the allowed HTML for breadcrumbs in the trail.
  • 4.3.0 [2-13-2013]:
    Behavior change: Home and Mainsite titles were removed.
    Behavior change: All HTML capable strings are now passed through wp_kses.
    New feature: Added bcn_breadcrumb_url filter.
    New feature: %title% and %htitle% now are replaced with the the “Site Title” for the home breadcrumb and the “Network Name” for mainsite breadcrumbs.
    New feature: Support for the proposed Theme Hook Alliance tha_breadcrumb_navigation filter.
    New feature: Added %ftitle% and %fhtitle% tags that are not affected by bcn_breadcrumb::trim().
    Bug fix: Minor tweaks to the tabs in the admin page to better support the new version of jQuery UI tabs (in WordPress 3.5+).
    Bug fix: Fixed issue where initial settings were not being translated due to the text domain not loading.
    Bug fix: Added verbiage to clarify what the “Post Parent” selection for “Post Hierarchy” does.
  • 4.2.0 [9-28-2012]:
    Behavior change: Date archives are only available for the “post” post type.
    New feature: All Custom Post Types can now either use a post parent, or taxonomy based hierarchy.
    New feature: Post Format archives are now supported.
    New feature: Reorganized settings page with more responsive elements.
    Bug fix: Widget will now display properly when told to include the paged breadcrumb on the main posts archive.
    Bug fix: Using flat taxonomies as the post hierarchy no longer causes extraneous breadcrumb templates to be applied.
    Bug fix: Mainsite link now works on posts and pages in multisite environments.
    Bug fix: bcn_breadcrumb::title_trim() no longer cuts HTML encoded characters.
    Bug fix: bcn_breadcrumb::title_trim() no longer trims the title when the title length is equal to the max length.
  • 4.1.0 [6-5-2012]:
    Behavior change: Made the behavior of posts using flat taxonomies match the behavior of using a hierarchical taxonomy when the post is not assigned a taxonomy term.
    New feature: Custom Post Types that are hierarchical can now fall back to a taxonomy if they don’t have a parent.
    New feature: Pretext option for the included Widget, allows ‘You are here: ‘ type messages in the widget.
    Bug fix: Textdomain was changed to the correct one in the widget.
    Bug fix: Textdomain was changed from ‘breadcrumb_navxt’ to ‘breadcrumb-navxt’ for improved compatibility with the new GlotPress translation flow.
    Bug fix: Fixed cause of PHP warnings on empty term archive pages.
    Bug fix: Fixed cause of PHP warnings on term archives restricted to a specified post type.
    Bug fix: Fixed cause of PHP warnings and improper behavior on author archives if showing the page number in the breadcrumb trail.
  • 4.0.2 [2-17-2012]:
    New feature: Estonian translation added props to Martin Orn.
    New feature: Azerbaijani translation added props to Zaur Bayramov.
    Bug fix: Replaced deprecated RDFa and Microformat breadcrumbs with breadcrumbs support in the included sidebar widget.
    Bug fix: Mainsite breadcrumbs are linked once again.
    Bug fix: Safe default settings for CPTs and taxonomies should work now.
    Bug fix: Updated translations should work, previously the old ones loaded.
  • 4.0.1 [1-3-2012]:
    New feature: Norwegian translations added props to Jan Rosvoldsve.
    Bug fix: Fixed line 591 and line 646 errors in multisite installs.
    Bug fix: Attachments will now obey the root page setting for their parent, regardless of the parent’s post type.
  • 4.0.0 [12-14-2011]:
    Behavior change: Prefix, suffix, and anchor settings have been replaced with templates for all breadcrumb types.
    Behavior change: bcn_display_nested function was removed from the main plugin. Will appear in a supplementary plugin.
    Behavior change: Import/Export/Reset tab moved under the admin bar Help menu.
    Behavior change: Paged breadcrumbs are enabled in the default settings, among other subtle changes.
    New feature: More useful Help menu, utilizing the new WordPress 3.3 Help menu.
    New feature: True URLs are now generated for current items when link current item is enabled.
    New feature: The display of the custom post type archive breadcrumb for custom post types may now be disabled.
    New feature: Added in fallback functions for PHP’s multibyte character string functions for environments that do not have multibyte character support.
    Bug fix: Custom post type archives now respect the root page setting.
    Bug fix: Custom post types without WordPress post archives enabled will no longer cause a double root page breadcrumb to be generated.
    Bug fix: Tabs on the settings page are now rounded for all “modern” browsers, including Firefox, Chrome, and IE9.
    Bug fix: Tabs on the settings page are now remembered between setting saves (including multiple saves from within the same tab).
    Bug fix: Fixed another cause of the “The following settings were not saved” error message.
  • 3.9.0 [5-31-2011]:
    Behavior change: Settings can not be saved, imported, or exported until any necessary settings updates and/or installs are completed.
    New feature: Support for WordPress 3.1 custom post type archives.
    Bug fix: Displays a warning message in the WordPress dashboard if PHP version is too old rather than trying to deactivate and dieing on all pages.
    Bug fix: Fixed a potential cause for the “options not saved” error.
    Bug fix: Fixed bug where the “Blog Breadcrumb” was not obeyed on archives.
  • 3.8.1 [2-25-2011]:
    Bug fix: Root pages for custom post types should work again.
    Bug fix: The post_post_root and post_page_root not being saved warning when saving settings should be fixed.
  • 3.8.0 [2-21-2011]:
    New feature: Error reporting added for some errors that may occur during a settings save.
    New feature: Custom post types may use dates as their taxonomy type.
    New feature: New display_nested function to facilitate support for Google’s Breadcrumbs RDFa and Microformat.
    New feature: Paged display works for all post types now (was previously restricted to archives).
    Bug fix: Fixed a few cases where Breadcrumb NavXT may cause PHP warnings.
    Bug fix: Automatically deactivates if PHP version is tool old rather than just displaying warning message.
    Bug fix: Custom post types that are not associated with any taxonomies no longer cause PHP Notices.
    Bug fix: Various PHP Notices introduced in 3.7.0 were fixed.
    Bug fix: Fixed issue where multiple runs caused the current_item_prefix and current_item_suffix to be applied multiple times.
    Bug fix: The included display functions will behave more appropriately when database settings don’t exist.
    Bug fix: Fixed multibyte UTF-8 character support for custom taxonomies.
    Bug fix: Fixed issue where the widget (Appearance > Widgets) would not load the appropriate translations.
  • 3.7.0 [12-3-2010]:
    New feature: Support for “global”/network wide breadcrumb trails in networked setups of WordPress 3.0.
    New feature: Can use any hierarchical post type as a hierarchy for flat post types.
    New feature: Users are now warned if settings are out of date, allowed to do a one click settings migration.
    New feature: Users can now control if a post type uses the “posts page” in it’s hierarchy or not.
    Bug fix: Breadcrumb trails for attachments work properly now for custom post types.
    Bug fix: Users can now set custom post types to have a page hierarchy through the settings page.
    Bug fix: Fixed issues where the PHP version check did not work correctly.
    Bug fix: Fixed issue where all settings would get reset on “clean” 3.6.0 installs on plugin activation.
    Bug fix: Fixed issue when a static front page is specified but the post page is not.
  • 3.6.0 [8-23-2010]:
    New feature: Vastly improved support for WordPress custom post types.
    New feature: Can now restrict breadcrumb trail output for the front page in the included Widget.
    New feature: Can now undo setting saves, resets, and imports.
    New feature: Translations for Japanese now included thanks to Kazuhiro Terada.
    Bug fix: Fixed issue where the class element were not closed in a li opening tag.
    Bug fix: Safer handling of blank anchor templates.
    Bug fix: Fixed issue where the %title% tag in the current item anchor template would be trimmed.
  • 3.5.1 [6-3-2010]:
    Bug fix: Fixed issue where a deactivation/activation cycle would reset all of the user specified settings.
    Bug fix: Fixed issue where the archive by date suffix field did not save.
    Bug fix: Fixed issue where custom taxonomy settings did not save.
    Bug fix: Fixed issue where xml settings files would not import.
    Bug fix: French and German translations updated for 3.5.x.
  • 3.5.0 [5-25-2010]:
    New feature: Added actions bcn_before_fill and bcn_after_fill, see documentation for more information.
    New feature: Widget rewritten to use the WordPress 2.8 Widget API, now multi-widget capable.
    New feature: Widget output can be in list form, can be in reversed order, and can be unlinked.
    Bug fix: Fixed issue where the current tab was forgotten after a save in the settings page.
    Bug fix: Fixed various WP API issues with WordPress 3.0.
    Bug fix: Fixed title trimming so that it works properly with multi-byte characters.
  • 3.4.1 [12-23-2009]:
    Bug fix: Fixed issue with PHP unexpected $end on line 1567 in breadcrumb_navxt_admin.php.
    Bug fix: Fixed issue where the %link% anchor tag would not be replaced with a URI for flat taxonomies (e.g. tags).
    Bug fix: Fixed issue where paged breadcrumbs would cause WP_Error objects to be thrown.
  • 3.4.0 [12-17-2009]:
    New feature: Proper support of custom taxonomies. category_parents and post_tags replaced with term_parents and post_terms.
    New feature: Ability to use date as post “taxonomy”.
    New feature: Translations for Italian now included thanks to Luca Camellini.
    Bug fix: Fixed permalink for day breadcrumbs.
    Bug fix: Flat taxonomy archive breadcrumbs now are surrounded by both the standard and archive prefix/suffix combination.
  • 3.3.0 [8-3-2009]:
    Behavior change: The core plugin was removed, and administrative plugin renamed, direct class access still possible.
    New feature: Ability to trim the title length for all breadcrumbs in the trail.
    New feature: Ability to selectively include the “Blog” in addition to the “Home” breadcrumb in the trail (for static front page setups).
    New feature: Translations for Russian now included thanks to Yuri Gribov.
    New feature: Translations for Swedish now included thanks to Patrik Spathon.
    Bug fix: Minor tweaks to the settings link in the plugins listing page so that it fits better in WordPress 2.8.
    Bug fix: Now selects the first category hierarchy of a post instead of the last.
  • 3.2.1 [5-29-2009]:
    New feature: Translations for Belorussian now included thanks to “Fat Cow”.
    Bug fix: The bcn_display() and bcn_display_list() wrapper functions obey the
    $return parameter.
    Bug fix: Anchors now will be valid html even when a page/category/post title has html tags in it.
    Bug fix: Revised bcn_breadcrumb_trail::category_parents to work around a bug in get_category that causes a WP_Error to be thrown.
    Bug fix: Importing settings XML files should no longer corrupt html entities.
    Bug fix: Can no longer import and reset options at the same time.
    Bug fix: WordPress 2.6 should be supported again.
  • 3.2.0 [5-4-2009]:
    New feature: Now can output breadcrumbs in trail as list elements.
    New feature: Translations for Dutch now included thanks to Stan Lenssen.
    New feature: Now breadcrumb trails can be output in reverse order.
    New feature: Ability to reset to default option values in administrative interface.
    New feature: Ability to export settings to a XML file.
    New feature: Ability to import settings from a XML file.
    Bug fix: Anchor templates now protected against complete clearing.
    Bug fix: Administrative interface related styling and JavaScript no longer leaks to other admin pages.
    Bug fix: Calling bcn_display() works with the same inputs as bcn_breadcrumb_trail::display().
    Bug fix: Calling bcn_display() multiple times will not place duplicate breadcrumbs into the trail.
  • 3.1.0 [1-26-2009]:
    New feature: Tabular plugin integrated into the administrative interface/settings page plugin.
    New feature: Default options now are localized.
    New feature: Plugin uninstaller following the WordPress plugin uninstaller API.
    Bug fix: Administrative interface tweaked, hopefully more usable.
    Bug fix: Tabs work with WordPress 2.8-bleeding-edge.
    Bug fix: Translations for German, French, and Spanish are all updated.
    Bug fix: Paged archives, searches, and frontpage fixed.
  • 3.0.2 [11-26-2008]:
    Bug fix: Default options are installed correctly now for most users.
    Bug fix: Now bcn_breadcrumb_trail::fill() is safe to call within the loop.
    Bug fix: In WPMU options now are properly separate/independent for each blog.
    Bug fix: WPMU settings page loads correctly after saving settings.
    Bug fix: Blog_anchor setting not lost on non-static frontpage blogs.
    Bug fix: Tabular add on no longer causes issues with WordPress 2.7.
    New feature: Spanish and French localization files are now included thanks to Karin Sequen and Laurent Grabielle.
  • 3.0.1 [10-22-2008]:
    Bug fix: UTF-8 characters in the administrative interface now save/display correctly.
    Bug fix: Breadcrumb trails for attachments of pages no longer generate PHP errors.
    Bug fix: Administrative interface tweaks for installing default options.
    Bug fix: Changed handling of situation when Posts Page is not set and Front Page is set.
  • 3.0.0 [9-22-2008]:
    New feature: Completely rewritten core and administrative interface.
    New feature: WordPress sidebar widget built in.
    New feature: Breadcrumb trail can output without links.
    New feature: Customizable anchor templates, allows things such as rel=”nofollow”.
    New feature: The home breadcrumb may now be excluded from the breadcrumb trail.
    Bug fix: 404 page breadcrumbs show up in static frontpage situations where the posts page is a child of the home page.
    Bug fix: Static frontpage situations involving the posts page being more than one level off of the home behave as expected.
    Bug fix: Compatible with all polyglot like plugins.
    Bug fix: Compatible with Viper007bond’s Breadcrumb Titles for Pages plugin (but 3.0.0 can replace it as well)
    Bug fix: Author page support should be fixed on some setups where it did not work before.
  • 2.1.4 [7-15-2008]:
    Bug fix: Post title max length option regression fixed.
    Bug fix: Double Home breadcrumb in static front page setups fixed.
    Bug fix: Home Breadcrumb in static front pages can be removed globally as it should have been able to before.
  • 2.1.3 [7-1-2008]:
    New feature: Support for the qTranslate plugin.
    Bug fix: Removed some options that already have WordPress equivalents, general Administrative interface cleanup.
    Bug fix: I18n support improved, added some strings that should have been there before.
    Bug fix: Improved security for the administrative form, using the standard WP nonce tools.
    Bug fix: Single posts under the category taxonomy now properly finds the first hiearchy all the time, the “Double Dipping the Hierarchy” problem is fixed.
  • 2.1.2 [5-21-2008]:
    Bug fix: Problems with /blog/ and // showing up in current item links should be resolved.
    Bug fix: Static front page options should work as expected now.
    Bug fix: Paged items now work as they did in 2.0.x.
    Bug fix: Auto detection of static front pages has been fixed to be consistent across the board.
  • 2.1.1 [4-25-2008]:
    Bug fix: Removed the array qualifier from the function header of bcn_select_options() this should fix compatibility issues with PHP4.
    Bug fix: Problems with linking the current item setting causing invalid XHTML output resolved.
    Bug fix: Behavior of linking current item works better in general.
  • 2.1.0 [4-2-2008]:
    New feature: Administrative interface has been reworked to match the WordPress 2.5 administration panel.
    New feature: Breadcrumbs leading to posts can now be delimited by categories or tags (See new options: singleblogpost_taxonomy, singleblogpost_taxonomy_display).
    New feature: Attachments to pages will now show the full path to the attachment.
    New feature: When using the posttitle_maxlen option, the title will be trimmed to the nearest word, not exceeding the maximum length.
    Bug fix: Static front page support is back, supports the official WordPress static frontpage method.
  • 2.0.4 [3-24-2008]:
    Bug fix: The warning generated by PHP on the use of strpos has been resolved.
  • 2.0.3 [3-6-2008]:
    Bug fix: Administrative interface no longer interferes with WordPress global CSS styles.
    Bug fix: Usermeta errors will now also generate a usermeta variable dump (will aide in permanently solving the problem).
    Bug fix: The warning generated by some versions of PHP on the use of strpos has been resolved.
  • 2.0.2 [2-15-2008]:
    Bug fix: Administrative interface default settings are now loaded when installing.
    Bug fix: Localization should work correctly now.
    Bug fix: Administrative interface now should handle html payloads in the form fields correctly.
    New feature: German localization files are now included thanks to Tom Klingenberg.
  • 2.0.1 [1-25-2008]:
    Bug fix: Administrative interface errors now have more obvious meaning.
  • 2.0.0 [1-19-2008]:
    New feature: Support for the standard WordPress localization methods.
    New feature: Support for the Polyglot plugin.
  • 2.0.0 Beta 2 [11-30-2007]:
    Bug fix: Page hierarchy should work correctly now in hierarchies deeper than 3 pages.
    New feature: SVN repository at
    New feature: Integration with the WordPress method of notification of new versions of the plugin.
  • 2.0.0 Beta 1 [11-22-2007]:
    Initial Beta Release.
    New feature: Completely rewritten substructure
    New feature: Hierarchical categories.
    New feature: 100% WordPress API support, no more custom queries.

The following versions were released as Breadcrumb Navigation XT, before it was renamed Breadcrumb NavXT.

  • 1.10.1 [10-05-2007]:
    Bug fix: “static front page” setting should now properly reflect the current value of the setting rather than the default/null value.
  • 1.10.0 [9-22-2007]:
    New feature: Added support for WordPress 2.3’s tagging system (See new options ‘archive_tag_prefix’ and ‘archive_tag_suffix’).
    Bug fix: All combo box settings now properly reflect the current value of the setting rather than the default value.
  • 1.9.3 [8-25-2007]:
    Bug fix: The new administration interface system now supports HTML entities more appropriately.
  • 1.9.2 [8-16-2007]:
    Bug fix: The new administration interface system now will output a breadcrumb on PHP4 systems.
  • 1.9.1 [8-12-2007]:
    Bug fix: Defaults now are loaded for the administrative interface.
  • 1.9.0 [8-06-2007]:
    New feature: New administrative interface allowing easier implementation and customization of breadcrumb navigation menus.
    New feature: Output for date archives now has three different possibilities for ordering month, day, and year. (See new option ‘archive_date_format’)
    New feature: Output for searches now displays the searched text along with a prefix and suffix. (See new options ‘search_prefix’ and ‘search_suffix’)
    Bug fix: Now attachment posts are no longer seen as normal posts. (See new options ‘attachment_prefix’ and ‘attachment_suffix’)
  • 1.8.0 [6-30-2007]:
    Initial release by John Havlik
    New feature: Option to limit the number of categories displayed in the breadcrumb when enabled. (See new option ‘singleblogpost_category_maxdisp’)
    Bug fix: Now author pages are no longer “broken”. (See new options ‘author_prefix’, ‘author_suffix’, and ‘author_display’)