常用函数-get_categories()
说明
返回与查询参数相匹配的类别对象数组。
变量与wp_list_categories基本一致，且变量可被作为数组传递，也可在查询句法中被传递。
用法
<?php $categories = get_categories(parameters); ?>
示例
缺省用法
<?php $defaults = array('type' => 'post',
'child_of' => 0,
'orderby' => 'name',
'order' => 'ASC',
'hide_empty' => true,
'include_last_update_time' => false,
'hierarchical' => 1,
'exclude' => ,
'include' => ,
'number' => ,
'pad_counts' => false);?>
下拉菜单
下面是一个如何创建某个类别（比如说，该类别存档了过去事件的相关信息）的子类下拉菜单的例子。这个例子也映射出 wp_get_archives 下拉菜单的示例，后者是关于如何创建每月存档的下拉菜单。
假设需要显示子类的类别编号为10，分类名称为“archives”。
<select name="event-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'>
<option value=""><?php echo attribute_escape(__('Select Event')); ?></option>
<?php
$categories= get_categories('child_of=10');
foreach ($categories as $cat) {
$option = '<option value="/category/archives/'.$cat->category_nicename.'">';
$option .= $cat->cat_name;
$option .= ' ('.$cat->category_count.')';
$option .= '</option>';
echo $option;
}
?>
</select>
参数
type（字符）
需检索的分类类型
- post — 默认
- link
child_of （整数）
仅显示标注了编号的分类的子类。该参数无默认值。使用该参数时应将hide_empty参数设为false。
orderby（字符）
将分类按字母顺序或独有分类编号进行排序。默认为按分类 编号排序。有效的值包括：
- ID — 默认
- name
order（字符）
为类别排序（升序或降序）。默认升序。可能的值包括：
- asc — 默认
- desc
hide_empty（布尔值）
触发显示没有文章的分类。默认值为true（隐藏空类别）。有效的值包括：
- 1（true）— 默认
- 0（false）
include_last_update_time（布尔值）
功能不确定
- 1 （true）
- 0（false）— 默认
hierarchical（布尔值）
将子类作为内部列表项目（父列表项下）或内联。默认为true（显示父列表项下的子类）。有效值包括：
- 1 （true）— 默认
- 0 （false）
exclude（字符）
除去wp_list_categories生成的列表中一个或多个分类。这个参数有一个用逗号分开的类别ID的列表，以升序排列。 参见示例。
include（字符）
只包含wp_list_categories 生成的若干类别。这个参数这个参数有一个用逗号分开的类别ID的列表，以升序排列。 参见示例。
- list — 默认
- none
number（字符）
将要返回的类别数量
pad_counts（布尔值）
通过子类中的项来计算链接或文章。有效值包括：
- 1 （true）
- 0（false）— 默认
分类：中文手册