Breadcrumb NavXT Multidimension Extensions 2.5.3

Announcing the immediate availability of Breadcrumb NavXT Multidimension Extensions 2.5.3. This version improves compatibility with the upcoming Breadcrumb NavXT 6.3. Changes in Breadcrumb NavXT 6.3’s setting page results in older versions of Breadcrumb NavXT Multidimension Extensions producing a blank settings tab.

You can grab Breadcrumb NavXT Multidimension Extensions from the WordPress.org plugin repository.

bcn_display_attribute_array

This filter is applied within the bcn_breadcrumb_trail class in the display_loop() function. This filter was introduced in version 6.3 to be an easier to use version of bcn_display_attributes. It receives three parameters:

  • $attribute_array(array)(required) A key-value pair array of the attributes placed in the li tag that wraps the each breadcrumb. Keys are attribute names, values is an array of values for the attribute
  • $type(array)(optional) The array of type strings for the breadcrumb
  • $id(int|NULL)(optional) The ID of the resource represented by the breadcrumb, will be NULL if not suitable ID exists

Updated:

bcn_register_rest_endpoint

This filter is applied within the bcn_rest_controller class in the register_rest_route() function. This filter was introduced in version 6.2. It receives four parameters:

  • $register_rest_endpoint(boolean)(required) The boolean decision whether or not to allow the REST endpoint to be registered
  • $endpoint(string)(optional) The name of the REST API endpoint being registered
  • $version(string)(optional) The REST API version of the endpoint being registered
  • $methods(array)(optional) The array of methods for the REST API endpoint being registered

Related Articles

Updated:

bcn_breadcrumb_assemble_json_ld_array

This filter is applied within the bcn_breadcrumb class in the assemble_json_ld() function. This filter was introduced in version 6.2 with three parameters. It receives three parameters:

  • $json_ld_array(array)(required) The JSON-LD array that will be returned by bcn_breadcrumb::assemble_json_ld() to filter
  • $type(array)(optional) The array of type strings for the breadcrumb
  • $id(int|NULL)(optional) The ID of the resource represented by the breadcrumb, will be NULL if not suitable ID exists

Updated:

Changing the Home Breadcrumb Title

Prior to Breadcrumb NavXT 4.3.0, there was an option for setting the Home and Mainsite breadcrumb titles. However, these were removed as their functionality was completely redundant—the same behavior could be achieved by modifying the Home and Mainsite breadcrumb templates, replacing %title% and %htitle% with the desired title.

This works fine for most use cases. However, it does not work with bcn_display_json_ld() (introduced in 5.7.0). Luckily, there is an even better way to define the titles for these breadcrumbs—using the bcn_breadcrumb_title filter.

The Code

add_filter('bcn_breadcrumb_title', 'my_breadcrumb_title_swapper', 3, 10);
function my_breadcrumb_title_swapper($title, $type, $id)
{
	if(in_array('home', $type))
	{
		$title = __('Home');
	}
	return $title;
}

To force the Home breadcrumb to use ‘Home’ as the title, just place this code into your site specific plugin and activate. Want to use something else as the title? Change ‘Home’ to whatever you wish to display for the home breadcrumb.

Consider the Following

  1. Combining this method of specifying the Home title with the method of replacing %title% and %htitle% with the desired title in the Home breadcrumb templates is not recommended—the Home breadcrumb templates will take precedence.
  2. This example may be extended to modify the title for the Mainsite breadcrumb. To do so, look for main-home in the $types array instead of  home.

-John Havlik

[end of transmission, stay tuned]