Ticket #12526: has_term.2.diff

wp-includes/category-template.php

@@ -251 +251 @@
  * @param int|post object Optional.  Post to check instead of the current post. @since 2.7.0
  * @return bool True if the current post is in any of the given categories.
  */
-function in_category( $category, $_post = null ) {
-        if ( empty( $category ) )
-                return false;
-
-        if ( $_post ) {
-                $_post = get_post( $_post );
-        } else {
-                $_post =& $GLOBALS['post'];
-        }
-
-        if ( !$_post )
-                return false;
-
-        $r = is_object_in_term( $_post->ID, 'category', $category );
-        if ( is_wp_error( $r ) )
-                return false;
-        return $r;
+function in_category( $category, $post = null ) {
+        return has_category( $category, $post );
 }
 
 /**
@@ -969 +954 @@
 }
 
 /**
- * Check if the current post has any of given tags.
+ * Check if the current post has any of given categories.
  *
- * The given tags are checked against the post's tags' term_ids, names and slugs.
- * Tags given as integers will only be checked against the post's tags' term_ids.
- * If no tags are given, determines if post has any tags.
+ * @since 3.0.0
  *
- * Prior to v2.7 of WordPress, tags given as integers would also be checked against the post's tags' names and slugs (in addition to term_ids)
- * Prior to v2.7, this function could only be used in the WordPress Loop.
- * As of 2.7, the function can be used anywhere if it is provided a post ID or post object.
+ * @uses is_object_in_term()
+ * @see has_term()
  *
+ * @param string|int|array $tag Optional. The category name/category_id/slug or array of them to check for.
+ * @param int|post object Optional.  Post to check instead of the current post.
+ * @return bool True if the current post has any of the the given categories (or any category, if no category specified).
+ */
+function has_category( $category = '', $post = null ) {
+        return has_term( $category, 'category', $post );
+}
+
+/**
+ * Check if the current post has any of given tags.
+ *
  * @since 2.6.0
  *
  * @uses is_object_in_term()
+ * @see has_term()
  *
- * @param string|int|array $tag Optional. The tag name/term_id/slug or array of them to check for.
+ * @param string|int|array $tag Optional. The tag name/tag_id/slug or array of them to check for.
+ * @param int|post object Optional.  Post to check instead of the current post.
+ * @return bool True if the current post has any of the the given tags (or any tag, if no tag specified).
+ */
+function has_tag( $tag = '', $post = null ) {
+        return has_term( $tag, 'post_tag', $post );
+}
+
+
+/**
+ * Check if the current post has any of given terms.
+ *
+ * The given terms are checked against the post's terms' term_ids, names and slugs.
+ * Terms given as integers will only be checked against the post's terms' term_ids.
+ * If no terms are given, determines if post has any terms.
+ *
+ * @since 3.0.0
+ *
+ * @uses is_object_in_term()
+ *
+ * @param string|int|array $tag Optional. The term name/term_id/slug or array of them to check for.
  * @param int|post object Optional.  Post to check instead of the current post. @since 2.7.0
  * @return bool True if the current post has any of the the given tags (or any tag, if no tag specified).
  */
-function has_tag( $tag = '', $_post = null ) {
-        if ( $_post ) {
-                $_post = get_post( $_post );
-        } else {
-                $_post =& $GLOBALS['post'];
-        }
+function has_term( $term = '', $taxonomy = '', $post = null ) {
+        if ( $post )
+                $post = get_post( $post );
+        else
+                $post =& $GLOBALS['post'];
 
-        if ( !$_post )
+        if ( !$post )
                 return false;
 
-        $r = is_object_in_term( $_post->ID, 'post_tag', $tag );
+        $r = is_object_in_term( $post->ID, $taxonomy, $term );
         if ( is_wp_error( $r ) )
                 return false;
         return $r;
 }
-
 ?>
- No newline at end of file