• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

テンプレートタグ/wp list cats

提供: WordPress Codex 日本語版
移動先: 案内検索

このテンプレートタグは WordPress 2.1 から非推奨となりました。後継となる新しいテンプレートタグが作られたか、動作対象外となり、WordPress の将来のバージョンで削除される見込みです。 このタグを使っていた場合は、後継の wp_list_categories に切り替えてください。


  • 書式: <?php wp_list_cats('arguments'); ?>
  • 説明: リスト形式でカテゴリーリンク一覧を出力。出力する内容はlist_catsとほぼ同じだが、コンマ区切りではなく&を使った書式で引数を指定する。
  • 位置: ループ外
  • 引数:
    • optionall (1/0)- すべての記事を含む、「All」リンクを出力するかどうか。
      • 1(デフォルト。「All」リンクを出力)
      • 0(「All」リンクを出力しない)
    • all (文字列)- すべての記事を含む、「All」リンクのラベルテキスト。デフォルト値は「All」。
    • sort_column (規定値)- 出力するカテゴリーの並べ方。
      • ID(デフォルト。カテゴリーID順)
      • name(カテゴリー名順)
    • sort_order (asc/desc)- 出力するカテゴリーの並び順。sort_columnで指定した並べ方に基づく。
      • asc(デフォルト。sort_columnで指定したルールに従い、昇順に並べる)
      • desc(降順に並べる)
    • file (文字列)- カテゴリーリンクを出力するファイル名。現時点のバージョンではこの引数を指定してもデフォルト値が採用される。
    • list (1/0)- <li>要素内に各カテゴリー名とそのリンクを出力するかどうか。
      • 1(デフォルト。
      • 要素を使用。)
      • 0(タグを付加しない)
    • optioncount (1/0)- カテゴリー内の記事数を出力するかどうか。
      • 1(記事数を出力)
      • 0(デフォルト。記事数を出力しない)
    • hide_empty (1/0)- 投稿記事数が0のカテゴリーを一覧に含めるどうか。
      • 1(デフォルト。記事数が0のカテゴリーを出力しない)
      • 0(記事数が0でもカテゴリーを出力)
    • use_desc_for_title (1/0)- a要素のtitle属性としてカテゴリーの説明を追加するかどうか。
      • 1(デフォルト。title属性を追加)
      • 0(title属性を追加しない)
    • children (1/0)- サブカテゴリーを出力するかどうか。
      • 1(サブカテゴリーを出力)
      • 0(デフォルト。サブカテゴリーを出力しない)
    • child_of (整数)- 指定したカテゴリーIDのサブカテゴリーのみを出力。デフォルトではすべてのカテゴリーのサブカテゴリーを出力する。
    • recurse (1/0)- 取得した値の処理方法。
      • 1(PHPで使用できる値としてカテゴリー一覧を返す)
      • 0(デフォルト。カテゴリー一覧をページ内に出力)
    • feed (文字列)- 各投稿者のRSSフィードをリンクするテキスト。デフォルトではテキストやリンクは出力されない。
    • feed_image (文字列)- 各投稿者のRSSフィードをリンクする画像のURL。「feed」引数で指定したテキストよりも優先される。
    • exclude (整数)- '1,2,3' などの形式で指定した、出力させないカテゴリーのID。
    • hierarchical (1/0)- サブカテゴリーを親カテゴリーの下階層として出力させるかどうか。
      • 1(デフォルト。複数階層形式で一覧を出力)
      • 0(すべてのカテゴリーを同じ階層として出力)- 数字のカテゴリーID。指定しない場合、現在のページのカテゴリーIDが自動で割り当てられる。
  • コード記述例:
<?php wp_list_cats('optionall=0&sort_column=name'); ?>
  • 出力例:
<li><a href="http://example.com/?cat=2" title="WordPress関連情報">Wordpress</a></li>
<li><a href="http://example.com/?cat=1" title="WordPressプラグイン関連情報">プラグイン</a></li>