詳解WordPress中分類函數(shù)wp_list_categories的使用
wp_list_categories 函數(shù)是 WordPress 中用來羅列系統(tǒng)中分類的函數(shù),該函數(shù)擁有許多控制輸出的參數(shù),今天突然被一個朋友問到,所以就大概整理了一下。
因為 WordPress 中內(nèi)置擴(kuò)展的小工具功能,
所以我們不經(jīng)任何函數(shù)就可以在邊欄或是其他我們想要的位置顯示一個分類列表,
所以wp_list_categories函數(shù)就很少有人用到,
該函數(shù)使用起來有點類似于wp_list_bookmarks,
wp_list_categories 描述
wp_list_categories 函數(shù)是 WordPress 中用來羅列系統(tǒng)中分類鏈接的函數(shù)。
英文原文就不上了,有興趣的可以去看一下官方文檔。
用法
<?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' ),//列表標(biāo)題的名稱
'show_option_none' => __('No categories'),//無分類時顯示的標(biāo)題
'number' => null,//顯示分類的數(shù)量
'echo' => 1,//是否顯示,顯示或者返回字符串
'depth' => 0,//層級限制
'current_category' => 0,//添加一個沒有的分類
'pad_counts' => 0,//這個我也不明白
'taxonomy' => 'category',//使用的分類法
'walker' => null//用于顯示的類(很復(fù)雜的概念)
?>
關(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>
<?php wp_list_categories('orderby=name&include=3,5,9,16'); ?>
</ul>
顯示Poetry為標(biāo)題的包括ID為5,9,23的分類列表
<ul>
<?php wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?>
</ul>
當(dāng)然你也可以像如下這樣書寫參數(shù),將參數(shù)整合為數(shù)組。
<?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分類法,是相對于標(biāo)簽(tag)的概念。
相關(guān)文章
PHP字符串與數(shù)組處理函數(shù)用法小結(jié)
php獲取ip的三個屬性區(qū)別介紹(HTTP_X_FORWARDED_FOR,HTTP_VIA,REMOTE_ADDR)
PHP實現(xiàn)獲取并生成數(shù)據(jù)庫字典的方法

