WordPress常用函数get categories

来自站长百科
跳转至: 导航、​ 搜索

导航: 上一页 | 首页 | WordPress中文论坛 | WordPress主机 | CMS程序 | 论坛程序 | ECShop | ShopNC | PowerEasy

说明[ ]

返回与查询参数相匹配的类别对象数组。

变量与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)— 默认

相关条目[ ]