in_category() — описание функции WordPress на русском

Сигнатура

in_category( int|string|int[]|string[] $category, int|null|WP_Post $post = null ): bool

Описание

Указанные рубрики сверяются с term_ids, именами и слагами рубрик записи.
Рубрики, заданные целыми числами, сверяются только с term_ids рубрик записи.
До версии WordPress 2.5 имена рубрик не поддерживались.
До версии 2.7 не поддерживались слаги рубрик.
До версии 2.7 можно было сравнивать только одну рубрику: in_category( $single_category ).
До версии 2.7 эту функцию можно было использовать только внутри цикла WordPress.
Начиная с версии 2.7 функцию можно использовать где угодно, если передать ей ID или объект записи.
Подробнее об этой и подобных функциях темы см. в статье Conditional Tags в справочнике разработчика тем.

Оригинал (английский)

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.

Параметры

$category int|string|int[]|string[] обязательный

ID рубрики, название, слаг или их массив для проверки.

$post int|null|WP_Post необязательный = null

Запись для проверки. По умолчанию используется текущая запись.

Возвращаемое значение

bool

Исходный код

wp-includes/category-template.php:257

function in_category( $category, $post = null ) {
	if ( empty( $category ) ) {
		return false;
	}

	return has_category( $category, $post );
}

История изменений

Версия	Описание
2.7.0	The $post parameter was added.
1.2.0	Introduced.