В WooCommerce AJAX-обновление корзины удобно до тех пор, пока не начинает ломать сценарии оформления, конфликтовать с темой или дергать лишние скрипты на слабых серверах. Чаще всего проблема проявляется не в самой корзине, а в связке: кастомная тема, сторонний плагин доставки, мини-корзина, кеширование и обработчики событий на фронтенде.
Если задача не в том, чтобы «убрать AJAX вообще», а в том, чтобы вернуть предсказуемое поведение корзины, лучше сначала понять, где именно возникает сбой. В WooCommerce можно отключить автоматическое обновление точечно, не трогая весь магазин и не ломая переход к оплате.
Когда AJAX обновление корзины действительно мешает
Отключение имеет смысл, если вы видите один из типичных сценариев:
- количество товаров меняется, но сумма в корзине пересчитывается только после ручного обновления страницы;
- после изменения количества товара сбрасываются выбранные способы доставки или купоны;
- кнопка «Обновить корзину» конфликтует с кастомным JS и вызывает двойной запрос;
- на мобильных устройствах корзина дергается, а мини-корзина обновляется с задержкой;
- после AJAX-запроса ломается верстка блока корзины или исчезают элементы управления.
Что проверить до правки кода
Сначала откройте консоль браузера и вкладку Network. Если при изменении количества товара уходит запрос на ?wc-ajax=update_shipping_method или похожие WooCommerce-запросы, значит проблема именно в автоматическом обновлении, а не в шаблоне страницы. Полезно также временно отключить кэш и минификацию JS, чтобы не перепутать причину с последствиями оптимизации.
Если ошибка появляется только на конкретной теме или после установки плагина доставки, не отключайте AJAX глобально без необходимости. Иногда достаточно убрать один обработчик или исключить конфликтующий скрипт.
Как отключить автоматическое обновление корзины в WooCommerce
Самый безопасный вариант — добавить небольшой фильтр в functions.php дочерней темы или в собственный мини-плагин. Так вы не затронете ядро WooCommerce и сможете быстро откатить изменение.
<?php
add_filter( 'woocommerce_enable_ajax_add_to_cart', '__return_false' );
Этот фильтр относится к AJAX-добавлению товара в корзину, а не к пересчету самой корзины. Если у вас проблема именно с обновлением количества и суммы в корзине, чаще нужен другой подход: отключить автопересчет на фронтенде и оставить ручное обновление через кнопку.
Для этого можно убрать стандартный скрипт, который отвечает за поведение корзины, и затем проверить, не завязан ли на него ваш шаблон:
<?php
add_action( 'wp_enqueue_scripts', function () {
if ( function_exists( 'is_cart' ) && is_cart() ) {
wp_dequeue_script( 'wc-cart' );
wp_deregister_script( 'wc-cart' );
}
}, 20 );
Такой вариант стоит использовать осторожно. Он может повлиять на часть стандартной логики WooCommerce, поэтому перед внедрением проверьте, не использует ли ваша тема или плагины события из wc-cart. Если после отключения пропадает кнопка обновления или перестают работать купоны, значит вы убрали слишком много.
Более точечный вариант: отключать только на проблемной странице
Если сбой возникает не везде, а только на определенном шаблоне корзины, ограничьте правку условием. Это уменьшает риск побочных эффектов и помогает сохранить AJAX там, где он работает нормально.
<?php
add_action( 'wp_enqueue_scripts', function () {
if ( function_exists( 'is_cart' ) && is_cart() && ! is_checkout() ) {
wp_dequeue_script( 'wc-cart' );
}
}, 20 );
На практике этого часто достаточно, если конфликт идет с кастомным блоком мини-корзины или сторонним виджетом пересчета доставки. Но если у вас корзина собрана на блоках WooCommerce, сначала проверьте, не используется ли другой набор скриптов и не меняет ли тема стандартную разметку.
Сравнение подходов: плагин, код или компромисс
| Подход | Когда подходит | Минус |
|---|---|---|
| Код в дочерней теме | Нужен точечный контроль и быстрый откат | Требует проверки после обновлений темы |
| Мини-плагин | Изменение должно жить отдельно от темы | Нужно поддерживать свой код |
| Оставить AJAX и исправить конфликт | Проблема в одном скрипте или плагине | Нужно время на диагностику |
Если вы уже используете плагин для чистки и оптимизации сайта, например Clearfy Pro, проверьте, не отключает ли он часть WooCommerce-скриптов или не объединяет ли JS агрессивнее, чем нужно. Для магазинов это часто важнее, чем сам факт наличия AJAX.
Пошаговое решение без лишнего риска
- Сделайте резервную копию файлов темы и базы.
- Отключите временно кеширование и JS-минимизацию.
- Проверьте, воспроизводится ли проблема на стандартной теме Storefront.
- Если проблема исчезла, ищите конфликт в теме или кастомных скриптах.
- Если проблема остается, тестируйте отключение
wc-cartтолько на странице корзины. - После правки очистите кеш сайта, CDN и браузера.
Если нужно быстро протестировать поведение без редактирования темы, удобнее вынести код в отдельный файл плагина. Это особенно полезно на проектах, где тему обновляют часто, а изменения в functions.php теряются.
Как проверить, что решение сработало
После внедрения откройте корзину в режиме инкогнито и выполните несколько действий:
- измените количество товара вручную;
- примените купон;
- переключите способ доставки, если он доступен;
- обновите страницу и убедитесь, что данные корзины сохранились;
- проверьте переход к оплате.
В DevTools на вкладке Network не должно быть лишних повторных запросов при каждом изменении поля количества, если вы сознательно отключали автоматическое обновление. При этом кнопка ручного обновления корзины должна отрабатывать без ошибок JavaScript и без потери выбранных товаров.
Частые ошибки и как их исправить
Отключили не тот скрипт
Если после правки перестали работать купоны, доставка или кнопка обновления, значит вы отключили слишком общий скрипт. Верните изменения и проверьте, какой именно handle используется в вашей версии WooCommerce и теме. Не стоит копировать код без проверки на конкретном сайте.
Сломали поведение мини-корзины
Мини-корзина часто использует собственные AJAX-события. Если она перестала обновляться, не отключайте все скрипты подряд. Лучше найти, какой плагин или тема навешивает обработчик, и убрать только его.
Не очистили кеш
После изменения кода старый JS может продолжать отдаваться из кеша. Очистите серверный кеш, CDN и кеш браузера, иначе вы будете тестировать старую версию страницы.
Проверяли только под админом
У администратора и гостя могут быть разные условия загрузки скриптов. Тестируйте как минимум в приватном окне без авторизации, иначе можно пропустить проблему, которая видна обычному покупателю.
Что делать, если AJAX нужен, но он конфликтует
Если автоматическое обновление корзины важно для UX, не отключайте его полностью. В этом случае лучше:
- убрать только конфликтующий плагин доставки или мини-корзины;
- исключить WooCommerce-скрипты из агрессивной оптимизации;
- проверить, не дублируется ли подключение jQuery в теме;
- перенести кастомный JS на
wp_enqueue_scriptsи не вставлять его напрямую в шаблон.
Для магазинов это обычно более устойчивый путь, чем полное отключение AJAX. Если проект активно развивается, точечная правка и контроль скриптов почти всегда безопаснее, чем глобальное упрощение поведения корзины.
В итоге рабочая схема такая: сначала локализуйте конфликт, затем решите, нужно ли отключать AJAX полностью или достаточно убрать его только на странице корзины. Это экономит время на поддержке и не ломает стандартные сценарии оформления заказа.