in_category

函数
in_category ( $category, $post = null )
参数
  • (int|string|int[]|string[]) $category Category ID, name, slug, or array of such to check against.
    Required:
  • (int|WP_Post) $post Optional. Post to check. Defaults to the current post.
    Required:
    Default: null
返回值
  • (bool) True if the current post is in any of the given categories.
定义位置
相关方法
is_categoryget_categoryhas_categorythe_categorywp_insert_category
引入
1.2.0
弃用
-

in_category: 这是一个条件函数,检查当前文章是否在一个或多个指定的类别中。如果文章是在任何一个指定的类别中,它将返回true,否则返回false。

检查当前文章是否在任何给定的类别内。

给出的类别会根据文章的类别的 term_ids、名称和 slugs 进行检查。以整数形式给出的类别将只与文章的类别的 term_ids 进行检查。

在WordPress的v2.5版本之前,不支持类别名称。
在v2.7版之前,不支持分类的词组。
在v2.7版之前,只有一个类别可以被比较:in_category( $single_category )。
在v2.7版之前,这个函数只能在WordPress循环中使用。
从2.7版开始,如果提供一个文章ID或文章对象,该函数可以在任何地方使用。

关于这个和类似的主题函数的更多信息,请查看《主题开发者手册》中的{@link Conditional Tags}文章。

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

	return has_category( $category, $post );
}

常见问题

FAQs
查看更多 >