Breadcrumb - All pages + SEOPress #1022

amWrk · 2025-05-14T14:37:35Z

amWrk
May 14, 2025

Hi there,

I am trying to get seopress breadcrumbs working on a local site. I have seopress pro and enabling that doesnt show the breadcrumbs.

Do i need to overide a template for me to get it working?

Plus, how can the breadcrumb be displayed on all pages (minus the home page or other pages i dont want it on?) seems like the breadcrumbs are set to only display on the main blog page and posts...

Can you please help me to get this working. Thank you

FYI: awseome theme 🙂

Answered by crftwrk

May 15, 2025

My apologies, I am a super newbie to wordpress and github.

All good, this forum exists to ask questions, get answers and learning. Your questions are legitimate. Let's break that down to clarify how the breadcrumb(s) works and how to add them to the blank pages.

Default breadcrumb

This is the default WordPress breadcrumb and supports only single posts. The function is in https://github.com/bootscore/bootscore/blob/main/inc/breadcrumb.php and called in the single-*php templates:

bootscore/single-templates/single-sidebar-left.php

Line 21 in 67285f7

<?php the_breadcrumb(); ?>

You can edit appearance, means classes and icon by filters https://bootscore.me/documentation/fil…

View full answer

crftwrk · 2025-05-14T16:12:44Z

crftwrk
May 14, 2025
Maintainer

Hello,

Do i need to overide a template for me to get it working?

No, you can do all with action hooks. See https://bootscore.me/documentation/filter-action-hooks/#actions

I have seopress pro and enabling that doesnt show the breadcrumbs.

Seopress for sure provides something like <?php the_seopress_breadcrumb(); ?> which should be added (via action hook) to the templates. Without this it will not added.

Plus, how can the breadcrumb be displayed on all pages (minus the home page or other pages i dont want it on?) seems like the breadcrumbs are set to only display on the main blog page and posts...

WordPress only supports breadcrumbs for posts by default. If you want to add a breadcrumb to pages, you have to write an own for this purpose. Add following snippet to your child's functions.php. This will add a breadcrumb using same classes as the default one to all pages except the blank page templates:

/**
 * Custom Breadcrumb for Pages
 */
function custom_page_breadcrumb() {
  if (!is_page()) {
    return;
  }

  echo '<nav aria-label="breadcrumb" class="' . apply_filters('bootscore/class/breadcrumb/nav', 'overflow-x-auto text-nowrap mb-4 mt-2 py-2 px-3 bg-body-tertiary rounded') . '">';
  echo '<ol class="breadcrumb ' . apply_filters('bootscore/class/breadcrumb/ol', 'flex-nowrap mb-0') . '">';
  echo '<li class="breadcrumb-item"><a class="' . apply_filters('bootscore/class/breadcrumb/item/link', '') . '" href="' . home_url() . '">'
      . apply_filters('bootscore/icon/home', '<i class="fa-solid fa-house"></i>')
      . '<span class="visually-hidden">' . __('Home', 'bootscore') . '</span></a></li>';

  // Optional: Include parent pages if nested
  if ($post = get_post()) {
    $parents = array_reverse(get_post_ancestors($post));
    foreach ($parents as $parent_id) {
      $parent = get_post($parent_id);
      echo '<li class="breadcrumb-item"><a class="' . apply_filters('bootscore/class/breadcrumb/item/link', '') . '" href="' . get_permalink($parent) . '">' . get_the_title($parent) . '</a></li>';
    }
  }

  echo '<li class="breadcrumb-item active" aria-current="page">' . get_the_title() . '</li>';
  echo '</ol>';
  echo '</nav>';
}

add_action('bootscore_after_primary_open', 'custom_page_breadcrumb');

Does this help?

0 replies

amWrk · 2025-05-14T16:50:49Z

amWrk
May 14, 2025
Author

No, you can do all with action hooks. See https://bootscore.me/documentation/filter-action-hooks/#actions

Thats what I did to add the default bredacrumb into the templates

