Цією статтею я познайомлю вас з функцією 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.