has_category() WordPress Function

The has_category() function is a boolean function that returns true if the current post has the specified category, or false otherwise.

has_category( string|int|array $category = '', int|object $post = null ) #

Checks if the current post has any of given category.


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.

If no categories are given, determines if post has any categories.


Top ↑

Parameters

$category

(string|int|array)(Optional) The category name/term_id/slug, or an array of them to check for.

Default value: ''

$post

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

Default value: null


Top ↑

Return

(bool) True if the current post has any of the given categories (or any category, if no category specified). False otherwise.


Top ↑

Source

File: wp-includes/category-template.php

function has_category( $category = '', $post = null ) {
	return has_term( $category, 'category', $post );
}


Top ↑

Changelog

Changelog
VersionDescription
3.1.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.