按層級輸出自定義分類法的所有分類

已經多次有網友郵件提問，使用 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.