常用函数-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）— 默认

分类：中文手册