编辑“WordPress常用函数get categories”

<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> [[WordPress常用函数(上)|
上一页]] | {{Template:WordPress导航}}</span>
<div style="clear:both;"></div>
==说明==
返回与查询参数相匹配的类别对象数组。

变量与[http://codex.wordpress.org/Template_Tags/wp_list_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);?>

===下拉菜单===
下面是一个如何创建某个类别（比如说，该类别存档了过去事件的相关信息）的子类下拉菜单的例子。这个例子也映射出[http://codex.wordpress.org/Template_Tags/wp_get_archives 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的列表，以升序排列。 参见[http://codex.wordpress.org/Template_Tags/wp_list_categories#Include_or_Exclude_Categories 示例]。

'''include（字符）'''

只包含wp_list_categories 生成的若干类别。这个参数这个参数有一个用逗号分开的类别ID的列表，以升序排列。 参见[http://codex.wordpress.org/Template_Tags/wp_list_categories#Include_or_Exclude_Categories 示例]。

*list — 默认 
*none 

'''number（字符）'''

将要返回的类别数量

'''pad_counts（布尔值）'''

通过子类中的项来计算链接或文章。有效值包括：

*1 （true） 
*0（false）— 默认

==相关条目==
*[[Drupal]] 
*[[OBLOG]] 
*[[X-Space]] 
*[[SaBlog-X]] 
*[[Bo-Blog]]

[[category:WordPress中文文档|G]]
[[category:WordPress网站开发|G]]
[[category:WordPress开发文档|G]]