常用函数-get_categories()

0条评论

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