詳解WordPress中分類函數(shù)wp_list_categories的使用，wplistcategories

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

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

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

用法

<&#63;php
 wp_list_categories( $args ); 
$args = array(
 'show_option_all'  => '',//是否列出分類鏈接
 'orderby'      => 'name',//按名稱排列
 'order'       => 'ASC',//升、降序
 'style'       => 'list',//是否用列表（ul>li）
 'show_count'     => 0,//是否顯示文章數(shù)量
 '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,//顯示分類的數(shù)量
 'echo'        => 1,//是否顯示，顯示或者返回字符串
 'depth'       => 0,//層級限制
 'current_category'  => 0,//添加一個沒有的分類
 'pad_counts'     => 0,//這個我也不明白
 'taxonomy'      => 'category',//使用的分類法
 'walker'       => null//用于顯示的類（很復雜的概念）
&#63;>

關(guān)于'pad_counts'，我也沒搞明白這個參數(shù)是干什么用的，
如果有興趣你可以研究一下這個參數(shù)的官方文檔。
也可以對照一下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>
<&#63;php wp_list_categories('orderby=name&include=3,5,9,16'); &#63;> 
</ul>

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

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

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

<&#63;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
);
&#63;>
 
<ul>
<&#63;php wp_list_categories( $args ); &#63;>
</ul>

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

您可能感興趣的文章:

• WordPress開發(fā)中用于標題顯示的相關(guān)函數(shù)使用解析
• WordPress中調(diào)試縮略圖的相關(guān)PHP函數(shù)使用解析
• 配置解決Nginx服務器中WordPress路徑不自動加斜杠問題
• WordPress中用于獲取搜索表單的PHP函數(shù)使用解析
• 在WordPress中使用wp_count_posts函數(shù)來統(tǒng)計文章數(shù)量
• 詳解WordPress中調(diào)用評論模板和循環(huán)輸出評論的PHP函數(shù)
• WordPress中限制非管理員用戶在文章后只能評論一次
• 詳解WordPress中創(chuàng)建和添加過濾器的相關(guān)PHP函數(shù)
• 詳解WordPress開發(fā)中wp_title()函數(shù)的用法