NOTE: Requires an HTML tag (either

or
) even if there are no subpages. Keep this in mind if you are using css to style the list.

<ul>
 <?php
  wp_list_pages('title_li=&amp;child_of='.$post->ID.'&amp;show_date=modified
  &amp;date_format=$date_format'); ?>
 </ul>

次の例は、現在のページに子（親として現在のページを指定するページ）がある場合、リストのみ生成します。

The following example will generate a list only if there are child (Pages that designate the current page as a Parent) for the current Page:

<?php
  $children = wp_list_pages('title_li=&amp;child_of='.$post->ID.'&amp;echo=0');
  if ($children) { ?>
 <ul>
 <?php echo $children; ?>
 </ul>
 <?php } ?>

サブページ上の場合でさえサブページをリスト表示する方法

上記の例では、親ページから子を表示するのみになるが、実際に子ページ上になります。このコードは親あるいは1つの子上である時に、子ページ及び子ページのみ表示されます。

The above examples will only show the children from the parent page, but not when actually on a child page. This code will show the child pages, and only the child pages, when on a parent or on one of the children.

サイドバーにウィジェットブロックの後に配置している場合、このコードは動作しません。

This code will not work if placed after a widget block in the sidebar.

<?php
  if($post->post_parent)
  $children = wp_list_pages("title_li=&amp;child_of=".$post->post_parent."&amp;echo=0");
  else
  $children = wp_list_pages("title_li=&amp;child_of=".$post->ID."&amp;echo=0");
  if ($children) { ?>
 <ul>
 <?php echo $children; ?>
 </ul>
 <?php } ?>

別の方法として、sidebar.phpにこのコードは、トップレベルページのみ表示しますが、子（あるいは子）を持つページを表示する時、親である子のみ表示します。

As an alternative, this code in a sidebar.php, displays only top level Pages, but when viewing a Page that has children (or is a child) it displays only children of that parent.

• メインページを訪問する時、全てのトップレベルページがサイドバーにリスト表示されます。
• 子を持たないトップレベルページを訪問する時、全てのトップレベルページがリスト表示されます。
• 子、まさに子ページ、子孫ページとトップレベルのページを訪問する時、表示されます。
• 親の子ページ、まさに子と子孫ページを訪問する時、表示されます。

• When visiting main page, all top level pages are listed in the sidebar.
• When visiting a top level page with no children, all top level pages are listed.
• When visiting a top level page with children, just the children pages, and descendant pages, are listed.
• When visiting a child page, just the children, and descendant pages, of that parent, are listed.

<?php
$output = wp_list_pages('echo=0&amp;depth=1&amp;title_li=<h2>Top Level Pages</h2>' );
if (is_page( )) {
  $page = $post->ID;
  if ($post->post_parent) {
$page = $post->post_parent;
  }
  $children=wp_list_pages( 'echo=0&amp;child_of=' . $page . '&amp;title_li=' );
  if ($children) {
$output = wp_list_pages ('echo=0&amp;child_of=' . $page . '&amp;title_li=<h2>Child Pages</h2>');
  }
}
echo $output;
?>

そのページリスト：子（サブ）ページが存在する場合、親ページと子ページ上のサブページのリストページを表示します。しかしこのコードは前の例から異なるマークするタイトルに親ページ名を保持します。

Page List that: Only displays if child (sub) pages exist, displays page list of subpages on the parent page AND on the child pages HOWEVER this code keeps the parent page name in the title which makes it different from the previous example.)

< ?php if($post->post_parent) {
$children = wp_list_pages(“title_li=&child_of=”.$post->post_parent.”&echo=0″);
$titlenamer = get_the_title($post->post_parent);
}

else {
$children = wp_list_pages(“title_li=&child_of=”.$post->ID.”&echo=0″);
$titlenamer = get_the_title($post->ID);
}
if ($children) { ?>

< ?php echo $titlenamer; ?>

< ?php echo $children; ?>

< ?php } ?>

全体のサブページを表示する方法

これは全体のサブページリストを取得する方法です。

This is how to get the whole subpages list

<?php
if(!$post->post_parent){
	// このトップレベルページのサブページを表示します。will display the subpages of this top level page
	$children = wp_list_pages("title_li=&amp;child_of=".$post->ID."&amp;echo=0");
}else{
	// 親レベルのサブページのみ表示します。diplays only the subpages of parent level
	//$children = wp_list_pages("title_li=&amp;child_of=".$post->post_parent."&amp;echo=0");
	
	if($post->ancestors)
	{
		// 今、このページのトップIDを付与することができます。now you can get the the top ID of this page
		// wp is putting the ids DESC, thats why the top level ID is the last one
		$ancestors = end($post->ancestors);
		$children = wp_list_pages("title_li=&amp;child_of=".$ancestors."&amp;echo=0");
		// 常に全体のサブページのリストが表示されます。you will always get the whole subpages list
	}
}

if ($children) { ?>
	<ul>
		<?php echo $children; ?>
	</ul>
<?php } ?>

ページ項目のマークアップとスタイリングする方法

デフォルトでは、書き込み＞ページの管理者パネルで作成されたWordPressページのページを順不同リストで、入れ子を生成します。title_liに空の文字列を設定することによって最も外側の項目 (li.pagenav)とリスト (ul)を削除することができます。

By default, wp_list_pages() generates a nested, unordered list of WordPress Pages created with the Write > Page admin panel. You can remove the outermost item (li.pagenav) and list (ul) by setting the title_li parameter to an empty string.

wp_list_pages()によって生成された全てのリスト項目（li）は、クラスのpage_itemが付与されています。wp_list_pages()がページを表示している間に呼び出される時、項目リストにページは追加クラスのcurrent_page_itemを与えられます。

All list items (li) generated by wp_list_pages() are marked with the class page_item. When wp_list_pages() is called while displaying a Page, the list item for that Page is given the additional class current_page_item.

<li class="pagenav">
Pages [title_li]
 <ul>
&amp;lt;!-- "title_li'パラメータが空の場合、出力はここから始まります。Output starts here if 'title_li' parameter is empty --&amp;gt;
   <li class="page-item-2 page_item current_page_ancestor current_page_parent">
  [parent of the current Page]
 <ul>
   <li class="page-item-21 page_item current_page_item">
  [the current Page]
   </li>
 </ul>
   </li>
   <li class="page-item-3 page_item">
  [another Page]
   </li>
 </ul>
</li>

CSSセレクタでスタイルを設定することができます。

They can be styled with CSS selectors:

.pagenav { … } /* 最も外側のリスト項目：リスト全体が含まれます。the outermost list item; contains whole list */
.page-item-2 { … } /* ページID2のための項目。item for Page ID 2 */
.page_item { … } /* 任意のページ項目。any Page item */
.current_page_item { … } /* 現在のページ。the current Page */
.current_page_parent { … } /* 現在のページの親。parent of the current Page */
.current_page_ancestor { … } /* 現在のページの任意の祖先。any ancestor of the current Page */

インスタンスのためのアコーディオンメニューの効果を有効にするために、以下のCSSを使用することができます。

In order to achieve an accordion menu effect for instance, the following CSS can be used:

.pagenav  ul ul,
.pagenav .current_page_item ul ul,
.pagenav .current_page_ancestor ul ul,
.pagenav .current_page_ancestor .current_page_item ul ul,
.pagenav .current_page_ancestor .current_page_ancestor ul ul {
	display: none;
	}

.pagenav .current_page_item ul,
.pagenav .current_page_ancestor ul,
.pagenav .current_page_ancestor .current_page_item ul,
.pagenav .current_page_ancestor .current_page_ancestor ul,
.pagenav .current_page_ancestor .current_page_ancestor .current_page_item ul,
.pagenav .current_page_ancestor .current_page_ancestor .current_page_ancestor ul {
	display: block;
	}

親ページと全ての子孫ページをリスト表示する方法

特定の親ツリー（親と全ての世代を表示します）を表示するためにwp_list_pagesを指示する方法がありません。
この例は親のための全ての子孫を取得するためにget_pagesを使用します。その際’family tree’を表示するためにwp_list_pagesを使用してください。

Since there’s no way to tell wp_list_pages to display a particular parent tree (parent and all generations displayes) this example uses get_pages to get all the descendants for a parent, then use wp_list_pages to display the ‘family tree’.

<?php 
// 親と全ての子ページの全ての世代（親とツリー）を表示するために wp_list_pagesを使用します。use wp_list_pages to display parent and all child pages all generations (a tree with parent)
$parent = 93;
$args=array(
  'child_of' => $parent
);
$pages = get_pages($args);  
if ($pages) {
  $pageids = array();
  foreach ($pages as $page) {
$pageids[]= $page->ID;
  }

  $args=array(
'title_li' => 'Tree of Parent Page ' . $parent,
'include' =>  $parent . ',' . implode(",", $pageids)
  );
  wp_list_pages($args);
}
?>