Actually i went down i dfferent route to the other code you provided. Here is what I did (work in progress) i chnaged the breadcrumb.php file to:

if ( ! function_exists( 'the_breadcrumb' ) ) :
  function the_breadcrumb() {
    if ( ! is_home() ) {
      echo '<nav aria-label="breadcrumb" class="' . apply_filters( 'bootscore/class/breadcrumb/nav', 'overflow-x-auto text-nowrap mb-4 mt-2 py-2 px-3 bg-body-tertiary rounded' ) . '">';
      if ( function_exists( 'seopress_display_breadcrumbs' ) ) {
        $raw = seopress_display_breadcrumbs( false );
        $raw = preg_replace( '#^<nav[^>]*>|</nav>$#is', '', $raw );
        $raw = preg_replace( '#^<ol[^>]*>|</ol>$#is', '', $raw );
        if ( preg_match( '#^(.*?)<li#is', $raw, $pmatch ) ) {
          $prefix = trim( $pmatch[1] );
          if ( $prefix ) {
            echo $prefix;
          }
        }
        if ( preg_match_all( '#<li[^>]*>(.*?)</li>#is', $raw, $lmatches ) ) {
          $items = $lmatches[1];
        } else {
          $items = array();
        }
        echo '<ol class="breadcrumb ' . esc_attr( apply_filters( 'bootscore/class/breadcrumb/ol', 'flex-nowrap mb-0' ) ) . '">';
        $count = count( $items );
        foreach ( $items as $i => $inner ) {
          $inner = trim( $inner );
          if ( $i === $count - 1 ) {
            echo '<li class="breadcrumb-item active" aria-current="page">' . $inner . '</li>';
          } else {
            echo '<li class="breadcrumb-item">' . $inner . '</li>';
          }
        }
        echo '</ol>';
      } else {
        echo '<ol class="breadcrumb ' . esc_attr( apply_filters( 'bootscore/class/breadcrumb/ol', 'container flex-nowrap mb-0' ) ) . '">';
        echo '<li class="breadcrumb-item"><a class="' . apply_filters( 'bootscore/class/breadcrumb/item/link', '' ) . '" href="' . esc_url( home_url() ) . '">' . apply_filters( 'bootscore/icon/home', '<i class="fa-solid fa-house"></i>' ) . '<span class="visually-hidden">' . __( 'Home', 'bootscore' ) . '</span></a></li>';
        if ( is_category() || is_single() || is_page() ) {
          $cat_ids = wp_get_post_categories( get_the_ID() );
          foreach ( $cat_ids as $cat_id ) {
            $cat = get_category( $cat_id );
            echo '<li class="breadcrumb-item"><a class="' . apply_filters( 'bootscore/class/breadcrumb/item/link', '' ) . '" href="' . esc_url( get_term_link( $cat->term_id ) ) . '">' . esc_html( $cat->name ) . '</a></li>';
          }
        }
        if ( is_page() || is_single() ) {
          echo '<li class="breadcrumb-item active" aria-current="page">' . esc_html( get_the_title() ) . '</li>';
        }
        echo '</ol>';
      }
      echo '</nav>';
    }
  }
endif;

Checks if seopress breadcrumbs is turned on and uses that BUT keeps the styling the same as default breadcrumbs (seopress doesnt come with styling) and if its not turned on then it defaults back to the bootscore breadcrumbs... Working so far but need to iron out a few bugs...

The ONLY downside I have seen so far is that i cannot use this breadcrumb.php in my child-heme and have to overwrite the parent file 😯

ill check your code too to see how i can use that if its better (probarbly is...) any other suggestions would be helpful...

6 replies

crftwrk May 14, 2025
Maintainer

The ONLY downside I have seen so far is that i cannot use this breadcrumb.php in my child-heme and have to overwrite the parent file

No need for that. The breadcrumb is a pluggable function if ( ! function_exists( 'the_breadcrumb' ) ) :...endif;. Simply copy the code between the if wrapper to child's functions.php and edit in an upgrade safe way:

