September 17th, 2020

Mapping Terms to Posts in Breadcrumb Trails

In certain site configurations, it makes sense to replace the WordPress built-in term archives with a post (an instance of some post type). Typically, a page (instance of the page post type) is used in place of the term archive. Since version 1.5, Breadcrumb NavXT Paths supports mapping terms to pages (with regards to where the breadcrumb links to). To facilitate this, Breadcrumb NavXT Paths provides a metabox in the term editor for establish this mapping.

Sometimes, the page post type does not make sense for this mapping. In that case, the bcn_paths_map_term_post_args can be used to change the post type that the term editor metabox added by Breadcrumb NavXT displays. Note that this filter was introduced in Breadcrumb NavXT Paths 1.6.0.

The Code

Placing the following code into a site specific plugin, will allow Breadcrumb NavXT Paths to map terms to the post post type:

add_filter('bcn_paths_map_term_post_args', 'my_bcn_paths_map_term_post_args', 10, 3);
function my_bcn_paths_map_term_post_args($args, $term, $taxonomy)
{
     $args['post_type'] = 'post';
     return $args;
}

Naturally, this can be modified to specify post types other than post. Should multiple post types be desired, just replace the string 'post' with an array of the post type names. Since this filter affects the arguments sent to get_post, other arguments may be set as well.

-John Havlik

August 16th, 2020

Remove ‘Private:’ from bbPress Private Forum and Topic Titles

Posted by John Havlik in Guides

Helpfully, and in some cases, annoyingly, WordPress, by default, prepends the text ‘Private: ‘ to the titles of private posts. While this may be helpful for the user, sometimes it is unnecessary. In the case for bbPress, it may get tiresome to see ‘Private: ‘ everywhere, and for logged in users with permissions to see said forums and topics, it is redundant. Luckily, WordPress provides the handy private_title_format filter which can be used to control the format of titles for private posts.

The Code

The below code, when placed in a site specific plugin, will remove the ‘Private: ‘ text from private forums and topics:

add_filter('private_title_format', 'my_private_title_format', 10, 2);
function my_private_title_format($format, $post)
{
	if($post instanceof WP_Post and ($post->post_type === 'forum' || $post->post_type === 'topic'))
	{
		$format = '%s';
	}
	return $format;
}

Note that this can be adapted to apply to any post type, or post types that are not forum and topic. Simply, change the post type checks in the if statement to target the desired post type(s).

-John Havlik

June 12th, 2020

Breadcrumb NavXT 6.5.0

Posted by John Havlik in WordPress > Plugins

Holy taxonomy jumping Batman! This first feature release of 2020 changes the way taxonomies are handled when passing from function to function. Now, it is possible to change the taxonomy, in addition to the term, used for a post’s hierarchy using the bcn_pick_post_term filter. Additionally, the bcn_breadcrumb_linked filter was added to allow manipulation of the breadcrumb’s linked state. On the administration interface front, a new capability was introduced, bcn_manage_options. Lastly, a bug was fixed in the settings exporter that caused it to generate non-importable settings files when certain HTML entities were present in a setting.

bcn_breadcrumb_linked Filter

In Breadcrumb NavXT 6.4.0, the way URLs and the linked state for individual breadcrumbs changed. This was to facilitate the ability to place the %link% tag in unlinked breadcrumb templates. As part of this bcn_breadcrumb::set_linked() was introduced. To allow users to control the behavior of this function, the bcn_breadcrumb_linked filter was added in 6.5.0.

bcn_manage_options Capability

Up until Breadcrumb NavXT 6.5.0, the manage_options capability was used to gate access to the Breadcrumb NavXT settings page. While this did insure the proper level of authority for modifying settings, it did not allow flexibility to add the ability to mange just the Breadcrumb NavXT settings to a role. Thus, in 6.5.0, the bcn_manage_options capability was added. By default this capability is added to the administrator role.

-John Havlik