Mill's Note

【Wordpress関数】get_category_parents()

/

自分を含めた親(先祖)のカテゴリー一覧を「リンク と セパレータ 付き」で取得する、カテゴリー一覧用のWordpressテンプレートタグ。

パラメータでの条件設定を上手く使う事で、簡単に自身(指定ID) + 親要素のリンク付きカテゴリー一覧を作成できます。

使い道は少ないかも? ですが、自作でパンくずリストを作る際などに重宝します^^

get_category_parents() 呼び出しコード

呼び出しコード説明
<?php get_category_parents(カテゴリID); ?>自身のID(必須)
<?php get_category_parents(カテゴリID,リンク,セパレータ,取得値); ?>リンク,セパレータ,取得値
※パラメータ参照

パラメータ

パラメータ初期値選択肢 / 説明
ID''指定必須
リンクfalse未指定可 true(リンクあり) /false(リンクなし)
セパレータ/'未指定可 任意のセパレータを指定
取得値false未指定可 true(カテゴリ名をスラッグで取得) /false(カテゴリ名で取得)

get_category_parents() の使用例

リンク付きのリストタイプで出力する

wp_list_categories() は最後にもセパレータが入ります。
そこは調節する必要がありますが、結構簡単にリストも作れます。

get_queried_object_id() でページIDを取得。後はカテゴリページの分岐を入れればそのまま使えます^^

PHP
<ul>
<?php 
  $list = get_category_parents(get_queried_object_id(),true,'</li><li>');
  $list = rtrim($list , '</li><li>'); //最後の出力タグを削除
  echo '<li>' . $list . '</li>';
?>
</ul>

/* 出力結果 */
<ul>
  <li><a href="祖先カテゴリーURL">祖先カテゴリー名</a></li>
  <li><a href="親カテゴリーURL">親カテゴリー名</a></li>
  <li><a href="現在のカテゴリーURL">現在のカテゴリー名</a></li>
</ul>