the_post_navigation()
Виводить на екран HTML блок посилань на наступний та попередній записи. Використовується на сторінці окремого запису: is_singular() .
Ця функція поєднує одну окремі функції: previous_post_link() . Функція створена для зручності, з нею вставляти блок навігації між сусідніми статтями (записами) можна одним рядком.
Щоб отримати HTML-код для обробки, використовуйте get_the_post_navigation()
Не плутайте з функцією the_posts_navigation() , яка відображає посилання на наступну/попередню сторінку із записами.
get_the_post_navigation()
Хуків немає.
Повертає
null. Нічого. Виводить на екран HTML код.
Використання
the_post_navigation ($ args);
Параметри $args
$args– це масив, який може містити наступні параметри:
-
$prev_text
(рядок) -
Текст, який буде показано, як анкор посилання на попередній запис.
За замовчуванням: %title -
$next_text
(рядок) -
Текст, який буде показано, як анкор посилання на наступний запис.
За замовчуванням: %title -
$screen_reader_text
(рядок) -
Назва блоку навігації для скануючих роботів.
Типово: __( ‘Post navigation’ ) -
$in_same_term
(логічний) -
true, коли потрібно, щоб посилання було з поточного елемента, зазначеного в
taxonomyтаксономії. З версії 4.4.
Типово: false -
$excluded_terms
(рядок/масив) -
ID елементів таксономії, які потрібно виключити. У вигляді масиву або в рядку через кому. З версії 4.4.
За замовчуванням: ” -
$taxonomy
(рядок) -
Назва таксономії, коли
$in_same_term= true. З версії 4.4.
Типово: ‘category’
Приклади
#1 Посилання навігації між постами
Виведемо посилання на наступний та попередній записи (пости) на окремій сторінці типу is_single().
/ / Слід. / Перед. Піст. the_post_navigation( array( 'next_text' => '<span class="meta-nav" aria-hidden="true">Далі</span> ' . '<span class="screen-reader-text">Наступний запис</span> ' . '<span class="post-title">%title</span>', 'prev_text' => '<span class="meta-nav" aria-hidden="true">Назад</span> ' . '<span class="screen-reader-text">Попередній запис</span> ' . '<span class="post-title">%title</span>', )));
В результаті ми отримаємо такий HTML код:
<nav class="navigation post-navigation" role="navigation"> <h2 class="screen-reader-text">Навігація за записами</h2> <div class="nav-links"> <div class="nav-previous"><a href="//example.com/post8/" rel="prev"><span class="meta-nav" aria-hidden="true">Назад</ span> <span class="screen-reader-text">Попередній запис:</span> <span class="post-title">Запис з випадковим номером 81717</span></a> </div> <div class="nav-next"><a href="//example.com/post10/" rel="next"><span class="meta-nav" aria-hidden="true">Далі</ span> <span class="screen-reader-text">Наступний запис:</span> <span class="post-title">Привіт, мир!</span></a> </div> </div> </nav>
Або так це виглядає в дефолній темі twentyfifteen:
список змін
| З версії 4.1.0 | Введено. |
Код the_post_navigation() the post navigation WP 6.0.2
function the_post_navigation( $args = array() ) {
echo get_the_post_navigation ($ args);
}