WooCommerce: установка ограничений на количество товаров в заказе

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

В интернет-магазинах на WooCommerce иногда требуется ограничить минимальное или максимальное количество товаров в заказе. Причины могут быть разные: контроль складских запасов, предотвращение спама или мошенничества, упрощение логистики, соблюдение правил продажи и т.д. Без таких ограничений пользователь может добавить слишком мало или слишком много товаров, что приведёт к проблемам с обработкой заказа.

Пошаговое решение: как реализовать ограничение количества товаров в заказе на WooCommerce

1. Использование хуков WooCommerce для проверки корзины

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

Для этого используйте хук woocommerce_check_cart_items, который вызывается при проверке корзины перед оформлением заказа.

2. Пример кода для ограничения максимального и минимального количества товаров

add_action('woocommerce_check_cart_items', 'custom_limit_cart_items_quantity');
function custom_limit_cart_items_quantity() {
    $min_quantity = 2; // минимальное количество товаров в заказе
    $max_quantity = 10; // максимальное количество товаров в заказе

    $cart_quantity = WC()->cart->get_cart_contents_count();

    if ( $cart_quantity < $min_quantity ) {
        wc_add_notice( sprintf('Минимальное количество товаров в заказе — %d. Пожалуйста, добавьте ещё товары.', $min_quantity), 'error' );
    }

    if ( $cart_quantity > $max_quantity ) {
        wc_add_notice( sprintf('Максимальное количество товаров в заказе — %d. Пожалуйста, уменьшите количество товаров.', $max_quantity), 'error' );
    }
}

Этот код добавьте в functions.php вашей темы или в плагин для кастомных функций.

3. Ограничение количества определённого товара

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

add_action('woocommerce_check_cart_items', 'custom_limit_specific_product_quantity');
function custom_limit_specific_product_quantity() {
    $target_product_id = 123; // ID товара
    $max_quantity = 3;
    $total_quantity = 0;

    foreach ( WC()->cart->get_cart() as $cart_item ) {
        if ( $cart_item['product_id'] == $target_product_id ) {
            $total_quantity += $cart_item['quantity'];
        }
    }

    if ( $total_quantity > $max_quantity ) {
        wc_add_notice( sprintf('Максимальное количество товара с ID %d — %d.', $target_product_id, $max_quantity), 'error' );
    }
}

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

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

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

• Ошибки не отображаются на странице оформления заказа. Проверьте, что в теме включена функция wc_print_notices() и что не отключена обработка сообщений WooCommerce.
• Код не срабатывает — корзина не проверяется. Убедитесь, что код находится в правильном месте (functions.php или кастомный плагин), и что WooCommerce активен.
• Конфликт с другими плагинами, которые изменяют корзину. Попробуйте отключить другие плагины и проверить работу кода.
• Пользователь может обойти ограничение через API. Для усиления защиты добавьте проверку на серверной стороне при создании заказа через хук woocommerce_checkout_process.

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

• Вместо жёсткого кодирования ID товаров и лимитов лучше создать настройки в админке (например, с помощью Customizer или ACF), чтобы легко менять параметры без правки кода.
• Если ограничений много, оптимизируйте проверки, чтобы не нагружать сервер при каждом запросе.
• Обязательно тестируйте на staging-среде, чтобы избежать сбоев в работе магазина.
• Для комплексного управления ограничениями рассмотрите использование профессиональных плагинов, например, Clearfy Pro, который предлагает различные оптимизации и настройки WooCommerce.

Сравнение способов реализации ограничений на количество товаров