get_categories()

get_categories()

说明

获取与查询参数相匹配的类别对象数组

用法

<?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 );?>

参数

Type

（字符串）

需查询的分类类型

§ post （默认）

§ link

3.0 后用 taxonomy=link_category 代替了 type=link

child_of

（整数）仅显示指定分类编号的子类和后辈类。该参数无默认值。使用该参数时应将 hide_empty 参数设为 false

parent

（整数）仅显示指定分类编号的子类。该参数无默认值

Orderby

（字符串）排序字段

§ id

§ name（默认）

§ slug

§ count

§ term_group

order

（字符串）排序方式（升序或降序）

§ asc （默认）

§ desc

hide_empty

（布尔型）是否显示没有文章的分类

§ 1（默认）

§ 0

hierarchical

（布尔型）是否包括那些含有非空子类的空子类

§ 1（默认）

§ 0

Exclude

（字符串）排除列表中以升序排列的用逗号分开的一个或多个分类

Include

（字符串）包含列表中以升序排列的用逗号分开的一个或多个分类

§ list （默认）

§ none

number

（字符串）需要返回的类别数量

taxonomy

(字符串) 需要返回的分类信息。3.0 加入

§ category （默认）

§ taxonomy （或其他的分类信息）

pad_counts

（布尔型）是否计算子类中链接或文章数量

§ 1 （true）

§ 0 （false）（默认）

例子

显示类别的下拉列表

wp_dropdown_categories(array('hide_empty' => 0, 'name' => 'category_parent', 'orderby' => 'name', 'selected' => $category->parent, 'hierarchical' => true, 'show_option_none' => __('None')));
wp_dropdown_categories(array('hide_empty' => 0, 'name' => 'select_name', 'hierarchical' => true));
下拉列表
<select name="event-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'>
<option value=""><?php echo esc_attr(__('Select Event')); ?></option>
<?php
$categories= get_categories('child_of=10');
foreach (categories as category) {
option = '&lt;option value="/category/archives/'.category->category_nicename.'">';
option .= category->cat_name;
option .= ' ('.category->category_count.')';
$option .= '</option>';
echo $option;
}
?>
</select>
列表和说明

<?php
$args=array(
'orderby' => 'name',
'order' => 'ASC'
);
categories=get_categories(args);
foreach(categories as category) {
echo '<p>Category: <a href="' . get_category_link( category-&gt;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>'; }
?>
$category 完整信息是

$category->term_id
$category->name
$category->slug
$category->term_group
$category->term_taxonomy_id
$category->taxonomy
$category->description
$category->parent
$category->count
$category->cat_ID
$category->category_count
$category->category_description
$category->cat_name
$category->category_nicename
$category->category_parent
源码位置

wp-includes/category.php