Четвертая статья обзора основных функций блога 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');
3 комментария к статье
отличный материал, только мне бы хотелось знать - как можно за раз применить два аргумента, ато я хочю написать что то типа
wp_list_pages(’title_li=’,'include=39′);
и ясное дело ниче не выходит.![:oops:](../../wp-includes/images/smilies/icon_redface.gif)
все. вспасибо понял как боротся =) перечислил через амперсант и все отлично пашит =)
А как можно избавиться от параметра title у ссылок, выводимых с помощью этой функции? В пунктах красивого меню они, ой, как не в тему.