制作wordpress主題時(shí),想要獲取所有分類(lèi)相關(guān)信息,可以通過(guò)get_categories()函數(shù),該函數(shù)可以返回與查詢參數(shù)相匹配的類(lèi)別對(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ō)明:
type
(字符)post和link 其中l(wèi)ink在新版3.0以后已被棄用。
child_of
(整數(shù))僅顯示標(biāo)注了編號(hào)的分類(lèi)的子類(lèi)。該參數(shù)無(wú)默認(rèn)值。使用該參數(shù)時(shí)應(yīng)將hide_empty參數(shù)設(shè)為false
parent
(整數(shù))只顯示某個(gè)父級(jí)分類(lèi)以及下面的子分類(lèi)(注:子分類(lèi)只顯示一個(gè)層級(jí))。
orderby
(字符)將分類(lèi)按字母順序或獨(dú)有分類(lèi)編號(hào)進(jìn)行排序。默認(rèn)為按分類(lèi) 編號(hào)排序包括ID(默認(rèn))和Name
order
(字符)為類(lèi)別排序(升序或降序)。默認(rèn)升序??赡艿闹蛋╝sc(默認(rèn))和desc
hide_empty
(布爾值)觸發(fā)顯示沒(méi)有文章的分類(lèi)。默認(rèn)值為true(隱藏空類(lèi)別)。有效的值包括:1(true)和0(false)
hierarchical
(布爾值)
將子類(lèi)作為內(nèi)部列表項(xiàng)目(父列表項(xiàng)下)的層級(jí)關(guān)系。默認(rèn)為true(顯示父列表項(xiàng)下的子類(lèi))。有效值包括1 (true)和0(false)
exclude
(字符)除去分類(lèi)列表中一個(gè)或多個(gè)分類(lèi),多個(gè)可以用逗號(hào)分開(kāi),用分類(lèi)ID號(hào)表示
include
(字符)只包含指定分類(lèi)ID編號(hào)的分類(lèi)。多個(gè)可以用逗號(hào)分開(kāi),用分類(lèi)ID號(hào)表示
number
(字符)將要返回的類(lèi)別數(shù)量
pad_counts
(布爾值)通過(guò)子類(lèi)中的項(xiàng)來(lái)計(jì)算鏈接或文章。有效值包括1(true)和0(false),0為默認(rèn)
taxonomy
(字符)返回一個(gè)分類(lèi)法,這個(gè)是wordpress3.0版本后新添加的一個(gè)參數(shù)。返回的值包括category(默認(rèn))和taxonomy(一些新定義的分類(lèi)名稱)
示例:顯示分類(lèi)列表和分類(lèi)描述以及包含的文章數(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)論