Как исправить неработающую пагинацию при комплексных запросах WP_Query в WordPress

Диагностика проблемы неработающей пагинации в WP_Query

Пагинация в WordPress часто ломается при использовании сложных запросов WP_Query с дополнительными параметрами таксономий, мета-записей или кастомных условий. Симптомы: переход по страницам пагинации ведет на 404 или выводит одну и ту же страницу с первыми записями.

Основные причины:

• Неправильное использование параметра paged в запросе.
• Неправильная логика в условии цикла.
• Конфликты с основным запросом (main query) и неправильная перезапись глобальной переменной $wp_query.
• Отсутствие корректного сброса постов после пользовательского запроса.
• Неправильные настройки параметров запроса, влияющие на количество постов или фильтрацию.

Пошаговое решение: правильная пагинация для сложных запросов WP_Query

1. Получение текущей страницы пагинации

Обязательно получайте номер текущей страницы через функцию get_query_var('paged'), учитывая, что на главной странице нужно дополнительно проверять page:

$paged = max( 1, get_query_var('paged'), get_query_var('page') );

2. Правильная установка параметра paged в WP_Query

Передайте полученный номер страницы в аргументы запроса:

$args = array(  
    'post_type' => 'post',
    'posts_per_page' => 10,
    'paged' => $paged,
    // Дополнительные параметры
);  
$query = new WP_Query( $args );

3. Правильный цикл и сброс постов

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

if ( $query->have_posts() ) {
    while ( $query->have_posts() ) {
        $query->the_post();
        // Вывод записи
    }
    wp_reset_postdata();
} else {
    echo 'Записей не найдено';
}

4. Использование правильной функции для вывода пагинации

Для генерации ссылок пагинации используйте paginate_links() с параметром total равным $query->max_num_pages:

echo paginate_links( array(
    'base' => get_pagenum_link(1) . '%_%',
    'format' => 'page/%#%/',
    'current' => $paged,
    'total' => $query->max_num_pages,
    'prev_text' => '« Назад',
    'next_text' => 'Вперед »',
) );

Проверка результата после внедрения

• Переход по страницам пагинации должен корректно менять контент.
• URL пагинации отображается с правильным номером страницы (например, /page/2/).
• При переходе на несуществующую страницу — выводится 404 или пустой результат без дублирования первой страницы.
• В консоли браузера отсутствуют ошибки JavaScript, влияющие на пагинацию.

Частые ошибки и как их исправить

• Ошибка 404 при переходе по страницам: Обычно связано с отсутствием paged в параметрах WP_Query или неверными правилами перезаписи в .htaccess. Решение: убедитесь, что paged корректно передается, и обновите постоянные ссылки в админке.
• Показ одинаковых записей на всех страницах: Параметр paged не используется или его значение всегда 1. Проверьте правильность получения текущей страницы.
• Конфликт с основным запросом: После пользовательского запроса не вызван wp_reset_postdata(). Это приводит к неправильному выводу и пагинации.
• Неверные ссылки пагинации: Неправильный параметр base в paginate_links(). Используйте get_pagenum_link(1) . '%_%' и правильный формат.

Практические советы по оптимизации и безопасности

• Оптимизируйте запросы WP_Query, избегая избыточной выборки — указывайте только необходимые поля через fields для тяжелых запросов.
• Используйте кеширование результата запросов, чтобы снизить нагрузку на базу данных (например, с помощью Transients API).
• Избегайте прямого вывода данных без экранирования, особенно если параметры запроса берутся из URL — используйте esc_url(), absint() для числовых значений.
• При работе с AJAX пагинацией всегда проверяйте nonce и права доступа пользователя.

Сравнение вариантов реализации пагинации для сложных WP_Query запросов