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

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

Часто магазины на WooCommerce сталкиваются с задачей ограничения количества добавляемых товаров в корзину. Причины разные: контроль запасов, предотвращение оптовых заказов без специальной лицензии, или просто улучшение UX. По умолчанию WooCommerce не предоставляет встроенного механизма для таких ограничений, поэтому требуется вмешательство через код.

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

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

Если вы хотите установить лимит, но не видите никаких ограничений, значит нужно внедрять кастомное решение.

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

1. Ограничение общего количества товаров в корзине

Например, ограничим корзину максимум 5 единицами товаров (суммарно по всем позициям):

add_filter('woocommerce_add_to_cart_validation', 'limit_cart_items_quantity', 10, 3);
function limit_cart_items_quantity($passed, $product_id, $quantity) {
    $max_items = 5; // Максимальное количество товаров в корзине
    $cart_quantity = WC()->cart->get_cart_contents_count();

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

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

Если нужно ограничить, например, товар с ID 123 максимум 3 штуками в корзине:

add_filter('woocommerce_add_to_cart_validation', 'limit_single_product_quantity', 10, 3);
function limit_single_product_quantity($passed, $product_id, $quantity) {
    $max_quantity = 3;
    $target_product_id = 123;

    if ($product_id == $target_product_id) {
        $current_quantity = 0;
        foreach (WC()->cart->get_cart() as $cart_item) {
            if ($cart_item['product_id'] == $target_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;
}

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

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

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

• Ошибка: уведомление не появляется, и лимит не действует.
  Причина: код не добавлен в functions.php текущей активной темы или используется кэширование. Решение: проверьте правильность добавления кода, очистите кэш сайта и браузера.
• Ошибка: лимит срабатывает даже при меньшем количестве.
  Причина: логика подсчёта количества товаров реализована неверно, возможно, повторный подсчёт или неправильное условие.
  Решение: внимательно проверьте переменные и условные операторы в коде.
• Ошибка: конфликт с другими плагинами корзины.
  Причина: некоторые плагины могут менять логику добавления в корзину.
  Решение: временно отключите другие плагины и протестируйте работу лимита, затем поочерёдно включайте их, выявляя конфликт.

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

• Добавляйте кастомные фильтры только в functions.php дочерней темы или через собственный плагин, чтобы избежать потери изменений при обновлении.
• Избегайте тяжелых циклов и лишних запросов — используйте кэширование данных корзины, если расширяете функционал.
• Проверяйте безопасность данных, особенно если расширяете логику через AJAX или API.
• Для удобства пользователей выводите уведомления в понятной форме, чтобы они знали причины ограничений.

Сравнение вариантов реализации лимита