Эта функция определена в файле 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 } ?>
Дополнительно: в разделе "Функции WordPress" также:
- URL и другая информация о блоге
- Функции, подключающие шаблоны
- Циклы WordPress
- wp_list_categories
- Вход в систему
- Функции даты и времени в WordPress
- wp_link_pages - ссылки на страницы статьи с nextpage
- Шорткод [gallery]
- Функции для работы с метками
- Функции action, filter, plugin и локализация
- Произвольные поля (custom fields)
- Функции для работы с типами данных (записей)
- Функция wp_insert_post - обновление/добавление записи заданного типа
- Административные меню
- Функции для работы с пользователями и ролями пользователей
Спасибо за статью, а то я список дочерних страниц вручную делал. Оказывается так просто вывести список автоматически.
Спасибо за хорошую инструкцию)
здравствуйте. подскажите пжл
как на материнской странице вывести дочерние страницы 2 уровня, по данной материнской страницы
Тоесть есть, такая структура: Производитель -> Категория товара -> Товар
Нужно: на странице Производитель вывести Товары
Спс заранее.
см. "Иерархия постоянных страниц и breadcrumbs (хлебные крошки)"
http://mblogm.ru/blog/page-children-and-breadcrumbs/