現在のページ、現在のページの祖先、そして現在のページの子をリスト表示し、child_ofが全ての子を表示するようになって以来、wpdbは全ての’and the kitchen sink’を表示しないように含めるのと同様に代わりに使用されます。

List current Page, ancestors of current page, and children of current page
Since child_of displays all children, wpdb is used instead, along with include to not display everything ‘and the kitchen sink’.

<?php
//投稿が親を持っている場合。if the post has a parent
if($post->post_parent){
  //祖先のページを収集します。collect ancestor pages
  $relations = get_post_ancestors($post->ID);
  //子ページを取得します。get child pages
  $result = $wpdb->get_results( "SELECT ID FROM wp_posts WHERE post_parent = $post->ID AND post_type='page'" );
  if ($result){
foreach($result as $pageID){
  array_push($relations, $pageID->ID);
}
  }
  //現在の投稿とページを追加します。add current post to pages
  array_push($relations, $post->ID);
  //子と親と地震のカンマ区切りのリストを取得します。get comma delimited list of children and parents and self
  $relations_string = implode(",",$relations);
  //収集したページのみリストに含めて使用します。use include to list only the collected pages. 
  $sidelinks = wp_list_pages("title_li=&amp;echo=0&amp;include=".$relations_string);
}else{
  // メインレベルと子のみ表示します。display only main level and children
  $sidelinks = wp_list_pages("title_li=&amp;echo=0&amp;depth=1&amp;child_of=".$post->ID);
}

if ($sidelinks) { ?>
 <h2><?php the_title(); ?></h2>
 <ul>
   <?php //<li>タグにリンクする。links in<li> tags
echo $sidelinks; ?>
 </ul> 
<?php } ?>

ホームページの一覧を表示する方法

ブログページへのリンクをしたい場合は、同様にwp_page_menu()を使用してください。

If you want a link to the blog page as well use wp_page_menu().

カスタムポストタイプのメンバーをリスト化する方法

特定のカスタム投稿タイプが事実上階層である場合、wp_list_pages()はカスタム投稿タイプのメンバーを一覧表示することに使用することができます。この例ではカスタム投稿タイプのポートフォリオがリスト表示されています。

If a given custom post type is hierarchical in nature, then wp_list_pages() can be used to list the member of that custom post type. In this example the custom post type Portfolio is listed:

<?php 
$args = array(
  'post_type'=>'portfolio',
  'title_li'=> __('Portfolio')
);
wp_list_pages( $args ); 
?> 

最上位の祖先とその直下の子を一覧表示する方法

このメソッドは、最上位の祖先の直下の子と同様に現在のページの最上位祖先を表示します。これはクリーンな第２のサブナビゲーションに使用することができます。

最初に、次の関数をを作成します（できればのfunctions.php内に、これがテーマにあると仮定して）。

This method will show the topmost ancestor of the current page as well as the topmost ancestor’s immediate children. This can be used for clean secondary subnavigation.

First, create the following function (preferably in functions.php, assuming this is for a theme):

if(!function_exists('get_post_top_ancestor_id')){
/**
 * Gets the id of the topmost ancestor of the current page. Returns the current
 * page's id if there is no parent.
 * 
 * @uses object $post
 * @return int 
 */
function get_post_top_ancestor_id(){
    global $post;
    
    if($post->post_parent){
        $ancestors = array_reverse(get_post_ancestors($post->ID));
        return $ancestors[0];
    }
    
    return $post->ID;
}}

次に、あなたのテーマに次のコードを追加します（あなたがメニューが表示したい場所）：

Next, add the following code to your theme (wherever you want the menu to appear):

<ul class="clearfix">
    <?php wp_list_pages( array('title_li'=>'','include'=>get_post_top_ancestor_id()) ); ?>
    <?php wp_list_pages( array('title_li'=>'','depth'=>1,'child_of'=>get_post_top_ancestor_id()) ); ?>
</ul>

注釈

参照: wp_page_menu(), get_pages()

変更ログ

• Since: 1.5.0
• 2.7 : Added the link_before, link_after and exclude_tree parameters.
• 2.8 : Added the number and offset parameters.

ソースファイル

wp_list_pages()は、wp-includes/post-template.php内に位置しています。

wp_list_pages() is located in wp-includes/post-template.php.

関連ファンクションタグ

wp_list_authors(), wp_list_categories(), wp_list_pages(), wp_list_bookmarks(), wp_list_comments(), wp_get_archives(), wp_page_menu(), wp_dropdown_pages(), wp_dropdown_categories(), wp_dropdown_users()