in_category()
in_category( int|string|array $category, int|object $po…
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)
测试环路外的电流桩
在回路中测试当前桩
类别:WordPress 函数手册、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。

还没有任何评论,赶紧来占个楼吧!