Press WordPress Блог

Четвертая статья обзора основных функций блога WordPress.
Подробный обзор функции wp_list_pages().Данная функция позволяет получить и вывести список страниц блога в виде ссылок на них.

Оригинальный англоязычный источник данного материала.

Вывод ссылок страниц(страниц блога).
[Page Link List]
Синтаксис wp_list_pages('arguments');
Данная функция позволяет получить и вывести список страниц блога в виде ссылок на них.
Функция может принимать оапределенные аргументы для сортировки, перебора и организации вывода полученной информации о страницах блога:
• sort_column
Данный параметр позволяет отсортировать получаемый по определенным параметрам.
Синтаксис wp_list_pages('sort_column=ID');

• post_title (позволяет отсортировать список в алфавитном порядке);
• menu_order;
• post_date (позволяет отсортировать список по дате создания);
• post_modified (позволяет отсортировать список по дате обновления);
• ID (позволяет отсортировать список по ID страницы);
• post_author (позволяет отсортировать список по автору страницы);

• sort_order
Позволяет добавить опцию сортировки (ASC или DESC).
Синтаксис wp_list_pages('sort_order=desc');
• exclude
Данный параметр позволяет не выводить в общем списке страницы с определенным значением ID.
Синтаксис wp_list_pages('exclude=62,63,64,65');
• include
Данный параметр позволяет организовать вывод страниц только с определенным ID. Значения ID задаются через запятую.
Синтаксис wp_list_pages('include=62,63,64,65');
• depth
Данный параметр определяет глубину уровеня вложенности иерархии при выводе списка.
Может передавать следующие значения:

• 0 (Обычный вывод списка. Данное значение применяется по умолчанию);
• -1 (Зависимые элементы списка выводятся в одной строке);
• 1 (В списке отображаются только главные элементы);
• 2 (Значение большее «1» определяет уровень отображения вложенности списка);

Синтаксис wp_list_pages('depth=1');
• child_of
Параметр указывает функции, что необходимо вывести дочерние элементы списка только для элемента, ID которого передается с помощью данного параметра.
Синтаксис wp_list_pages('child_of=7');
• show_date
Параметр указывает функции – показывать дату создания (или дату изменения если таковое имело быть место) или не показывать. По умолчанию – ничего не выводит.
Синтаксис wp_list_pages('showdate=modified');
• date_format
Данный параметр управляет форматом даты, которая устанавливается параметром show_date (например: “l, F j, Y”). По умолчанию, данный параметр принимает значение формата даты, которое устанавливается в основных настройках сайта.
Синтаксис wp_list_pages('date_format=l, F j, Y');
• title_li
Данный параметр задает стиль и текст заголовка списка.
Синтаксис wp_list_pages('title_li=Page List');
• echo
Данный параметр определяет, будет ли список передан переменной для дальнейшей обработки данных с помошью PHP (значение 0), или будет выведен пользователю (значение 1).
Синтаксис wp_list_pages('echo=0');
• meta_key and meta_value
Данный параметр определяет и выводит элементы списка которые подходят под заданные параметром значения (мета данные).
Синтаксис wp_list_pages('meta_key=sport&meta_value=basketball');