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

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

По умолчанию в WooCommerce при обновлении количества товара в корзине просто меняется значение количества. Однако в некоторых сценариях требуется не обновлять количество, а полностью удалить товар из корзины, например, если новое количество равно нулю или установлено определённое условие. Типичная проблема — пользователь пытается уменьшить количество до 0, но товар остаётся в корзине, создавая неудобства и путаницу.

Как проверить текущую логику обновления корзины?

Для диагностики можно добавить временный код, который логирует изменения корзины:

add_action('woocommerce_before_calculate_totals', function() {
    error_log(print_r(WC()->cart->get_cart(), true));
});

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

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

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

add_action('woocommerce_before_calculate_totals', 'custom_remove_cart_items_with_zero_quantity', 10);
function custom_remove_cart_items_with_zero_quantity() {
    $cart = WC()->cart->get_cart();
    foreach ($cart as $cart_item_key => $cart_item) {
        if ($cart_item['quantity'] <= 0) {
            WC()->cart->remove_cart_item($cart_item_key);
        }
    }
}

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

Обработка обновления через AJAX

WooCommerce обновляет корзину также через AJAX. Для предотвращения конфликтов рекомендуется добавить вывод сообщения пользователю и обновление фронтенда:

add_action('wp_ajax_update_cart', 'custom_ajax_remove_zero_quantity');
add_action('wp_ajax_nopriv_update_cart', 'custom_ajax_remove_zero_quantity');
function custom_ajax_remove_zero_quantity() {
    foreach (WC()->cart->get_cart() as $cart_item_key => $cart_item) {
        if ($cart_item['quantity'] <= 0) {
            WC()->cart->remove_cart_item($cart_item_key);
        }
    }
    WC()->cart->calculate_totals();
    wp_send_json_success();
}

Однако в большинстве случаев первый хук достаточно, так как WooCommerce сам обновляет корзину корректно.

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

• Добавьте товар в корзину с количеством 1 или больше.
• Перейдите в корзину и измените количество на 0.
• Обновите корзину и убедитесь, что товар исчез из списка.
• Проверьте, что итоговая сумма пересчиталась корректно без удалённого товара.

Также проверьте работу на мобильных устройствах и в разных браузерах.

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

• Товар не удаляется при количестве 0: проверьте, что код добавлен и правильно подключен, а также нет конфликтов с другими плагинами, которые могут переопределять обработку корзины.
• Ошибка «Headers already sent» при добавлении кода: убедитесь, что в functions.php нет лишних пробелов или символов перед открывающим <?php и после закрывающего ?>.
• Удаление происходит, но на фронтенде товар остаётся: возможно, кеширование страницы или AJAX обновление не срабатывает. Очистите кеш браузера и кеш плагинов кэширования.
• Производительность падает: не используйте тяжелые операции внутри цикла корзины, избегайте лишних запросов к БД.

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

• Не используйте функции, которые могут повлиять на сессию или транзакции вне хука woocommerce_before_calculate_totals, чтобы избежать проблем с синхронизацией корзины.
• Обязательно тестируйте изменения на тестовой копии сайта, чтобы не повредить данные реальных пользователей.
• Если на сайте много покупателей, контролируйте нагрузку на сервер, избегая тяжелых операций внутри хука.
• Для расширенной кастомизации можно использовать фильтр woocommerce_update_cart_validation для валидации количества перед обновлением.

Сравнение вариантов: плагин vs кастомный код