ワードプレスのis_tag関数の使用方法・解説

概要

is_tag関数は、WordPressにおいて現在のリクエストがタグアーカイブページであるかを調べる際に使用される関数です。この関数は、特定のタグに関連する投稿を表示するページで使用されます。以下は、この関数がよく使われる機能の例です：

1. タグの投稿リストを表示する。
2. タグページ用のカスタムテンプレートを作成する。
3. タグに基づいたフィルタリング機能を実装する。
4. SEO対策としてのメタデータ設定を行う。
5. ウィジェットやサイドバーにタグ情報を表示する。
6. タグページに特別なスタイルを適用する。
7. タグにリンクするためのナビゲーションを作成する。
8. トップページや他のページからのナビゲーションを改善する。

構文

is_tag( $tag = '' );

パラメータ

• $tag (オプション): 調べたいタグのスラッグまたはID。指定しない場合、現在のリクエストのタグが使用されます。

戻り値

• true: 現在のクエリがタグアーカイブページである場合。
• false: それ以外の場合。

関連する関数

• is_single
• is_category
• is_archive
• is_tax

使用可能なバージョン

• WordPress 1.5以降で使用可能。

コアファイルのパス

• wp-includes/query.php

サンプルコード

サンプル1：タグ名を取得して表示

このサンプルコードは、現在のタグアーカイブページのタグ名を取得して表示します。

if ( is_tag() ) {
    $tag = get_queried_object();
    echo '現在のタグ: ' . esc_html( $tag->name );
}

（出典元: https://developer.wordpress.org/reference/functions/get_queried_object/）

サンプル2：カスタムメッセージの表示

このコードは、タグアーカイブページに特定のメッセージを表示します。

if ( is_tag( 'example-tag' ) ) {
    echo 'このタグに関連する投稿を表示しています。';
}

（出典元: https://developer.wordpress.org/reference/functions/is_tag/）

サンプル3：タグに基づいたスタイルの適用

このサンプルは、特定のタグページで異なるスタイルシートを読み込む方法を示しています。

if ( is_tag( 'special-tag' ) ) {
    wp_enqueue_style( 'special-tag-style', get_stylesheet_directory_uri() . '/css/special-tag.css' );
}

（出典元: https://developer.wordpress.org/reference/functions/wp_enqueue_style/）

サンプル4：タグフィルタリング機能

このサンプルは、特定のタグが選択されている場合の投稿ループの例です。

if ( is_tag() ) {
    $query = new WP_Query( array( 'tag' => get_query_var( 'tag' ) ) );
    while ( $query->have_posts() ) {
        $query->the_post();
        the_title();
    }
    wp_reset_postdata();
}

（出典元: https://developer.wordpress.org/reference/classes/wp_query/）

サンプル5：タグページでのナビゲーションリンク

このサンプルは、タグページでナビゲーションリンクを表示する方法です。

if ( is_tag() ) {
    $tag = get_queried_object();
    echo '<a href="' . esc_url( get_tag_link( $tag->term_id ) ) . '">このタグの投稿一覧へ</a>';
}

（出典元: https://developer.wordpress.org/reference/functions/get_tag_link/）

この関数のアクションでの使用可能性

アクション名	使用可能性
mu_plugin_loaded
registered_post_type
plugins_loaded
wp_roles_init
setup_theme
after_setup_theme
set_current_user
init	〇
register_sidebar
wp_loaded
send_headers
parse_query	〇
pre_get_posts	〇
wp	〇
template_redirect
get_header
wp_head

この関数は、特定のバージョンで非推奨または削除されていません。