Mill's Note
  1. HOME
  2. Wordpress関数
  3. 固定ページに関わるWP関数
  4. wp_list_pages()

【Wordpress関数】wp_list_pages()

/

固定ページの情報を一覧(配列)で取得して「リンク と HTMLタグ 付き」で出力する、固定ページ一覧用のWordpressテンプレートタグ。

パラメータで細かく条件設定でき、簡単にリンク付き固定ページ一覧を作成できる優れもの。
階層指定もできるので、面倒なテンプレートタグの入れ子をする必要もありません。

wp_list_pages() 呼び出しコード

呼び出しコード説明
<?php wp_list_pages('title_li='); ?>最低限のパラメータ
<?php wp_list_pages('depth=0&title_li='); ?>直接指定 = パラメータが少ない場合など
<?php
  $args = array(
    'title_li'    => '',
    'depth'       => '0',
    'sort_column' => rand
  );
  wp_list_pages($args );
?>		引数を代入 = パラメータが多い場合など

wp_list_pages() パラメータ

パラメータ初期値設定できる値説明
show_date”modified(更新日)、
post_deta(公開日)、”(非表示)		更新日や公開日を表示
date_format一般設定Ymd, Y年m月d日等show_date=>'' 以外のみ
link_before”文字列ページタイトル前に挿入するテキスト
link_after”文字列ページタイトル後に挿入するテキスト
depth00、n取得階層
 0 = 全て (ul, li 階層あり)
 n = 最上位階層からn階層まで (ul, li 階層あり)
title_li固定ページ”、 タイトル文字列'title_li'=>'' を指定推奨
echo11(表示)、0(値を返す)変数として利用する場合は 0
sort_columnnameID、post_title、menu_order、rand等ソート対象 / 固定ページ一覧のカラム名など
sort_orderASCASC(昇順)、DESC(降順)ソート順
includearray()固定ページID /複数時 array()指定固定ページのみ
excludearray()固定ページID /複数時 array()取得しない固定ページ
child_of0固定ページID指定固定ページの子孫カテゴリーを取得
authors”投稿者ID /複数時 ,区切り投稿者
主要なパラメータを記載 / 他のパラメータはGoogle様でm(__)m

wp_list_pages() の使用例

wp_list_categories() は、パラメータ指定に合わせ自動的に成形された状態で出力されます。

最低限のパラメータのみのシンプルな設定

<ul><li> のリスト形式で出力。
'title_li'=>'' を設定した場合、別途<ul></ul>やタイトルを設置する必要があります。

PHP
<h2>固定ページ一覧</h2>
<ul>
<?php wp_list_pages('title_li='); ?>
<ul>
/* 出力結果 */
<h2>固定ページ一覧</h2>
<ul>
  <li class="page_item page_item-ID"><a href="ページURL">ページ名</a></li>
  <li class="page_item page_item-ID"><a href="ページURL">ページ名</a></li>
  <li class="page_item page_item-ID"><a href="ページURL">ページ名</a>
    <ul class="children">
      <li class="page_item page_item-ID"><a href="子ページURL">子ページ名</a></li>
      <li class="page_item page_item-ID"><a href="子ページURL">子ページ名</a></li>
    </ul>
  </li>
  <li class="page_item page_item-ID"><a href="ページURL">ページ名</a></li>
</ul>

子ページを一覧表示

各ページに設置する場合は、親ページIDを動的に取得する設定が必要となります。

※ 親ページID = 1 とした場合
PHP
<h2>子ページ一覧</h2>
<ul>
<?php wp_list_categories('title_li=&child_of=1'); ?>
<ul>
/* 出力結果 */
<h2>子ページ一覧</h2>
<ul>
  <li class="page_item page_item-ID"><a href="子ページURL">子ページ名</a></li>
  <li class="page_item page_item-ID"><a href="子ページURL">子ページ名</a></li>
  <li class="page_item page_item-ID"><a href="子ページURL">子ページ名</a></li>
</ul>