This function provides a means of retrieving the preferred term according to Breadcrumb NavXT Paths’ view of the world. This function was introduced in 1.6.0. It receives two parameters:

  • $post_id(int)(required) The ID of the post to retrieve the preferred term for
  • $taxonomy(string)(required) The taxonomy to retrieve the preferred term from

This function returns the WP_Term instance for the preferred term, if found. Otherwise, it returns FALSE.



This filter is applied within the bcn_paths_term_metabox class in the paths_meta_box member function, the result of this filter is passed into the dropdown_posts member function. This affects the posts displayed in the Page Map for Breadcrumbs dropdown. This filter was introduced in 1.6.0. It receives three parameters:

  • $get_post_args(array)(required) The array of arguments being passed into the call to get_posts within paths_metabox::dropdown_posts function
  • $term(WP_Term)(optional) The term object for the term being edited
  • $taxonomy(string)(optional) The taxonomy of the term being edited

Related Articles