WordPress基礎：常用分類列表wp_list_categories

函數：wp_list_categories($args)

作用：列出某個分類下的分類項目

用法：

<ul>
    <?php 
    $args= array(
        'depth'=>1,
        'orderby'=>id,
        'style'=>none
        );
    wp_list_categories( $args ); ?>
</ul>

或

<ul>
            <?php wp_list_categories('depth=10'); ?>
</ul>

輸出html結構：

<ul>
            <li class="categories">分類目錄<ul>    <li class="cat-item cat-item-2"><a href="#">使用手冊</a>
<ul class="children">
    <li class="cat-item cat-item-6"><a href="#">使用應用</a>
</li>
    <li class="cat-item cat-item-3"><a href="#">如何安裝</a>
</li>
    <li class="cat-item cat-item-7"><a href="#">常見問題</a>
</li>
    <li class="cat-item cat-item-4"><a href="#">界面介紹</a>
</li>
    <li class="cat-item cat-item-5"><a href="#">訂購應用</a>
</li>
</ul>
</li>
    <li class="cat-item cat-item-8"><a href="#">開發手冊</a>
</li>
    <li class="cat-item cat-item-1"><a href="#">未分類</a>
</li>
</ul></li>        </ul>

常見參數說明：

參數	用途	參數值
show_option_all	指定站點首頁的超鏈接
order	升序或降序	ASC升序（默認)、 DESC降序
style	分類列表顯示的樣式	list 輸出li, none 使用<br >標簽分隔列表項
show_count	是否顯示文章數量	1,0
hide_empty	是否隱藏沒有文章的分類	1,0
use_desc_for_title	是否在鏈接顯示 title 屬性	1,0
child_of	只顯示此參數確定的分類的子分類	為8 顯示ID為 8 的分類的子分類 為0則顯示分類的所有子類
exclude	排除一個或多個分類。使用逗號分隔每個分類的ID，參數 include 必須為空。	4,7
exclude_tree	排除分類樹。使用逗號分隔每個分類的ID，參數 include 必須為空。
include	只顯示特定的分類，使用逗號分隔每個分類的ID	3,5,9,16
hierarchical	是否按層級顯示分類	1,0
title_li	設置列表的標題，默認為“Categories”。
number	要顯示的分類數量	默認為不限制
echo	顯示結果或保存在一個變量里	1,0
depth	顯示分類的深度（即顯示多少層的子分類）	0 – 所有分類和子分類（默認） -1 – 所有類別顯示在平面（不縮進）的形式（覆蓋hierarchical）。 1 – 只顯示頂級分類 n – 任意大於1的值，根據n的具體數字來顯示對應等級的分類。
current_category	默認為0，在當前分類下加樣式值，便於美化	為0則根據頁面動圖添加當前樣式值，填指定分類id，則僅在指定分類中添加樣式值
pad_counts	父分類的文章數是否包括子分類的鏈接或文章數。	1,0
title_li	列表的標題

 

注意： wp_list_categories() 和 list_cats() 以及 wp_list_cats() 的使用類似，但是后面 2 個已經棄用。