in_category() – Checks if the current post is within any of the given categories.
You appear to be a bot. Output may be restricted
Description
Checks if the current post is within any of the given categories.
The given categories are checked against the post's categories' term_ids, names and slugs. Categories given as integers will only be checked against the post's categories' term_ids. Prior to v2.5 of WordPress, category names were not supported. Prior to v2.7, category slugs were not supported. Prior to v2.7, only one category could be compared: in_category( $single_category ). 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. For more information on this and similar theme functions, check out the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ Conditional Tags} article in the Theme Developer Handbook.
Usage
$bool = in_category( $category, $post );
Parameters
- $category
- ( int|string|int[]|string[] ) required – Category ID, name, slug, or array of such to check against.
- $post
- ( int|WP_Post ) optional – Optional. Post to check. Defaults to the current post.
Returns
bool True if the current post is in any of the given categories.
Source
File name: wordpress/wp-includes/category-template.php
Lines:
function in_category( $category, $post = null ) { if ( empty( $category ) ) { return false; } return has_category( $category, $post ); }