1. 首页
  2. WordPress 函数手册

in_category()

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

检查当前职位是否在任何给定类别内。
Checks if the current post is within any of the given categories.

目录锚点:#说明#参数#返回#源码#笔记


说明(Description)

给定的分类将与文章的分类词、名称和段塞进行比较。以整数形式给出的类别将仅与文章类别的术语ID进行核对。

在WordPress的v2.5之前,不支持类别名称。在v2.7之前,不支持类别slug。在v2.7之前,只能比较一个类别:in_类别($single_类别)。在v2.7之前,此函数只能在WordPress循环中使用。从2.7开始,如果提供post ID或post对象,则该函数可以在任何地方使用。

有关此主题函数和类似主题函数的更多信息,请参阅主题开发人员手册中的条件标记文章。


参数(Parameters)

参数 类型 必填 说明
$category (int | string | array) 必需 类别ID,名称或slug,或said的数组。
$post (int | object) 可选 发布以检查而不是当前发布。(从2.7.0开始)

返回(Return)

(bool)如果当前职位属于任何给定类别,则为True。


源码(Source)

/**
 * Check if the current post in 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.
 *
 * @since 1.2.0
 *
 * @param int|string|array $category Category ID, name or slug, or array of said.
 * @param int|object $post Optional. Post to check instead of the current post. (since 2.7.0)
 * @return bool True if the current post is in any of the given categories.
 */
function in_category( $category, $post = null ) {
	if ( empty( $category ) )
		return false;

	return has_category( $category, $post );
}
更新版本 源码位置 使用 被使用
1.2.0 wp-includes/category-template.php:245 0 1 function

笔记(Notes)

测试环路外的电流桩
在回路中测试当前桩

in_category() 为WP2原创文章,链接:https://www.wp2.cn/functions/in_category/

发表评论

您的电子邮箱地址不会被公开。