Функция get_previous_post_link() в WordPress предназначена для получения ссылки на предыдущий пост, который идет перед текущим постом. Эта функция помогает пользователям удобно перемещаться по контенту сайта и улучшает навигацию.
get_previous_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 (string, необязательный): Формат анкора ссылки. По умолчанию —
%title, что означает, что в ссылке будет отображаться заголовок поста. - $in_same_term (bool, необязательный): Определяет, должен ли предыдущий пост находиться в той же таксономии, что и текущий пост. По умолчанию —
false. - $excluded_terms (int[]|string, необязательный): Массив или строка с ID терминов, которые следует исключить из выборки. По умолчанию — пустая строка.
- $taxonomy (string, необязательный): Название таксономии, если установлен параметр
$in_same_term. По умолчанию —'category'.
Возвращаемое значение
Функция возвращает строку, содержащую HTML-код ссылки на предыдущий пост. Если предыдущего поста нет, возвращается пустая строка.
Пример 1: Вывод ссылки на предыдущий пост
Для начала, рассмотрим простой пример получения ссылки на предыдущий пост:
// Получаем ссылку на предыдущий пост
echo get_previous_post_link();
// Выводит: « <a href="http://example.com/previous-post" rel="prev">Предыдущий пост</a>
Пример 2: Ссылка на предыдущий пост из текущей рубрики
Если вы хотите получить ссылку на предыдущий пост, который находится в той же категории, что и текущий пост, используйте следующий код:
// Получаем ссылку на предыдущий пост из текущей рубрики
echo get_previous_post_link('%link', '← %title', true);
// Выводит: <a href="http://example.com/previous-in-category" rel="prev">← Предыдущий пост в категории</a>
Пример 3: Ссылка на предыдущий пост из пользовательской таксономии
Если вам необходимо получить ссылку на предыдущий пост из пользовательской таксономии, например, my_custom_tax, вы можете сделать это следующим образом:
// Получаем ссылку на предыдущий пост из пользовательской таксономии
echo get_previous_post_link('%link', '%title →', true, '', 'my_custom_tax');
// Выводит: <a href="http://example.com/previous-post-in-my-tax" rel="prev">Предыдущий пост из my_custom_tax →</a>
Пример 4: Исключение определенных категорий
Если нужно исключить определенные категории из выборки, это можно сделать следующим образом:
// Получаем ссылку на предыдущий пост, исключая категории с ID 3 и 7
$excluded_terms = '3,7'; // Идентификаторы терминов для исключения
echo get_previous_post_link('%link', '%title →', false, $excluded_terms);
// Выводит: <a href="http://example.com/another-previous-post" rel="prev">Другой предыдущий пост →</a>
Заключение
Функция get_previous_post_link() — это полезный инструмент для навигации между записями в WordPress. Она позволяет быстро создавать ссылки на предыдущие посты, что значительно улучшает пользовательский опыт. Благодаря множеству параметров, вы можете настроить отображение ссылок так, как вам необходимо, будь то по категориям, пользовательским таксономиям или с исключениями для определенных терминов.