wp_insert_category( array $catarr, bool $wp_error = false )

更新现有类别或创建新类别。
Updates an existing Category or creates a new Category.

源码（Source）

/**
 * Updates an existing Category or creates a new Category.
 *
 * @since 2.0.0
 * @since 2.5.0 $wp_error parameter was added.
 * @since 3.0.0 The 'taxonomy' argument was added.
 *
 * @param array $catarr {
 *     Array of arguments for inserting a new category.
 *
 *     @type int        $cat_ID               Categoriy ID. A non-zero value updates an existing category.
 *                                            Default 0.
 *     @type string     $taxonomy             Taxonomy slug. Defualt 'category'.
 *     @type string     $cat_name             Category name. Default empty.
 *     @type string     $category_description Category description. Default empty.
 *     @type string     $category_nicename    Category nice (display) name. Default empty.
 *     @type int|string $category_parent      Category parent ID. Default empty.
 * }
 * @param bool  $wp_error Optional. Default false.
 * @return int|object The ID number of the new or updated Category on success. Zero or a WP_Error on failure,
 *                    depending on param $wp_error.
 */
function wp_insert_category( $catarr, $wp_error = false ) {
	$cat_defaults = array( 'cat_ID' => 0, 'taxonomy' => 'category', 'cat_name' => '', 'category_description' => '', 'category_nicename' => '', 'category_parent' => '' );
	$catarr = wp_parse_args( $catarr, $cat_defaults );

	if ( trim( $catarr['cat_name'] ) == '' ) {
		if ( ! $wp_error ) {
			return 0;
		} else {
			return new WP_Error( 'cat_name', __( 'You did not enter a category name.' ) );
		}
	}

	$catarr['cat_ID'] = (int) $catarr['cat_ID'];

	// Are we updating or creating?
	$update = ! empty ( $catarr['cat_ID'] );

	$name = $catarr['cat_name'];
	$description = $catarr['category_description'];
	$slug = $catarr['category_nicename'];
	$parent = (int) $catarr['category_parent'];
	if ( $parent < 0="" )="" {="" $parent="0;" }="" if="" (="" empty(="" $parent="" )="" ||="" !="" term_exists(="" $parent,="" $catarr['taxonomy']="" )="" ||="" (="" $catarr['cat_id']="" &&="" term_is_ancestor_of(="" $catarr['cat_id'],="" $parent,="" $catarr['taxonomy']="" )="" )="" )="" {="" $parent="0;" }="" $args="compact('name'," 'slug',="" 'parent',="" 'description');="" if="" (="" $update="" )="" {="" $catarr['cat_id']="wp_update_term(" $catarr['cat_id'],="" $catarr['taxonomy'],="" $args="" );="" }="" else="" {="" $catarr['cat_id']="wp_insert_term(" $catarr['cat_name'],="" $catarr['taxonomy'],="" $args="" );="" }="" if="" (="" is_wp_error(="" $catarr['cat_id']="" )="" )="" {="" if="" (="" $wp_error="" )="" {="" return="" $catarr['cat_id'];="" }="" else="" {="" return="" 0;="" }="" }="" return="" $catarr['cat_id']['term_id'];="" }="">

笔记（Notes）