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

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

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

Как понять, что требуется ограничение

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

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

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

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

Код добавляем в файл functions.php активной темы или в кастомный плагин.

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

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

<?php
add_filter('woocommerce_add_to_cart_validation', 'wpfix_limit_single_product_quantity', 10, 3);
function wpfix_limit_single_product_quantity($passed, $product_id, $quantity) {
    $max_per_product = 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) > $max_per_product) {
        wc_add_notice('Максимум '.$max_per_product.' единиц этого товара можно добавить в корзину.', 'error');
        return false;
    }
    return $passed;
}
?>

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

После добавления кода:

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

Для проверки ошибок воспользуйтесь включением WP_DEBUG в wp-config.php и проверьте логи при возникновении проблем.

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

• Ограничение не срабатывает: возможно, кэширование мешает обновлению корзины – очистите кэш и проверьте, что код загружается;
• Сообщение об ошибке не отображается: убедитесь, что в теме подключена функция woocommerce_output_all_notices() для вывода уведомлений;
• Лимит сбрасывается при обновлении страницы: проверьте, что корзина корректно сохраняется в сессии;
• Проблемы с AJAX-добавлением в корзину: убедитесь, что хук woocommerce_add_to_cart_validation применяется и для AJAX-запросов.

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

• Не используйте тяжелые запросы к базе данных внутри хука проверки количества товаров – используйте данные из WC()->cart;
• Для сложных ограничений с разными условиями рассмотрите создание отдельного плагина с кешированием результатов;
• Обязательно проверяйте и на стороне сервера, и на стороне клиента (JavaScript) для лучшего UX;
• Избегайте жесткого хардкода лимитов, выносите их в настройки плагина или темы для удобства;
• Рекомендуется дополнительно логировать случаи превышения лимита для анализа поведения пользователей.

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