tag_exists()


WordPressの関数tag_exists()は、指定されたタグが存在するかを確認するために使用されます。この関数を使用することで、特定のタグが存在するかどうかを条件として操作を行うことができます。

構文

tag_exists( string $tag );
  • $tag (string) — 存在を確認したいタグ名またはタグID。

例1: タグの存在を確認する

指定したタグが存在するかを確認し、結果を表示します。

<?php
if ( tag_exists( 'news' ) ) {
    echo 'タグ "news" は存在します。';
} else {
    echo 'タグ "news" は存在しません。';
}
?>

例2: タグが存在する場合に投稿を取得する

タグが存在する場合、そのタグを持つ投稿を取得します。

<?php
if ( tag_exists( 'news' ) ) {
    $query = new WP_Query( array( 'tag' => 'news' ) );
    while ( $query->have_posts() ) {
        $query->the_post();
        the_title();
    }
    wp_reset_postdata();
}
?>

例3: タグが存在しない場合に新しいタグを作成する

指定したタグが存在しない場合に新しいタグを作成します。

<?php
if ( ! tag_exists( 'new-tag' ) ) {
    wp_insert_term( 'new-tag', 'post_tag' );
    echo '新しいタグ "new-tag" を作成しました。';
}
?>

例4: タグが存在するかで特定のテンプレートを読み込む

タグの存在を条件にテンプレートを動的に読み込みます。

<?php
if ( tag_exists( 'special' ) ) {
    get_template_part( 'template-special' );
} else {
    get_template_part( 'template-default' );
}
?>

例5: タグ存在チェックとカスタムメッセージの表示

タグが存在するかに応じて異なるメッセージを表示します。

<?php
$tag_name = 'event';
if ( tag_exists( $tag_name ) ) {
    echo 'タグ "' . $tag_name . '" は既に存在します。';
} else {
    echo 'タグ "' . $tag_name . '" は存在しません。';
}
?>

注意点

  • この関数は主に投稿タグ（post_tag）に使用されます。

関連機能：