get_categories()函數(shù)可以獲得分類(lèi)所有信息,返回與查詢參數(shù)相匹配的類(lèi)別對(duì)象數(shù)組。變量與wp_list_categories()函數(shù)基本一致,且變量可被作為數(shù)組傳遞,也可在查詢句法中被傳遞。
語(yǔ)法結(jié)構(gòu)
<?php $categories = get_categories( $args ); ?>
<?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ù)
type(字符) post
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)升序。可能的值包括asc(默認(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)表示。
pad_counts(布爾值)通過(guò)子類(lèi)中的項(xiàng)來(lái)計(jì)算鏈接或文章。有效值包括1(true)和0(false),0為默認(rèn)。
number(字符)將要返回的類(lèi)別數(shù)量。
taxonomy(字符))返回一個(gè)分類(lèi)法,這個(gè)是wordpress3.0版本后新添加的一個(gè)參數(shù)。返回的值包括category(默認(rèn))和taxonomy(一些新定義的分類(lèi)名稱)。
實(shí)例
不使用wordpress默認(rèn)的wp_list_categories()分類(lèi)列表來(lái)實(shí)現(xiàn)分類(lèi)列表,而使用get_categories自定義分類(lèi)列表,而且還能在分類(lèi)列表中加上圖標(biāo)。
<?php
$args=array(
'orderby' => 'name',
'order' => 'aSC'
);
$categories = get_categories($args);
foreach($categories as $category) {
echo ' <li class="cat-'. $category-> slug .'">';
echo ' <a href="' . get_category_link( $category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), $category->name ) . '" ' . '>' . $category->name.' </a>';
echo ' </li>';
}
?>
輸出html代碼:
<li class="cat-photo"><a href="#">Photo</a></li>
<li class="cat-design"><a href="#">Design</a></li>