Получение навигации между записями в WordPress (GET_THE_POST_NAVIGATION())

Функция get_the_post_navigation() используется для получения HTML-ссылок на предыдущую и следующую записи в WordPress. Она применяется на странице отдельной записи (например, в случае функции is_singular()).

Для чего это нужно?

Эта функция позволяет создать навигацию между записями, что может быть полезно, например, для перемещения между вложениями (картинками, которые прикреплены к записям).

Ранее, до версии 4.1, для отображения ссылок на предыдущую и следующую записи вам приходилось использовать функции get_next_post_link() и get_previous_post_link(). Функция get_the_post_navigation() является оберткой для этих функций.

Чтобы сразу вывести навигацию на экран, используйте функцию the_post_navigation().

Возвращаемое значение

Функция get_the_post_navigation() возвращает строку с HTML-разметкой для ссылок на записи.

Использование функции

Синтаксис

get_the_post_navigation( $args );

Параметры

Функция принимает один параметр — массив $args. По умолчанию это пустой массив. Вот основные аргументы, которые можно использовать:

• prev_text (string): текст ссылки на предыдущую запись. По умолчанию: '%title'
• next_text (string): текст ссылки на следующую запись. По умолчанию: '%title'
• in_same_term (true|false): указывает, должна ли ссылка быть в той же категории. По умолчанию: false
• excluded_terms (int[]|string): массив или список ID исключённых категорий. По умолчанию: ''
• taxonomy (string): тип таксономии, если $in_same_term установлен в true. По умолчанию: category
• screen_reader_text (string): текст для экранных читалок. По умолчанию: 'Навигация по записям'
• aria_label (string): ARIA-метка для элемента навигации. По умолчанию: 'Записи'
• class (string): пользовательский класс для элемента навигации. По умолчанию: 'post-navigation'

Примеры использования

Пример 1: Навигация между записями

Этот пример показывает, как вывести ссылки на предыдущие и следующие записи на странице записи с помощью is_single().

// Получаем ссылки на предыдущую и следующую записи
$post_nav = get_the_post_navigation( array(
    'prev_text' => 'Назад ' .
        'Предыдущая запись ' .
        '%title',
    'next_text' => 'Вперёд ' .
        'Следующая запись ' .
        '%title',
) );

echo $post_nav;

Этот код создаёт следующий HTML:

Пример 2: Добавление атрибута title к ссылкам

Этот пример демонстрирует, как добавить атрибут title ко всем ссылкам в блоке. Значение будет содержать название записи и предшествующее слово "Смотрите: ".

add_filter( 'next_post_link', 'add_title_adjacent_post_link', 10, 4 );
add_filter( 'previous_post_link', 'add_title_adjacent_post_link', 10, 4 );

function add_title_adjacent_post_link( $output, $format, $link, $post ){
    $title = esc_attr( 'Смотрите: '. $post->post_title );
    return str_replace( '