Функция get_previous_posts_link() используется в WordPress для создания ссылки на предыдущую страницу постов в контексте пагинации. Это особенно полезно на страницах архивов, таких как главная страница блога, страницы категорий или тегов, где посты разбиты на несколько страниц.
Описание функции
Функция get_previous_posts_link() возвращает HTML-ссылку на предыдущую страницу постов. Она автоматически обрабатывает ссылки в зависимости от текущего контекста и параметров запроса.
get_previous_posts_link( $label = null )Параметры
- $label (string): Текст ссылки. По умолчанию «Newer Posts» (Новые записи).
Возвращаемое значение
- (string|null): HTML-ссылка на предыдущую страницу постов или null, если предыдущая страница недоступна.
Примеры использования
Пример 1. Стандартное использование функции
Этот пример показывает, как использовать get_previous_posts_link() для создания ссылки на предыдущую страницу постов в простейшем виде.
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
// Выводим посты
}
echo '<div class="pagination">';
echo get_previous_posts_link( 'Новые посты' );
echo '</div>';
}Пример 2. Использование с кастомным текстом
В этом примере мы задаем кастомный текст для ссылки.
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
// Выводим посты
}
echo '<div class="pagination">';
echo get_previous_posts_link( 'Назад к новым постам' );
echo '</div>';
}Пример 3. Совместное использование с get_next_posts_link()
Зачастую ссылки на следующую и предыдущую страницы постов используются вместе для реализации полной навигации.
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
// Выводим посты
}
echo '<div class="pagination">';
echo get_previous_posts_link( 'Новые посты' );
echo get_next_posts_link( 'Старые посты' );
echo '</div>';
}Пример 4. Добавление классов CSS для стилизации
Для стилизации ссылки можно добавить классы CSS.
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
// Выводим посты
}
echo '<div class="pagination">';
$prev_link = get_previous_posts_link( 'Новые посты' );
if ( $prev_link ) {
echo '<div class="prev-posts-link">' . $prev_link . '</div>';
}
echo '</div>';
}Заключение
Функция get_previous_posts_link() является простым и эффективным способом добавить навигацию на предыдущую страницу постов на вашем сайте WordPress. Используйте ее в сочетании с get_next_posts_link() для создания полной системы навигации по страницам.