Mill's Note

【Wordpress関数】the_terms()

/

投稿に紐づいたタクソノミーのタームを一覧(配列)で取得して「リンク と HTMLタグ( 又はセパレータ ) 付き」で出力。
投稿ページで、リンク付きターム一覧をサクッと表示できるWordpressテンプレートタグです。。(ループ内のみ利用可能)

出力は「投稿ID(必須), タクソノミー(必須), 最初, セパレータ, 最後」以外固定。
パラメータ以外の出力は固定となる為、要素を個別に設定したい場合は get_the_terms() など他のテンプレートタグをお勧めします。

the_terms()

taxonomyを指定 することで、カテゴリー、タグ、カスタムタクソノミーの一覧を出力することができます。

呼び出しコードパラメータ
<?php the_terms(get_the_ID(),'taxonomy'); ?>投稿ID(必須), タクソノミー(必須)
<?php the_terms(get_the_ID(),'taxonomy','before','sep','after'); ?>投稿ID(必須), タクソノミー(必須), 最初の文字列, セパレータ, 最後の文字列

the_terms() の使用例

パラメータ「投稿ID、タクソノミー」のみ指定

「, 」区切りで出力されます

カスタムタクソノミー ( taxonomy = taxonomyスラッグ )

PHP
<?php the_terms(get_the_ID(),'taxonomyスラッグ'); ?> 
/* 出力結果 */
<a href="ターム1URL">ターム1名</a>, <a href="ターム2URL">ターム2名</a>, <a href="ターム3URL">ターム3名</a>・・・

カテゴリー ( taxonomy = category )

PHP
<?php the_terms(get_the_ID(),'category'); ?> 
/* 出力結果 */
<a href="カテゴリ1URL">カテゴリ1名</a>, <a href="カテゴリ2URL">カテゴリ2名</a>, <a href="カテゴリ3URL">カテゴリ3名</a>・・・

タグ ( taxonomy = post_tag )

PHP
<?php the_terms(get_the_ID(),'post_tag'); ?> 
/* 出力結果 */
<a href="タグ1URL">タグ1名</a>, <a href="タグ2URL">タグ2名</a>, <a href="タグ3URL">タグ3名</a>・・・

<ul><li> で囲む

特定のタグで囲みたい場合は、「最初に開始タグ」「最後に閉じタグ」で囲み、セパレータに途中になるタグを入れます。
class なども設定可能です。

PHP
<?php 
the_terms(get_the_ID(),'taxonomy','<ul><li>','</li><li>','</li></ul>');
?>
/* 出力結果 */
<ul>
<li><a href="ターム1URL">ターム1名</a></li><li><a href="ターム2URL">ターム2名</a></li>・・・
</ul>