function the_breadcrumb() {

  if (!is_home()) {
    echo '<nav aria-label="breadcrumb" class="' . apply_filters('bootscore/class/breadcrumb/nav', 'overflow-x-auto text-nowrap mb-4 mt-2 py-2 px-3 bg-body-tertiary rounded') . '">';
    echo '<ol class="breadcrumb ' . apply_filters('bootscore/class/breadcrumb/ol', 'flex-nowrap mb-0') . '">';
    echo '<li class="breadcrumb-item"><a class="' . apply_filters('bootscore/class/breadcrumb/item/link', '') . '" href="' . home_url() . '">' . '' . apply_filters('bootscore/icon/home', '<i class="fa-solid fa-house"></i>') . '<span class="visually-hidden">' . __('Home', 'bootscore') . '</span>' . '</a></li>';
    // display parent category names with links
    if (is_category() || is_single()) {
      $cat_IDs = wp_get_post_categories(get_the_ID());
      foreach ($cat_IDs as $cat_ID) {
        $cat = get_category($cat_ID);
        echo '<li class="breadcrumb-item"><a class="' . apply_filters('bootscore/class/breadcrumb/item/link', '') . '" href="' . get_term_link($cat->term_id) . '">' . $cat->name . '</a></li>';
      }
    }
    // display current page name
    if (is_page() || is_single()) {
      echo '<li class="breadcrumb-item active" aria-current="page">' . get_the_title() . '</li>';
    }
    echo '</ol>';
    echo '</nav>';
  }
}

add_filter('breadcrumbs', 'breadcrumbs');

The code from my previous comment has nothing to do with the SEOpress, it is an additional breadcrumb hooked into pages for what you have asked for.

amWrk May 15, 2025
Author

thanks for the update.

