has_tag()
has_tag( string|int|array $tag = ”, int|object $post = …
has_tag( string|int|array $tag = ”, int|object $post = null )
检查当前文章是否有任何给定的标记。
Checks if the current post has any of given tags.
目录锚点:#说明#参数#返回#源码#笔记
说明(Description)
给定的标签会根据帖子标签的术语、名称和段塞进行检查。以整数形式给出的标记只会与post标记的term_id进行比较。如果没有给出标记,则确定post是否有任何标记。
在WordPress的v2.7之前,以整数形式给出的标签也会与v2.7之前的post标签的名称和slug(除了term_id)进行核对,这个功能只能在WordPress循环中使用。从2.7开始,如果提供post ID或post对象,则该函数可以在任何地方使用。
有关此主题函数和类似主题函数的更多信息,请参阅主题开发人员手册中的条件标记文章。
参数(Parameters)
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
$tag | (string | int | array) | 可选 | 要检查的标记名/术语/id/slug或它们的数组。 |
$post | (int | object) | 可选 | 发布以检查而不是当前发布。(从2.7.0开始) |
返回(Return)
(bool)如果当前文章具有任何给定的标记(或任何标记,如果未指定标记),则为True。
源码(Source)
/** * Check if the current post has any of given tags. * * The given tags are checked against the post's tags' term_ids, names and slugs. * Tags given as integers will only be checked against the post's tags' term_ids. * If no tags are given, determines if post has any tags. * * Prior to v2.7 of WordPress, tags given as integers would also be checked against the post's tags' names and slugs (in addition to term_ids) * 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 2.6.0 * * @param string|int|array $tag Optional. The tag name/term_id/slug or array of them to check for. * @param int|object $post Optional. Post to check instead of the current post. (since 2.7.0) * @return bool True if the current post has any of the given tags (or any tag, if no tag specified). */ function has_tag( $tag = '', $post = null ) { return has_term( $tag, 'post_tag', $post ); }
更新版本 | 源码位置 | 使用 | 被使用 |
---|---|---|---|
2.6.0 | wp-includes/category-template.php:1449 | 0 | 1 function |
笔记(Notes)
如果文章有标签,请出示。否则什么也不做。它在循环中工作。
如果Post有标签,就给他们看。否则,如果Post有category,则显示category。否则就做其他。
类别:WordPress 函数手册、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!