WordPress实现面包屑导航的方法

最后更新于 2013 年 7 月 1 日

面包屑导航是一个很基本的功能，当网站结构复杂的时候，面包屑导航可以不让用户迷失方向。WordPress实现面包屑导航无非是安装插件，或者直接写代码。在网上看了不少介绍，有些代码感觉质量不高，插件也有很多都没人维护了。所以记录一下目前比较好用的方法。

面包屑导航应该满足哪些要求

1. 显示完整路径，例如一个位于次级目录下的文章，应该显示为

首页 » 分类 » 次级分类 » 文章标题

而不是

首页 »  次级分类 » 文章标题

2. 对于page页面，也应体现出parent和child的关系

首页 » Page Level 1 » Page Level 2 » Page Level 3

3. 应该支持WordPress所有需要显示面包屑导航的文章类型，包括

• 分页 （例如yourdomain.com/page/1）
• 分类归档页面
• 标签归档页面
• 时间归档页面
• 作者页面
• single post页面
• single page页面
• 附件页面
• 搜索页面
• 404页面

一个好的面包屑导航插件或代码，应该至少满足以上要求，像可以更改“Home”文字或者允许显示/隐藏首页等等功能，有当然比没有好。

符合以上要求的插件

推荐Breadcrumb NavXT，设置界面并不复杂，效果不错，目前支持到WordPress 3.3.2，作者维护的还是很勤快的。一款有人维护的插件才是安全的。

WordPress官网还有很多面包屑插件，不想一一介绍，介绍多了只会看着头疼，找到好用的，知道怎么修改就够了。

有一篇文章介绍了hack该插件的故事，有兴趣可以读一下

Recommended breadcrumb plugins with possibility for hiding “Home” link

如果不想用插件

一个非常受欢迎的代码解决方案来自Wordpress Breadcrumbs Without a Plugin，建议大家经常关注一下原作，WordPress在更新，这些代码也需要及时升级，很多用户会反馈bug，作者修改后会更新代码。

代码多长不重要，重要的是你只需要将这段代码拷贝到functions.php中，然后在需要显示面包屑的地方写上

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

附：2012-05-04更新的代码，最新代码请关注上面提到的文章，代码开头几行是设置选项，包括

• 是否在首页显示面包屑导航
• 分隔符用什么，默认是»
• 是否显示当前post/page标题
• 当前面包屑的起始标签，默认<span class="current">，方便定义样式
• 自然还要有个$after定义结束标签，默认</span>

function dimox_breadcrumbs() {
 
  $showOnHome = 0; // 1 - show breadcrumbs on the homepage, 0 - don't show
  $delimiter = '»'; // 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()