wp_insert_category函数是WordPress提供的一个用于插入分类的函数。它的用法如下：
1. 基本用法：
wp_insert_category( $catarr, $wp_error );
- $catarr（数组）：要插入的分类的信息，包括名称、父分类、描述等。
- $wp_error（布尔值，默认为false）：是否返回WP_Error对象，如果为true，则在插入失败时返回WP_Error对象。
2. 示例代码：
$catarr = array(
'cat_name' => '新闻分类',
'category_description' => '用于存储新闻相关的文章',
'category_parent' => 0,
'taxonomy' => 'category'
);
$cat_id = wp_insert_category( $catarr );
以上示例代码将插入一个名称为"新闻分类"，父分类为0（即顶级分类），描述为"用于存储新闻相关的文章"的分类。
3. 注意事项：
- 插入的分类名称必须是唯一的，否则会插入失败。
- 可以通过指定'category_parent'属性来将分类插入到指定的父分类下，如果不指定，则默认为顶级分类。
- 插入的分类信息中可以包含其他自定义分类法（taxonomy）的属性，例如'taxonomy' => 'custom_taxonomy'，将分类插入到名为"custom_taxonomy"的自定义分类法中。
4. 返回值：
- 成功插入分类时，返回插入的分类ID。
- 插入失败时，根据$wp_error参数的值返回不同类型的数据。如果$wp_error为true，则返回一个WP_Error对象；如果为false，则返回0。
综上所述，wp_insert_category函数是一个用于插入分类的函数，通过传入一个包含分类信息的数组来插入分类，并返回插入的分类ID。
0 个评论