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

wp_list_pages

概要

WordpressのPagesへのリンク一覧を表示します。
引数はquery_string(key1=value1&key2=value2 ... )形式です。
サイドバーやヘッダーのカスタマイズによく使われますが、同様にTemplatesにも使われます。
このタグはWordpress1.5以上で使用出来ます。

用法

<?php wp_list_pages('arguments'); ?>

引数

sort_order (string)

'asc'
昇順で並べ替え(デフォルト)
'desc'
降順で並べ替え

exclude

(string)
コンマ区切りでPages IDを指定し、一覧から除外します。
例:'exclude=3,7,31'

include

(string)
コンマ区切りでPages IDを指定し、一覧に表示します。
例:'include=3,7,31'

depth (integer)

一覧に含めるPagesのうち、どのような内容のページを含めるかを指定します。
0
PagesとサブPagesの全てを表示します。(デフォルト)
-1
PagesとサブPagesの全て表示しますが、サブPagesをインデントしません。
1
トップレベルのPagesのみ表示します。
2
2以上の数字が指定された場合、その数字までのPagesの階層に含まれるサブPagesを表示します。

child_of

(integer)
シングルページのsub-pagesのみを表示します。PagesのIDを指定します。(デフォルト:0 : 全て表示)

show_date (string)

作成日、または最終更新日を表示します。
' '
日付を表示しません(デフォルト)
'modified'
更新日を表示します
'xxx'
作成日を表示します。modified以外の文字を指定します。

date_format

(string)
show_dateパラメータで使用する、日付フォーマットです

title_li

(string)
Pagesリストのヘッダ(表題)に使用します。(デフォルト:__('Pages') : 'Pages'と表示します

echo (boolean)

1(TRUE)
作成したリストをブラウザに表示します。
0(FALSE)
作成したリストをPHPで使用出来るように文字列として返します。

hierarchical (boolean)

1(TRUE)
Pagesの階層に従ってインデントします。(デフォルト)
0(FALSE)
横一列に表示します。

meta_key

(string)
ここで指定されたキーワードがCustom Field Keyに含まれるPagesのみ表示します。

meta_value

(string)
ここで指定されたキーワードがCustom Field Value含まれるPagesのみ表示します。

用例

-