wp_create_category( int|string $cat_name, int $category_parent ): int|WP_Error
Adds a new category to the database if it does not already exist.
Contents
Parameters
-
$cat_nameint|string Required -
Category name.
-
$category_parentint Optional -
ID of parent category.
Return
int|WP_Error
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
File: wp-admin/includes/taxonomy.php.
View all references
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,
)
);
}
Changelog
| Version | Description |
|---|---|
| 2.0.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
Examples
In order to create a simple category use:
To create a category that is a child of Uncategorized (or whatever category has the ID 0), use:
To get id of category created and put value in variable: