Получение ссылки на следующий пост в WordPress с помощью функции get_next_post_link()
Функция get_next_post_link()
в WordPress позволяет получить ссылку на следующий пост относительно текущего поста по дате. Это полезно, если вы хотите создать навигацию между постами на вашем сайте.
Использование функции
Чтобы получить ссылку на предыдущий пост, вы можете использовать функцию get_previous_post_link()
.
От чего зависит работа функции?
Функция использует другие функции для получения ссылок на соседние посты, такие как get_adjacent_post_link()
. При этом она не имеет хуков (hooks), поэтому вы не можете изменять её поведение через стандартные хуки WordPress.
Возвращаемое значение
Функция возвращает строку:
- HTML ссылки:
Название поста
- Пустую строку, если подходящий пост не найден.
Синтаксис функции
get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
Аргументы функции
-
$format (string): Формат ссылки.
%link
будет заменён на HTML-ссылку. Например,'%link →'
выведет<a ...> →
.- По умолчанию:
'« %link'
- По умолчанию:
-
$link (string): Формат текста ссылки.
%title
будет заменён на название поста.- По умолчанию:
'%title'
- По умолчанию:
-
$in_same_term (bool): Нужна ли ссылка на пост в той же категории.
true
— получить следующий пост из текущей категории. Если пост находится в пользовательской таксономии, нужно указать параметр$taxonomy
.- По умолчанию:
false
- По умолчанию:
-
$excluded_terms (array/string): Массив или список ID категорий, которые нужно исключить. Вы можете указать строку или массив:
'1,5,15'
илиarray(1,5,15)
.- По умолчанию:
''
- По умолчанию:
-
$taxonomy (string): Название таксономии для параметра
$in_same_term
.- По умолчанию:
'category'
- По умолчанию:
Примеры использования
Простой пример
echo get_next_post_link();
// выведет: Что-то →
Ссылка на следующий пост из текущей категории
echo get_next_post_link( '%link', '%title →', 1 );
// выведет: Что-то →
Ссылка на следующий пост из пользовательской таксономии
echo get_next_post_link( '%link', '%title →', 1, '', 'my_tax' );
Добавление собственного класса к ссылкам
Если вам нужно добавить собственный класс к ссылке на следующий или предыдущий пост, вы можете использовать следующий код:
$next = get_next_post_link( '%link', 'следующий пост', true );
echo str_replace( '
Заключение
Функция get_next_post_link()
— это простой и мощный инструмент для создания навигации между постами на вашем сайте WordPress. С её помощью ваши читатели смогут легко перемещаться по контенту, что улучшит общую навигацию и пользовательский опыт.