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