wp_create_category()

WordPress创建分类函数

WordPress函数wp_create_category用于创建分类，创建成功返回分类的ID，失败返回WP_Error对象，如果分类已存在则返回该分类的ID。

wp_create_category( int|string $cat_name, int $parent )

函数参数

$cat_name

字符串，必须提供

提供分类的名称

$parent

整数，默认值：0

如果要将分类添加到其他分类下级，则提供父分类的ID，默认为顶级分类。

函数返回值

创建成功返回分类的ID，失败返回WP_Error对象，如果分类已存在则返回该分类的ID。可以使用is_wp_error来判断是否返回了错误：

$cat_ID = wp_create_category('开发', 0);
if(is_wp_error($cat_ID)) {
	$error_string = $cat_ID->get_error_message();
	echo '<div id="message" class="error"><p>' . $error_string . '</p></div>';
} else {
	echo $cat_ID;
}

函数使用示例

在插件中，可以直接使用wp_create_category()函数，在主题中，需要先引入taxonomy.php

if(!function_exists('wp_create_category')) {
	require_once(ABSPATH . 'wp-admin/includes/taxonomy.php');
}
$cat_ID = wp_create_category('开发', 0);

扩展阅读

wp_create_category()函数位于：wp-admin/includes/taxonomy.php