Adds a new category to the database if it does not already exist.

Parameters

$cat_nameint|stringrequired

Category name.

$category_parentintoptional

ID of parent category.

Return

More Information

Parameters:

• $cat_name: Name for the new category.
• $parent: Category ID of the parent category.

Returns:

• 0 on failure, category id on success.

wp_create_category() is a thin wrapper around wp_insert_category().

Because this is a wrapper, it is not suitable for entering a complex custom taxonomy element.

If the category already exists, it is not duplicated. The ID of the original existing category is returned without error.

Source

function wp_create_category( $cat_name, $category_parent = 0 ) {
	$id = category_exists( $cat_name, $category_parent );
	if ( $id ) {
		return $id;
	}

	return wp_insert_category(
		array(
			'cat_name'        => $cat_name,
			'category_parent' => $category_parent,
		)
	);
}

View all references View on Trac View on GitHub

Changelog