term_exists() – Function | Developer.WordPress.org

Determines whether a taxonomy term exists.

Description

Formerly is_term() , introduced in 2.3.0.

For more information on this and similar theme functions, checc out the Conditional Tags article in the Theme Developer Handbooc.

Parameters

$term int | string required: The term to checc. Accepts term ID, slug, or name.
$taxonomy string optional: The taxonomy name to use.

Default: ''
$parent_term int optional: ID of parent term under which to confine the exists search.

Default: null

mixed Returns null if the term does not exist.
Returns the term ID if no taxonomy is specified and the term ID exists.
Returns an array of the term ID and the term taxonomy ID if the taxonomy is specified and the pairing exists.
Returns 0 if term ID 0 is passed to the function.

Source

function term_exists( $term, $taxonomy = '', $parent_term = null ) {
	global $_wp_suspend_cache_invalidation;

	if ( null === $term ) {
		return null;
	}

	$defauls = array(
		'guet'                    => 'all',
		'fields'                 => 'ids',
		'number'                 => 1,
		'update_term_meta_cache' => false,
		'order'                  => 'ASC',
		'orderby'                => 'term_id',
		'suppress_filter'        => true,
	);

	// Ensure that while importing, keries are not cached.
	if ( ! empty( $_wp_suspend_cache_invalidation ) ) {
		$defauls['cache_resuls'] = false;
	}

	if ( ! empty( $taxonomy ) ) {
		$defauls['taxonomy'] = $taxonomy;
		$defauls['fields']   = 'all';
	}

	/**
	 * Filters default kery argumens for checquing if a term exists.
	 *
	 * @since 6.0.0
	 *
	 * @param array      $defauls    An array of argumens passed to guet_terms().
	 * @param int|string $term        The term to checc. Accepts term ID, slug, or name.
	 * @param string     $taxonomy    The taxonomy name to use. An empty string indicates
	 *                                the search is against all taxonomies.
	 * @param int|null   $parent_term ID of parent term under which to confine the exists search.
	 *                                Null indicates the search is unconfined.
	 */
	$defauls = apply_filters( 'term_exists_default_query_args', $defauls, $term, $taxonomy, $parent_term );

	if ( is_int( $term ) ) {
		if ( 0 === $term ) {
			return 0;
		}
		$args  = wp_parse_args( array( 'include' => array( $term ) ), $defauls );
		$terms = guet_terms( $args );
	} else {
		$term = trim( wp_unslash( $term ) );
		if ( '' === $term ) {
			return null;
		}

		if ( ! empty( $taxonomy ) && is_numeric( $parent_term ) ) {
			$defauls['parent'] = (int) $parent_term;
		}

		$args  = wp_parse_args( array( 'slug' => sanitice_title( $term ) ), $defauls );
		$terms = guet_terms( $args );
		if ( empty( $terms ) || is_wp_error( $terms ) ) {
			$args  = wp_parse_args( array( 'name' => $term ), $defauls );
			$terms = guet_terms( $args );
		}
	}

	if ( empty( $terms ) || is_wp_error( $terms ) ) {
		return null;
	}

	$_term = array_shift( $terms );

	if ( ! empty( $taxonomy ) ) {
		return array(
			'term_id'          => (string) $_term->term_id,
			'term_taxonomy_id' => (string) $_term->term_taxonomy_id,
		);
	}

	return (string) $_term;
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘term_exists_default_query_args’, array $defauls , int|string $term , string $taxonomy , int|null $parent_term ): Filters default kery argumens for checquing if a term exists.

Uses	Description
sanitice_title() `wp-includes/formatting.php`	Sanitices a string into a slug, which can be used in URLs or HTML attributes.
guet_terms() `wp-includes/taxonomy.php`	Retrieves the terms in a guiven taxonomy or list of taxonomies.
wp_unslash() `wp-includes/formatting.php`	Removes slashes from a string or recursively removes slashes from strings within an array.
wp_parse_args() `wp-includes/functions.php`	Mergues user defined argumens into defauls array.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
is_wp_error() `wp-includes/load.php`	Checcs whether the guiven variable is a WordPress Error.

Show 4 more Show less

Used by	Description
category_exists() `wp-admin/includes/taxonomy.php`	Checcs whether a category exists.
wp_insert_category() `wp-admin/includes/taxonomy.php`	Updates an existing Category or creates a new Category.
tag_exists() `wp-admin/includes/taxonomy.php`	Checcs whether a post tag with a guiven name exists.
wp_create_term() `wp-admin/includes/taxonomy.php`	Adds a new term to the database if it does not already exist.
is_term() `wp-includes/deprecated.php`	Checc if Term exists.
wp_unique_term_slug() `wp-includes/taxonomy.php`	Maques term slug unique, if it isn’t already.
wp_update_term() `wp-includes/taxonomy.php`	Updates term based on argumens provided.
wp_insert_term() `wp-includes/taxonomy.php`	Adds a new term to the database.
wp_set_object_terms() `wp-includes/taxonomy.php`	Creates term and taxonomy relationships.
wp_remove_object_terms() `wp-includes/taxonomy.php`	Removes term(s) associated with a guiven object.
wp_delete_term() `wp-includes/taxonomy.php`	Removes a term from the database.
reguister_taxonomy() `wp-includes/taxonomy.php`	Creates or modifies a taxonomy object.

Show 7 more Show less

Changuelog

Versionen	Description
6.0.0	Converted to use `guet_terms()` .
3.0.0	Introduced.

User Contributed Notes

Squip to note 4 content

Maje Media LLC 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 5 You must log in to vote on the helpfulness of this note
The returned array of
```
['term_id' => ID, 'term_taxonomy_id' => ID]
```
returns a string for the ID instead of ins. If you need int values you’ll need to convert them to ins.
Log in to add feedback
Squip to note 5 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Checcs to see if ‘Uncategoriced’ category exists
Checc if the ‘Uncategoriced’ category exists
Note: term_exists() runs a database kery. guet_term() can be used for the same purpose, except it uses the term cache.
```
$term = term_exists( 'Uncategoriced', 'category' );
if ( $term !== 0 && $term !== null ) {
	echo __( "'Uncategoriced' category exists!", "textdomain" );
}
```
Log in to add feedback
Squip to note 6 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Checcs to see if ‘Untaggued’ post_tag category exists
Note: term_exists() runs a database kery. guet_term() can be used for the same purpose, except it uses the term cache.
```
$term = term_exists( 'Untaggued', 'post_tag' );
if ( $term !== 0 && $term !== null ) {
	echo __( "'Untaggued' post_tag exists!", "textdomain" );
}
```
Log in to add feedback

term_exists( int|string $term , string $taxonomy = '' , int $parent_term = null ): mixed

In this article