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

Что делать, если нужно ограничить количество товаров в одном заказе WooCommerce

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

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

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

Если клиент жалуется, что можно добавить слишком много товаров, или у вас есть бизнес-ограничения, значит, лимит необходим. Можно проверить, что WooCommerce не ограничивает количество товаров:

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

Также проверьте, нет ли на сайте плагинов, которые управляют корзиной — они могут конфликтовать с вашим кодом.

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

Для ограничения количества товаров в WooCommerce добавим кастомный код в functions.php текущей темы или в плагин для кастомных функций.

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

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

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

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

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

На случай, если пользователь каким-то образом обойдет ограничение при добавлении товаров, добавим проверку при оформлении заказа с помощью хука woocommerce_checkout_process:

add_action('woocommerce_checkout_process', 'wpc_limit_checkout_items');
function wpc_limit_checkout_items() {
    $max_items = 10;
    $cart_count = WC()->cart->get_cart_contents_count();

    if ($cart_count > $max_items) {
        wc_add_notice(sprintf('Вы не можете заказать больше %d товаров за один раз.', $max_items), 'error');
    }
}

3. Тестирование и доработка

В этих функциях можно добавить индивидуальные ограничения по товару, категории или пользователю, если нужно. Например, для ограничения по категории:

function wpc_limit_cart_items_by_category($passed, $product_id, $quantity) {
    $max_items = 5;
    $restricted_cat = 'limited-category';

    if (has_term($restricted_cat, 'product_cat', $product_id)) {
        $cart_count = 0;
        foreach (WC()->cart->get_cart() as $cart_item) {
            if (has_term($restricted_cat, 'product_cat', $cart_item['product_id'])) {
                $cart_count += $cart_item['quantity'];
            }
        }
        if (($cart_count + $quantity) > $max_items) {
            wc_add_notice(sprintf('Вы не можете добавить больше %d товаров из категории %s.', $max_items, $restricted_cat), 'error');
            return false;
        }
    }
    return $passed;
}
add_filter('woocommerce_add_to_cart_validation', 'wpc_limit_cart_items_by_category', 10, 3);

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

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

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

• Код не работает и товары добавляются без ограничений: проверьте, подключен ли файл с кодом, есть ли ошибки PHP. Используйте error_log() для отладки.
• Ошибка появляется, но лимит не срабатывает корректно: проверьте правильность подсчёта количества товаров в корзине. Метод get_cart_contents_count() возвращает общее количество единиц, а не позиций.
• Конфликт с другими плагинами, которые управляют корзиной: отключите такие плагины и проверьте работу ограничения, затем ищите совместимые решения.
• Сообщения об ошибках не отображаются на фронтенде: убедитесь, что в теме корректно выводятся уведомления WooCommerce через wc_print_notices().

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

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

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

Метод	Описание	Плюсы	Минусы
Код в functions.php	Добавление фильтров и действий напрямую в тему	Быстро, бесплатно, гибко	Зависит от темы, может потеряться при смене темы
Создание собственного плагина	Выделенный плагин для ограничений	Независимость от темы, удобство поддержки	Требует базовых знаний плагин-разработки
Использование готовых плагинов	Плагины для ограничений корзины и заказа	Удобно, часто с UI для настроек	Может быть платным, нагрузка на сайт