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

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

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

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

Как определить текущее поведение WooCommerce по добавлению товаров в корзину

По умолчанию WooCommerce не ограничивает суммарное количество товаров в корзине. Можно добавить любое число единиц одного товара и разных товаров, пока не исчерпается запас.

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

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

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

Вставьте следующий код в файл functions.php вашей дочерней темы или в кастомный плагин:

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

    // Получаем текущее количество товаров в корзине
    $current_cart_quantity = WC()->cart->get_cart_contents_count();

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

Этот код ограничит общее количество товаров в корзине (включая все позиции) максимум 10 единицами. При попытке добавить больше — пользователь увидит ошибку.

Как задать ограничения на количество каждого товара по отдельности

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

add_filter('woocommerce_add_to_cart_validation', 'limit_individual_product_quantity', 10, 3);
function limit_individual_product_quantity($passed, $product_id, $quantity) {
    $max_per_product = 3; // Максимум по одному товару

    $cart = WC()->cart->get_cart();
    foreach ($cart as $cart_item_key => $values) {
        if ($values['product_id'] == $product_id) {
            $new_quantity = $values['quantity'] + $quantity;
            if ($new_quantity > $max_per_product) {
                wc_add_notice(sprintf('Максимум %d единиц этого товара можно добавить в корзину.', $max_per_product), 'error');
                return false;
            }
            break;
        }
    }
    return $passed;
}

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

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

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

• Ошибка: сообщения об ошибках не выводятся
  Проверьте, что в вашем шаблоне темы присутствует вызов функции wc_print_notices() или woocommerce_output_all_notices(). Без этого уведомления не будут видны.
• Ограничение не срабатывает для вариаций товаров
  В функции нужно использовать $values['variation_id'] если работаете с вариативными товарами, или сравнивать по product_id и variation_id вместе.
• Конфликты с другими плагинами, которые тоже изменяют корзину
  Отключайте сторонние плагины и проверяйте, не влияют ли они на добавление в корзину.

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

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

Сравнение способов установки ограничений в WooCommerce