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

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

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

Чаще всего пользователи сталкиваются с такими проблемами:

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

Как проверить, что лимит на количество товаров в корзине отсутствует

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

Проверить можно и через консоль разработчика, отправив несколько AJAX-запросов добавления товара с разным количеством и проследив реакции сервера.

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

В WooCommerce нет встроенной настройки для ограничения количества товаров в корзине, поэтому добавим кастомный код в functions.php дочерней темы или в собственный плагин.

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

    $current_quantity = 0;
    foreach (WC()->cart->get_cart() as $cart_item) {
        $current_quantity += $cart_item['quantity'];
    }

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

    return $passed;
}

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

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

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

add_filter('woocommerce_add_to_cart_validation', 'limit_quantity_per_product', 10, 3);
function limit_quantity_per_product($passed, $product_id, $quantity) {
    $max_quantity_per_product = 5; // Лимит на один товар

    $cart = WC()->cart->get_cart();
    $current_quantity = 0;

    foreach ($cart as $cart_item_key => $cart_item) {
        if ($cart_item['product_id'] === $product_id) {
            $current_quantity = $cart_item['quantity'];
            break;
        }
    }

    if (($current_quantity + $quantity) > $max_quantity_per_product) {
        wc_add_notice(sprintf('Максимальное количество для этого товара — %d.', $max_quantity_per_product), 'error');
        return false;
    }

    return $passed;
}

Как проверить, что решение сработало

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

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

• Ошибка: Лимит не применяется
  Причина: Кэширование браузера или плагинов кэширования. Решение: Очистите кеш и отключите кэширование для страницы корзины и добавления товара.
• Ошибка: Функция конфликтует с другими плагинами
  Причина: Конфликт хуков или переопределение корзины другими плагинами.
  Решение: Проверьте совместимость, отключите плагины поочередно, чтобы выявить конфликт.
• Ошибка: Ошибка при добавлении товара с вариациями
  Причина: Код не учитывает вариативные продукты.
  Решение: Добавьте проверку по variation_id или используйте get_product_id() для корректного определения товара.

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

• Не храните большие объемы данных в сессии. WooCommerce уже оптимизирован для хранения корзины.
• Добавляйте проверки на серверной стороне, чтобы не полагаться на JavaScript и исключить обход ограничений.
• Используйте транзиенты для кэширования результатов тяжелых запросов, если код усложняется.
• Ограничение количества товаров улучшает UX, снижая вероятность ошибок и перегрузки сервера.

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