get_categories() 说明 获取与查询参数相匹配的类别对象数组 用法 默认参数 ‘post’, ‘child_of’ => 0, ‘parent’ => ”, ‘orderby’ => ‘name’, ‘order’ => ‘ASC’, ‘hide_empty’ => 1, ..

get_categories()

本贴最后更新于 2490 天前,其中的信息可能已经沧海桑田

get_categories()

说明

获取与查询参数相匹配的类别对象数组

用法

<?php categories = get_categories( args ); ?>

默认参数

<?php $args = array(

‘type’ => ‘post’,

‘child_of’ => 0,

‘parent’ => ”,

‘orderby’ => ‘name’,

‘order’ => ‘ASC’,

‘hide_empty’ => 1,

‘hierarchical’ => 1,

‘exclude’ => ”,

‘include’ => ”,

‘number’ => ”,

‘taxonomy’ => ‘category’,

‘pad_counts’ => false );?>

参数

Type

(字符串)

需查询的分类类型

§ post (默认)

§ link

3.0 后用 taxonomy=link_category 代替了 type=link

child_of

(整数)仅显示指定分类编号的子类和后辈类。该参数无默认值。使用该参数时应将 hide_empty 参数设为 false

parent

(整数)仅显示指定分类编号的子类。该参数无默认值

Orderby

(字符串)排序字段

§ id

§ name(默认)

§ slug

§ count

§ term_group

order

(字符串)排序方式(升序或降序)

§ asc (默认)

§ desc

hide_empty

(布尔型)是否显示没有文章的分类

§ 1(默认)

§ 0

hierarchical

(布尔型)是否包括那些含有非空子类的空子类

§ 1(默认)

§ 0

Exclude

(字符串)排除列表中以升序排列的用逗号分开的一个或多个分类

Include

(字符串)包含列表中以升序排列的用逗号分开的一个或多个分类

§ list (默认)

§ none

number

(字符串)需要返回的类别数量

taxonomy

(字符串) 需要返回的分类信息。3.0 加入

§ category (默认)

§ taxonomy (或其他的分类信息)

pad_counts

(布尔型)是否计算子类中链接或文章数量

§ 1 (true)

§ 0 (false)(默认)

例子

显示类别的下拉列表

wp_dropdown_categories(array('hide_empty' => 0, 'name' => 'category_parent', 'orderby' => 'name', 'selected' => category-&gt;parent, 'hierarchical' =&gt; true, 'show_option_none' =&gt; __('None'))); wp_dropdown_categories(array('hide_empty' =&gt; 0, 'name' =&gt; 'select_name', 'hierarchical' =&gt; true)); 下拉列表 &lt;select name="event-dropdown" onchange='document.location.href=this.options[this.selectedIndex].value;'&gt; &lt;option value=""&gt;&lt;?php echo esc_attr(__('Select Event')); ?&gt;&lt;/option&gt; &lt;?php categories= get_categories('child_of=10');
foreach (categories as category) {
option = '&lt;option value="/category/archives/'.category->category_nicename.'">';
option .= category->cat_name;
option .= ' ('.category->category_count.')';
option .= '&lt;/option&gt;'; echo option;
}
?>
</select>
列表和说明

<?php
args=array( 'orderby' =&gt; 'name', 'order' =&gt; 'ASC' ); categories=get_categories(args); foreach(categories as category) { echo '&lt;p&gt;Category: &lt;a href="' . get_category_link( category->term_id ) . '" title="' . sprintf( __( "View all posts in %s" ), category-&gt;name ) . '" ' . '&gt;' . category->name.'</a> </p> ';
echo '<p> Description:'. category-&gt;description . '&lt;/p&gt;'; echo '&lt;p&gt; Post Count: '. category->count . '</p>'; }
?>
$category 完整信息是

category-&gt;term_id category->name
category-&gt;slug category->term_group
category-&gt;term_taxonomy_id category->taxonomy
category-&gt;description category->parent
category-&gt;count category->cat_ID
category-&gt;category_count category->category_description
category-&gt;cat_name category->category_nicename
$category->category_parent
源码位置

wp-includes/category.php

  • WordPress

    WordPress 是一个使用 PHP 语言开发的博客平台,用户可以在支持 PHP 和 MySQL 数据库的服务器上架设自己的博客。也可以把 WordPress 当作一个内容管理系统(CMS)来使用。WordPress 是一个免费的开源项目,在 GNU 通用公共许可证(GPLv2)下授权发布。

    41 引用 • 100 回帖 • 517 关注
回帖
请输入回帖内容...