Как исправить ошибку 404 при пагинации WooCommerce с кастомными WP_Query

Диагностика ошибки 404 при пагинации WooCommerce с кастомными WP_Query

Ошибка 404 при переходе по страницам пагинации WooCommerce возникает чаще всего из-за неправильной обработки параметра paged в кастомных WP_Query. В WooCommerce пагинация тесно связана с глобальными переменными и запросом WordPress, и если не учитывать специфику WooCommerce, пагинация ломается.

Типичные симптомы:

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

Причина в том, что WooCommerce использует собственный запрос, а кастомные WP_Query требуют правильной инициализации параметров и синхронизации с глобальным запросом.

Пошаговое решение: правильная настройка пагинации с WP_Query в WooCommerce

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

Используйте следующий код для определения параметра paged, учитывая как стандартный, так и WooCommerce подход:

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

2. Настроить WP_Query с параметром paged

Пример правильного создания кастомного запроса с пагинацией в WooCommerce:

$args = array(  
    'post_type' => 'product',  
    'posts_per_page' => 12,  
    'paged' => $paged,  
    // можно добавить дополнительные параметры фильтрации  
);

$custom_query = new WP_Query($args);

3. Правильно выводить пагинацию

После цикла выводите пагинацию, используя функции WooCommerce или WordPress, например:

echo paginate_links( array(  
    'total' => $custom_query->max_num_pages,  
    'current' => $paged,  
    'format' => '?paged=%#%',  
    'prev_text' => '«',  
    'next_text' => '»',
) );

4. Сброс глобальных данных после кастомного цикла

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

wp_reset_postdata();

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

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

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

• Ошибка: Не учитывается параметр paged или page.
  Решение: использовать max(1, get_query_var('paged'), get_query_var('page')) для корректного определения номера страницы.
• Ошибка: Не сброшен глобальный запрос после WP_Query.
  Решение: всегда вызывать wp_reset_postdata() после кастомного цикла.
• Ошибка: Использование query_posts() для пагинации, что ломает глобальный запрос.
  Решение: избегать query_posts(), использовать WP_Query и правильные хуки.
• Ошибка: Неправильный формат ссылки пагинации.
  Решение: использовать параметр format в paginate_links(), например 'format' => '?paged=%#%' или соответствующий структуре постоянных ссылок.

Практические советы по безопасности и производительности

• Не запрашивайте слишком большое количество товаров за один раз — оптимально 10-20 на страницу, чтобы не перегружать сервер.
• Кешируйте результаты WP_Query при больших объемах данных, используя transient API или внешние решения кеширования.
• Избегайте выполнения WP_Query в хуках, которые выполняются слишком часто, чтобы не ухудшать производительность.
• Проверяйте права доступа при выводе товаров, если используется пользовательская логика ограничения видимости.

Сравнение способов реализации пагинации с кастомным WP_Query в WooCommerce