My apologies, I am a super newbie to wordpress and github. I tried pasting my code but it came out garbled :(

ok, so if i am undersatding this correctly i need to do the following:

use th action hook/filter to add in the code to the template files? IF so im unsure how to do that (i got it worng when i said i did that before, i manually added to template!) what would be the hook/filter i couldnt find the right one...
1.a. I assume if thats the case then to use seopress instead of: i would use: instead?
to diaplay on all pages I would then use the code you pasted in your first reply? it says it wont add it to the blank template.. im actually going to use that template on a lot of pages. Any reason why it wont add to that template? and how can i add i please?
2.a. if i want the breadcrumbs to show in the hook it uses: bootscore_after_primary_open BUT if I want it directly under the main header what would that need to be changed with? I tried looking for the page/template hook guide postions but cannot seem to find them againa.
to display the seopress with a fallback to your default breadcrumbs and to diaply on all pages I assume i would need to use no2 above BUT updated with relevant code (i.e a combination of what you posted and what i tried) is that right? if so ill give that a go. Code would be helpful and I am trying to learn too, a little guidance would be super helpful too.

apologies in advance for any confusion . appreciate the help. Thank you.

crftwrk May 15, 2025
Maintainer

My apologies, I am a super newbie to wordpress and github.

All good, this forum exists to ask questions, get answers and learning. Your questions are legitimate. Let's break that down to clarify how the breadcrumb(s) works and how to add them to the blank pages.

Default breadcrumb

This is the default WordPress breadcrumb and supports only single posts. The function is in https://github.com/bootscore/bootscore/blob/main/inc/breadcrumb.php and called in the single-*php templates:

bootscore/single-templates/single-sidebar-left.php

Line 21 in 67285f7

<?php the_breadcrumb(); ?>

You can edit appearance, means classes and icon by filters https://bootscore.me/documentation/filter-action-hooks/#breadcrumb or change separator in _bootscore-variables.scss.

If filters are not enough and you need to modify the default breadcrumb with more functionality or adapt it to SEOpress, luckily this is a pluggable function and you can copy code between the if wrapper to your child's functions.php and edit it in a upgrade-safe way. See https://bootscore.me/documentation/functions/ how pluggable functions works.

WooCommerce breadcrumb

This is the default breadcrumb for WooCommerce pages. The function is in https://github.com/bootscore/bootscore/blob/main/woocommerce/inc/wc-breadcrumb.php and is pluggable as well. The WC breadcrumb is called in:

bootscore/woocommerce.php

Line 30 in 67285f7

<?php woocommerce_breadcrumb(); ?>

Both breadcrumbs using the same filters, means if you change a class via a filter, changes are applied to both breadcrumbs to make sure they have the same look.

Breadcrumb for pages

WordPress does not support breadcrumb for pages by default, means that you have to code an own and I've added an example in my previous comment and hooked it into:

bootscore/page.php

Line 26 in 67285f7

<?php do_action( 'bootscore_after_primary_open', 'page' ); ?>

Breadcrumb for `blank` pages

the blank page templates are blank canvas templates to create landing/frontpage pages which do not have <?php do_action( 'bootscore_after_primary_open', 'file-location' ); ?> action to keep this files "blank". That's why you can't use it here in that way.

Add an own `blank` template to your child

Create folder page-templates in your child-theme.
Go to parent-theme folder page-templates and copy page-blank.php to your child's page-templates
Rename file into, for example, page-custom-blank.php
Open file in a editor and rename template name in line 4 Template Name: Custom Blank
Add action <?php do_action( 'bootscore_after_primary_open', 'page-custom-blank' ); ?> direct after the <div id="primary" class="content-area"> open tag.
Select in page edit screen your new template.

Now you have a custom blank template with a breadcrumb.

SEOpress

I have no experience with this plugin and can't help here, but if that plugin needs a modified breadcrumb(s), you can use the pluggable functions to rewrite code to your needs in child-theme. But before struggling with that, simply show ChatGDP the function and tell him what do you want to do. You will get an answer with full working code in under 10 seconds ;-)

Has this been clarified?

Answer selected by amWrk

amWrk May 15, 2025
Author

@crftwrk thank you so much. Thats great help and definitly going to make things easy for me. I ll get cracking on it now and hopefully get it done easily. Thank you for all your help ☺

crftwrk May 16, 2025
Maintainer

👍You're welcome. Please mark the answer as solved. This will help other users if they have the same question. Thank you!

crftwrk Jan 29, 2026
Maintainer

Breadcrumb as a shortcode #1152

Navigation Menu

Bootscore

Breadcrumb - All pages + SEOPress #1022

Uh oh!

{{title}}

Uh oh!

Replies: 2 comments 6 replies

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Bootscore

Breadcrumb - All pages + SEOPress #1022

Uh oh!

amWrk May 14, 2025

Default breadcrumb

Replies: 2 comments · 6 replies

Uh oh!

crftwrk May 14, 2025 Maintainer

Uh oh!

Uh oh!

amWrk May 14, 2025 Author

Uh oh!

crftwrk May 14, 2025 Maintainer

Uh oh!

amWrk May 15, 2025 Author

Uh oh!

crftwrk May 15, 2025 Maintainer

Default breadcrumb

WooCommerce breadcrumb

Breadcrumb for pages

Breadcrumb for blank pages

Add an own blank template to your child

SEOpress

Uh oh!

amWrk May 15, 2025 Author

Uh oh!

crftwrk May 16, 2025 Maintainer

Uh oh!

crftwrk Jan 29, 2026 Maintainer

amWrk
May 14, 2025

Replies: 2 comments 6 replies

crftwrk
May 14, 2025
Maintainer

amWrk
May 14, 2025
Author

crftwrk May 14, 2025
Maintainer

amWrk May 15, 2025
Author

crftwrk May 15, 2025
Maintainer

Breadcrumb for `blank` pages

Add an own `blank` template to your child

amWrk May 15, 2025
Author

crftwrk May 16, 2025
Maintainer

crftwrk Jan 29, 2026
Maintainer