Как отключить AJAX Add to Cart на страницах магазина в WooCommerce

На небольших магазинах AJAX-кнопка «Добавить в корзину» выглядит удобно. Но на практике она часто мешает кэшированию, ломает мини-корзину, создает лишние запросы и усложняет отладку. Особенно это заметно, когда тема или набор плагинов уже вмешиваются в стандартный сценарий WooCommerce.

Если задача не в «красивой анимации», а в предсказуемом поведении каталога, AJAX на страницах магазина и в архивах лучше отключить точечно. Ниже — рабочие способы, как это сделать без переписывания шаблонов.

Когда AJAX Add to Cart действительно мешает

Проблема обычно проявляется не сразу. Сайт может работать нормально в админке и на тестовом товаре, но в каталоге начинаются странности: товар добавляется, а счетчик корзины не обновляется; кэш отдает старое состояние кнопки; на мобильных устройствах после клика страница ведет себя непредсказуемо; сторонний скрипт перехватывает событие и вызывает дублирование запросов.

Если у вас включены серверный кэш, CDN или агрессивная оптимизация JS, AJAX-добавление в корзину часто становится лишней точкой отказа. В таких случаях проще вернуть обычный переход на страницу товара или стандартную отправку формы.

Диагностика: что проверить до правки кода

• Откройте страницу магазина в режиме инкогнито и проверьте, меняется ли мини-корзина после клика.
• Посмотрите вкладку Network в DevTools: есть ли запросы к ?wc-ajax=add_to_cart.
• Проверьте, не подключен ли кэш для страниц каталога без исключений для корзины и оформления заказа.
• Временно отключите плагины, которые меняют поведение кнопок каталога, и сравните результат.
• Убедитесь, что тема не переопределяет шаблоны WooCommerce с собственной логикой кнопки.

Как отключить AJAX Add to Cart на страницах магазина

Самый надежный вариант — убрать поддержку AJAX у кнопок каталога через фильтр WooCommerce. Это влияет на архивы товаров и страницы магазина, но не ломает стандартную корзину и оформление заказа.

<?php
add_action( 'after_setup_theme', function() {
    remove_theme_support( 'wc-product-gallery-zoom' );
} );

add_filter( 'woocommerce_loop_add_to_cart_link', function( $html, $product, $args ) {
    if ( ! $product instanceof WC_Product ) {
        return $html;
    }

    // Убираем AJAX-класс у кнопки в каталоге.
    $html = str_replace( 'ajax_add_to_cart', '', $html );

    return $html;
}, 10, 3 );

Этот вариант полезен, если тема генерирует кнопку через стандартный шаблон WooCommerce. Но на практике надежнее не править HTML строкой, а отключить саму поддержку AJAX для каталога через фильтр.

<?php
add_filter( 'woocommerce_loop_add_to_cart_args', function( $args, $product ) {
    if ( ! $product instanceof WC_Product ) {
        return $args;
    }

    unset( $args['class'] );

    return $args;
}, 10, 2 );

Если нужен более предсказуемый результат, можно вообще убрать AJAX-скрипты WooCommerce на страницах каталога. Это уже более жесткое решение, но оно хорошо работает там, где важна стабильность кэша.

<?php
add_action( 'wp_enqueue_scripts', function() {
    if ( is_shop() || is_product_taxonomy() ) {
        wp_dequeue_script( 'wc-add-to-cart' );
        wp_dequeue_script( 'wc-cart-fragments' );
    }
}, 20 );

Здесь важно понимать компромисс: если отключить wc-cart-fragments, мини-корзина и счетчик могут перестать обновляться без перезагрузки страницы. Это нормально, если вы сознательно выбираете стабильность и кэшируемость вместо динамики.

Сравнение подходов

Пошаговое решение без риска сломать корзину

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

1. Сделайте резервную копию файлов и базы.
2. Добавьте код в дочернюю тему или в собственный мини-плагин.
3. Сначала отключите AJAX только на страницах магазина и архивов.
4. Проверьте, не завязаны ли счетчики корзины на wc-cart-fragments.
5. Если все стабильно, зафиксируйте изменения и очистите кэш.

Для точечного отключения только на каталоге можно использовать такой вариант:

<?php
add_action( 'wp', function() {
    if ( is_shop() || is_product_category() || is_product_tag() ) {
        add_filter( 'woocommerce_loop_add_to_cart_link', function( $html ) {
            return preg_replace( '/\s*ajax_add_to_cart\s*/', ' ', $html );
        } );
    }
} );

Если у вас в теме есть собственная кнопка и стандартный фильтр не срабатывает, ищите шаблон content-product.php или переопределение кнопки в папке woocommerce темы. Там часто прямо прописан класс ajax_add_to_cart.

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

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

• В DevTools откройте Network и убедитесь, что запросы wc-ajax=add_to_cart больше не уходят с каталога.
• Нажмите кнопку товара в магазине и проверьте, происходит ли переход на страницу товара или в корзину по стандартному сценарию.
• Очистите весь кэш: серверный, плагина кэширования и CDN, если он есть.
• Проверьте мини-корзину в инкогнито и в обычной сессии.
• Сравните поведение на мобильном и десктопе, особенно если тема использует отдельные скрипты для адаптива.

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

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

Отключили не тот скрипт

Иногда вместе с wc-add-to-cart убирают и другие зависимости, после чего ломается не только каталог, но и корзина. Проверяйте, какие именно скрипты реально используются на странице, прежде чем деактивировать их массово.

Правят HTML через str_replace без проверки темы

Это работает только до первого обновления шаблона или изменения разметки. Если тема меняет классы кнопки, строковая замена перестает быть надежной. Лучше использовать фильтры WooCommerce или переопределение шаблона в дочерней теме.

Не очищают кэш после изменения

Для WooCommerce это критично. Даже если код уже исправлен, старый HTML и старые JS-файлы могут продолжать отдаваться из кэша. После внедрения всегда очищайте кэш страниц, объектный кэш и CDN.

Отключают AJAX на всех страницах без анализа

Иногда AJAX нужен на странице товара или в мини-корзине. Если отключить его глобально, можно ухудшить UX там, где он действительно полезен. Лучше сначала ограничиться архивами и магазином.

Безопасность и производительность: что учесть после правки

Если вы отключаете AJAX ради кэширования, проверьте, не завязаны ли на него другие элементы интерфейса. Часто вместе с ним отключают фрагменты корзины, а потом удивляются, что счетчик не обновляется без перезагрузки. Это не баг, а следствие выбранной архитектуры.

Для магазинов с большим каталогом такой подход обычно даже полезнее: меньше запросов, меньше JS-магии, проще отладка. Но если у вас активные промо-кампании, быстрые покупки и мини-корзина как часть сценария продаж, сначала протестируйте изменения на staging-окружении.

Если нужно не только убрать AJAX, но и почистить лишние зависимости WooCommerce, имеет смысл отдельно проверить, какие скрипты и стили реально нужны на каталоге. Для этого удобно использовать инструменты аудита темы и плагинов, а не отключать все подряд.

Когда требуется быстро убрать лишнюю нагрузку и дубли в WooCommerce, иногда помогает связка точечных правок в теме и аккуратной оптимизации плагинов. Но здесь важнее не «облегчить сайт любой ценой», а сохранить предсказуемый путь покупки.