web関連

【wordpress】カテゴリーやタームの「説明」を出力する方法

【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うるさいお客さんの時覚えておくと便利かも