Breadcrumb NavXT

Changelog

7.5.1

Release date: December, 21st 2025

• Behavior change: Removed deprecated bcn_li_attributes filter.
• Bug fix: Fixed issue where the block could be used to generate breadcrumb trails that were not for the current resource.
• Bug fix: Removed deprecated title length setting from settings page.
• Bug fix: Fixed issue where XML settings import did not properly validate imported settings.

7.5.0

Release date: December, 4th 2025

• Behavior change: Refactored bcn_breadcrumb_trail::post_hierarchy to use WP_Post instance instead of id/type/parent parameters.
• Behavior change: Removed deprecated function breadcrumb_trail::title_trim per deprecation schedule.
• Bug fix: Fixed issue where the uninstaller would result in PHP errors and fail.
• Bug fix: Fixed issue where “Hide on Home” option in the block did not function as intended.
• Bug fix: Fixed typo in the block that resulted in web browser console warning.
• Bug fix: Fixed issue where the block selector in block.json did not match the selector the block generated with.
• Bug fix: Fixed issue where settings exporter failed to export settings.
• Bug fix: Fixed issue where boolean options with false values could not be imported.

7.4.1

Release date: January, 9th 2025

• Bug fix: Fixed issue where the legacy widget was not available due to changes introduced in 7.4.0.

7.4.0

Release date: December, 30th 2024

• New feature: Added bcn_admin_post_root_args filter.
• Bug fix: Fixed issue where the ignore the breadcrumb cache option within the Breadcrumb Trail block resulted in the breadcrumb trail not getting generated on the home page.
• Bug fix: Fixed issue where breadcrumb trails generated within the loop were improperly missing the home breadcrumb when on the home page.
• Bug fix: Fixed issue breadcrumb-navxt textdomain is loaded too early (improved WordPress 6.7 support).
• Bug fix: Improved bcn_breadcrumb_trail::post_hierarchy() resiliency to unexpected returns from get_post().
• Bug fix: Fixed translation text typos in Breadcrumb Trail block.

7.3.1

Release date: June, 27th 2024

• Bug fix: Fixed issue where $force parameter wasn’t passed into bcn_breadcrumb_trail::fill() within bcn_display*() functions.
• Bug fix: Fixed improper textdomain existing within adminKit.
• Bug fix: Fixed issue with $force parameter where when it is not set the homepage breadcrumb would use the wrong template when calling the breadcrumb trail within the loop.

7.3.0

Release date: February, 9th 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

Release date: February, 9th 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

Release date: July, 17th 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

Release date: January, 4th 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

Release date: December, 27th 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

Release date: December, 17th 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.