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

Parameters

$categoriesstring[]

Array of category names to create.

$post_idintoptional

The post ID. Default empty.Default: 0

Return

int[]

Array of IDs of categories assigned to the given post.

Uses · 3

• category_exists()Checks whether a category exists.
• wp_create_category()Adds a new category to the database if it does not already exist.
• wp_set_post_categories()Sets categories for a post.

Source

View on Trac ↗View on GitHub ↗

78function wp_create_categories( $categories, $post_id = 0 ) {79	$cat_ids = array();80	foreach ( $categories as $category ) {81		$id = category_exists( $category );82		if ( $id ) {83			$cat_ids[] = $id;84		} else {85			$id = wp_create_category( $category );86			if ( $id ) {87				$cat_ids[] = $id;88			}89		}90	}91 92	if ( $post_id ) {93		wp_set_post_categories( $post_id, $cat_ids );94	}95 96	return $cat_ids;97}

History

Introduced in 2.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-admin/includes/taxonomy.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.