wp_create_categories() WordPress Function
The wp_create_categories() function allows you to create new categories for your posts and pages. This function takes two arguments: the name of the category and the parent category. The name argument is required, while the parent category is optional. If you do not specify a parent category, the category will be created at the top level.
wp_create_categories( string[] $categories, int $post_id = '' ) #
Create categories for the given post.
Parameters
- $categories
(string[])(Required)Array of category names to create.
- $post_id
(int)(Optional) The post ID.
Default value: ''
Return
(int[]) Array of IDs of categories assigned to the given post.
Source
File: wp-admin/includes/taxonomy.php
function wp_create_categories( $categories, $post_id = '' ) { $cat_ids = array(); foreach ( $categories as $category ) { $id = category_exists( $category ); if ( $id ) { $cat_ids[] = $id; } else { $id = wp_create_category( $category ); if ( $id ) { $cat_ids[] = $id; } } } if ( $post_id ) { wp_set_post_categories( $post_id, $cat_ids ); } return $cat_ids; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
2.0.0 | Introduced. |