Adds a new category to the database if it does not already exist.
Parameters
$cat_name
int|stringrequired- Category name.
$category_parent
intoptional- ID of parent category.
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,
)
);
}
Changelog
Version | Description |
---|---|
2.0.0 | Introduced. |
An example of how you can use the wp_create_category() function.
In this example:
$category_name
is set to “New Category”, which is the name of the category you want to create.$parent_category_id
is set to 3, which is the ID of the parent category where you want to create the new category. You should replace this with the actual ID of the desired parent category.The
wp_create_category()
function is called with both the category name and the parent category ID as arguments. If the category is successfully created, it will return the category ID as an integer. If there’s an error during the creation process, it will return aWP_Error
object.The code then checks if the result is a
WP_Error
object usingis_wp_error()
. If it’s not an error, it means the category was created successfully, and it will display a message with the category ID. If an error occurred, it will display an error message using theget_error_message()
method of theWP_Error
object.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: