get_the_tags() の説明と使用例

WordPressのget_the_tags()関数は、現在の投稿に紐づけられたタグを取得するために使用されます。この関数は、タグのオブジェクトの配列を返します。

構文

get_the_tags( int $post_id );

$post_id (int) — タグを取得したい投稿のID。省略した場合、現在の投稿のIDが使用されます。

例1: 現在の投稿のタグを取得する

この例では、現在の投稿に紐づけられたタグを取得し、その名前を表示します。

<?php $tags = get_the_tags(); if ($tags) { foreach ($tags as $tag) { echo $tag->name . ' '; } } ?>

例2: 特定の投稿のタグを取得する

この例では、指定した投稿IDのタグを取得し、その名前を表示します。

<?php $tags = get_the_tags(get_the_ID()); if ($tags) { foreach ($tags as $tag) { echo $tag->name . ' '; } } ?>

例3: タグのリンクを表示する

この例では、タグの名前とそのアーカイブページへのリンクを表示します。

<?php $tags = get_the_tags(); if ($tags) { foreach ($tags as $tag) { echo '<a href="' . get_tag_link($tag->term_id) . '">' . $tag->name . '</a> '; } } ?>

例4: タグの数を表示する

この例では、現在の投稿に紐づけられたタグの数を表示します。

<?php $tags = get_the_tags(); if ($tags) { echo count($tags); } ?>

例5: タグの説明を表示する

この例では、タグの説明を表示します。

<?php $tags = get_the_tags(); if ($tags) { foreach ($tags as $tag) { echo $tag->description; } } ?>

例6: タグのスラッグを表示する

この例では、タグのスラッグを表示します。

<?php $tags = get_the_tags(); if ($tags) { foreach ($tags as $tag) { echo $tag->slug . ' '; } } ?>

例7: タグのIDを表示する

この例では、タグのIDを表示します。

<?php $tags = get_the_tags(); if ($tags) { foreach ($tags as $tag) { echo $tag->term_id . ' '; } } ?>

例8: タグのカスタムフィールドを表示する

この例では、タグのカスタムフィールドを表示します。

<?php $tags = get_the_tags(); if ($tags) { foreach ($tags as $tag) { echo get_term_meta($tag->term_id, 'custom_field_key', true); } } ?>

注意点

get_the_tags()は、投稿にタグが紐づけられていない場合、falseを返します。
タグの情報を取得する前に、the_post()やsetup_postdata()を使用して、グローバルな投稿オブジェクトを設定する必要があります。

構文