Выводит список страниц WordPress в виде ссылок на них. Часто используется в темах в шапке и в сайдбаре.
wp_list_pages($args = '')
- $args
- (массив) Список значений параметра $args по умолчанию:
$args = array( 'authors' => '', // все авторы 'child_of' => 0, // и родительские и дочерние страницы 'date_format' => get_option('date_format'), 'depth' => 0, // любой уровень вложенности 'echo' => 1, // вывести результат 'exclude' => '', // ничего не исключать 'include' => '', // не выводить какие-либо конкретные страницы 'link_after' => '', // ничего не добавлять перед ссылкой 'link_before' => '', // ничего не добавлять после ссылки 'post_type' => 'page', // тип поста - только страницы 'post_status' => 'publish', // статус - только опубликованные 'show_date' => '', // не указывать дату 'sort_column' => 'menu_order, post_title', // сорировать по порядку, а затем по заголовку 'sort_order' => '', // порядок сортировки - по возрастанию 'title_li' => __('Pages'), // заголовок списка - Страницы );
- authors
- (строка) Укажите через запятую ID авторов, страницы, опубликованные которыми, нужно вывести.
<ul> <?php wp_list_pages( 'authors=1,15' ) ?> </ul>
- child_of
- (целое число) Выводит дочерние страницы, находящихся на всех уровнях вложенности, для страницы с указанным ID.
<ul> <?php wp_list_pages( 'child_of=15' ) ?> </ul>
- show_date
- (строка) Нужно ли отобразить дату публикации или изменения страницы:
modified— выводить дату изменения,created(либо любое другое значение, отличное от пустой строки) — отображать дату публикации;
- date_format
- (строка) Формат даты (зависит от предыдущего параметра). Пример:
<ul> <?php $args = array( 'show_date' => 'modified', 'date_format' => 'j M Y' ); wp_list_pages( $args ); ?> </ul>
- sort_column
- (строка) По какому параметру сортировать выводимые ссылки на страницы:
post_title— по заголовку страниц,menu_order— по порядку (устанавливается в админке при редактировании страниц),post_date— по дате создания,post_modified— по дате последнего изменения,ID— по ID,post_author— по ID автора,post_name— по ярлыку страниц;
- sort_order
- (строка) Порядок сортировки:
ASC— по возврастанию (по умолчанию),DESC— по убыванию;
Сортируем по заголовку в обратном алфавитном порядке:
<ul> <?php wp_list_pages( 'sort_column=post_title&sort_order=DESC' ) ?> </ul>
- exclude
- (строка) Укажите через запятую ID страниц, которые нужно исключить из списка.
- exclude_tree
- (строка) Укажите через запятую ID родительских страниц, которые нужно исключить из списка вместе с их дочерними страницами.
- include
- (строка) Если вам нужно включить только какие-то конкретные страницы в выводимый список, укажите их IDы через запятую, используя этот параметр.
- depth
- (целое число) Параметр позволяет задать максимальный уровень вложенности выводимых страниц:
- 0 — любой уровень вложенности, страницы выводятся с учетом иерархии,
- -1 — любой уровень вложенности, но без учета иерархии,
- 1 — только страницы с нулевым уровнем вложенности,
- 2, 3, … — укажите максимальный уровень вложенности страниц.
- title_li
- (строка) Заголовок списка. Если указать
nullили пустое значение, заголовок не будет добавлен, а список не будет заключен в тег<ul>.Например в этих случаях заголовка не будет:
<ul> <?php wp_list_pages('title_li='); ?> </ul>
<ul> <?php wp_list_pages('exclude=1,3,7&title_li='); ?> </ul>
- echo
- (логическое) Что в итоге нужно сделать с полученным результатом:
- 1 (true) — вывести,
- 0 (false) — возвратить.
<?php $children53 = wp_list_pages('title_li=&child_of=53&echo=0'); if ($children53) { ?> <ul> <?php echo $children53; ?> </ul> <?php } ?>
- meta_key
- (строка) Название произвольного поля (используется в совокупности с параметром meta_value).
- meta_value
- (строка) Значение произвольного поля (используется в совокупности с параметром meta_key).
<ul> <?php wp_list_pages( 'meta_key=color&meta_value=white' ) ?> </ul>
- link_before
- (строка) Текст или код HTML, который нужно добавить перед анкором ссылки внутри тега
<a>. - link_after
- (строка) Текст или код HTML, который нужно добавить после анкора ссылки внутри тега
<a>. - number
- (целое число) Количество ссылок на страниц, которое нужно вывести (по умолчанию — все).
- offset
- (целое число) Количество страниц с начала списка, которые нужно пропустить.
- post_type
- (строка) Вы можете выводить не только страницы, но и другие типы постов с иерархией.
Например выведем работы из портфолио:
$args = array( 'post_type'=> 'portfolio', 'title_li'=> 'Портфолио' ); wp_list_pages( $args );
- post_status
- (строка) Страницы с какими статусами следует включить в список. Например, опубликованные или черновики. Список всех статусов здесь. Можно указать несколько статусов через запятую.
$args = array( 'authors' => '', // все авторы 'child_of' => 0, // и родительские и дочерние страницы 'date_format' => get_option('date_format'), 'depth' => 0, // любой уровень вложенности 'echo' => 1, // вывести результат 'exclude' => '', // ничего не исключать 'include' => '', // не выводить какие-либо конкретные страницы 'link_after' => '', // ничего не добавлять перед ссылкой 'link_before' => '', // ничего не добавлять после ссылки 'post_type' => 'page', // тип поста - только страницы 'post_status' => 'publish', // статус - только опубликованные 'show_date' => '', // не указывать дату 'sort_column' => 'menu_order, post_title', // сорировать по порядку, а затем по заголовку 'sort_order' => '', // порядок сортировки - по возрастанию 'title_li' => __('Pages'), // заголовок списка - Страницы );
- authors
- (строка) Укажите через запятую ID авторов, страницы, опубликованные которыми, нужно вывести.
<ul> <?php wp_list_pages( 'authors=1,15' ) ?> </ul>
- child_of
- (целое число) Выводит дочерние страницы, находящихся на всех уровнях вложенности, для страницы с указанным ID.
<ul> <?php wp_list_pages( 'child_of=15' ) ?> </ul>
- show_date
- (строка) Нужно ли отобразить дату публикации или изменения страницы:
modified— выводить дату изменения,created(либо любое другое значение, отличное от пустой строки) — отображать дату публикации;
- date_format
- (строка) Формат даты (зависит от предыдущего параметра). Пример:
<ul> <?php $args = array( 'show_date' => 'modified', 'date_format' => 'j M Y' ); wp_list_pages( $args ); ?> </ul>
- sort_column
- (строка) По какому параметру сортировать выводимые ссылки на страницы:
post_title— по заголовку страниц,menu_order— по порядку (устанавливается в админке при редактировании страниц),post_date— по дате создания,post_modified— по дате последнего изменения,ID— по ID,post_author— по ID автора,post_name— по ярлыку страниц;
- sort_order
- (строка) Порядок сортировки:
ASC— по возврастанию (по умолчанию),DESC— по убыванию;
Сортируем по заголовку в обратном алфавитном порядке:
<ul> <?php wp_list_pages( 'sort_column=post_title&sort_order=DESC' ) ?> </ul>
- exclude
- (строка) Укажите через запятую ID страниц, которые нужно исключить из списка.
- exclude_tree
- (строка) Укажите через запятую ID родительских страниц, которые нужно исключить из списка вместе с их дочерними страницами.
- include
- (строка) Если вам нужно включить только какие-то конкретные страницы в выводимый список, укажите их IDы через запятую, используя этот параметр.
- depth
- (целое число) Параметр позволяет задать максимальный уровень вложенности выводимых страниц:
- 0 — любой уровень вложенности, страницы выводятся с учетом иерархии,
- -1 — любой уровень вложенности, но без учета иерархии,
- 1 — только страницы с нулевым уровнем вложенности,
- 2, 3, … — укажите максимальный уровень вложенности страниц.
- title_li
- (строка) Заголовок списка. Если указать
nullили пустое значение, заголовок не будет добавлен, а список не будет заключен в тег<ul>.Например в этих случаях заголовка не будет:
<ul> <?php wp_list_pages('title_li='); ?> </ul>
<ul> <?php wp_list_pages('exclude=1,3,7&title_li='); ?> </ul>
- echo
- (логическое) Что в итоге нужно сделать с полученным результатом:
- 1 (true) — вывести,
- 0 (false) — возвратить.
<?php $children53 = wp_list_pages('title_li=&child_of=53&echo=0'); if ($children53) { ?> <ul> <?php echo $children53; ?> </ul> <?php } ?>
- meta_key
- (строка) Название произвольного поля (используется в совокупности с параметром meta_value).
- meta_value
- (строка) Значение произвольного поля (используется в совокупности с параметром meta_key).
<ul> <?php wp_list_pages( 'meta_key=color&meta_value=white' ) ?> </ul>
- link_before
- (строка) Текст или код HTML, который нужно добавить перед анкором ссылки внутри тега
<a>. - link_after
- (строка) Текст или код HTML, который нужно добавить после анкора ссылки внутри тега
<a>. - number
- (целое число) Количество ссылок на страниц, которое нужно вывести (по умолчанию — все).
- offset
- (целое число) Количество страниц с начала списка, которые нужно пропустить.
- post_type
- (строка) Вы можете выводить не только страницы, но и другие типы постов с иерархией.
Например выведем работы из портфолио:
$args = array( 'post_type'=> 'portfolio', 'title_li'=> 'Портфолио' ); wp_list_pages( $args );
- post_status
- (строка) Страницы с какими статусами следует включить в список. Например, опубликованные или черновики. Список всех статусов здесь. Можно указать несколько статусов через запятую.
<ul> <?php wp_list_pages( 'authors=1,15' ) ?> </ul>
<ul> <?php wp_list_pages( 'child_of=15' ) ?> </ul>
<ul> <?php $args = array( 'show_date' => 'modified', 'date_format' => 'j M Y' ); wp_list_pages( $args ); ?> </ul>
Сортируем по заголовку в обратном алфавитном порядке:
<ul> <?php wp_list_pages( 'sort_column=post_title&sort_order=DESC' ) ?> </ul>
Например в этих случаях заголовка не будет:
<ul> <?php wp_list_pages('title_li='); ?> </ul>
<ul> <?php wp_list_pages('exclude=1,3,7&title_li='); ?> </ul>
<?php $children53 = wp_list_pages('title_li=&child_of=53&echo=0'); if ($children53) { ?> <ul> <?php echo $children53; ?> </ul> <?php } ?>
<ul> <?php wp_list_pages( 'meta_key=color&meta_value=white' ) ?> </ul>
Например выведем работы из портфолио:
$args = array( 'post_type'=> 'portfolio', 'title_li'=> 'Портфолио' ); wp_list_pages( $args );
(Пока оценок нет)
Загрузка...