Hook wpseo_breadcrumb_links to override category breadcrumbs

functions.php

function custom_override_yoast_breadcrumb_trail( $links ) {
    global $post;

    if ( is_singular() ) {
		
		$bit_term_key = 0;
		$bit_parent_page = 0;
		
		foreach (  $links  as  $key => $link ) {
			// Is there a term / category within a breadcrumn in a singular post
			if ( isset( $link['term'] ) ) {
				
				// Make sure ACF is present
				if( function_exists('get_field') ){
				
					// Get the corresponing page to this term/category
					$bit_connected_page = get_field( 'bit_connected_page', $link['term'] );
					if( ! empty( $bit_connected_page ) ){
						// Replace the term with this page and let Yoast do tht rest
						$links[$key] = array( 'id' => $bit_connected_page->ID );
						
						// Keep the key as a reference to insert custom /blog page in front of.
						$bit_term_key = $key;
						
						// Keep the parent id to locate custom /blog page in front of.
						$bit_parent_page = $bit_connected_page->post_parent ;						
					}
				}
			}
		}
		
		// Also insert the custom /blog page in front of the term
		if($bit_term_key > 0 && $bit_parent_page > 0){
			return array_merge(
						array_slice( $links, 0, $bit_term_key ),
						array( array( 'id' => $bit_parent_page )),
						array_slice( $links, $bit_term_key )
					);
		}
    }
	
    return $links;
}
add_filter( 'wpseo_breadcrumb_links', 'custom_override_yoast_breadcrumb_trail' );

(This uses ACF to map a specific page to a category.)

1. When the Yoast breadcrumb loads on a singular post then

• if it finds a category (term) that has a mapped page (using ACF here)
• it gets replaced by that page.

2. Also adds the parent of that page on before the page.

The above will not change anything unless a mapped page is found.

Important:

• Needs to be changed if it is to be used for multiple categories or hierarchical categories.

Hi Froutis

I stumbled upon your snippet here and tried to make use of it, but can't get it to work. Could you be so kind to elaborate:

• Where do you create the field for mapping the page - is that on the taxonomy?
• Which ACF field type do you use?

Your help would be much appreciated.

Best regards

@jlock6000 this is quite old but yes.

The ACF field is on the Taxonomy and it is a Post Object (return Object and not ID)

@froutsis Thanks a lot for getting back to me so quickly. Much appreciated!

I still have some problems getting it to work. I see that you do freelance work. Would you be interested in taking on this task and fixing it on my project? If so, please get in touch with me at [email protected]

Thanks