! 各ページ右上の画像広告経由でコンピュータウィルスがダウンロードされた可能性があります。ウィルスチェックをお願いします。詳しくは http://bono.s201.xrea.com/2008/06/693-virus_by_xrea_ad/ をご覧ください。ご迷惑をおかけしてしまい大変申し訳ありません。
テンプレートタグ/wp list cats
出典: ps*wiki
< テンプレートタグ
このテンプレートタグは 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が自動で割り当てられる。
- optionall (1/0)- すべての記事を含む、「All」リンクを出力するかどうか。
- コード記述例:
<?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>
