the_terms()


関数the_terms()は、指定された投稿に関連付けられたターム（カテゴリーやタグなど）を表示するために使用されるWordPressの関数です。

構文

the_terms( int $post_id, string $taxonomy, string $before = '', string $sep = '', string $after = '' );

引数の説明:

  • $post_id(int) — タームを取得する投稿のID。
  • $taxonomy(string) — タームを取得するタクソノミー（例: ‘category’, ‘post_tag’）。
  • $before(string) — タームリストの前に表示するテキスト。
  • $sep(string) — ターム間の区切り文字。
  • $after(string) — タームリストの後に表示するテキスト。

例1: カテゴリーを表示する

投稿に関連付けられたカテゴリーを表示します。

<?php the_terms( get_the_ID(), 'category', 'カテゴリー: ', ', ', '' ); ?>

例2: タグを表示する

投稿に関連付けられたタグを表示します。

<?php the_terms( get_the_ID(), 'post_tag', 'タグ: ', ' | ', '' ); ?>

例3: カスタムタクソノミーのタームを表示する

カスタムタクソノミー「genre」のタームを表示します。

<?php the_terms( get_the_ID(), 'genre', 'ジャンル: ', ' / ', '' ); ?>

例4: 区切り文字を変更する

ターム間の区切り文字をカスタマイズします。

<?php the_terms( get_the_ID(), 'category', 'カテゴリー: ', ' &gt; ', '' ); ?>

例5: タームリストを囲むHTMLタグを追加する

タームリストを<div>タグで囲みます。

<?php the_terms( get_the_ID(), 'category', '&lt;div&gt;カテゴリー: ', ', ', '&lt;/div&gt;' ); ?>

例6: タームが存在しない場合の処理

タームが存在しない場合にメッセージを表示します。

<?php if ( ! the_terms( get_the_ID(), 'category', 'カテゴリー: ', ', ', '' ) ) { echo 'カテゴリーはありません。'; } ?>

注意点

  • タームが存在しない場合、the_terms()は何も出力しません。
  • タームを取得する際に、適切なタクソノミーを指定することが重要です。

関連機能：