Wordpress Document

Author tags

Category tags

Comment tags

Date and Time tags

General tags

Geo tags

Link tags

Links Manager tags

Permalink tags

Post tags

Trackback tags

WP/PHP General

list_cats (2.1で非推奨)

概要

カテゴリー一覧をリンク形式で表示します

用法

<?php list_cats(optionall, 'all', 'sort_column', 'sort_order', 'file', list, optiondates, optioncount, hide_empty, use_desc_for_title, children, child_of, 'Categories', recurse, 'feed', 'feed_img', 'exclude', hierarchical); ?>

引数

optionall (boolean)

TRUE
”全カテゴリーを表示するページ”へのリンクを表示します(デフォルト)
FALSE
-

all (string)

(string)
optionallがTRUEになっているとき全カテゴリーページへのリンクのラベルに使用します(デフォルト:'All')

sort_column (string)

ID
ID順で並べ替え(デフォルト)
'name'
カテゴリー名で並べ替え

sort_order (string)

'asc'
昇順(デフォルト)
'desc'
降順

file (string)

(string)
カテゴリー一覧を表示するときに使用するPHPファイル名(デフォルト:'index.php')

list (boolean)

TRUE
<li>〜</li>リストを使って一覧表示します(デフォルト)
FALSE
単純に<br>区切りで表示します

optiondates (boolean)

TRUE
カテゴリーごとに、投稿された最終日を 'Y-m-d' 形式で表示します
FALSE
最終投稿日を表示しません(デフォルト)

optioncount (boolean)

TRUE
カテゴリーごとの投稿数を表示します
FALSE
(デフォルト)

hide_empty (boolean)

TRUE
投稿が1件もないカテゴリーを表示しません(デフォルト)
FALSE
全てのカテゴリーを表示します

use_desc_for_title (boolean)

TRUE
<a>タグのtitle属性にカテゴリーの説明を記述します(デフォルト)
FALSE
-

children (boolean)

TRUE
サブカテゴリーを表示します
FALSE
(デフォルト)

child_of (integer)

(カテゴリーID)
指定されたカテゴリーIDのサブカテゴリーのみ表示します

Categories (integer)

0
0を指定すべきですが、それ以外の値が指定されてもWordpressの内部でのみ使用します

recurse (boolean)

TRUE
カテゴリーリンクをプログラムで使用出来るように文字列として返します
FALSE
カテゴリーリンクを表示します

feed (string)

(none)
RSSフィードにカテゴリーページへのリンクを記載しません(デフォルト)
(string)
RSSフィードに表示されるカテゴリーページへのリンクラベルを指定します

feed_image (string)

(none)
RSSフィードにカテゴリーページへのリンクを記載しません(デフォルト)
(string)
RSSフィードに表示されるカテゴリーページへのリンクアイコンのファイル名を指定します

exclude (string)

(string)
除外カテゴリーを指定します。配列形式で書かなければなりません

hierarchical (boolean)

1 (TRUE)
サブカテゴリーを階層的に表示します(デフォルト)
0 (FALSE)
-

用例

-