wp_create_categories( string[] $categories, int $post_id = '' )
Creates categories for the given post.
Parameters
- $categories
-
(Required) Array of category names to create.
- $post_id
-
(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 ) {
if ( $id = category_exists( $category ) ) {
$cat_ids[] = $id;
} elseif ( $id = wp_create_category( $category ) ) {
$cat_ids[] = $id;
}
}
if ( $post_id )
wp_set_post_categories($post_id, $cat_ids);
return $cat_ids;
}
Changelog
| Version | Description |
|---|---|
| 2.0.0 | Introduced. |