詳解WordPress中分類函數(shù)wp_list_categories的使用
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ù)。
英文原文就不上了,有興趣的可以去看一下官方文檔。
用法
<?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//用于顯示的類(很復(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為標題的包括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分類法,是相對于標簽(tag)的概念。
相關(guān)文章
PHP擴展Swoole實現(xiàn)實時異步任務(wù)隊列示例
這篇文章主要介紹了PHP擴展Swoole實現(xiàn)實時異步任務(wù)隊列,結(jié)合實例形式分析了PHP擴展Swoole實現(xiàn)實時異步任務(wù)隊列相關(guān)客戶端與服務(wù)器端操作技巧,需要的朋友可以參考下2019-04-04PHP利用Socket獲取網(wǎng)站的SSL證書與公鑰
這篇文章主要給大家介紹了PHP利用Socket獲取網(wǎng)站的SSL證書與公鑰的相關(guān)資料,文中給出了詳細的示例代碼供大家參考學(xué)習(xí),對大家具有一定的參考學(xué)習(xí)價值,需要的朋友們下面來一起看看吧。2017-06-06