wp_create_categories() – Function | Developer.WordPress.org

wp_create_categories( string[] $categories, int $post_id = ” ): int[]

Creates categories for the given post.

Parameters

$categoriesstring[]required: Array of category names to create.
$post_idintoptional: The post ID.
Default:''

Return

int[] Array of IDs of categories assigned to the given post.

Source

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;
}

View all references View on Trac View on GitHub

Uses	Description
category_exists()`wp-admin/includes/taxonomy.php`	Checks whether a category exists.
wp_create_category()`wp-admin/includes/taxonomy.php`	Adds a new category to the database if it does not already exist.
wp_set_post_categories()`wp-includes/post.php`	Sets categories for a post.

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.