Функция the_post_navigation() в WordPress

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

Что такое the_post_navigation()?

Эта функция объединяет две другие функции — next_post_link() и previous_post_link() — чтобы сделать навигацию между постами более удобной. С её помощью можно быстро вставить блок навигации между соседними статьями.

Чтобы получить HTML-код для навигации, используется функция get_the_post_navigation().

Важно не путать с

Функцией the_posts_navigation(), которая выводит ссылки на следующую и предыдущую страницу с набором постов (например, на странице категории).

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

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

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

Чтобы использовать the_post_navigation(), вы можете написать следующий код в файле шаблона:

<?php the_post_navigation( $args ); ?>

Параметры функции

Функция the_post_navigation() принимает массив параметров $args, которые могут включать:

• $prev_text (string): Текст для ссылки на предыдущий пост. По умолчанию: '%title'.

• $next_text (string): Текст для ссылки на следующий пост. По умолчанию: '%title'.

• $in_same_term (true/false): Указывает, должны ли ссылки быть в одной таксономической категории. По умолчанию: false.

• $excluded_terms (array/string): Массив или список ID таксономических терминов, которые нужно исключить. По умолчанию: ''.

• $taxonomy (string): Указывает таксономию, если $in_same_term равно true. По умолчанию: 'category'.

• $screen_reader_text (string): Текст для экранных считывателей, связанный с элементом навигации. По умолчанию: 'Навигация по постам'.

По умолчанию параметры выглядят так: array().

Пример кода

Вот пример, как вывести ссылки на предыдущий и следующий пост:

<?php
the_post_navigation( array(
'prev_text' => 'Назад ' .
'Предыдущий пост ' .
'%title',
'next_text' => 'Вперёд ' .
'Следующий пост ' .
'%title',
) );
?>

Результат

В результате выполнения данного кода будет сгенерирован следующий HTML-блок:

Изменения

Функция the_post_navigation() была введена с версии 4.1.0.

Связанные функции

Вы также можете использовать другие функции навигации:

• get_adjacent_post_link() – выводит ссылку на соседний пост.
• get_next_post_link() – выводит ссылку на следующий пост.
• get_previous_post_link() – выводит ссылку на предыдущий пост.
• get_the_posts_navigation() – выводит навигацию между страницами постов.

Эти функции помогают улучшить навигацию и доступность контента на вашем сайте WordPress.