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

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

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

Какие проблемы возникают без ограничения

• Покупатели могут заказать слишком много товара, превышая складские запасы.
• Отсутствие контроля ведет к конфликтам с логистикой и неудовлетворённости клиентов.
• Сложно автоматизировать лимиты без кастомной логики.

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

Рассмотрим пример, как ограничить максимальное количество покупки для конкретного товара через код в functions.php или в собственном плагине.

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

add_filter('woocommerce_add_to_cart_validation', 'limit_product_quantity_in_cart', 10, 3);
function limit_product_quantity_in_cart($passed, $product_id, $quantity) {
    $max_quantity = 3; // максимальное количество для товара

    // Проверяем ID товара, для которого ставим ограничение
    if ($product_id == 123) { // замените 123 на ID вашего товара
        $current_quantity = 0;
        // Получаем текущее количество этого товара в корзине
        foreach (WC()->cart->get_cart() as $cart_item) {
            if ($cart_item['product_id'] == $product_id) {
                $current_quantity += $cart_item['quantity'];
            }
        }

        if (($current_quantity + $quantity) > $max_quantity) {
            wc_add_notice(sprintf('Вы можете купить не более %d единиц этого товара.', $max_quantity), 'error');
            return false;
        }
    }
    return $passed;
}

Этот код проверяет, чтобы суммарное количество товара с ID 123 в корзине не превышало 3.

2. Ограничиваем изменение количества товара в корзине

Чтобы пользователь не мог увеличить количество товара напрямую в корзине выше лимита, добавим проверку при обновлении корзины:

add_filter('woocommerce_update_cart_validation', 'limit_quantity_in_cart_update', 10, 4);
function limit_quantity_in_cart_update($passed, $cart_item_key, $values, $quantity) {
    $max_quantity = 3;
    $product_id = $values['product_id'];

    if ($product_id == 123) {
        if ($quantity > $max_quantity) {
            wc_add_notice(sprintf('Максимальное количество для этого товара: %d.', $max_quantity), 'error');
            return false;
        }
    }
    return $passed;
}

3. Настройка для нескольких товаров

Для нескольких товаров используйте массив ID и лимитов:

$limits = [
    123 => 3,
    456 => 5,
];

// В функции проверяйте наличие ID в массиве и сравнивайте с соответствующим лимитом

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

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

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

• Неправильный ID товара: Убедитесь, что используете верный ID товара. Проверьте через админку или код var_dump($product_id).
• Кэширование корзины: Иногда кэш страниц мешает обновлению ограничений. Отключите кэш для страниц корзины/чекаута.
• Конфликт с плагинами: Некоторые плагины могут менять поведение корзины. Ищите конфликты, отключая плагины по очереди.
• Отсутствие уведомлений: Убедитесь, что в теме выводятся wc_print_notices(), иначе пользователь не увидит ошибки.

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

• Для крупных магазинов с большим количеством товаров и пользователей лучше делать ограничения на серверном уровне, чтобы избежать обхода через REST API или прямые запросы.
• Используйте транзиенты или кэширование, если проверяете ограничения для большого количества товаров одновременно.
• Внимательно тестируйте на staging-среде, чтобы не сломать процесс покупки.
• Рассмотрите готовые решения, например, плагин Clearfy Pro, если нужна расширенная настройка ограничений и автоматизация.

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