詳解WordPress中分類函數wp_list_categories的使用

wp_list_categories 函數是 WordPress 中用來羅列系統中分類的函數，該函數擁有許多控制輸出的參數，今天突然被一個朋友問到，所以就大概整理了一下。

因為 WordPress 中內置擴展的小工具功能，
所以我們不經任何函數就可以在邊欄或是其他我們想要的位置顯示一個分類列表，
所以wp_list_categories函數就很少有人用到，
該函數使用起來有點類似於wp_list_bookmarks，

wp_list_categories 描述
wp_list_categories 函數是 WordPress 中用來羅列系統中分類鏈接的函數。
英文原文就不上了，有興趣的可以去看一下官方文檔。

用法

<?php
 wp_list_categories( $args ); 
$args = array(
 'show_option_all'  => '',//是否列出分類鏈接
 'orderby'      => 'name',//按名稱排列
 'order'       => 'ASC',//升、降序
 'style'       => 'list',//是否用列表（ul>li）
 'show_count'     => 0,//是否顯示文章數量
 'hide_empty'     => 1,//是否顯示無日志分類
 'use_desc_for_title' => 1,//是否顯示分類描述
 'child_of'      => 0,//是否限制子分類
 'feed'        => '',//是否顯示rss
 'feed_type'     => '',//rss類型
 'feed_image'     => '',//是否顯示rss圖片
 'exclude'      => '',//排除分類的ID，多個用',（英文逗號）'分隔
 'exclude_tree'    => '',//排除分類樹，即父分類及其下的子分類
 'include'      => '',//包括的分類
 'hierarchical'    => true,//是否將子、父分類分級
 'title_li'      => __( 'Categories' ),//列表標題的名稱
 'show_option_none'  => __('No categories'),//無分類時顯示的標題
 'number'       => null,//顯示分類的數量
 'echo'        => 1,//是否顯示，顯示或者返回字符串
 'depth'       => 0,//層級限制
 'current_category'  => 0,//添加一個沒有的分類
 'pad_counts'     => 0,//這個我也不明白
 'taxonomy'      => 'category',//使用的分類法
 'walker'       => null//用於顯示的類（很復雜的概念）
?>

關於'pad_counts'，我也沒搞明白這個參數是干什麼用的，
如果有興趣你可以研究一下這個參數的官方文檔。
也可以對照一下wp_list_bookmarks去使用。

pad_counts
(boolean) Calculates link or post counts by including items from child categories. If show_counts and hierarchical are true this is automatically set to true. This parameter added at Version 2.9 Valid values:
1 (true)
0 (false) – default

使用實例
顯示包括ID為3,5,9,16的分類鏈接，且按名稱排列順序

<ul>
<?php wp_list_categories('orderby=name&include=3,5,9,16'); ?> 
</ul>

顯示Poetry為標題的包括ID為5,9,23的分類列表

<ul>
<?php wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?> 
</ul>

當然你也可以像如下這樣書寫參數，將參數整合為數組。

<?php 
$taxonomy   = 'genre';
$orderby   = 'name'; 
$show_count  = 0;   // 1 for yes, 0 for no
$pad_counts  = 0;   // 1 for yes, 0 for no
$hierarchical = 1;   // 1 for yes, 0 for no
$title    = '';
 
$args = array(
 'taxonomy'   => $taxonomy,
 'orderby'   => $orderby,
 'show_count'  => $show_count,
 'pad_counts'  => $pad_counts,
 'hierarchical' => $hierarchical,
 'title_li'   => $title
);
?>
 
<ul>
<?php wp_list_categories( $args ); ?>
</ul>

taxonomy分類法，是相對於標簽（tag）的概念。