get_category_parents()


WordPress関数get_category_parents()は、指定したカテゴリーの親カテゴリーを取得し、それらを文字列として返します。この関数を使用すると、カテゴリー階層を表示したり、パンくずリストを作成したりする際に役立ちます。

構文

get_category_parents( int|object $category, bool $link = false, string $separator = '/', bool $nicename = false, array $visited = array() );

引数の説明

  • $category (int|object) — カテゴリーのIDまたはオブジェクト。
  • $link (bool) — trueの場合、カテゴリー名にリンクを付ける。デフォルトはfalse。
  • $separator (string) — カテゴリー名を区切る文字列。デフォルトはスラッシュ（/）。
  • $nicename (bool) — trueの場合、スラッグを返す。デフォルトはfalse。
  • $visited (array) — 再帰処理時に使用される内部パラメータ。通常は指定不要。

使用例

例1: 親カテゴリー名の取得

カテゴリーIDを指定して親カテゴリーを取得します。

<?php echo get_category_parents( get_queried_object_id(), false ); ?>

例2: 親カテゴリーをリンク付きで取得

親カテゴリー名にリンクを追加して取得します。

<?php echo get_category_parents( get_queried_object_id(), true ); ?>

例3: スラッグを取得

親カテゴリーのスラッグを取得します。

<?php echo get_category_parents( get_queried_object_id(), false, '/', true ); ?>

例4: カスタム区切り文字を使用

親カテゴリー名をカスタム区切り文字で連結します。

<?php echo get_category_parents( get_queried_object_id(), false, ' > ' ); ?>

例5: パンくずリストの生成

親カテゴリーをパンくずリストとして出力します。

<?php 
if ( is_category() ) {
    echo get_category_parents( get_queried_object_id(), true, ' » ' );
}
?>

注意事項

  • この関数は指定されたカテゴリーが存在しない場合、falseを返します。
  • 適切なデータ型（IDまたはオブジェクト）を渡す必要があります。

関連機能：