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

Диагностика задачи: зачем менять количество товаров автоматически

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

Типичные вопросы:

• Как задать минимальное количество товара при добавлении в корзину?
• Как увеличить количество товара на фиксированное значение при добавлении?
• Как проверить, что количество корректно изменяется без ошибок?

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

Использование хука woocommerce_add_to_cart_quantity

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

add_filter('woocommerce_add_to_cart_quantity', function($quantity, $product_id, $variation_id) {
    // Увеличиваем количество на 2
    return $quantity + 2;
}, 10, 3);

Установка минимального количества (например, 5)

Если нужно гарантировать минимум 5 штук, независимо от введённого количества, используйте:

add_filter('woocommerce_add_to_cart_quantity', function($quantity, $product_id, $variation_id) {
    return max(5, $quantity);
}, 10, 3);

Изменение количества для определённых товаров

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

add_filter('woocommerce_add_to_cart_quantity', function($quantity, $product_id, $variation_id) {
    $target_ids = [12, 34, 56]; // ID товаров
    if (in_array($product_id, $target_ids)) {
        return max(3, $quantity); // минимум 3 для этих товаров
    }
    return $quantity;
}, 10, 3);

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

1. Добавьте в functions.php дочерней темы или в кастомный плагин приведённый выше код.
2. Перейдите на страницу товара и добавьте в корзину количество меньше минимального (например, 1 штуку, если стоит минимум 5).
3. Откройте корзину и убедитесь, что количество товара равно минимальному (5 или 3 согласно примеру).
4. Проверьте, что для других товаров количество не изменяется.
5. Проверьте работу на вариациях товаров, если применимо.

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

• Код не срабатывает: Убедитесь, что код добавлен в правильное место (functions.php дочерней темы или плагин), и что нет конфликтов с другими хуками, которые могут переопределять количество.
• Изменённое количество не отображается в корзине: Проверьте, не используется ли плагин кеширования, который может сохранять старое состояние корзины.
• Ошибки при добавлении вариаций: Если используются вариационные товары, передавайте корректно $variation_id и при необходимости измените логику для вариаций.
• Конфликт с плагинами минимального заказа: Если у вас установлены плагины, контролирующие минимальный заказ, отключите их или настройте так, чтобы они не конфликтовали с вашим кодом.

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

• Добавляйте кастомный код только в дочернюю тему или отдельный плагин, чтобы избежать потери изменений при обновлении.
• Минимизируйте влияние на производительность, избегая сложных вычислений в фильтрах, которые срабатывают при каждом добавлении в корзину.
• Тестируйте изменения на тестовом сайте перед внедрением на продакшн.
• Проверяйте совместимость с другими плагинами, особенно с теми, что управляют корзиной и заказами.

Сравнение способов управления количеством при добавлении в корзину