Wordpress Breadcrumbs Without a Plugin

301109'

Written by Dimox

Breadcrumbs is an important element of a web site navigation, which boosts his usability. Especially it concerns to a sites with a complex structure. Unfortunatelly, I don’t use breadcrumbs on my sites, may be because their structure is very simple or because I could not find a way of making breadcrumbs, suitable for me.

I have seen a different ways of a breadcrumbs implementation on WordPress sites, but not one of them I does not like, because all of them does not display a full chain of links. So I have created my version of WordPress breadcrumbs without a plugin.

Yes, there is a ready plugins for WordPress breadcrumbs, but I prefer to use a short code snippets, which doing the same.

Features of my version of WordPress breadcrumbs

Displays a full chain of links to the current page. For example, if the current post is in a second level category, so breadcrumbs will looks like this:

Home » Category » Subcategory » Post Title

But all, what I have seen, displays only such an option (excluding plugins):

Home » Subcategory » Post Title

The same applies to pages and subpages. For example, for a 3rd level page breadcrumbs will looks like this:

Home » Page Level 1 » Page Level 2 » Page Level 3
Breadcrumbs is appearing on a following types of WordPress pages:
- paged navigation (like sitename.com/page/2/);
- category archive;
- tag archive;
- daily archive;
- monthly archive;
- yearly archive;
- author archive;
- single post page;
- single page;
- attachment page;
- search results;
- 404 error page.
adding a page number (if archive page is second or more);
custom symbol of delimiter;
custom text for a ‘Home’ link;
current crumb styling.

WordPress breadcrumbs function (last updated: 05.04.2012)

function dimox_breadcrumbs() {
 
  $showOnHome = 0; // 1 - show breadcrumbs on the homepage, 0 - don't show
  $delimiter = '&raquo;'; // delimiter between crumbs
  $home = 'Home'; // text for the 'Home' link
  $showCurrent = 1; // 1 - show current post/page title in breadcrumbs, 0 - don't show
  $before = '<span class="current">'; // tag before the current crumb
  $after = '</span>'; // tag after the current crumb
 
  global $post;
  $homeLink = get_bloginfo('url');
 
  if (is_home() || is_front_page()) {
 
    if ($showOnHome == 1) echo '<div id="crumbs"><a href="' . $homeLink . '">' . $home . '</a></div>';
 
  } else {
 
    echo '<div id="crumbs"><a href="' . $homeLink . '">' . $home . '</a> ' . $delimiter . ' ';
 
    if ( is_category() ) {
      $thisCat = get_category(get_query_var('cat'), false);
      if ($thisCat->parent != 0) echo get_category_parents($thisCat->parent, TRUE, ' ' . $delimiter . ' ');
      echo $before . 'Archive by category "' . single_cat_title('', false) . '"' . $after;
 
    } elseif ( is_search() ) {
      echo $before . 'Search results for "' . get_search_query() . '"' . $after;
 
    } elseif ( is_day() ) {
      echo '<a href="' . get_year_link(get_the_time('Y')) . '">' . get_the_time('Y') . '</a> ' . $delimiter . ' ';
      echo '<a href="' . get_month_link(get_the_time('Y'),get_the_time('m')) . '">' . get_the_time('F') . '</a> ' . $delimiter . ' ';
      echo $before . get_the_time('d') . $after;
 
    } elseif ( is_month() ) {
      echo '<a href="' . get_year_link(get_the_time('Y')) . '">' . get_the_time('Y') . '</a> ' . $delimiter . ' ';
      echo $before . get_the_time('F') . $after;
 
    } elseif ( is_year() ) {
      echo $before . get_the_time('Y') . $after;
 
    } elseif ( is_single() && !is_attachment() ) {
      if ( get_post_type() != 'post' ) {
        $post_type = get_post_type_object(get_post_type());
        $slug = $post_type->rewrite;
        echo '<a href="' . $homeLink . '/' . $slug['slug'] . '/">' . $post_type->labels->singular_name . '</a>';
        if ($showCurrent == 1) echo ' ' . $delimiter . ' ' . $before . get_the_title() . $after;
      } else {
        $cat = get_the_category(); $cat = $cat[0];
        $cats = get_category_parents($cat, TRUE, ' ' . $delimiter . ' ');
        if ($showCurrent == 0) $cats = preg_replace("#^(.+)\s$delimiter\s$#", "$1", $cats);
        echo $cats;
        if ($showCurrent == 1) echo $before . get_the_title() . $after;
      }
 
    } elseif ( !is_single() && !is_page() && get_post_type() != 'post' && !is_404() ) {
      $post_type = get_post_type_object(get_post_type());
      echo $before . $post_type->labels->singular_name . $after;
 
    } elseif ( is_attachment() ) {
      $parent = get_post($post->post_parent);
      $cat = get_the_category($parent->ID); $cat = $cat[0];
      echo get_category_parents($cat, TRUE, ' ' . $delimiter . ' ');
      echo '<a href="' . get_permalink($parent) . '">' . $parent->post_title . '</a>';
      if ($showCurrent == 1) echo ' ' . $delimiter . ' ' . $before . get_the_title() . $after;
 
    } elseif ( is_page() && !$post->post_parent ) {
      if ($showCurrent == 1) echo $before . get_the_title() . $after;
 
    } elseif ( is_page() && $post->post_parent ) {
      $parent_id  = $post->post_parent;
      $breadcrumbs = array();
      while ($parent_id) {
        $page = get_page($parent_id);
        $breadcrumbs[] = '<a href="' . get_permalink($page->ID) . '">' . get_the_title($page->ID) . '</a>';
        $parent_id  = $page->post_parent;
      }
      $breadcrumbs = array_reverse($breadcrumbs);
      for ($i = 0; $i < count($breadcrumbs); $i++) {
        echo $breadcrumbs[$i];
        if ($i != count($breadcrumbs)-1) echo ' ' . $delimiter . ' ';
      }
      if ($showCurrent == 1) echo ' ' . $delimiter . ' ' . $before . get_the_title() . $after;
 
    } elseif ( is_tag() ) {
      echo $before . 'Posts tagged "' . single_tag_title('', false) . '"' . $after;
 
    } elseif ( is_author() ) {
       global $author;
      $userdata = get_userdata($author);
      echo $before . 'Articles posted by ' . $userdata->display_name . $after;
 
    } elseif ( is_404() ) {
      echo $before . 'Error 404' . $after;
    }
 
    if ( get_query_var('paged') ) {
      if ( is_category() || is_day() || is_month() || is_year() || is_search() || is_tag() || is_author() ) echo ' (';
      echo __('Page') . ' ' . get_query_var('paged');
      if ( is_category() || is_day() || is_month() || is_year() || is_search() || is_tag() || is_author() ) echo ')';
    }
 
    echo '</div>';
 
  }
} // end dimox_breadcrumbs()

