13 views 
Summery Summery
Checks if the current post is within any of the given categories.
Syntax Syntax
Description Description
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 Conditional Tags article in the Theme Developer Handbook.
Parameters Parameters
- $category
-
(Required) Category ID, name or slug, or array of said.
- $post
-
(Optional) Post to check instead of the current post. (since 2.7.0)
Default value: null
Return Return
(bool) True if the current post is in any of the given categories.
Source Source
File: wp-includes/category-template.php
* the {@link https://developer.wordpress.org/themes/basics/conditional-tags/
* Conditional Tags} article in the Theme Developer Handbook.
*
* @since 1.2.0
* @since 2.7.0 The `$post` parameter was added.
*
* @param int|string|array $category Category ID, name or slug, or array of said.
Advertisement
Changelog Changelog
| Version | Description |
|---|---|
| 1.2.0 | Introduced. |