• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

関数リファレンス/has tag

提供: WordPress Codex 日本語版
移動先: 案内検索

現在の投稿が指定されたタグを持っているかチェックします。

指定されたタグは、投稿に付けられたタグの ID、名前、スラッグに合うかチェックされます。 整数で指定されたタグは、投稿のタグの ID のみと比較されます。

タグが指定されない場合は、投稿が任意のタグを持つかチェックします。

参考:この関数は下記の関数呼び出しに置き換えられます:

has_term( $tag, 'post_tag', $post )

そのため、あるカスタム投稿タイプの投稿が指定されたタグ(カスタム投稿タグ)を持つかチェックするには、次のように呼び出す必要があります:

has_term( $tag, 'mycpt_tag', $post )

使い方

<?php has_tag( $tag, $post ); ?>

パラメータ

$tag
mixed) (オプション) タグの名前、ID またはスラッグ。またはそれらの配列。
初期値: なし
$post
オブジェクト) (オプション) 現在の投稿の代わりにチェックする投稿。
初期値: 現在の投稿

戻り値

(真偽値) 
指定されたタグの何れかを(タグが指定されなかった場合は、任意のタグを)投稿が持っていれば true を、持っていなければ false を返す。

変更履歴

バージョン 2.6.0 にて導入されました。

ソースファイル

has_tag()wp-includes/category-template.php にあります。

has_term(), has_category()

条件分岐タグis_404(), is_admin(), is_admin_bar_showing(), is_archive(), is_attachment(), is_author(), is_category(), is_comments_popup(), is_date(), is_day(), is_feed(), is_front_page(), is_home(), is_local_attachment(), is_main_query, /is_multi_author, is_month(), is_new_day(), is_page(), is_page_template(), is_paged(), is_plugin_active(), is_plugin_active_for_network() /en, is_plugin_inactive() /en, is_plugin_page() /en, is_post_type_archive(), is_preview() /en, is_search(), is_single(), is_singular(), is_sticky(), is_tag(), is_tax(), is_taxonomy_hierarchical(), is_time(), is_trackback(), is_year(), in_category(), in_the_loop(), is_active_sidebar(), is_active_widget(), is_blog_installed() /en, is_rtl(), is_dynamic_sidebar(), is_user_logged_in(), has_excerpt(), has_post_thumbnail(), has_tag(), pings_open(), email_exists(), post_type_exists(), taxonomy_exists(), term_exists(), username_exists() /en, wp_attachment_is_image(), wp_script_is()


関数リファレンステンプレートタグ目次もご覧ください。


最新英語版: WordPress Codex » Function Reference/has_tag最新版との差分