in_category( int|string|array $category, int|object $post = null )

Check if the current post is within any of the given categories.


25 related functions found for: in_category

Top ↑

Related terms found for this post

TaxonomyTerms
wp-parser-related-wordscategori, categories, category, category-template-php, taxonomi, taxonomy, wp-includes
wp-parser-packageTemplate, WordPress
wp-parser-source-filewp-includes/category-template.php

Top ↑

Terms Used Terms Used

Terms used in the related posts query

  • categori
  • categories
  • category
  • category-template-php
  • taxonomi
  • taxonomy
  • Template
  • wp-includes
  • wp-includes/category-template.php
  • template

Top ↑

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.


Top ↑

Parameters Parameters

$category

(int|string|array) (Required) Category ID, name or slug, or array of said.

$post

(int|object) (Optional) Post to check instead of the current post. (since 2.7.0)

Default value: null


Top ↑

Return Return

(bool) True if the current post is in any of the given categories.


Top ↑

Source Source

File: wp-includes/category-template.php


			

Top ↑

Changelog Changelog

Changelog
Version Description
1.2.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.