WooCommerce: как автоматически удалять товар из корзины при обновлении количества

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

Иногда при обновлении количества товара в корзине WooCommerce возникает необходимость автоматически удалять этот товар из корзины, например, если количество становится нулём или по бизнес-логике магазина. Стандартно WooCommerce просто обновляет количество, но не удаляет позицию. Часто это приводит к некорректному отображению или логике оформления заказа.

Чтобы точно диагностировать проблему, нужно определить:
– в каких сценариях нужно удалять товар (при каком значении количества);
– как происходит обновление количества (через AJAX, страницу корзины или REST API);
– не конфликтует ли кастомный код или плагины с обработкой корзины.

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

Реализация задачи возможна с помощью фильтра WooCommerce woocommerce_update_cart_action_cart_updated и хука woocommerce_before_cart_item_quantity_zero. Но наиболее универсальный способ — перехватить момент обновления корзины и проверить значения количества.

Добавьте следующий код в файл functions.php вашей темы или в кастомный плагин:

add_action('woocommerce_cart_updated', 'auto_remove_cart_item_if_quantity_zero');
function auto_remove_cart_item_if_quantity_zero() {
    // Получаем текущую корзину
    $cart = WC()->cart->get_cart();
    foreach ( $cart as $cart_item_key => $cart_item ) {
        if ( isset($cart_item['quantity']) && $cart_item['quantity'] <= 0 ) {
            WC()->cart->remove_cart_item( $cart_item_key );
        }
    }
}

Этот код проверяет каждый товар в корзине после обновления и удаляет все позиции с количеством 0 или меньше.

Как настроить удаление товара при других условиях

Если нужно удалять товар при других условиях, например, если количество превышает лимит, можно расширить проверку:

add_action('woocommerce_cart_updated', 'auto_remove_cart_item_on_custom_condition');
function auto_remove_cart_item_on_custom_condition() {
    $max_quantity = 10; // максимальное разрешенное количество
    $cart = WC()->cart->get_cart();
    foreach ( $cart as $cart_item_key => $cart_item ) {
        $qty = $cart_item['quantity'];
        if ( $qty <= 0 || $qty > $max_quantity ) {
            WC()->cart->remove_cart_item( $cart_item_key );
        }
    }
}

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

Чтобы проверить, что автоматическое удаление работает:

• Добавьте товар в корзину с количеством 1.
• Перейдите в корзину и измените количество товара на 0, нажмите «Обновить корзину».
• Товар должен исчезнуть из корзины без ошибок.
• Попробуйте обновить количество на отрицательное или слишком большое значение — товар также должен удалиться, если используется кастомное условие.

Для отладки включите вывод ошибок PHP или используйте плагин Query Monitor для отслеживания запросов и хуков.

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

• Код не срабатывает при AJAX-обновлении корзины: В WooCommerce обновление корзины часто происходит через AJAX. Хук woocommerce_cart_updated срабатывает и при AJAX, но если код не работает, проверьте, не конфликтует ли с JS-скриптами или другими плагинами.
• Удаление товара не происходит: Убедитесь, что условие $cart_item['quantity'] <= 0 реально срабатывает. Для отладки можно временно вывести значения через error_log().
• Ошибки в PHP из-за синтаксиса: Проверьте правильность кавычек и точек с запятой. Пример кода приведён с корректным синтаксисом.
• Конфликты с другими плагинами корзины: Иногда сторонние плагины модифицируют поведение корзины. Попробуйте временно отключить их и проверить работу скрипта.

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

• Не используйте тяжелые циклы и запросы внутри хука обновления корзины — это может замедлить процесс оформления.
• Проверяйте входящие данные (например, количество) на стороне клиента и сервера, чтобы избежать некорректных значений.
• Для крупных магазинов с большой нагрузкой рассмотрите кеширование корзины и оптимизацию AJAX-запросов.
• Храните изменения в корзине только через официальные методы WooCommerce, чтобы не нарушать целостность данных.

Сравнение вариантов решения