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

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

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

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

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

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

1. Используем хук 'woocommerce_before_calculate_totals' для проверки и удаления товара

Этот хук срабатывает перед пересчётом стоимости корзины. Можно пройтись по всем товарам и удалить те, у которых количество меньше 1.

add_action('woocommerce_before_calculate_totals', 'custom_remove_items_with_zero_qty', 10, 1);
function custom_remove_items_with_zero_qty($cart) {
    if (is_admin() && !defined('DOING_AJAX')) return;
    foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
        if ($cart_item['quantity'] < 1) {
            $cart->remove_cart_item($cart_item_key);
        }
    }
}

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

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

add_action('wp_ajax_update_cart_item_quantity', 'custom_ajax_update_cart_item_quantity');
add_action('wp_ajax_nopriv_update_cart_item_quantity', 'custom_ajax_update_cart_item_quantity');

function custom_ajax_update_cart_item_quantity() {
    $cart_item_key = sanitize_text_field($_POST['cart_item_key']);
    $quantity = intval($_POST['quantity']);

    if ($quantity < 1) {
        WC()->cart->remove_cart_item($cart_item_key);
    } else {
        WC()->cart->set_quantity($cart_item_key, $quantity, true);
    }

    WC()->cart->calculate_totals();
    wp_send_json_success();
}

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

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

• Откройте страницу корзины с товарами.
• Измените количество товара на 0 или отрицательное число.
• Нажмите кнопку обновления корзины.
• Убедитесь, что товар удалился из корзины.
• Если используется кастомный AJAX, проверьте, что при изменении количества товар исчезает без перезагрузки страницы.

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

• Товар не удаляется при вводе 0: возможно, код добавлен не в functions.php или конфликтует с плагинами кеширования. Отключите кеширование и проверьте.
• Ошибка при удалении товара через AJAX: некорректный ключ корзины или отсутствует nonce для безопасности. Проверьте правильность передачи данных и безопасность запроса.
• Обновление количества не срабатывает корректно: кастомный JS не интегрирован, либо переопределение стандартного скрипта некорректно. Проверьте консоль браузера на ошибки.

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

• Добавляйте проверку is_admin() && !DOING_AJAX для предотвращения выполнения кода в админке.
• Используйте встроенные методы WooCommerce для работы с корзиной, чтобы избежать конфликтов.
• Для AJAX-запросов обязательно реализуйте проверку nonce и прав пользователя, чтобы предотвратить CSRF-атаки.
• Кеширование страниц с корзиной и обновлением количества отключайте или настраивайте с умом, чтобы избежать устаревших данных.

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