Функция PREVIOUS_POSTS_LINK() в WordPress: описание, примеры использования, изменения

# Функция PREVIOUS_POSTS_LINK() в WordPress

Функция PREVIOUS_POSTS_LINK() отвечает за отображение ссылки на страницу с предыдущими записями в WordPress.

## Что она делает

Эта функция выводит ссылку на предыдущую страницу записей, если такая существует. Она использует внутреннюю функцию get_previous_posts_link().

## Возврат значения

Функция не возвращает значение (null).

## Как использовать

Чтобы использовать функцию, необходимо вызвать её с текстом ссылки:

```php
previous_posts_link( $label );

где:

• $label (строка) — текст ссылки на предыдущую страницу. По умолчанию значение отсутствует (null).

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

Пример 1: Простая ссылка на предыдущие записи

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

Пример 2: Изменение текста ссылки

Вы можете изменить текст ссылки, например, на «« Назад»:

Пример 3: Проверка наличия ссылки

Перед тем как выводить ссылку, вы можете проверить, существует ли она:

if( get_previous_posts_link() ) {
    previous_posts_link( '« Новые записи' );
}

Изменения в версии

Функция была введена в версии 0.71.

Код функции в WordPress

Вот как выглядит код функции в файле wp-includes/link-template.php:

function previous_posts_link( $label = null ) {
    echo get_previous_posts_link( $label );
}

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

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

• get_next_posts_link() — Ссылка на следующие записи.
• get_next_posts_page_link() — Ссылка на следующую страницу записей.
• get_pagenum_link() — Генерация ссылки на заданную страницу записей.
• get_posts_nav_link() — Ссылка для навигации между записями.
• get_previous_posts_link() — Получает ссылку на предыдущие записи.
• get_previous_posts_page_link() — Ссылка на предыдущую страницу записей.
• next_posts_link() — Ссылка на следующие записи с текстом.
• paginate_links() — Генерация линий пагинации.

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