Пагинация WooCommerce не работает: причины и решение

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

Пагинация в WooCommerce — важный элемент удобства навигации по каталогу товаров. Если после обновления темы, плагинов или кастомных правок пагинация перестала работать, необходимо точно определить источник проблемы. Чаще всего пагинация не работает по следующим причинам:

• Конфликты с темой или плагинами, переопределяющими запросы WP_Query для товаров.
• Ошибки в параметрах запроса при использовании pre_get_posts или кастомных WP_Query.
• Неправильная настройка постоянных ссылок (Permalinks).
• Кэширование страниц без учёта параметров пагинации.
• Использование нестандартных шаблонов WooCommerce без поддержки пагинации.

Проверка текущей конфигурации

Для начала проверьте, не возникает ли ошибка 404 при переходе на страницы пагинации, и корректно ли отображаются ссылки пагинации (в URL должен присутствовать параметр paged или номер страницы в ЧПУ).

Откройте консоль браузера и проверьте HTTP-статус страницы пагинации — должен быть 200, а не 404 или редирект.

Пошаговое решение проблемы с пагинацией WooCommerce

1. Проверка и сброс постоянных ссылок

Перейдите в Настройки > Постоянные ссылки в админке WordPress и нажмите «Сохранить изменения» без изменений. Это сбросит правила перезаписи и часто решает проблему 404 на страницах пагинации.

2. Проверка кастомных фильтров WP_Query

Если в теме или плагинах есть хук pre_get_posts, который изменяет запрос для главной страницы или архива товаров, убедитесь, что он не сбрасывает параметр paged. Пример правильного кода:

add_action('pre_get_posts', function($query) {
    if (!is_admin() && $query->is_main_query() && (is_shop() || is_product_category() || is_product_tag())) {
        // Не забудьте сохранить номер страницы
        $paged = get_query_var('paged') ? get_query_var('paged') : 1;
        $query->set('paged', $paged);
        // Пример: изменить количество товаров на странице
        $query->set('posts_per_page', 12);
    }
});

Обратите внимание, что если в коде параметр paged не устанавливается, пагинация работать не будет.

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

Убедитесь, что в шаблоне каталога товаров вызывается функция woocommerce_pagination(), которая корректно выводит навигацию по страницам.

<?php woocommerce_pagination(); ?>

Если в теме используется собственный вывод пагинации, попробуйте заменить его на стандартный для проверки.

4. Отключение конфликтующих плагинов и кэша

Временно отключите плагины кеширования (например, WP Super Cache, W3 Total Cache) и любые плагины, связанные с пагинацией, чтобы исключить влияние кэша.

5. Проверка шаблонов WooCommerce

Если вы переопределяли шаблоны WooCommerce в теме (папка woocommerce), проверьте, что файл archive-product.php и другие шаблоны правильно реализуют цикл и пагинацию.

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

• Откройте страницу каталога товаров и перейдите на вторую и последующие страницы.
• Проверьте URL: должен содержать номер страницы, например, /shop/page/2/.
• Убедитесь, что отображаются товары именно той страницы, на которую вы перешли.
• Проверьте HTTP-статус страницы — он должен быть 200, а не 404.
• Если есть AJAX пагинация, проверьте обновление контента без перезагрузки.

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

• Пагинация всегда возвращает первую страницу
  Причина: игнорирование параметра paged в запросах. Решение: обязательно получить и задать paged в pre_get_posts.
• Пагинация ведёт на 404
  Причина: неправильные правила перезаписи. Решение: сбросить постоянные ссылки, проверить .htaccess.
• Пагинация не отображается
  Причина: отсутствие вызова woocommerce_pagination() или кастомный шаблон без поддержки. Решение: использовать стандартный вывод пагинации.
• Кэш страниц ломает пагинацию
  Причина: кэшируется страница без учёта параметров. Решение: настроить исключения для страниц пагинации в плагинах кэширования.

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

• При использовании pre_get_posts не обращайтесь к базе напрямую — используйте стандартные методы WP_Query.
• Минимизируйте количество товаров на странице для снижения нагрузки.
• Настройте кэширование с исключением страниц пагинации WooCommerce, чтобы избежать показа устаревших данных.
• Используйте child-тему для кастомизаций, чтобы не потерять изменения при обновлении темы.

Сравнение подходов к решению проблемы пагинации WooCommerce