Changeset 10159 for trunk/wp-includes/taxonomy.php

Timestamp:

12/09/2008 11:31:11 PM (16 years ago)

Author:

ryan

Message:

Convert in_category() and has_tags() to use the same is_object_in_term(), which accepts one object, one taxonomy, and 0, 1 or multiple term term_ids/names/slugs.

In those functions, compare ints only to term_ids. Strings are compared to term_ids, names, slugs.

Document all three better, and note how they've changed with WP versions. Prop mdawaffe

File:

• trunk/wp-includes/taxonomy.php (modified) (1 diff)

trunk/wp-includes/taxonomy.php

@@ -2225 +2225 @@
 }
 
+/**
+ * Determine if the given object is associated with any of the given terms.
+ *
+ * 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.
+ *
+ * @since 2.7.0
+ * @uses get_object_term_cache()
+ * @uses wp_get_object_terms()
+ *
+ * @param int $object_id.  ID of the object (post ID, link ID, ...)
+ * @param string $taxonomy.  Single taxonomy name
+ * @param int|string|array $terms Optional.  Term term_id, name, slug or array of said
+ * @return bool|WP_Error. WP_Error on input error.
+ */
+function is_object_in_term( $object_id, $taxonomy, $terms = null ) {
+    if ( !$object_id = (int) $object_id )
+        return new WP_Error( 'invalid_object', __( 'Invalid object ID' ) );
+
+    $object_terms = get_object_term_cache( $object_id, $taxonomy );
+    if ( empty( $object_terms ) )
+         $object_terms = wp_get_object_terms( $object_id, $taxonomy );
+
+    if ( is_wp_error( $object_terms ) )
+        return $object_terms;
+    if ( empty( $object_terms ) )
+        return false;
+    if ( empty( $terms ) )
+        return ( !empty( $object_terms ) );
+
+    $terms = (array) $terms;
+
+    if ( $ints = array_filter( $terms, 'is_int' ) )
+        $strs = array_diff( $terms, $ints );
+    else
+        $strs =& $terms;
+
+    foreach ( $object_terms as $object_term ) {
+        if ( $ints && in_array( $object_term->term_id, $ints ) ) return true; // If int, check against term_id
+        if ( $strs ) {
+            if ( in_array( $object_term->term_id, $strs ) ) return true;
+            if ( in_array( $object_term->name, $strs ) )    return true;
+            if ( in_array( $object_term->slug, $strs ) )    return true;
+        }
+    }
+
+    return false;
+}
+
 ?>