WordPress函数get_categories()用法 获取所有的分类信息

描述：

获取所有的分类信息

用法：

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

(string) 要检索的类别类型

post - 默认
link
注意：从WordPress3.0开始，type=link已经被弃用。改用taxonomy=link_category。

child_of

(integer) 显示由其ID标识的类别的所有子类别（即子分类和孙分类）。此参数没有默认值。如果使用该参数，则hide_empty参数设置为false。

parent

(integer) 仅显示由其ID标识的分类的直接子代（即仅子代）的类别。这与“child_of”参数不同。此参数没有默认值。[在2.8.4中]

orderby

(string) 按字母顺序或按唯一类别ID对分类排序。默认为按名称排序。有效值：

id
name - 默认
slug
count
term_group
order

(string) 分类的排序顺序（升序或降序）。默认值为升序。有效值：

asc - 默认
desc
hide_empty

(boolean) 切换不显示文章的类别的显示。默认值为1表示真，或者可以添加“0”表示假（显示空类别）。有效值：

1 - 默认
0
hierarchical

(boolean) 如果为true，则结果将包括空的子类别，只要这些子类别具有非空的子类别。默认值为true。有效值：

1 (true) - 默认
0 (false)
exclude

(string) 从wp_list_categories生成的列表中排除一个或多个类别。此参数采用按唯一ID以逗号分隔的类别列表（按升序排列）。请参见示例。

include

(string) 只包括wp_list_categories生成的列表中的某些类别。此参数采用按唯一ID以逗号分隔的类别列表（按升序排列）。请参见示例。

list - 默认.
none
number

(string) 要返回的分类数

taxonomy

(string or array) 要返回的分类法。此参数在版本3.0中添加了有效值：

category - 默认
taxonomy - 或 任何已注册的分类法
pad_counts

(boolean) 通过包含子分类中的项目来计算链接或投递计数。有效值：

1 (true)
0 (false) - 默认

示例：

<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 = '<option value="/category/archives/'.$category->category_nicename.'">';
	$option .= $category->cat_name;
	$option .= ' ('.$category->category_count.')';
	$option .= '</option>';
	echo $option;
  }
 ?>
</select>

源文件：

function get_categories( $args = '' ) {
$defaults = array( 'taxonomy' => 'category' );
$args = wp_parse_args( $args, $defaults );

/**
* Filters the taxonomy used to retrieve terms when calling get_categories().
*
* @since 2.7.0
*
* @param string $taxonomy Taxonomy to retrieve terms from.
* @param array $args An array of arguments. See get_terms().
*/
$args['taxonomy'] = apply_filters( 'get_categories_taxonomy', $args['taxonomy'], $args );

// Back compat
if ( isset( $args['type'] ) && 'link' == $args['type'] ) {
_deprecated_argument(
__FUNCTION__,
'3.0.0',
sprintf(
/* translators: 1: "type => link", 2: "taxonomy => link_category" */
__( '%1$s is deprecated. Use %2$s instead.' ),
'<code>type => link</code>',
'<code>taxonomy => link_category</code>'
)
);
$args['taxonomy'] = 'link_category';
}

$categories = get_terms( $args );

if ( is_wp_error( $categories ) ) {
$categories = array();
} else {
$categories = (array) $categories;
foreach ( array_keys( $categories ) as $k ) {
_make_cat_compat( $categories[ $k ] );
}
}

return $categories;
}