Как исправить ошибку AJAX при добавлении товара в корзину WooCommerce

Автор: Андрей Карпов | Опубликовано: 01.05.2026

Диагностика проблемы: почему не работает AJAX при добавлении в корзину

Самая распространённая ошибка — при нажатии кнопки «Добавить в корзину» страница не обновляется, корзина не меняется, и в консоли браузера появляется ошибка JavaScript или ответ сервера с ошибкой. Это обычно связано с конфликтами в JavaScript, неправильными настройками темы или плагинов, либо с некорректной работой AJAX-обработчиков WooCommerce.

Как проверить, что именно не так

Откройте консоль браузера (F12 > Console) и посмотрите ошибки JavaScript.
Проверьте вкладку Network на запросы AJAX при клике по кнопке «Добавить в корзину» — они должны возвращать статус 200 и содержать JSON с обновлёнными данными.
Отключите плагины по одному, чтобы выявить конфликт.
Активируйте дефолтную тему (например, Storefront) и проверьте работу AJAX.

Пошаговое решение ошибки AJAX при добавлении товара в корзину

1. Проверка правильности вызова AJAX кнопки

WooCommerce использует класс ajax_add_to_cart для кнопок на страницах архивов и стандартный обработчик для страниц товара. Убедитесь, что в вашей теме кнопка имеет правильные классы и data-атрибуты:

<a href="<?php the_permalink(); ?>" data-quantity="1" class="button product_type_simple ajax_add_to_cart" data-product_id="<?php the_ID(); ?>" aria-label="Добавить “<?php the_title_attribute(); ?>” в корзину" rel="nofollow">Добавить в корзину</a>

Если кнопка — это input или button, нужно использовать правильные классы и добавить JS-обработчик.

2. Подключение скриптов WooCommerce AJAX

Убедитесь, что в вашей теме вызов wp_footer() есть, так как именно там подключаются необходимые JS-скрипты WooCommerce. Если нет, добавьте:

<?php wp_footer(); ?>

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

3. Принудительное подключение скриптов в functions.php

Если скрипты не подгружаются, добавьте в functions.php:

function wplearn_enqueue_woocommerce_ajax() {
    if ( function_exists( 'is_woocommerce' ) && ( is_product() || is_shop() || is_product_category() ) ) {
        wp_enqueue_script( 'wc-add-to-cart' );
    }
}
add_action( 'wp_enqueue_scripts', 'wplearn_enqueue_woocommerce_ajax' );

4. Проверка конфликта с другими плагинами и темами

Отключите все плагины, кроме WooCommerce, и переключитесь на дефолтную тему Storefront. Если AJAX заработал, включайте плагины по одному, чтобы определить виновника.

Как проверить, что ошибка исправлена

Кликните кнопку «Добавить в корзину» на странице товара или архива товара.
Проверьте, что количество товаров в корзине обновилось без перезагрузки страницы.
В консоли браузера не должно быть ошибок JavaScript или AJAX-запросы должны возвращать статус 200 с корректным JSON-ответом.

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

1. Ошибка 400 или 500 на AJAX-запрос

Причина — серверная ошибка или модификации WooCommerce фильтров на сервере. Проверьте логи сервера, отключите кастомный код, который может влиять на обработчик добавления в корзину (например, фильтры на woocommerce_add_to_cart_validation).

2. Отсутствие вызова `wp_footer()` в шаблоне

Без него не работают стандартные скрипты WooCommerce. Добавьте вызов.

3. Конфликт с оптимизацией JS

Многие плагины для оптимизации JavaScript (Autoptimize, WP Rocket и др.) могут объединять и минифицировать скрипты WooCommerce с ошибками. Временно отключите их или исключите скрипт wc-add-to-cart из минификации.

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

Используйте nonce для AJAX-запросов, если добавляете собственные обработчики, чтобы защититься от CSRF.
Кэшируйте страницы, не кэшируйте AJAX-запросы WooCommerce.
Для больших магазинов проверяйте нагрузку на сервер при массовых AJAX-запросах и настройте лимиты.

Сравнение способов решения проблемы AJAX в WooCommerce

Метод	Плюсы	Минусы
Использование стандартных классов WooCommerce (ajax_add_to_cart)	Гарантированная совместимость и простота	Ограничение по кастомизации
Подключение скриптов вручную	Контроль над загрузкой ресурсов	Риск забыть подключить нужные скрипты
Использование сторонних плагинов для AJAX	Дополнительный функционал, расширенные настройки	Могут вызывать конфликты, нагрузку

Исправление ошибки AJAX при добавлении товара в корзину в WooCommerce