给 WordPress 网站添加面包屑导航

面包屑导航(BreadcrumbNavigation)这个概念来自童话故事“汉赛尔和格莱特”,当汉赛尔和格莱特穿过森林时,不小心迷路了,但是他们发现在沿途走过的地方都撒下了面包屑,让这些面包屑来帮助他们找到回家的路。

所以,WordPress 面包屑导航 的作用是告诉访问者他们目前在网站中的位置以及如何返回,可以增强用户体验和操作。

最终实现效果

添加面包屑导航

在主题根目录下的 functions.php 文件的 <?php 标签之后添加:

/*
 * WordPress 添加面包屑导航,支持谷歌结构化数据测试
 */
  function dimox_breadcrumbs(){
    
    /*=请保持下列设置,以免产生错误!=*/
    $text['home']     = '首页'; // 文字为“主页”链接
    $text['category'] = '%s'; // 文本的分类页面
    $text['search']   = '搜索结果 "%s" Query'; // 文本的搜索结果页面
    $text['tag']      = '文章标签 "%s"'; // 文本标签页
    $text['author']   = '文章发表于 %s'; // 文本的作者页面
    $text['404']      = 'Error 404'; // 文本404页
    
    $show_current   = 1; // 1 - 显示当前文章/页/类别标题面包屑, 0 - 不显示
    $show_on_home   = 0; // 1 - 在主页上显示面包屑, 0 - 不显示
    $show_home_link = 1; // 1 - 显示“主页”链接, 0 - 不显示
    $show_title     = 1; // 1 - 显示标题的链接, 0 - 不显示
    $delimiter      = ' <small>/</small> '; // 面包屑之间的分隔符
    $before         = '<span class="current">'; // 在当前标签之前
    $after          = '</span>'; // 标签后面
    /* === END OF OPTIONS === */
    global $post;
    $home_link    = home_url('/');
    $link_before  = '<span typeof="v:Breadcrumb">';
    $link_after   = '</span>';
    $link_attr    = ' rel="v:url" property="v:title"';
    $link         = $link_before . '<a' . $link_attr . ' href="%1$s">%2$s</a>' . $link_after;
    $parent_id    = $parent_id_2 = $post->post_parent;
    $frontpage_id = get_option('page_on_front');
    
    if (is_home() || is_front_page()) {
        
        if ($show_on_home == 1)
            echo '<ol class="breadcrumb"><a href="' . $home_link . '">' . $text['home'] . '</a></ol>';
        
    } else {
        
        echo '<ol class="breadcrumb" xmlns:v="http://rdf.data-vocabulary.org/#">';
        if ($show_home_link == 1) {
            echo '<a href="' . $home_link . '" rel="v:url" property="v:title">' . $text['home'] . '</a>';
            if ($frontpage_id == 0 || $parent_id != $frontpage_id)
                echo $delimiter;
        }
        
        if (is_category()) {
            $this_cat = get_category(get_query_var('cat'), false);
            if ($this_cat->parent != 0) {
                $cats = get_category_parents($this_cat->parent, TRUE, $delimiter);
                if ($show_current == 0)
                    $cats = preg_replace("#^(.+)$delimiter$#", "$1", $cats);
                $cats = str_replace('<a', $link_before . '<a' . $link_attr, $cats);
                $cats = str_replace('</a>', '</a>' . $link_after, $cats);
                if ($show_title == 0)
                    $cats = preg_replace('/ title="(.*?)"/', '', $cats);
                echo $cats;
            }
            if ($show_current == 1)
                echo $before . sprintf($text['category'], single_cat_title('', false)) . $after;
            
        } elseif (is_search()) {
            echo $before . sprintf($text['search'], get_search_query()) . $after;
            
        } elseif (is_day()) {
            echo sprintf($link, get_year_link(get_the_time('Y')), get_the_time('Y')) . $delimiter;
            echo sprintf($link, get_month_link(get_the_time('Y'), get_the_time('m')), get_the_time('F')) . $delimiter;
            echo $before . get_the_time('d') . $after;
            
        } elseif (is_month()) {
            echo sprintf($link, get_year_link(get_the_time('Y')), get_the_time('Y')) . $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;
                printf($link, $home_link . '/' . $slug['slug'] . '/', $post_type->labels->singular_name);
                if ($show_current == 1)
                    echo $delimiter . $before . get_the_title() . $after;
            } else {
                $cat  = get_the_category();
                $cat  = $cat[0];
                $cats = get_category_parents($cat, TRUE, $delimiter);
                if ($show_current == 0)
                    $cats = preg_replace("#^(.+)$delimiter$#", "$1", $cats);
                $cats = str_replace('<a', $link_before . '<a' . $link_attr, $cats);
                $cats = str_replace('</a>', '</a>' . $link_after, $cats);
                if ($show_title == 0)
                    $cats = preg_replace('/ title="(.*?)"/', '', $cats);
                echo $cats;
                if ($show_current == 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($parent_id);
            $cat    = get_the_category($parent->ID);
            $cat    = $cat[0];
            if ($cat) {
                $cats = get_category_parents($cat, TRUE, $delimiter);
                $cats = str_replace('<a', $link_before . '<a' . $link_attr, $cats);
                $cats = str_replace('</a>', '</a>' . $link_after, $cats);
                if ($show_title == 0)
                    $cats = preg_replace('/ title="(.*?)"/', '', $cats);
                echo $cats;
            }
            printf($link, get_permalink($parent), $parent->post_title);
            if ($show_current == 1)
                echo $delimiter . $before . get_the_title() . $after;
            
        } elseif (is_page() && !$parent_id) {
            if ($show_current == 1)
                echo $before . get_the_title() . $after;
            
        } elseif (is_page() && $parent_id) {
            if ($parent_id != $frontpage_id) {
                $breadcrumbs = array();
                while ($parent_id) {
                    $page = get_page($parent_id);
                    if ($parent_id != $frontpage_id) {
                        $breadcrumbs[] = sprintf($link, get_permalink($page->ID), get_the_title($page->ID));
                    }
                    $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 ($show_current == 1) {
                if ($show_home_link == 1 || ($parent_id_2 != 0 && $parent_id_2 != $frontpage_id))
                    echo $delimiter;
                echo $before . get_the_title() . $after;
            }
            
        } elseif (is_tag()) {
            echo $before . sprintf($text['tag'], single_tag_title('', false)) . $after;
            
        } elseif (is_author()) {
            global $author;
            $userdata = get_userdata($author);
            echo $before . sprintf($text['author'], $userdata->display_name) . $after;
            
        } elseif (is_404()) {
            echo $before . $text['404'] . $after;
            
        } elseif (has_post_format() && !is_singular()) {
            echo get_post_format_string(get_post_format());
        }
        
        if (get_query_var('paged')) {
            if (is_category() || is_day() || is_month() || is_year() || is_search() || is_tag() || is_author())
                echo ' (';
            echo __('第') . get_query_var('paged') .'页';
            if (is_category() || is_day() || is_month() || is_year() || is_search() || is_tag() || is_author())
                echo ')';
        }
        
        echo '</ol><!-- .breadcrumbs -->';
        
    }
}

调用面包屑导航

在需要显示面包屑导航的位置插入以下代码即可:

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

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注