the_post_navigation()
Выводит на экран HTML блок ссылок на следующую и предыдущую записи. Используется на странице отдельной записи: is_singular().
Эта функция объединяет в одну отдельные функции: next_post_link() и previous_post_link(). Функция создана для удобства, с ней вставлять блок навигации между соседними статьями (записями) можно одной строкой.
Чтобы получить HTML код для обработки, используйте get_the_post_navigation()
Не путайте с функцией the_posts_navigation(), которая выводит ссылки на следующую/предыдущую страницу с записями.
Хуков нет.
Возвращает
null
. Ничего (null). Выводит на экран HTML код.
Использование
the_post_navigation( $args );
Параметры $args
$args
- это массив который может содержать следующие параметры:
- $prev_text(строка)
- Текст который будет показан, как анкор ссылки на предыдущую запись.
По умолчанию: '%title' - $next_text(строка)
- Текст который будет показан, как анкор ссылки на следующую запись.
По умолчанию: '%title' - $screen_reader_text(строка)
- Название блока навигации для сканирующих роботов.
По умолчанию: __( 'Post navigation' ) - $in_same_term(логический)
- true, когда нужно, чтобы ссылка была из текущего элемента указанной в
taxonomy
таксономии. C версии 4.4.
По умолчанию: false - $excluded_terms(строка/массив)
- ID элементов таксономии, который нужно исключить. В виде массива или в строке через запятую. C версии 4.4.
По умолчанию: '' - $taxonomy(строка)
- Название таксономии, когда
$in_same_term
= true. C версии 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.7.1
function the_post_navigation( $args = array() ) { echo get_the_post_navigation( $args ); }