wp_list_pages

Эта функция определена в файле wp-includes/post-template.php.
Выводит список ссылок на страницы WordPress.

<?php wp_list_pages( $args ); ?>

где по умолчанию

<?php $args = array(
 'depth'        => 0,
 'show_date'    => ,
 'date_format'  => get_option('date_format'),
 'child_of'     => 0,
 'exclude'      => ,
 'include'      => ,
 'title_li'     => __('Pages'),
 'echo'         => 1,
 'authors'      => ,
 'sort_column'  => 'menu_order, post_title',
 'link_before'  => ,
 'link_after'   => ,
 'exclude_tree' =>  ); ?>

Аргументы можно разделять символом &:

<?php wp_list_pages('аргумент1=значение&аргумент2=значение&...'); ?>

Описание параметров

sort_column	string Сортировка 'post_title' – но названию страниц в алфавитном порядке 'menu_order' – по номеру, задаваемому в поле «Порядок» 'post_date' – по времени создания 'post_modified' – по времени последнего изменения 'ID' – по id 'post_author' - по id автора 'post_name' – по имени в адресе
sort_order	string Позволяет изменять порядок сортировки 'ASC' – по возрастающей 'DESC' – по убывающей
exclude	string исключение страниц с id, указанными через запятую
exclude_tree	string исключение страниц с id, указанными через запятую, и их дочерних страниц
include	string включение страниц с id, указанными через запятую
depth	integer показывать 0  – все страницы и все дочерние страницы -1 – все страницы как простой список 1 – только страницы верхнего уровня n – ограничение уровня вложенности страниц
child_of	integer показывать дочерние страницы одной страницы с заданным id
show_date	string показывать около каждой ссылки на страницу дату создания или последнего изменения '' – без даты 'modified' – дата последнего изменения 'xxx' – (любое значение кроме 'modified') дата создания
date_format	string формат даты (например, "l, F j, Y")
title_li	string текст и стиль заголовка списка страниц по умолчанию: '__('Страницы')' отображается заголовок Страницы null или пустая строка ('') – заголовок не отображается и не добавляются теги <ul>
echo	boolean 1 (true) – отображается сгенерированный список 0 (false) – список возвращается как HTML-строка для использования в PHP-коде
meta_key	string включает только страницы с заданным ключом произвольного поля (Custom Field Key)
meta_value	string включает только страницы с заданным значением произвольного поля (Custom Field Key)
link_before	string задает текст или html-код, который предшествует тексту внутри тега <a>
link_after	string задает текст или html-код, который следует за текстом внутри тега <a>
authors	включает только страницы авторов с id, указанными через запятую если авторы не заданы, включает страницы всех авторов
number	integer количество отображаемых страниц
offset	integer количество страниц, которые нужно пропустить до сбора набора страниц по умолчанию страницы не пропускаются

Примеры

Сортировка по дате создания

Страницы отсортированы по дате создания, а рядом с каждой ссылкой на страницу показана дата создания:

<ul>
  <?php wp_list_pages('sort_column=post_date&show_date=created'); ?>
</ul>

Список дочерних страниц для страницы с заданным id

<h3>Справочник WordPress</h3>
<?php wp_list_pages('child_of=123&title_li='); ?>

Как узнать id: URL и id в WordPress

Список дочерних страниц на странице

Этот код можно поместить в раздел the_post() шаблона page.php вашейтемы WordPress после the_content() или в шаблон страницы, который используется для страниц, имеющих дочерние страницы:

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

А этот код генерирует список, только если у текущей страницы есть дочерние страницы:

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