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

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

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

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

Прежде чем внедрять ограничения, нужно убедиться, что:

• Требуется ограничение именно по количеству товара, а не по сумме заказа или по другим параметрам.
• Ограничение должно применяться ко всем покупателям или только к зарегистрированным.
• Ограничение нужно на уровне корзины, при добавлении товара или в момент оформления заказа.

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

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

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

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

add_filter('woocommerce_add_to_cart_validation', 'limit_product_quantity_in_cart', 10, 3);function limit_product_quantity_in_cart($passed, $product_id, $quantity) {    $limit = 3; // Максимальное количество товара    $cart = WC()->cart->get_cart();    $current_quantity = 0;    foreach ($cart as $cart_item) {        if ($cart_item['product_id'] === $product_id) {            $current_quantity += $cart_item['quantity'];        }    }    if (($current_quantity + $quantity) > $limit) {        wc_add_notice(sprintf('Вы не можете добавить больше %d единиц этого товара в корзину.', $limit), 'error');        return false;    }    return $passed;}

Этот код не позволит добавить в корзину больше 3 единиц одного товара за один заказ.

2. Ограничение количества товара при оформлении заказа (после добавления в корзину)

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

add_action('woocommerce_check_cart_items', 'limit_product_quantity_checkout');function limit_product_quantity_checkout() {    $limit = 3;    $cart = WC()->cart->get_cart();    $quantities = [];    foreach ($cart as $cart_item) {        $product_id = $cart_item['product_id'];        if (!isset($quantities[$product_id])) {            $quantities[$product_id] = 0;        }        $quantities[$product_id] += $cart_item['quantity'];    }    foreach ($quantities as $product_id => $quantity) {        if ($quantity > $limit) {            wc_add_notice(sprintf('Вы не можете купить больше %d единиц товара %s.', $limit, get_the_title($product_id)), 'error');            break;        }    }}

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

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

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

• Ошибка: ограничение не срабатывает при добавлении товара
  Проверьте, подключен ли хук woocommerce_add_to_cart_validation и нет ли конфликтов с другими плагинами, которые могут изменять поведение корзины.
• Ошибка: сообщение об ошибке не отображается
  Убедитесь, что в вашей теме поддерживаются уведомления WooCommerce (функция wc_print_notices() используется в шаблонах).
• Ошибка: ограничение не срабатывает при оформлении заказа
  Проверьте, что хук woocommerce_check_cart_items не отключен и корректно работает. Иногда другие плагины могут нарушать логику корзины.

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

• Не устанавливайте слишком низкие лимиты без явной необходимости — это может раздражать пользователей.
• Кэшируйте результаты запроса к корзине, если делаете сложные проверки, чтобы не нагружать сервер.
• Если у вас большой магазин, протестируйте работу ограничения на нагрузку, чтобы избежать замедлений.
• Для более гибких ограничений рассмотрите использование плагинов с поддержкой условий и правил, например, WooCommerce Quantity Manager, но кодовый вариант легче отладить и кастомизировать.

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