/
投稿に紐づいたタクソノミーのタームを一覧(配列)で取得して「リンク と HTMLタグ( 又はセパレータ ) 付き」で出力。
投稿ページで、リンク付きターム一覧をサクッと表示できるWordpressテンプレートタグです。。(ループ内のみ利用可能)
出力は「投稿ID(必須), タクソノミー(必須), 最初, セパレータ, 最後」以外固定。
パラメータ以外の出力は固定となる為、要素を個別に設定したい場合は get_the_terms() など他のテンプレートタグをお勧めします。
the_terms()
taxonomyを指定 することで、カテゴリー、タグ、カスタムタクソノミーの一覧を出力することができます。
呼び出しコード | パラメータ |
---|---|
<?php the_terms(get_the_ID(), | 投稿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>