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 删除。
还没有任何评论,赶紧来占个楼吧!