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

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

Как работает NEXT_POSTS_LINK()

Функция next_posts_link() использует другую функцию под названием get_next_posts_link(), которая делает всю основную работу. Эта функция не имеет дополнительных хуков.

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

Функция возвращает null, то есть ничего не выводит, если нет следующей страницы.

Использование функции

Для того чтобы использовать функцию, нужно вызвать её с двумя параметрами:

next_posts_link( $label, $max_page );

• $label (string) — это текст, который будет отображаться на ссылке. По умолчанию это значение равно null.
• $max_page (int) — максимальное количество страниц.

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

Пример 1: Отображение ссылки на следующую страницу

Этот код выведет ссылку на следующую страницу с записями без текста на кнопке.

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

В этом примере текст ссылки на следующую страницу будет "Далее", а 0 использует значение по умолчанию для максимального количества страниц.

Пример 3: Использование в цикле WP_Query

Если вы используете WP_Query для выборки записей, добавьте параметр $max_page:

// Устанавливаем параметр "paged" (используйте 'page', если запрос на статической главной странице)
$paged = get_query_var( 'paged' ) ?: 1;

// Выполняем запрос
$the_query = new WP_Query( [
    'cat'   => 1, // ID категории
    'paged' => $paged // Текущая страница
] );

if ( $the_query->have_posts() ) {
    while ( $the_query->have_posts() ) {
        $the_query->the_post();
        the_title(); // Отображаем заголовок записи
    }

    // Использование next_posts_link() с max_num_pages.
    next_posts_link( __( 'Старее', 'textdomain' ), $the_query->max_num_pages );
    previous_posts_link( __( 'Новее', 'textdomain' ) );

    // Очистка данных после запроса и пагинации.
    wp_reset_postdata(); 
} else {
    ?>
    

    

function next_posts_link( $label = null, $max_page = 0 ) {
    echo get_next_posts_link( $label, $max_page );
}