Функция get_previous_posts_link() в WordPress

Функция get_previous_posts_link() позволяет получить ссылку на предыдущую страницу записей на сайте, сделанном с помощью WordPress. Это полезно, если у вас есть несколько страниц со статьями, и вы хотите добавить навигацию для удобства пользователей.

Как это работает

Функция проверяет, какую страницу вы сейчас просматриваете, и если это не одиночная запись (например, страница с одной статьей), а также если вы находитесь на второй или более страницах, функция создаст ссылку на предыдущую страницу.

Возвращаемое значение

Функция возвращает строку (HTML-код) со ссылкой на предыдущую страницу. Если ссылки нет, то возвращается значение null.

Синтаксис

get_previous_posts_link( $label );

Параметры

• $label (строка) — текст для ссылки на предыдущую страницу. По умолчанию: null, что означает, что будет использован стандартный текст «Предыдущая страница».

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

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

$prev = get_previous_posts_link();
echo $prev;

Этот код сохранит ссылку на предыдущую страницу записей в переменную $prev и затем выведет её.

Пример 2: Удаление лишних слешей из ссылок

Если вы используете ссылки без окончательных слешей, добавьте следующий фильтр в файл функций вашей темы, чтобы убрать лишние слеши из сгенерированных ссылок:

add_filter( 'get_pagenum_link', 'user_trailingslashit' );

Замечания

• Глобальная переменная $paged используется для отслеживания текущей страницы.

История изменений

Функция get_previous_posts_link() была введена в версии 2.7.0.

Код функции

Вот как выглядит код функции get_previous_posts_link():

function get_previous_posts_link( $label = null ) {
global $paged;

if ( null === $label ) {
    $label = __( '« Предыдущая страница' );
}

if ( ! is_single() && $paged > 1 ) {
    /**
     * Фильтрует атрибуты для тега ссылки на предыдущую страницу записей.
     *
     * @since 2.7.0
     *
     * @param string $attributes Атрибуты для тега ссылки.
     */
    $attr = apply_filters( 'previous_posts_link_attributes', '' );

    return sprintf(
        '%3$s',
        previous_posts( false ),
        $attr,
        preg_replace( '/&([^#])(?![a-z]{1,8};)/i', '&$1', $label )
    );
}

}

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

Вот несколько функций, которые могут быть полезны вместе с get_previous_posts_link():

• get_next_posts_link() — получает ссылку на следующую страницу записей.
• get_previous_comments_link() — получает ссылку на предыдущие комментарии.
• get_the_author_posts_link() — получает ссылку на все записи автора.

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

Теперь у вас есть все необходимые знания, чтобы использовать функцию get_previous_posts_link() в вашем проекте на WordPress!