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

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

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

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

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

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

Пошаговое решение: установка общего лимита товаров в заказе

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

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

    foreach ( $cart->get_cart() as $cart_item ) {
        $current_count += $cart_item['quantity'];
    }

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

    return $passed;
}

Добавьте этот код в файл functions.php вашей дочерней темы или используйте плагин для пользовательских сниппетов.

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

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

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

    foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
        if ( $product_id == $cart_item['product_id'] ) {
            $new_quantity = $cart_item['quantity'] + $quantity;
            if ( $new_quantity > $max_per_product ) {
                wc_add_notice(sprintf('Вы не можете добавить более %d штук этого товара.', $max_per_product), 'error');
                return false;
            }
        }
    }

    return $passed;
}

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

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

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

• Ошибка: Лимит не срабатывает, можно добавить больше товаров.
  Причина: Код не подключён, или есть конфликт с другим плагином, который перезаписывает проверку корзины.
  Решение: Проверьте, что код загружается (например, добавив error_log() внутри функции). Отключите временно другие плагины для проверки конфликтов.
• Ошибка: Сообщение об ошибке не отображается.
  Причина: Тема или плагин переопределяют шаблоны сообщений WooCommerce.
  Решение: Проверьте консоль браузера на ошибки JS, проверьте шаблоны темы.
• Ошибка: Ограничение применяется неправильно при AJAX-добавлении товаров.
  Причина: Фильтр woocommerce_add_to_cart_validation не всегда срабатывает для AJAX.
  Решение: Убедитесь, что AJAX-запросы проходят через стандартные хуки WooCommerce, либо добавьте обработку через wp_ajax.

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

• Всегда тестируйте добавление кода на тестовом сайте — ошибки в функции добавления в корзину могут нарушить пользовательский опыт.
• Для больших магазинов с множеством товаров и вариаций используйте кэширование результатов проверки или оптимизируйте логику, чтобы не перебирать весь массив корзины без необходимости.
• Если нужно более гибкое управление лимитами, рассмотрите использование плагина Clearfy Pro (https://wpshop.ru/plugins/clearfy?utm_source=wpset.ru&utm_medium=article&utm_campaign=woocommerce-ustanovka-limits-na-kolichestvo-tovarov-v-odnom-zakaze-s-pomoshhyu-koda), который предоставляет расширенные возможности управления WooCommerce.

Сравнение способов установки лимитов на товары в WooCommerce