the_terms()でカスタムタクソノミーを表示する方法【WordPress】

the_terms()でタクソノミーをテーマに出力する
the_terms()の基本の書き方
実装パターン別コード
躓きやすいポイント
まとめ

the_terms()でタクソノミーをテーマに出力する

WordPressでカスタムタクソノミーを作ったはいいけど、「テーマ側でどうやって表示すればいいの？」と悩んだことはありませんか？

カテゴリーならthe_category()、タグならthe_tags()という専用関数がありますが、カスタムタクソノミーにはそれがありません。そこで使うのがthe_terms()です。この記事ではthe_terms()の基本の使い方から、リンクなしで出力する方法まで実装コード付きで紹介します。

カスタムタクソノミーをfunctions.phpで登録する方法【WordPress】

こんにちは！コーダーのゆうしです。WordPressのカスタム投稿タイプを使っていると「カテゴリーとは別に独自の分類を追…

↑タクソノミーを登録する方法はこちら

the_terms()の基本の書き方

<?php the_terms( get_the_ID(), 'タクソノミー名', '前に付くテキスト', '区切り文字', '後に付くテキスト' ); ?>

各パラメータの解説

引数	内容
第1引数	投稿ID（`get_the_ID()`でOK）
第2引数	表示したいタクソノミーのスラッグ
第3引数	出力の前に付けるテキスト（省略可）
第4引数	タームとタームの区切り文字（デフォルトは`,` ）
第5引数	出力の後に付けるテキスト（省略可）

実装パターン別コード

① シンプルに出力する

<?php the_terms( get_the_ID(), 'dammy' ); ?>

dammyの部分は自分で登録したタクソノミーのスラッグに変えてください。タームがリンク付きで出力されます。

② 区切り文字を変える

<?php the_terms( get_the_ID(), 'dammy', '', ' / ' ); ?>

第4引数で区切り文字を指定できます。/や・など、デザインに合わせて変えましょう。

③ 前後にテキストを付ける

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

出力例：ジャンル：アクション / RPG

ラベルを付けたいときは第3引数を使います。

④ リンクなしで名前だけ出力したい場合

the_terms()はリンク付きで出力されますが、リンクなしで名前だけ取得したい場合はget_the_terms()を使います。

<?php
$terms = get_the_terms( get_the_ID(), 'dammy' );
if ( $terms && ! is_wp_error( $terms ) ) {
    foreach ( $terms as $term ) {
        echo '<span class="genre-label">' . esc_html( $term->name ) . '</span>';
    }
}
?>