get_category_parents

（1.2.0以降）
get_category_parents - 親カテゴリー名を含んだカテゴリー名を取得する

説明

mixed get_category_parents( int $id [ , bool $link = false [ , string $separator = '/' [ , bool $nicename = false [ , array $deprecated ~~$visited~~ = array() ] ] ] ] )

親カテゴリー名を含んだカテゴリー名を取得する。

パラメータ

$id
カテゴリーID。
$link
カテゴリー名をリンクで取得する場合はtrue、名前のみの場合はfalseを指定（省略時はfalse）。
$separator
区切り文字（省略時は'/'）。
$nicename
カテゴリーのスラッグを取得する場合はtrue、カテゴリー名を取得する場合はfalse（省略時はfalse）。
$deprecated ~~$visited~~
[4.8.0]廃止~~閲覧済みのカテゴリーIDの配列~~（省略時はarray()）。

返り値

親カテゴリー名を含んだカテゴリー名を返す。ただし、パラメータ$idが無効なカテゴリーIDの場合は、 WP_Errorのオブジェクトを返す。

注意

パラメータ$idで指定したカテゴリーの名前について、親カテゴリーの名前と連結してものを返す。各カテゴリーの名前の後にはそれぞれ区切り文字が連結される（パラメータ$idで指定したカテゴリーの名前にも区切り文字が連結される）。

[4.8.0]第5パラメータが廃止となった。カテゴリーIDが格納された配列が指定された場合は内部で空の配列に変更されるため、これまでと異なる結果となる。

使用例

カテゴリーIDが7のカテゴリー名を取得する。
<?php $cat = get_category_parents( 7 ); ?>
$catの内容:（親子関係のあるカテゴリーが、それぞれ親（IDが3、スラッグがparent）、子（IDが5、スラッグがchild）、孫（IDが7、スラッグがgrandchild）の場合）
親/子/孫/
カテゴリーIDが7のカテゴリー名（スラッグ）を取得する。
<?php $cat = get_category_parents( 7, false, '/', true ); ?>
$catの内容:
parent/child/grandchild/
カテゴリーIDが7のカテゴリー名（リンク付き）を区切り文字>で取得する。
<?php $cat = get_category_parents( 7, true, ' > ' ); ?>
$catの内容:（ドメインがlocalhostの場合）
<a href="http://localhost/?cat=3" title="親の投稿をすべて表示">親</a> > <a href="http://localhost/?cat=5" title="子の投稿をすべて表示">子</a> > <a href="http://localhost/?cat=7" title="孫の投稿をすべて表示">孫</a> >