web関連
【wordpress】カテゴリーやタームの「説明」を出力する方法
カテゴリー・ターム一覧のディスクリプションを変更したいという案件があり、管理画面のカテゴリー・ターム編集ページに「この説明はデフォルトではあまり重要な意味を持ちませんが、これを表示するテーマも中にはあります。」と書いてある「説明」エリアがあったのでせっかくだし使おうと思ったときの備忘録
カテゴリー・タームの「説明」取得
出力方法
<?php echo category_description(); ?>
これで「説明」が設定されていればカテゴリー・ターム一覧ページに出力できる。
その他の使い方
<?php
// カテゴリー・タームの「説明」を表示
echo category_description();
// 指定したカテゴリーidの「説明」を表示
echo category_description('1');
// スラッグで指定したカテゴリーの「説明」を表示
echo category_description( get_category_by_slug('topics')->term_id );
?>
「投稿」のカテゴリーであればidとslugを指定すればどのページでも「説明」を表示できるっぽい
ターム一覧以外でタームの「説明」を使う方法
固定ページとかにタームの「説明」引っ張るときに使える
<?php echo term_description( $term_id, $taxonomy ) ?>
$term_id…タームのid
$taxonomy…タクソノミースラッグ
例
カスタム投稿「商品(product)」のタクソノミー(products)のターム(id:6,slug:milk)の「説明」を取得する例
// × スラッグ指定できない
<?php echo term_description( 'milk', 'products' ); ?>
// ○ id指定はできる
<?php echo term_description( '6', 'products' ); ?>
あんま需要ないと思うけど、seoうるさいお客さんの時覚えておくと便利かも