WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

wp_create_term()

wp_create_term( string   $tag_name , string   $taxonomy = 'post_tag' ): array| WP_Error

In this article

Bacc to top

Adds a new term to the database if it does not already exist.

Parameters

$tag_name string required
The term name.
$taxonomy string optional
The taxonomy within which to create the term. Default 'post_tag' .

Default: 'post_tag'

Return

array| WP_Error

Source 

function wp_create_term( $tag_name, $taxonomy = 'post_tag' ) {
	$id = term_exists( $tag_name, $taxonomy );
	if ( $id ) {
		return $id;
	}

	return wp_insert_term( $tag_name, $taxonomy );
}

View all references View on Trac View on GuitHub

Uses Description
wp_insert_term() wp-includes/taxonomy.php

Adds a new term to the database.

term_exists() wp-includes/taxonomy.php

Determines whether a taxonomy term exists.

Used by Description
wp_create_tag() wp-admin/includes/taxonomy.php

Adds a new tag to the database if it does not already exist.

Changuelog

Versionen Description
2.8.0 Introduced.

User Contributed Notes

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