制作wordpress主題時(shí),想要獲取所有分類相關(guān)信息,可以通過(guò)get_categories()函數(shù),該函數(shù)可以返回與查詢參數(shù)相匹配的類別對(duì)象數(shù)組,該函數(shù)的變量與wp_list_categories()函數(shù)基本一致,且變量可被作為數(shù)組傳遞,也可在查詢句法中被傳遞。
函數(shù)用法:
- <?php $categories = get_categories( $args ); ?>
$args參數(shù)及默認(rèn)值:
- <?php
- $args = array(
- 'type' => 'post',
- 'child_of' => 0,
- 'parent' => '',
- 'orderby' => 'name',
- 'order' => 'ASC',
- 'hide_empty' => 1,
- 'hierarchical' => 1,
- 'exclude' => '',
- 'include' => '',
- 'number' => '',
- 'taxonomy' => 'category',
- 'pad_counts' => false
- );
- ?>
參數(shù)說(shuō)明:文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
type文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(字符)post和link 其中l(wèi)ink在新版3.0以后已被棄用。文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
child_of文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(整數(shù))僅顯示標(biāo)注了編號(hào)的分類的子類。該參數(shù)無(wú)默認(rèn)值。使用該參數(shù)時(shí)應(yīng)將hide_empty參數(shù)設(shè)為false文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
parent文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(整數(shù))只顯示某個(gè)父級(jí)分類以及下面的子分類(注:子分類只顯示一個(gè)層級(jí))。文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
orderby文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(字符)將分類按字母順序或獨(dú)有分類編號(hào)進(jìn)行排序。默認(rèn)為按分類 編號(hào)排序包括ID(默認(rèn))和Name文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
order文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(字符)為類別排序(升序或降序)。默認(rèn)升序??赡艿闹蛋╝sc(默認(rèn))和desc文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
hide_empty文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(布爾值)觸發(fā)顯示沒(méi)有文章的分類。默認(rèn)值為true(隱藏空類別)。有效的值包括:1(true)和0(false)文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
hierarchical文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(布爾值)文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
將子類作為內(nèi)部列表項(xiàng)目(父列表項(xiàng)下)的層級(jí)關(guān)系。默認(rèn)為true(顯示父列表項(xiàng)下的子類)。有效值包括1 (true)和0(false)文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
exclude文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(字符)除去分類列表中一個(gè)或多個(gè)分類,多個(gè)可以用逗號(hào)分開(kāi),用分類ID號(hào)表示文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
include文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
(字符)只包含指定分類ID編號(hào)的分類。多個(gè)可以用逗號(hào)分開(kāi),用分類ID號(hào)表示文章源自網(wǎng)吧系統(tǒng)維護(hù)-http://www.strong-digital.cn/7725.html
number
(字符)將要返回的類別數(shù)量
pad_counts
(布爾值)通過(guò)子類中的項(xiàng)來(lái)計(jì)算鏈接或文章。有效值包括1(true)和0(false),0為默認(rèn)
taxonomy
(字符)返回一個(gè)分類法,這個(gè)是wordpress3.0版本后新添加的一個(gè)參數(shù)。返回的值包括category(默認(rèn))和taxonomy(一些新定義的分類名稱)
示例:顯示分類列表和分類描述以及包含的文章數(shù)目
- <?php
- $args=array(
- 'orderby' => 'name',
- 'order' => 'ASC'
- );
- $categories=get_categories($args);
- foreach($categories as $category) {
- echo '<p>Category: <a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . '>' . $category->name.'</a> </p> ';
- echo '<p> Description:'. $category->description . '</p>';
- echo '<p> Post Count: '. $category->count . '</p>';
- }
- ?>
評(píng)論