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_columnstring
Сортировка
'post_title' – но названию страниц в алфавитном порядке
'menu_order' – по номеру, задаваемому в поле «Порядок»
'post_date' – по времени создания
'post_modified' – по времени последнего изменения
'ID' – по id
'post_author' - по id автора
'post_name' – по имени в адресе
sort_orderstring
Позволяет изменять порядок сортировки
'ASC' – по возрастающей
'DESC' – по убывающей
excludestring
исключение страниц с id, указанными через запятую
exclude_treestring
исключение страниц с id, указанными через запятую, и их дочерних страниц
includestring
включение страниц с id, указанными через запятую
depthinteger
показывать
0  – все страницы и все дочерние страницы
-1 – все страницы как простой список
1 – только страницы верхнего уровня
n – ограничение уровня вложенности страниц
child_ofinteger
показывать дочерние страницы одной страницы с заданным id
show_datestring
показывать около каждой ссылки на страницу дату создания или последнего изменения
'' – без даты
'modified' – дата последнего изменения
'xxx' – (любое значение кроме 'modified') дата создания
date_formatstring
формат даты (например, "l, F j, Y")
title_listring
текст и стиль заголовка списка страниц
по умолчанию: '__('Страницы')' отображается заголовок Страницы
null или пустая строка ('') – заголовок не отображается и не добавляются теги <ul>
echoboolean
1 (true) – отображается сгенерированный список
0 (false) – список возвращается как HTML-строка для использования в PHP-коде
meta_keystring
включает только страницы с заданным ключом произвольного поля (Custom Field Key)
meta_valuestring
включает только страницы с заданным значением произвольного поля (Custom Field Key)
link_beforestring
задает текст или html-код, который предшествует тексту внутри тега <a>
link_afterstring
задает текст или html-код, который следует за текстом внутри тега <a>
authorsвключает только страницы авторов с id, указанными через запятую
если авторы не заданы, включает страницы всех авторов
numberinteger
количество отображаемых страниц
offsetinteger
количество страниц, которые нужно пропустить до сбора набора страниц
по умолчанию страницы не пропускаются

Примеры

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

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

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

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

  1. Игорь говорит:

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

  2. Антон говорит:

    Спасибо за хорошую инструкцию)

  3. Надежда говорит:

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

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

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