is_object_in_term

Determine if the given object is associated with any of the given terms.

Description

(bool|WP_Error) is_object_in_term( (int) $object_id, (string) $taxonomy, (null) $terms = null ); 

The given terms are checked against the object's terms' term_ids, names and slugs. Terms given as integers will only be checked against the object's terms' term_ids. If no terms are given, determines if object is associated with any terms in the given taxonomy.

Returns (bool|WP_Error)

WP_Error on input error.

Parameters (3)

0. $object_id (int)
ID of the object (post ID, link ID, ...).
1. $taxonomy (string)
Single taxonomy name.
2. $terms — Optional. (null) => null
Term term_id, name, slug or array of said. Default null.

Usage

  1. if ( !function_exists( 'is_object_in_term' ) ) { 
  2.     require_once ABSPATH . WPINC . '/taxonomy.php'; 
  3. } 
  4.   
  5. // ID of the object (post ID, link ID, ...). 
  6. $object_id = -1; 
  7.   
  8. // Single taxonomy name. 
  9. $taxonomy = ''; 
  10.   
  11. // Optional. Term term_id, name, slug or array of said. Default null. 
  12. $terms = null; 
  13.   
  14. // NOTICE! Understand what this does before running. 
  15. $result = is_object_in_term($object_id, $taxonomy, $terms); 
  16.     

Defined (1)

The function is defined in the following location(s).

/wp-includes/taxonomy.php  
  1. function is_object_in_term( $object_id, $taxonomy, $terms = null ) { 
  2.     if ( !$object_id = (int) $object_id ) 
  3.         return new WP_Error( 'invalid_object', __( 'Invalid object ID' ) ); 
  4.  
  5.     $object_terms = get_object_term_cache( $object_id, $taxonomy ); 
  6.     if ( false === $object_terms ) { 
  7.         $object_terms = wp_get_object_terms( $object_id, $taxonomy, array( 'update_term_meta_cache' => false ) ); 
  8.         if ( is_wp_error( $object_terms ) ) { 
  9.             return $object_terms; 
  10.         } 
  11.  
  12.         wp_cache_set( $object_id, wp_list_pluck( $object_terms, 'term_id' ), "{$taxonomy}_relationships" ); 
  13.     } 
  14.  
  15.     if ( is_wp_error( $object_terms ) ) 
  16.         return $object_terms; 
  17.     if ( empty( $object_terms ) ) 
  18.         return false; 
  19.     if ( empty( $terms ) ) 
  20.         return ( !empty( $object_terms ) ); 
  21.  
  22.     $terms = (array) $terms; 
  23.  
  24.     if ( $ints = array_filter( $terms, 'is_int' ) ) 
  25.         $strs = array_diff( $terms, $ints ); 
  26.     else 
  27.         $strs =& $terms; 
  28.  
  29.     foreach ( $object_terms as $object_term ) { 
  30.         // If term is an int, check against term_ids only. 
  31.         if ( $ints && in_array( $object_term->term_id, $ints ) ) { 
  32.             return true; 
  33.         } 
  34.  
  35.         if ( $strs ) { 
  36.             // Only check numeric strings against term_id, to avoid false matches due to type juggling. 
  37.             $numeric_strs = array_map( 'intval', array_filter( $strs, 'is_numeric' ) ); 
  38.             if ( in_array( $object_term->term_id, $numeric_strs, true ) ) { 
  39.                 return true; 
  40.             } 
  41.  
  42.             if ( in_array( $object_term->name, $strs ) ) return true; 
  43.             if ( in_array( $object_term->slug, $strs ) ) return true; 
  44.         } 
  45.     } 
  46.  
  47.     return false; 
  48. }