按层级输出自定义分类法的所有分类

已经多次有网友邮件提问，使用 register_taxonomy 注册了一个新的自定义分类法，比如 「products」，然后在后台创建了分类，想在前台将这些分类按层级列出，怎么办。

本篇教程就教大家实现 1. 按层级输出分类。 2. 设置当前访问项

当前访问项

首先，按层级列出分类的时候，我们需要将当前访问的分类加上特殊标记，比如"active"、"current"。

思路：需要考虑三种页面， 1. 归档页，2. 分类页面，3. 文章页。归档页是没有当前访问项的，所以不需要考虑，分类页面，不能简单的获取当前分类，若是在子分类页面，还需将父分类也定义为正在访问，文章页，也是一样，需要考虑父分类等。所以，正在访问的项可能不止一个。

用图来表示，可能更明了。

下面的代码，将当前访问项 (可能是多个) 放入数组 $current_array 中，要实现还需使用到一个阿树自建的一个函数 ashuwp_get_top_term_id 。

1. /**
2. *获取任意分类的"顶级父分类", 返回分类 ID, 若本身是顶级分类, 返回本身 ID
3. * $term_id 分类的 ID
4. * $taxonomy 分类法，默认为 category
5. * $top_level 人为设定的顶级分类的父分类，默认为 0 。范例，若设置为 3，则将 ID 为 3 的分类的第一级子分类定义"顶级父分类"
6. **/
7. function ashuwp_get_top_term_id ($term_id ,$taxonomy='category', $top_level=0) {
9.     while ($term_id != $top_level) {
10.         $term = get_term($term_id, $taxonomy);
11.         $term_id = $term->parent;
12.         $parent_id = $term->term_id;
13.     }
14.     return $parent_id;
15. }
18. /**先获取当前页面的分类 ID**/
20. //分类页面
21. if(is_tax('products')){
22.   $currentterm = get_queried_object(); //获取当前分类
23.   $currentterm_id = $currentterm->term_id;
25.   //当前分类的顶级父分类 ID
26.   $top_term_id = ashuwp_get_top_term_id($currentterm->term_id,'products');
27.   //获取顶级分类对象
28.   $top_term = get_term($top_term_id,'products');
30.   //当前分类 ID 、当前分类的父分类 ID 都是当前访问，放入 $current_array 数组
31.   $current_array = array($currentterm_id);
32.   $parent_id = $currentterm->parent;
33.   while($parent_id){
34.     $current_array[] = $parent_id;
35.     $parent_term = get_term($parent_id, 'products');
36.     $parent_id = $parent_term->parent;
37.   }
39. }elseif(is_singular('product')){
40.   //单页面
42.   /*获取文章所属分类，文章同属多个分类，将第一个分类当做 「当前分类」
43.   *重复上面工作，将当前分类 ID 、当前分类的父分类 ID 都是当前访问，放入 $current_array 数组
44.   */
45.   $terms = get_the_terms( $post->ID, 'products' );
46.   if ( $terms && ! is_wp_error( $terms ) ) :
47.     $currentterm = current($terms);
48.     $current_array[] = $currentterm->term_id;
49.     $top_term_id = ashuwp_get_top_term_id($currentterm->term_id,'products');
50.     $top_term = get_term($top_term_id,'products');
52.     $parent_id = $currentterm->parent;
53.     while($parent_id){
54.       $current_array[] = $parent_id;
55.       $parent_term = get_term($parent_id, 'products');
56.       $parent_id = $parent_term->parent;
57.     }
59.   else:
60.     $currentterm_id = 0;
61.     $top_term_id = 0;
62.     $current_array = array();
63.   endif;
65. }else{
66.   //若为归档页面，则没有当前访问
67.   $currentterm_id = 0;
68.   $top_term_id = 0;
69.   $current_array = array();
70. }

 

按层级输出

思路：学过任意一门变成语言的人应该都会这个思路，先获取所有顶级分类，将顶级分类循环输出，在循环内部再嵌套输出子分类的子循环。

1. //先获取所有顶级分类
2. $top_args = array(
3.   'taxonomy'=>'products', //分类法名称
4.   'hide_empty'=>false,
5.   'parent'=>0, //顶级分类的父级都是 0
6. );
7. $top_terms = get_terms($top_args);
8. if ( $top_terms && ! is_wp_error( $top_terms ) ) :
10.   echo '<ul class="top_ul">'; //最外层 ul 标签
12.   //顶级分类循环输出
13.   foreach( $top_terms as $top_term ):
14.     $current = '';
15.     //若这个顶级分类的 ID 在数组 $current_array 中，为当前访问项
16.     if(in_array($top_term->term_id,$current_array))
17.       $current = 'class="current"';
18.   ?>
19.     <li <?php echo $current; ?>>
20.       <a href="<?php echo get_term_link($top_term,'products'); ?>"><?php echo $top_term->name; ?></a>
21.       <?php
22.       //获取当前顶级分类的子分类
23.       $child_args = array(
24.         'taxonomy'=>'products',
25.         'hide_empty'=>false,
26.         'parent'=>$top_term->term_id,
27.       );
28.       $child_terms = get_terms($child_args);
29.       if ( $child_terms && ! is_wp_error( $child_terms ) ) :
30.         echo '<ul>'; //第二层 ul 标签
31.         //循环子分类
32.         foreach($child_terms as $child_term):
33.           $current = '';
34.           //若这个子分类的 ID 在数组 $current_array 中，为当前访问项
35.           if(in_array($child_term->term_id,$current_array))
36.             $current = 'class="current"';
37.           ?>
38.             <li <?php echo $current; ?>><a href="<?php echo get_term_link($child_term,'products'); ?>"><?php echo $child_term->name; ?></a></li>
39.           <?php
40.           endforeach;
41.         echo '</ul>';
42.       endif;
43.       ?>
44.     </li>
45.   <?php
46.   endforeach;
48.   echo '</ul>';
50. endif;

