Page-list керує виведенням дочірніх сторінок. Виведення списку сторінок у WordPress за допомогою функції wp_list_pages() #2.2 Використовуючи цей код, ми приберемо заголовок "Сторінки" у списку

Більшість бізнес-сайтів найчастіше використовують сторінки для розміщення контенту. Через те, що сторінки відрізняються від записів, вам можуть знадобитися різні способи їх відображення. У цій статті ми покажемо вам, як легко додати список сторінок з мініатюрами в WordPress. Також ми продемонструємо вам спосіб виведення дочірніх та однорівневих сторінок.

Насамперед вам необхідно встановити та активувати плагін Page-list . Він працює «з коробки» не потребує додаткового налаштування.

Page-list має шорткоди з великою кількістю доступних параметрів. Почнемо з додавання простого списку всіх сторінок у вигляді карти сайту.

Просто створіть нову сторінку в WordPress і додайте до неї шорткод .

Цей шорткод відобразить простий вкладений список усіх сторінок.

Ви можете використовувати цей або будь-який інший шорткод у текстових віджетах WordPress. Якщо шорткоди не спрацьовують у віджетах на вашому сайті, необхідно активувати їх підтримку. Додайте наступний рядок до файлу functions.php вашої теми або в :

Add_filter("widget_text","do_shortcode");

Виводимо дочірні сторінки для батьківщини у WordPress

Раніше в наших статтях ми показували вам різні способи виведення дочірніх сторінок на батьківській сторінці в WordPress. Page-list набагато спрощує відображення дочірніх сторінок.

Все, що вам потрібно зробити, це додати шорткод на батьківську сторінку.

Також ви можете використовувати шорткод у текстовому віджеті.

Виводимо однорівневі сторінки на сторінках WordPress

Однорівневі сторінки — це дочірні сторінки, які мають одну й ту саму батьківську сторінку. Ви можете вивести однорівневі сторінки за допомогою шорткоду на сторінці або всередині віджету.

Виводимо список сторінок з мініатюрою та цитатою

У плагіні Page-list є ще один шорткод. . Цей шорткод надає розширені можливості виведення списку сторінок у WordPress.

Ви можете використовувати його для виведення списку сторінок із мініатюрою та цитатою. Наприклад, ось так:

Також можна налаштувати розмір зображення за допомогою параметра image_width.

Існує можливість контролювати довжину цитати за допомогою параметра limit_contentвсередині шорткод.

Якщо ж ви не хочете відображати коротку цитату, її можна вимкнути шляхом використання параметра show_contentвсередині шорткод.

Для більш повного списку опцій загляньте в повний список параметрів , які можна використовувати у цьому шорткоді.

Ми сподіваємося, що ця стаття допомогла вам легко вивести список сторінок із мініатюрами у WordPress.

З усіх питань та відгуків прохання писати в коментарі нижче.

Більшість корпоративних та класичних сайтів, створених на WordPress, для наповнення частіше використовують сторінки, ніж пости. На статичних сторінках розміщується інформація про компанію, співробітників, послуги фірми тощо. При цьому відображення списку сторінок обмежені лише стандартним функціоналом меню. Так, можна скористатися функцією wp_nav_menu з різними параметрами, але для новачків це не просто і не наочно. У таких випадках вам допоможе плагін Page-list.

Модуль дозволяє виводити списки сторінок за допомогою шорткодів. При цьому можна вказувати певні параметри для відображення, наприклад, показувати мініатюри для сторінок.

Встановлюється модуль Page-list досить легко. Після активації нічого додатково налаштовувати не потрібно. Для того, щоб відобразити список сторінок, пишете в якомусь текстовому блоці WordPress. Це може бути пост блогу, сторінка або віджет із сайдбару. Якщо шорткод у віджеті не спрацьовує, потрібно додати у functions.php рядок:

Add_filter("widget_text","do_shortcode");

Шорткод виводить список усіх сторінок.

У зображенні вище ви можете помітити у шорткоду наявність спеціальних параметрів. З їхньою допомогою будь-який користувач може вивести потрібний йому набір сторінок. У прикладі використовувалися: child_of (ID батьківської сторінки для відображення її підсторінок), exclude (виключення певних сторінок) та depth (кількість рівнів ієрархії сторінок для відображення).

