> WordPress中文手册 > wordpress创建新分类函数:wp_insert_category()

【函数介绍】

wp_insert_category() 用于插入一个新分类数据到分类系统。

【函数用法】

<?PHP wp_insert_category( $catarr, $wp_error ); ?>

【参数】

$catarr
(array) (必须) 分类信息.
Default: None
$catarr 默认值如下:

$cat_defaults = array(
  'cat_ID' => 0,                //分类ID
  'cat_name' => ,               //分类名称
  'category_description' => ,   //分类描述
  'category_nicename' => ,      //分类别名
  'category_parent' => ,        //父类
  'taxonomy' => 'category'      //分类系统类别
  );

说明$catarr 可能还有其他参数,但是强烈建议至少提供以上默认的参数列表。
$wp_error
(boolean) (可选) 是否返回 WP_Error 或者布尔型. 默认返回:布尔型.
默认: false

【返回值】

(boolean | WP_Error | int)
插入分类成功返回新创建的分类ID,插入错误则返回boolean或者WP_Error

【示例】

插入一个新分类

//定义分类数据
$my_cat = array('cat_name' => 'My Category', 'category_description' => 'A Cool Category', 'category_nicename' => 'category-slug', 'category_parent' => '');

// 创建分类
$my_cat_id = wp_insert_category($my_cat);

【源代码】

wp_insert_category() 位于 wp-admin/includes/taxonomy.php.