总结

本篇教程共写了两段代码，如果你并不清楚如何应用，请往下看。

首先，将本教程用到的一个函数放在主题的 functions.php 文件中，如下。

1. /**
2. *获取任意分类的"顶级父分类", 返回分类 ID, 若本身是顶级分类, 返回本身 ID
3. * $term_id 分类的 ID
4. * $taxonomy 分类法，默认为 category
5. * $top_level 人为设定的顶级分类的父分类，默认为 0 。范例，若设置为 3，则将 ID 为 3 的分类的第一级子分类定义"顶级父分类"
6. **/
7. function ashuwp_get_top_term_id ($term_id ,$taxonomy='category', $top_level=0) {
9.     while ($term_id != $top_level) {
10.         $term = get_term($term_id, $taxonomy);
11.         $term_id = $term->parent;
12.         $parent_id = $term->term_id;
13.     }
14.     return $parent_id;
15. }

再将下面一整段代码放在要输出分类列表的地方。

1. <?php
2. //分类页面
3. if(is_tax('products')){
4.   $currentterm = get_queried_object(); //获取当前分类
5.   $currentterm_id = $currentterm->term_id;
7.   //当前分类的顶级父分类 ID
8.   $top_term_id = ashuwp_get_top_term_id($currentterm->term_id,'products');
9.   //获取顶级分类对象
10.   $top_term = get_term($top_term_id,'products');
12.   //当前分类 ID 、当前分类的父分类 ID 都是当前访问，放入 $current_array 数组
13.   $current_array = array($currentterm_id);
14.   $parent_id = $currentterm->parent;
15.   while($parent_id){
16.     $current_array[] = $parent_id;
17.     $parent_term = get_term($parent_id, 'products');
18.     $parent_id = $parent_term->parent;
19.   }
21. }elseif(is_singular('product')){
22.   //单页面
24.   /*获取文章所属分类，文章同属多个分类，将第一个分类当做 「当前分类」
25.   *重复上面工作，将当前分类 ID 、当前分类的父分类 ID 都是当前访问，放入 $current_array 数组
26.   */
27.   $terms = get_the_terms( $post->ID, 'products' );
28.   if ( $terms && ! is_wp_error( $terms ) ) :
29.     $currentterm = current($terms);
30.     $current_array[] = $currentterm->term_id;
31.     $top_term_id = ashuwp_get_top_term_id($currentterm->term_id,'products');
32.     $top_term = get_term($top_term_id,'products');
34.     $parent_id = $currentterm->parent;
35.     while($parent_id){
36.       $current_array[] = $parent_id;
37.       $parent_term = get_term($parent_id, 'products');
38.       $parent_id = $parent_term->parent;
39.     }
41.   else:
42.     $currentterm_id = 0;
43.     $top_term_id = 0;
44.     $current_array = array();
45.   endif;
47. }else{
48.   //若为归档页面，则没有当前访问
49.   $currentterm_id = 0;
50.   $top_term_id = 0;
51.   $current_array = array();
52. }
56. //先获取所有顶级分类
57. $top_args = array(
58.   'taxonomy'=>'products', //分类法名称
59.   'hide_empty'=>false,
60.   'parent'=>0, //顶级分类的父级都是 0
61. );
62. $top_terms = get_terms($top_args);
63. if ( $top_terms && ! is_wp_error( $top_terms ) ) :
65.   echo '<ul class="top_ul">'; //最外层 ul 标签
67.   //顶级分类循环输出
68.   foreach( $top_terms as $top_term ):
69.     $current = '';
70.     //若这个顶级分类的 ID 在数组 $current_array 中，为当前访问项
71.     if(in_array($top_term->term_id,$current_array))
72.       $current = 'class="current"';
73.   ?>
74.     <li <?php echo $current; ?>>
75.       <a href="<?php echo get_term_link($top_term,'products'); ?>"><?php echo $top_term->name; ?></a>
76.       <?php
77.       //获取当前顶级分类的子分类
78.       $child_args = array(
79.         'taxonomy'=>'products',
80.         'hide_empty'=>false,
81.         'parent'=>$top_term->term_id,
82.       );
83.       $child_terms = get_terms($child_args);
84.       if ( $child_terms && ! is_wp_error( $child_terms ) ) :
85.         echo '<ul>'; //第二层 ul 标签
86.         //循环子分类
87.         foreach($child_terms as $child_term):
88.           $current = '';
89.           //若这个子分类的 ID 在数组 $current_array 中，为当前访问项
90.           if(in_array($child_term->term_id,$current_array))
91.             $current = 'class="current"';
92.           ?>
93.             <li <?php echo $current; ?>><a href="<?php echo get_term_link($child_term,'products'); ?>"><?php echo $child_term->name; ?></a></li>
94.           <?php
95.           endforeach;
96.         echo '</ul>';
97.       endif;
98.       ?>
99.     </li>
100.   <?php
101.   endforeach;
103.   echo '</ul>';
105. endif;
106. ?>

The end.