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

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

Иногда в WooCommerce требуется не просто добавить один товар в корзину при нажатии кнопки «В корзину», а изменить количество автоматически. Например, для акций, комплектов или минимального количества заказа. В стандартном WooCommerce при добавлении товара количество берётся из поля на странице товара или равно 1 по умолчанию. Чтобы изменить это поведение, нужно использовать хуки WooCommerce.

Ключевые хуки для управления количеством товаров в корзине

Для изменения количества товаров при добавлении в корзину можно использовать фильтр woocommerce_add_to_cart_quantity. Этот фильтр позволяет изменить количество товара до того, как он попадёт в корзину.

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

Пример использования фильтра woocommerce_add_to_cart_quantity

add_filter('woocommerce_add_to_cart_quantity', 'custom_add_to_cart_quantity', 10, 3);
function custom_add_to_cart_quantity($quantity, $product_id, $variation_id) {
    // Увеличиваем количество товара до 3, если это конкретный товар
    if ($product_id == 123) { // замените 123 на ID вашего товара
        return 3;
    }
    return $quantity;
}

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

1. Определите ID товара, для которого хотите изменить количество.
2. Добавьте код фильтра в файл functions.php вашей темы или в кастомный плагин.
3. В фильтре сравните $product_id с нужным ID и измените $quantity на требуемое число.
4. Очистите кэш сайта и браузера.
5. Проверьте добавление товара в корзину.

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

Чтобы проверить, что количество товара изменяется автоматически, откройте страницу товара с ID, указанным в коде, и нажмите кнопку «В корзину» без изменения количества вручную. Затем перейдите в корзину и убедитесь, что количество товара равно заданному в фильтре.

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

error_log('Добавлено в корзину количество: ' . $quantity . ' для товара ID: ' . $product_id);

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

• Неверный ID товара. Проверьте, что вы используете правильный ID. Можно узнать его на странице редактирования товара в админке WooCommerce.
• Код добавлен в неправильное место. Фильтр должен быть в functions.php активной темы или в отдельном плагине. Если вы используете дочернюю тему, добавьте туда.
• Кэширование мешает проверить изменения. Очищайте кэш плагинов и браузера.
• Конфликты с другими плагинами. Временно отключите плагины, которые могут менять поведение корзины.

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

• Избегайте жестко прописанных ID, если изменений много — лучше использовать условие по категории товара или пользовательские мета-поля.
• Не увеличивайте количество без предупреждения пользователя, чтобы не ухудшать UX.
• Проверяйте код на тестовом сайте перед внедрением на боевом.
• Используйте детальную отладку для мониторинга ошибок и предупреждений в логах сервера.

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

Дополнительный пример: установка минимального количества товара в корзине

add_filter('woocommerce_add_to_cart_validation', 'custom_minimum_quantity_check', 10, 3);
function custom_minimum_quantity_check($passed, $product_id, $quantity) {
    $min_qty = 3; // минимальное количество
    if ($quantity < $min_qty) {
        wc_add_notice(sprintf('Минимальное количество для товара %s: %d штук.', get_the_title($product_id), $min_qty), 'error');
        return false;
    }
    return $passed;
}

Этот код запрещает добавление товара в количестве меньше указанного и выводит ошибку.