カテゴリのリストを表示するタグです。詳しい説明はCodexのwp_list_catsページに。list_cats()と殆ど同じですが、変数の設定の仕方がクエリー形式になります。

使い方

表示したいテンプレートファイルに
<?php wp_list_cats('変数'); ?>
とすればいいだけです。変数の部分には色んな設定ができます。指定したい物だけを()内に、「変数名=値」の形で書き、複数の指定する項目がある場合は「&」でつなぎます。

使用例

標準値
何も指定しない時の設定です。
<?php wp_list_cats(); ?>
だけだと、以下の標準値が表示されます。

  • optionall - 全カテゴリー表示へのリンクを表示しない
  • all - 全カテゴリを表示へのリンクの表題となるテキスト。allを押すと全カテゴリが表示されます。
  • sort_column - カテゴリIDでソート
  • sort_order - 昇順にソート
  • file - カテゴリをindex.phpに表示する
  • list - カテゴリをリスト形式で表示(<ul><li>)
  • optioncount - 各カテゴリの記事数を表示しない
  • hide_empty - 記事のないカテゴリは表示しない
  • use_desc_for_title - カテゴリにマウスを置くとそのカテゴリの説明がでてくる
  • children - サブカテゴリを表示する
  • hierarchical - サブカテゴリを各メインカテゴリの下に階層で表示する

いくつかのカテゴリを除いたリスト
カテゴリIDが10と15のものを除いて、カテゴリ名でソートし、各カテゴリの記事数を表示する場合
<ul>
<?php wp_list_cats(’sort_column=name&optioncount=1&exclude=10, 15′); ?>
</ul>

特定のカテゴリのサブカテゴリだけを表示
カテゴリIDが8のカテゴリのサブカテゴリだけを、カテゴリIDでソートし、各カテゴリの記事数を表示せず、カテゴリの説明をリンクタイトルに表示しない（マウスをカテゴリに置いた時にカテゴリ説明がでない）場合
<?php wp_list_cats('sort_column=id&optioncount=0&use_desc_for_title=0&child_of=8'); ?>
もし指定したメインカテゴリ（この場合はID8）に記事がない場合、そのサブカテゴリに記事があってもリストが表示されません。表示したい場合はhide_empty=0を使うことで回避できます。

使用上の注意

リスト表示にする設定の場合(”list”で設定)、各カテゴリはLIタグでくくられますので、wp_list_cats() タグをULでくくってあげてください。

変数

設定できる変数の説明です。

  • optional
    “全カテゴリを表示”をリストに加えるかどうか。使える値は:

    • 1 (True) - 全カテゴリ表示をリストに加える
    • 0 (False - 標準値) - 加えない
  • all
    “全カテゴリ表示”に使うテキスト。標準値は’all’. “全カテゴリ表示”という言葉を使いたい場合はここで指定します。
  • sort_column
    ソートできる項目

    • ID (標準値) - カテゴリID
    • name - カテゴリ名
  • sort_order
    設定できるソート順。使える値は:

    • asc (標準値) - 昇順
    • desc - 降順
  • file
    カテゴリファイルが表示されるphpファイル。標準値はindex.php
  • list
    カテゴリリストをリストタグ（<ul><li>)でくくるかどうか。使える値は:

    • 1 (True - 標準値) - くくる
    • 0 (False) - くくらない
  • optiondates
    各カテゴリに最新で投稿された日付。使える値は:

    • 1 (True) - 表示する
    • 0 (False - 標準値) - 表示しない
  • optioncount
    各カテゴリの記事数を表示するかどうか。 使える値は:

    • 1 (True) - 表示する
    • 0 (False - 標準値) - 表示しない
  • hide_empty
    記事がないカテゴリを隠す（非表示にする）かどうか。使える値は:

    • 1 (True - 標準値) - 非表示にする
    • 0 (False) - 表示する
  • use_desc_for_title
    カテゴリの説明をリンクタイトルに表示するかどうか(例. <a title=”カテゴリの説明” href=”…)。使える値は:

    • 1 (True - 標準値) - 表示する
    • 0 (False) - 表示しない
  • children
    サブカテゴリを表示するかどうか。使える値は:

    • 1 (True - 標準値) - 表示する
    • 0 (False) - 表示しない
  • child_of
    特定のカテゴリのサブカテゴリだけ表示する。ID番号で指定する。標準値はありません。
  • feed
    各カテゴリのRSS2 feedのリンクに表示されるテキスト。デフォルトは表示するテキストはなしで、feedも表示されない。
  • feed_image
    各カテゴリのRSS2 feedのリンクとして使われる画像までのパスかファイル名。feedの設定に上書きされる。
  • exclude
    表示しない（除く）カテゴリID。”,”で区切って複数指定もできる。(例: 1, 2, 3).
  • hierarchical
    サブカテゴリを各メインカテゴリの直下に階層でリスト表示するかどうか。使える値は:

    • 1 (True - 標準値) - 階層で表示
    • 0 (False) - 階層で表示しない

    • hierarchicalの変数が使えるのはバージョン1.5以降です。