WordPress 親カテゴリの取得方法 - wp_list_categories

カテゴリーのソート順を指定します。初期値は 昇順 (ASC) です。

• ASC: 昇順 (初期値)
• DESC: 降順

<?php
wp_list_categories('orderby=ID&order=DESC');
?>

各カテゴリーの投稿の最終更新日を表示するか否かを指定します。初期値は非表示(false)です。

• 1 (true): 表示
• 0 (false): 非表示 (初期値)

<?php
wp_list_categories('show_last_update=1');
?>

カテゴリーリストの表示形式を設定します。初期値は 箇条書き(list) です。

• list: 箇条書き(liタグ)で表示 (初期値)
• none: 表示形式なし。各カテゴリーは(改行brタグ)で区切られます

<?php
wp_list_categories('style=none');
?>

各カテゴリーの投稿数を表示するか否かを指定します。初期値は 非表示(false) です。

• 0 (false): 非表示 (初期値)
• 1 (true): 表示

<?php
wp_list_categories('show_count=1');
?>

投稿のないカテゴリーを非表示にするか否かを指定します。初期値は 空カテゴリーを隠す(true) です。

• 1 (true): 空カテゴリーを隠す (初期値)
• 0 (false): 全て表示

<?php
wp_list_categories('hide_empty=0');
?>

カテゴリー概要を、リンクの title 属性に挿入するか否かを指定します。初期値は 挿入する(true) です。

※<a title="<em>カテゴリー概要</em>" href="...">のようになります。

• 1 (true): カテゴリー概要を挿入 (初期値)
• 0 (false): 挿入しない

<?php
wp_list_categories('use_desc_for_title=false');
?>

指定したカテゴリーIDの子カテゴリーのみ表示します。初期値は 非表示 です。このパラメータを使うと、hide_empty パラメータに false がセットされます。

<?php
wp_list_categories('child_of=5');
?>

指定したカテゴリーを表示させないようにします。複数選択が可能です。表示させないカテゴリーIDをカンマ区切りで昇順に指定します。child_of パラメータは自動的に無効となります。

<?php
wp_list_categories('exclude=1,4');
?>

指定したカテゴリーIDのみ表示させます。複数指定が可能です。カンマ区切りで昇順に指定します。

<?php
wp_list_categories('include=4,5');
?>

子カテゴリーを親カテゴリーに属するツリー表示にするか否かを指定します。 初期値は ツリー表示(true) です。

• 1 (true): ツリー表示 (初期値)
• 0 (false): 親子同レベル

<?php
wp_list_categories('hierarchical=0');
?>

カテゴリーリストの外側に表示するタイトルと表示形式を指定します。このパラメータを中身を空で指定すると、カテゴリーリストの外側には何も表示しません。 初期値は __( 'Categories' ) です。

<?php
wp_list_categories('title_li=<h2>ブログカテゴリー</h2>');
?>

表示するカテゴリー数を指定します(SQL の LIMIT 値)。初期値は 無制限 です。

<?php
wp_list_categories('number=5');
?>

結果を表示するか、変数等へ値を返すかを指定します。初期値は 整形されたカテゴリーリストを表示(true) です。

• 1 (true): 整形されたカテゴリーリストを表示 (初期値)
• 0 (false): 値を返す

<?php
$parentheses = wp_list_categories('echo=0&show_count=1);
$parentheses = str_replace(array('(',')'), array('[',']'), $parentheses);
echo $parentheses;
?>

カテゴリー階層のどのレベルまでカテゴリーリストに表示させるかを指定します。初期値は 全ての親子カテゴリーを出力(0) です。

• 0: 全ての親子カテゴリーを出力 (初期値)
• -1: 全てのカテゴリーをフラット(インデントなし)形式で出力 (hierarchicalパラメータより優先されます)
• 1: 最上位カテゴリーのみ出力
• n: n（数値）階層目までを出力。'2' と指定すれば、最上位とすぐ下の子カテゴリーまでを出力

<?php
wp_list_categories('depth=2');
?>

カテゴリーアーカイブページ以外で current-cat を表示させます。メニューのハイライト表示に使えます。

<?php
$catId = get_the_category();
$myCat = $catId[0]->cat_ID;
wp_list_categories('current_category='.$myCat);
?>

子カテゴリーの項目を含めてリンクまたは投稿数を計算するか否かを指定します。show_counts または hierarchical が true の場合、自動的に true に設定されます。

• 0 (false): 初期値
• 1 (true)

<?php
wp_list_categories('show_count=1&pad_counts=0');
?>

分類(タクソノミー)名を指定します。初期値は category です。

• category: 初期値
• taxonomy: 登録されたタクソノミー名

<?php
wp_list_categories(array('title_li' =>'', 'taxonomy'=>'タクソノミー名','hide_empty'=>0));
?>

リストをレンダリングする Walker クラスです。

• object: Walker_Category または Walker を拡張する Class インスタンス

functions.php

class my_walker extends Walker_Category {
  function start_el(&$output, $category, $depth, $args) {
    extract($args);
    $cat_name = esc_attr( $category->name );
    $link = '<a href="%1$s" rel="%2$s">%3$s</a>';
    $link = sprintf($link
            , esc_attr( get_term_link($category) )
            , $category->slug
            , $cat_name
            );
    $check_third = count( get_ancestors( $category->term_id, 'category' ) );
    if($check_third == 2 and $category->category_parent > 0 ){
      $class = 'third';
    }
    if($check_third == 1 and $category->category_parent > 0 ){
      $class = 'second';
    }
    if($category->category_parent == 0){
      $class = 'first';
    }
    $output .= '<li class="'.$class.'">'.$link;
  }
}

テンプレート内記述

<?php
$MyWalker = new MyWalker();
$args = array('walker' => $MyWalker);
?>
<ul>
<?php
wp_list_categories($args);
?>
</ul>

当サイトではこんな感じでフッターに表示しています。

<?php
wp_list_categories('title_li=&depth=1');
?>

サイドバーはこんな感じ。

<?php
wp_list_categories('orderby=order&show_count=1&title_li=');
?>

WordPress Codex 日本語版
http://wpdocs.sourceforge.jp/テンプレートタグ/wp_list_categories/

WordPressで親カテゴリの取得する方法を紹介しました。

wp_list_categories は WordPress を利用する上で必ずといっていい程使われるものです。しっかり覚えておきたいですね。