Функция get_next_post_link() в WordPress предоставляет ссылку на следующий пост, который идет после текущего поста в указанной таксономии. Это полезный инструмент для навигации между постами и улучшения пользовательского опыта на сайте.
get_next_post_link( string $format = '%link »', string $link = '%title', bool $in_same_term = false, int[]|string $excluded_terms = '', string $taxonomy = 'category' ): string
Параметры
- $format (string, необязательный): Формат ссылки. По умолчанию —
'%link »', где%linkбудет заменен на HTML-код ссылки. - $link (string, необязательный): Формат анкора ссылки. По умолчанию —
'%title', где%titleбудет заменен на заголовок записи. - $in_same_term (bool, необязательный): Определяет, должна ли ссылка находиться в том же таксономическом термине, что и текущий пост. По умолчанию —
false. - $excluded_terms (int[]|string, необязательный): Массив или строка с ID терминов, которые нужно исключить из выборки. По умолчанию — пустая строка.
- $taxonomy (string, необязательный): Название таксономии, если установлен параметр
$in_same_term. По умолчанию —'category'.
Возвращаемое значение
Функция возвращает HTML-код ссылки на следующий пост, если такой пост существует, или пустую строку, если подходящей записи нет.
Пример 1: Ссылка на следующий пост
В этом примере мы получаем ссылку на следующий пост относительно текущего.
// Выводим ссылку на следующий пост
echo get_next_post_link();
// Например: <a href="http://example.com/some" rel="next">Что-то</a> »
Пример 2: Ссылка на следующий пост из текущей категории
В этом примере мы получаем ссылку на следующий пост, находящийся в той же категории, что и текущий.
// Выводим ссылку на следующий пост из текущей категории
echo get_next_post_link('%link', '%title →', true);
// Например: <a href="http://example.com/some" rel="next">Что-то →</a>
Пример 3: Ссылка на следующий пост из пользовательской таксономии
В этом примере мы получаем ссылку на следующий пост из пользовательской таксономии, например, my_tax.
// Выводим ссылку на следующий пост из пользовательской таксономии
echo get_next_post_link('%link', '%title →', true, '', 'my_tax');
// Например: <a href="http://example.com/some" rel="next">Что-то →</a>
Пример 4: Добавление собственного класса к ссылке
Если вы хотите добавить свой класс к ссылке на следующий пост, вы можете использовать следующий код:
// Добавляем класс к ссылке на следующий пост
$next = get_next_post_link('%link', 'Следующий пост', true);
echo str_replace('<a ', '<a class="my-custom-class" ', $next);
// Аналогично для предыдущего поста
$prev = get_previous_post_link('%link', 'Предыдущий пост', true);
echo str_replace('<a ', '<a class="my-custom-class" ', $prev);
Заключение
Функция get_next_post_link() в WordPress позволяет легко создавать навигационные ссылки между постами, улучшая пользовательский опыт на сайте. С ее помощью вы можете настраивать ссылки на основе текущей категории или таксономии, а также добавлять пользовательские классы для стилизации ссылок.