Как отключить AJAX добавление в корзину для отдельных товаров WooCommerce

Иногда проблема не в WooCommerce как таковом, а в том, что AJAX-добавление в корзину конфликтует с конкретным товаром, вариациями, кастомной кнопкой или сторонним плагином. На части магазинов это проявляется так: товар добавляется, но мини-корзина не обновляется; у вариативного товара не срабатывает выбор опций; после клика страница ведёт себя нестабильно; или нужен обычный переход на страницу корзины именно для отдельных SKU.

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

Когда точечное отключение AJAX действительно нужно

Сценарий обычно один из трёх:

• у товара есть сложные вариации, и фронтенд-скрипты не успевают корректно обработать добавление;
• после AJAX-клика не обновляются мини-корзина, счётчик или виджет корзины;
• на странице товара подключён кастомный JS, который перехватывает событие, но не дружит с WooCommerce AJAX.

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

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

Перед изменениями стоит понять, где именно ломается сценарий. Это экономит время и помогает не лечить не ту причину.

Проверьте, как ведёт себя товар без сторонних плагинов

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

Посмотрите, не ломает ли сценарий оптимизация JS

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

Проверьте тип товара и шаблон кнопки

Для простых товаров и вариативных товаров WooCommerce использует разные шаблоны и разные JS-сценарии. Если у вас кастомный шаблон карточки товара, убедитесь, что кнопка добавления в корзину не заменена на собственную разметку без нужных классов и атрибутов.

Решение: отключить AJAX только для выбранных товаров

Самый надёжный способ — убрать AJAX для конкретных товаров через фильтр woocommerce_loop_add_to_cart_link или через изменение поведения кнопки на уровне шаблона. Но для практики чаще удобнее использовать фильтр, который отключает AJAX-класс у нужных товаров в каталоге.

Ниже пример для простого сценария: отключаем AJAX для товаров по ID. Код можно добавить в functions.php дочерней темы или в небольшой функциональный плагин.

<?php
add_filter( 'woocommerce_loop_add_to_cart_link', 'wpblock_disable_ajax_add_to_cart_for_products', 10, 2 );
function wpblock_disable_ajax_add_to_cart_for_products( $html, $product ) {
    if ( ! $product instanceof WC_Product ) {
        return $html;
    }

    $disabled_product_ids = array( 123, 456, 789 );

    if ( in_array( $product->get_id(), $disabled_product_ids, true ) ) {
        $html = str_replace( 'ajax_add_to_cart', '', $html );
    }

    return $html;
}

Что делает этот код: в каталоге у выбранных товаров убирается класс ajax_add_to_cart, и WooCommerce перестаёт отправлять запрос без перезагрузки страницы. Для пользователя это выглядит как обычное добавление в корзину с переходом по стандартному сценарию темы и настроек магазина.

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

Вариант через условие по категории

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

<?php
add_filter( 'woocommerce_loop_add_to_cart_link', 'wpblock_disable_ajax_add_to_cart_for_category', 10, 2 );
function wpblock_disable_ajax_add_to_cart_for_category( $html, $product ) {
    if ( ! $product instanceof WC_Product ) {
        return $html;
    }

    if ( has_term( array( 'custom-products', 'configurators' ), 'product_cat', $product->get_id() ) ) {
        $html = str_replace( 'ajax_add_to_cart', '', $html );
    }

    return $html;
}

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

Если нужен более жёсткий сценарий: принудительно убрать AJAX у всех товаров

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

<?php
add_filter( 'woocommerce_product_add_to_cart_ajax_enabled', '__return_false' );

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

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

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

После внедрения не ограничивайтесь визуальной проверкой кнопки. Пройдитесь по короткому чек-листу:

• товар из списка проблемных добавляется в корзину без ошибки;
• страница корзины открывается штатно, если AJAX отключён;
• мини-корзина и счётчик обновляются там, где AJAX оставлен;
• вариативный товар выбирается и добавляется без зависания формы;
• в консоли браузера нет ошибок JavaScript, связанных с wc-add-to-cart или скриптами темы.

Если используете кэш-плагин или оптимизацию JS, очистите кэш страницы товара и кэш объекта, если он есть. Иначе можно смотреть на старую версию шаблона и делать ложный вывод, что код не сработал.

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

Слишком грубая замена HTML

Иногда пытаются просто удалить строку ajax_add_to_cart из всего HTML без проверки типа товара. Это может затронуть не только кнопку, но и другие элементы, если тема использует похожие классы. Безопаснее работать через фильтр и проверять объект товара.

Правка в родительской теме

Если вставить код в functions.php родительской темы, он исчезнет после обновления. Для таких правок лучше использовать дочернюю тему или небольшой mu-plugin.

Конфликт с оптимизатором скриптов

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

Неправильный список товаров

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

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

Точечное отключение AJAX обычно безопаснее, чем попытки переписать поведение корзины через JS. Чем меньше фронтенд-хака, тем проще сопровождать магазин после обновлений WooCommerce.

Если у вас много подобных точечных исключений, вынесите их в отдельный мини-плагин. Так код не потеряется при смене темы и будет проще отлаживаться. Для магазинов с большим количеством контента и служебных блоков можно дополнительно использовать Clearfy Pro для чистки лишних дублей и служебного мусора, но это не заменяет проверку конфликтов скриптов и шаблонов.

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