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

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

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

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

用法

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

關(guān)于'pad_counts'，我也沒(méi)搞明白這個(gè)參數(shù)是干什么用的，
如果有興趣你可以研究一下這個(gè)參數(shù)的官方文檔。
也可以對(duì)照一下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

使用實(shí)例
顯示包括ID為3,5,9,16的分類(lèi)鏈接，且按名稱(chēng)排列順序

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

顯示Poetry為標(biāo)題的包括ID為5,9,23的分類(lèi)列表

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

當(dāng)然你也可以像如下這樣書(shū)寫(xiě)參數(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分類(lèi)法，是相對(duì)于標(biāo)簽（tag）的概念。

您可能感興趣的文章:

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