the_taxonomies()


関数the_taxonomies()は、WordPressで投稿に関連付けられたタクソノミー（カテゴリーやタグなど）を表示するために使用されます。この関数は、投稿に紐づくタクソノミーをリスト形式で出力します。

構文

the_taxonomies( array|string $args = array() );

引数の説明:

  • $args(array|string) — タクソノミー表示の設定を指定するための引数。デフォルトは空の配列。
  • template(string) — タクソノミー表示のテンプレート。デフォルトは%s: %l.。
  • term_template(string) — 各ターム表示のテンプレート。デフォルトは%s。
  • before(string) — タクソノミーリストの前に表示するテキスト。
  • after(string) — タクソノミーリストの後に表示するテキスト。
  • sep(string) — タクソノミー間の区切り文字。デフォルトは, 。

例1: 基本的なタクソノミー表示

投稿に関連付けられたタクソノミーをデフォルト設定で表示します。

<?php the_taxonomies(); ?>

例2: カスタムテンプレートを使用した表示

タクソノミー表示のテンプレートをカスタマイズします。

<?php the_taxonomies( array( 'template' => '分類: %l' ) ); ?>

例3: タームテンプレートの変更

各タームの表示形式を変更します。

<?php the_taxonomies( array( 'term_template' => '<span class="term">%s</span>' ) ); ?>

例4: 区切り文字の変更

タクソノミー間の区切り文字を変更します。

<?php the_taxonomies( array( 'sep' => ' | ' ) ); ?>

例5: 前後にテキストを追加

タクソノミーリストの前後にテキストを追加します。

<?php the_taxonomies( array( 'before' => 'タクソノミー: ', 'after' => '.' ) ); ?>

例6: 特定のタクソノミーのみ表示

特定のタクソノミーのみを表示します。

<?php the_taxonomies( array( 'taxonomy' => 'category' ) ); ?>

注意点

  • この関数は、投稿のループ内で使用することを想定しています。ループ外で使用する場合は、投稿IDを指定する必要があります。
  • カスタムタクソノミーを使用している場合、適切に登録されていることを確認してください。

関連機能：