1. 首页
  2. WordPress 函数手册

has_tag()

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。否则就做其他。

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

发表评论

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