Що ж до шорткодів, то їх всього 4:

- Список всіх сторінок сайту;
– список підсторінок поточної сторінки;
– список підсторінок, що мають одну й ту саму батьківську сторінку з поточної;
– список сторінок з ілюстраціями та описом;

Шорткоди і дуже цікавий для корпоративних сайтів. Теоретично, за їх допомогою можна створити контекстно-залежне меню. Це коли ви заходите до одного з пунктів меню з підсторінками і бачите їх список у сайдбарі.

Дуже популярна опція на класичних сайтах. Що ж до шорткоду то це взагалі просто знахідка. З його допомогою можна організувати простий каталог товарів на сторінках. Функція виводить зображення сторінки та короткий її опис. Можна навіть задавати кількість символів у тексті та розмір картинки.

Для виведення такого списку використовується такий шорткод:

Як я вже сказав вище, можна обмежити довжину тексту опису:

Або взагалі прибрати короткий анонс:

Плагін Page-listзастосовується для виведення дочірніх сторінок. Не дивлячись на те, що будувати сайт на сторінках не зовсім зручно, особливо при великій кількості сторінок (що пов'язано з відсутністю поділу за таксономіями та труднощами сортування), проте така можливість є і якщо припече, то реалізувати такий проект цілком реально.

Плагін завантажило/встановило понад 40К, а останнє оновлення було у липні цього року.

Навіщо використовується плагін Page-list?

Майстерно використовуючи набір шоткод можна побудувати структуру сайту на базі сторінок, часом це буває необхідно. Шоткод велику кількість на всі випадки життя. Основне завдання плагіна – вивести аналог архіву для дочірніх сторінок. Існує можливість виведення мініатюри, заголовка та частини контенту статті (цитати).

Налаштування формату виведення здійснюється через CSS.

Особливості встановлення Page-list

Плагін працює відразу після активації, настрої його виявлено не було.

Недоліки Page-list

Не знайшов параметра, який би дозволяв вивести для поточної сторінки лише перший рівень вкладеності. Така можливість є лише за умови примусового вказівки ID сторінки. Рішення.Задати поточну сторінку параметром: parent=»this»

Приклад шоткод з виведенням заданого розміру мініатюри

Висновок

Інструмент робітник, конфліктів не помічено, зручно.

Беремо у репозиторії WordPress Page-list	посилання на Page-list
Документація проекту Page-list	Page-list , на іноземній мові
Аналогічний інструмент для постів

Цією статтею я познайомлю вас із функцією wp_list_pages, яка використовується для виведення списку сторінок у wordpress.
Освоївши роботу з цією функцією, ви зможете без зусиль вивести впорядкований список сторінок wordpress у будь-якому місці вашого сайту.

У деяких випадках може знадобитися вивести список сторінок як меню. Можна, звичайно, використовувати віджет сторінкиз цією метою, та його функціональність дуже обмежена. У цьому випадку ви будете задовольнятися лише вибором способу сортування сторінок, включених до переліку і можливістю виключити окремі сторінки. Погодьтеся, не дуже багаті можливості.

А якщо ми хочемо більшого? Що якщо нам потрібне щось особливе?

Тоді варто звернути свій погляд у бік гнучкішого інструменту з набагато більшими можливостями.
У WordPress таким інструментом є функція wp_list_pages.

Функція wp_list_pagesу Wordpress зазвичай використовується для виведення списку сторінок у сайдбарах та заголовках у вигляді посилань. Однак може використовуватися і в інших довільних місцях шаблонів.

Синтаксис використання функції наступний

За промовчанням список сторінок, викликаний за допомогою функції wp_list_pagesвиводиться наступним чином:

відображаються всі сторінки та підсторінки
дата створення не відображається
заголовком списку є «Сторінки» («Pages»)
сторінки сортовані по порядку (ID), за заголовками (title)
сторінки відображаються в ієрархічній структурі

Аргументів у функції досить багато, я не розповідатиму про всіх них докладно. Для цього ви завжди можете скористатися Codex WordPress.

Краще я зупинюся тільки на часто використовуваних із них, знання яких буде достатньо для виконання більшості стандартних завдань.

Метод сортування ( sort_column)
Часто використовувані значення:
‘post_title’— сортування проводитиметься за назвою сторінок.
‘menu_order’- Сортування по порядку сторінок.
‘post_date’- Сортування за датою створення.

Порядок сортування ( sort_order) задає порядок сортування сторінок у списку (зменшуючий, зростаючий).

include— дозволяє відображати у списку лише вказані сторінки (ID).

exclude— дозволяє виключити зі списку зазначені сторінки (ID).

child_of— виведення списку сторінок нащадків певної сторінки (вказується ID батьківської сторінки).

title_li- Задає заголовок списку сторінок.

А тепер наведу кілька прикладів використання функції wp_list_pagesдля виведення списку сторінок

Приклад 1. Виведення списку всіх сторінок

Приклад 2. Виведення списку всіх сторінок (сортування за назвою сторінки, за абеткою)

Приклад 3. Виведення списку всіх сторінок, крім сторінок з ID=3,5,7. Заголовок списку — 'Мої сторінки'

Мої сторінки");?>

Приклад 4. Виведення списку сторінок з ID=5,10 із сортуванням за спаданням

Удачі всім!

А ті знавці Wordpress, які люблять гаджети можуть купити Nokia Lumia 920 і почати освоювати Windows Phone 8.

Виводить список постійних сторінок як посилань.

Зазвичай використовується у файлах header.php (шапка сайту) або sidebar.php (бічна панель) для створення меню.

Також дивіться дуже схожу функцію wp_page_menu() ;

Альтернативою створення меню є функція wp_nav_menu() , додана з версії 3.0. Мануал.

✈ 1 раз = 0.014449с = гальмо| 50000 разів = 213.16с = гальмо| PHP 7.1.2, WP 4.7.3

Хуки з функції

Використання

Шаблон використання

$args = array("depth" => 0, "show_date" => "", "date_format" => get_option("date_format"), "child_of" => 0, "exclude" => "", "exclude_tree" => "", "include" => "", "title_li" => __("Pages"), "echo" => 1, "authors" => "", "sort_column" => "menu_order, post_title" , "sort_order" => "ASC", "link_before" => "", "link_after" => "", "meta_key" => "", "meta_value" => "", "number" => "", "offset" => "", "walker" => "", "post_type" => "page", // з функції get_pages()); wp_list_pages($args);

Крім параметрів нижче, функція може приймати ті самі параметри як і get_pages() , тому що вона працює на її основі.

Depth (число)

Цей параметр контролює рівень вкладеності дочірніх сторінок, які будуть включені до списку. За замовчуванням 0 (показати всі дочірні сторінки, включаючи подвійну та більше вкладеність).

0 (за замовчуванням) Увімкніть у списку всі рівні вкладених сторінок і показуйте їх у деревоподібному вигляді.
-1 Включити до списку всі рівні вкладених сторінок, але не показувати вкладеність (древоподібне відображення списку вимикається, список буде показаний як загальний).
1 Показати лише перші вкладені сторінки, тобто. дочірні сторінки першого рівня.
2, 3 і т.д. Включити до списку дочірні сторінки 2, 3 тощо. рівня…

За замовчуванням: 0

Show_date (рядок)

Показує дату створення або зміни сторінки, поряд із посиланням. За промовчанням показ дат вимкнено.

"" - не відображати дати (за замовчуванням).
modified – показувати дату зміни.
created – показувати дату створення сторінки.

Типово: null

Date_format (рядок)Контролює, у якому вигляді буде показана дата, якщо включений параметр show_date , наприклад, d/m/Y виведе: 10/11/2011
За замовчуванням: налаштування дати WordPress child_of (число)Показувати лише дочірні сторінки окремої сторінки, зазначеної у цьому параметрі. Вказувати потрібно ID сторінки, підсторінки якої хочемо вивести. За промовчанням 0 - відображати всі сторінки.
За замовчуванням: 0 exclude (рядок)У цьому параметрі вказуємо через кому ID сторінок, які ми хочемо, щоб потрапили до списку, наприклад: exclude=3,7,31 .
За замовчуванням: "" exclude_tree (рядок)Вкажіть через кому ID батьківський сторінок, які ви хочете виключити зі списку. Також будуть виключені всі вкладені (дочірні сторінки) вказаних ID. Тобто. цей параметр виключає зі списку дерево сторінок.
Доданий до версії 2.7.
За замовчуванням: "" include (рядок/масив)

Показати лише вказані сторінки. ID можна вказати через кому або пропуск у вигляді рядка: include=45 63 78 94 128 140 .

Цей параметр скасовує параметри, що стосуються формування списку, оскільки він створює список лише з тих сторінок, які вказані. Скасовуються параметри: exclude , child_of , depth , meta_key , meta_value , authors .
За замовчуванням: ""

Title_li (рядок)Заголовок списку. Типово: __("Pages") __("") потрібно для локалізації. Якщо обнулити цей параметр (""), то заголовок списку не буде показуватися, так само будуть видалені HTML теги, що обрамляють список ().
Типово: __("Pages") echo (логічний)Виводити результат на екран (true) чи повертати для обробки (false).
Типово: true authors (рядок)Показати сторінки, що належать лише вказаним у цьому параметрі авторам. Вказувати потрібно ID авторів, через кому.
За замовчуванням: "" sort_column (рядок)

Сортувати список за вказаними полями. За замовчуванням список сортується за заголовками (post_title) за абеткою. Можна вказувати кілька параметрів через кому, відповідно до яких потім буде відсортовано список.

post_title - сортувати за заголовком (в алфавітному порядку);
menu_order - сортувати за порядком, що вказується на адмін-панелі на сторінці редагування "постійної сторінки";
post_date - сортувати за датою створення "постійної сторінки";
post_modified – сортувати за датою зміни сторінки;
ID – сортувати за ідентифікатором запису у Базі Даних (за ID);
post_author – сортувати за ID авторів;
post_name - сортувати в алфавітному порядку за альтернативним ім'ям посту (зазвичай транслітерація заголовка).

Типово: "menu_order, post_title"

Sort_order (рядок)Напрямок сортування: "ASC" - по порядку, "DESC" - у зворотному порядку.
Типово: "ASC" link_before (рядок)Вкажіть текст або HTML код, який буде вставлено перед текстом посилання (всередині тега ). Доданий до версії 2.7.
За замовчуванням: "" link_after (рядок)Вкажіть текст або HTML код, який буде вставлено після тексту посилання (всередині тега ). Доданий до версії 2.7.
За замовчуванням: "" meta_key (рядок)Виводить сторінки, які мають лише вказані довільні поля (працює лише разом із параметром meta_value).
За замовчуванням: "" meta_value (рядок)Виведе сторінки, які мають лише вказані значення довільних полів (ключ довільного поля обов'язково вказувати в параметрі meta_key).
За замовчуванням: "" number (число)Обмеження кількості посилань у списку (SQL LIMIT). У деяких випадках може не працювати.
За замовчуванням: ні offset (число)Верхній відступ списку. Наприклад, якщо вказати 5, то перші 5 посилань, які мали б бути показані не буде показано у списку.
Доданий до версії 2.8.
За замовчуванням: ні item_spacing (рядок)Залишати чи ні перенесення рядків у HTML коді меню. Можливо: preserve або discard . C WP 4.7.
Типово: "preserve" walker (рядок) php Клас, який обробляє побудову списку.
За замовчуванням: ""

Приклади

#1 Видалення або зміна заголовка списку

#1.1 Видалимо заголовок списку, скасувавши параметр title_li.

Майте на увазі, що теги ul також будуть видалені і їх потрібно вказувати окремо:

#1.2. Змінимо заголовок

Змінимо заголовок на "Поети", обернемо його в HTML тег

і виведемо у списку тільки постійні сторінки з ID 9, 5 та 23:

" . __("Poetry") . "

"); ?>

#2 Сортування списку сторінок

#2.1 Відсортуємо список відповідно до порядкових номерів, вказаних на сторінці редагування "постійних сторінок":

#2.2 Використовуючи цей код, ми приберемо заголовок "Сторінки" у списку:

#2.3 Тепер виведемо список відсортований за датою створення "постійної сторінки" та покажемо дату поряд з кожним посиланням:

#3 Виключення та включення сторінок

#3.1 Використовуючи параметр excludeвиключимо сторінки з ID 17,38:

#3.2 Використовуючи параметр include, створимо список тільки зі сторінок в ID 35, 7, 26 та 13:

" . __("Pages") . ""); ?>

#4 Виведення дочірніх сторінок

#4.1 Виведемо список дочірніх сторінок

Використовуючи наступний приклад, можна вивести в сайдбарі (або деінде) список дочірніх сторінок (підсторінок), постійної сторінки на який ви зараз перебуваєте. Для цього скористаємося параметром child_ofі перевіркою чи існують взагалі дочірні сторінки для поточної (спробуємо отримати дочірні сторінки в змінну $children, якщо вийде, виведемо список):

ID."&echo=0"); if ($children) (?>

#4.2. Статичний список дочірніх сторінок

post_parent) $children = wp_list_pages("title_li=&child_of=".$post->post_parent."&echo=0"); else $children = wp_list_pages("title_li=&child_of=".$post->ID."&echo=0"); if ($children) (?>

Цей приклад можна використовувати в бічній панелі (сайдбарі), однак потрібно розуміти, що він перевіряє спочатку наявність батьківської сторінки у поточній, якщо вона існує, то виводиться список однорівневих сторінок, якщо батьківської сторінки немає, то виводиться список дочірніх сторінок. Таким чином, ми матимемо на всіх сторінках замкнутий список для сторінок верхнього рівня.

#4.3. Альтернативний варіант попереднього коду. Цей приклад також можна використовувати у сайдбарі, він виводитиме:

коли ви перебуваєте на головній сторінці, будуть показані всі "постійні сторінки" верхнього рівня;

коли ви знаходитесь на "постійній сторінці" верхнього рівня, яка не має дочірніх сторінок, будуть показані ті самі "постійні сторінки" верхнього рівня;

коли ви знаходитесь на "постійній сторінці" верхнього рівня, яка має дочірні сторінки, будуть показані ці дочірні сторінки та їх дочірні сторінки;

коли ви знаходитесь на дочірній сторінці "постійної сторінки" верхнього рівня (на сторінці другого рівня), будуть показані дочірні сторінки "постійної сторінки" верхнього рівня (тобто дочірні сторінки батьківської).

Сторінки верхнього рівня"); if (is_page()) ( $page = $post->ID; if ($post->post_parent) ( $page = $post->post_parent; ) $children=wp_list_pages("echo=0&child_of=" ). $page . "&title_li="); if ($children) ( $output = wp_list_pages ("echo=0&child_of=" ).

Child Pages

"); ) ) echo $output; ?>

#4.4 Список сторінок тільки якщо він є

Список дочірніх сторінок, який буде показаний, лише якщо "постійна сторінка" має дочірні сторінки. Дочірні сторінки будуть показані як на батьківській "постійній сторінці", так і на самих дочірніх сторінках. Відмінністю від попереднього прикладу є наявність назви батьківської "постійної сторінки" в заголовку списку:

post_parent) ( $children = wp_list_pages("title_li=&child_of=".$post->post_parent."&echo=0"); $titlenamer = get_the_title($post->post_parent); ) else ( $children = wp_list_pages("title_li =&child_of=".$post->ID."&echo=0"); $titlenamer = get_the_title($post->ID); ) if ($children) ( ?>

#4.5 Як отримати всі дочірні сторінки, на "постійних сторінках" будь-якого рівня вкладеності:

post_parent)( // отримаємо дочірні сторінки, для "постійної сторінки" верхнього рівня $children = wp_list_pages("title_li=&child_of=".$post->ID."&echo=0"); )else( // отримаємо дочірні сторінки, якщо ми знаходимося на дочірній сторінці першого рівня: //$children = wp_list_pages("title_li=&child_of=".$post->post_parent."&echo=0"); першої сторінки (старшої) // wp збирає ID у зворотному порядку, тому "перша" сторінки буде останньою $ancestors = end($post->ancestors); $children = wp_list_pages("title_li=&child_of=".$ancestors." &echo=0"); // все, тепер у нас завжди буде список зі всіх дочірніх сторінок, // на якому рівні вкладеності ми б не знаходилися. ) ) if ($children) ( ?>

#4.6 Дерево дочірніх сторінок вказаної "постійної сторінки"

Тому що немає можливості вказати wp_list_pagesвиводити дерево (усі рівні вкладеності) сторінок певної сторінки (наприклад, сторінки з ID 93), то для такого трюку ми можемо скористатися функцією get_pages() :

ID; $args=array("title_li" => "Дерево батьківської сторінки: " . $parent, "include" => $parent . "," . implode(",", $pageids)); wp_list_pages($args); ) ?>

#5 Маркування та Стилізація списків постійних сторінок

За замовчуванням, wp_list_pages()створює список такої конструкції:

Сторінки

...

Якщо ми приберемо заголовок, поставивши порожній параметр title_li=, то вигляд стане таким:

...

Інакше можна написати так:

Сторінки

[Батько поточної сторінки]
- [поточна сторінка]
[інші сторінки]

Усі теги li створювані функцією wp_list_pages()позначені CSS класом page_item. Коли у списку з'являється сторінка, на який ви знаходитесь, до li елементу списку додається ще клас current_page_parent .

Таким чином, список можна "розфарбовувати" наступними селекторами CSS:

Pagenav ( … ) /* головний клас ul тега, який обертає весь список */ .page-item-2 ( … ) /* елемент, що відноситься до сторінки з ID 2 */ .page_item ( … ) /* будь-який елемент списку */ . current_page_item ( … ) /* поточна сторінка */.

Щоб досягти глобального впливу на елементи списку, використовуйте такі селектори:

Pagenav ul ul, pagenav .current_page_item ul ul, .pagenav .current_page_ancestor ul ul, .pagenav .current_page_ancestor .current_page_item ul ul, .pagenav .current_page_ancestor .current_page_ancestor ul. ul, .pagenav . current_page_ancestor ul, .pagenav .current_page_ancestor .current_page_item ul, .pagenav .current_page_ancestor .current_page_ancestor ul, .pagenav .current_page_ancestor .current_page_ancestor . _page_ancestor ul ( display: block; )

#6. Список родинних або дочірніх сторінок до поточної

post_parent)( // збираємо родинні сторінки $relations = get_post_ancestors($post->ID); // отримуємо дочірні сторінки (якщо є) $result = $wpdb->get_results("SELECT ID FROM wp_posts WHERE post_parent = $post-> ID AND post_type="page""); // якщо дочірні сторінки цієї сторінки вдалося // отримати об'єднуємо їх з родинними if ($result)( foreach($result as $pageID)( array_push($relations, $pageID->ID) ); ) ) // додаємо поточну сторінку до родинних array_push($relations, $post->ID);// робимо список ID розділений комами з родинних, дочірніх і поточної $relations_string = implode(",",$relations); / / отримуємо список за допомогою параметра include $sidelinks = wp_list_pages("title_li=&echo=0&include=".$relations_string); ) // якщо це не дочірня сторінка else ( // показуємо тільки дочірні сторінки один рівень $sidelinks = wp_list_pages("title_li =&echo=0&depth=1&child_of=". $post->ID); ) if($sidelinks)( ?>

тегах echo $sidelinks; ?>

#7 Використання довільного типу записів (відмінного від page)

Якщо на сайті створено довільний тип записів із деревоподібною структурою, то wp_list_pages()можна використовувати для виведення таких записів.

В цілому всі вищеописані приклади підійдуть і для цього випадку, єдине потрібно змінювати тип запису, з яким працюватиме функція.

Тип запису вказується у параметрі post_type:

Wp_list_pages(array("post_type"=>"portfolio", "title_li"=>__("Portfolio"))));

нотатки

З версії 2.7 додані параметри: link_before, link_after та exclude_tree.
З версії 2.8 додано параметри: number та offset.

Хочете отримати справді живих передплатників на канал у Телеграмі, але не знаєте де це зробити? Переходьте за посиланням та купуйте необхідний ресурс за неймовірно дешевими цінами. Також Вам будуть доступні оптові знижки для швидкого та ефективного просування каналу.