get_categories()函數(shù)可以獲得分類所有信息,返回與查詢參數(shù)相匹配的類別對象數(shù)組。變量與wp_list_categories()函數(shù)基本一致,且變量可被作為數(shù)組傳遞,也可在查詢句法中被傳遞。
語法結(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ù))僅顯示標注了編號的分類的子類。該參數(shù)無默認值。使用該參數(shù)時應(yīng)將hide_empty參數(shù)設(shè)為false
parent(整數(shù))只顯示某個父級分類以及下面的子分類(注:子分類只顯示一個層級)。
orderby(字符)將分類按字母順序或獨有分類編號進行排序。默認為按分類 編號排序包括ID(默認)和Name
order(字符)為類別排序(升序或降序)。默認升序??赡艿闹蛋╝sc(默認)和desc
hide_empty(布爾值)觸發(fā)顯示沒有文章的分類。默認值為true(隱藏空類別)。有效的值包括:1(true)和0(false)。
hierarchical(布爾值)將子類作為內(nèi)部列表項目(父列表項下)的層級關(guān)系。默認為true(顯示父列表項下的子類)。有效值包括1 (true)和0(false)
exclude(字符)除去分類列表中一個或多個分類,多個可以用逗號分開,用分類ID號表示。
include(字符)只包含指定分類ID編號的分類。多個可以用逗號分開,用分類ID號表示。
pad_counts(布爾值)通過子類中的項來計算鏈接或文章。有效值包括1(true)和0(false),0為默認。
number(字符)將要返回的類別數(shù)量。
taxonomy(字符))返回一個分類法,這個是wordpress3.0版本后新添加的一個參數(shù)。返回的值包括category(默認)和taxonomy(一些新定義的分類名稱)。
實例
不使用wordpress默認的wp_list_categories()分類列表來實現(xiàn)分類列表,而使用get_categories自定義分類列表,而且還能在分類列表中加上圖標。
<?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>