Simply paste this function into a functions.php file of your theme and then paste the following code in a place of your theme, where breadcrumbs must appearing:

<?php if (function_exists('dimox_breadcrumbs')) dimox_breadcrumbs(); ?>

All that remains to do for now, is to design your breadcrumbs with CSS. You can use #crumbs for styling breadcrumbs block and #crumbs .current for styling a current crumb.

You can also look at breadcrumbs video tutorial, which show you how to install this function on TwentyTen WordPress theme.

Function works on WordPress 3.0 or higher.

Category: WordPress

Tagged with: breadcrumbs, function, WordPress

Next post

Previous post

434

May 2, 2012 at 12:14 am

factotum said:

вариант для категорий, если необходимо добавить микродаты:
$currentCat = get_category(get_query_var('cat'),false); if ($currentCat->category_parent) : $parentCats = get_category($currentCat->category_parent); echo '<li><a href="' . get_category_link( $parentCats->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $parentCats->name ) . '" >' . $parentCats->name.'</a></li>'; endif; echo '<li>' . $before . single_cat_title('', false) . $after . '</li>';
PS. В примере парсит только один уровень родительской категории.

435

May 2, 2012 at 8:17 am

вывод категорий для постов:
найти:
$cat = get_the_category(); $cat = $cat[0]; $cats = get_category_parents($cat, TRUE, ' ' . $delimiter . ' ');
заменить на:
$cat = get_the_category(); $cat = $cat[0]; if ($cat) : $cats = get_category_parents($cat, TRUE, ' ' . $delimiter . ' '); endif;
необходимо в случае, если не задана категория поста. По умолчанию выводится “без категории”, но дебагер выдает ошибку – “$cat не существует”
Ну конечно же, было бы неплохо увидеть текстовые домены. а их нет ни одного…

436

May 14, 2012 at 12:30 am

Davor Popovic said:

Hi,

I think you must change, because on some theme and new wordpress version not want to work…

$homeLink = home_url();

437

May 14, 2012 at 12:31 am
Davor Popovic said:

uh sorry code is:
$homeLink = get_bloginfo('url');
to
$homeLink = home_url();

- 438
  
  @
  
  May 14, 2012 at 1:10 am
  Emil Uzelac said:
  
  Yes sir, that’s what I said last month http://dimox.net/wordpress-breadcrumbs-without-a-plugin/comment-page-8/#comment-1522
  
  Thanks,
  Emil

439

May 15, 2012 at 9:00 am

timoto said:

I would like to change the order of the breadcrumb so that instead of:

grandparent > parent > child > grandchild

it would be:

grandchild < child < parent < grandparent

Is that possible ?

Thank you.

440

May 15, 2012 at 10:13 am
Dimox said:

Sorry, not possible.

Wordpress Breadcrumbs Without a Plugin

Features of my version of WordPress breadcrumbs

WordPress breadcrumbs function (last updated: 05.04.2012)

Cоmmеnts (440):

Lеаvе а соmmеnt

Wordpress Breadcrumbs Without a Plugin

Features of my version of WordPress breadcrumbs

WordPress breadcrumbs function (last updated: 05.04.2012)

Cоmmеnts (440):

Lеаvе а соmmеnt

Tag Cloud