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 } ?>

wp_list_pages - список ссылок на страницы: 4 комментария

  1. Игорь

    Спасибо за статью, а то я список дочерних страниц вручную делал. Оказывается так просто вывести список автоматически.

  2. Надежда

    здравствуйте. подскажите пжл
    как на материнской странице вывести дочерние страницы 2 уровня, по данной материнской страницы
    Тоесть есть, такая структура: Производитель -> Категория товара -> Товар
    Нужно: на странице Производитель вывести Товары
    Спс заранее.

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *