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

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

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

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

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

1. Определяем роли пользователей и желаемые лимиты

Для примера возьмём три роли с разными лимитами:

• subscriber — розничный покупатель, максимум 3 товара;
• wholesale_customer — оптовый покупатель, максимум 10 товаров;
• administrator — администратор, без ограничений.

2. Добавляем проверку при добавлении товара в корзину

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

add_filter('woocommerce_add_to_cart_validation', 'limit_cart_items_by_user_role', 10, 3);
function limit_cart_items_by_user_role($passed, $product_id, $quantity) {
    if (current_user_can('administrator')) {
        return $passed; // Без ограничений для админа
    }

    $user = wp_get_current_user();
    $role = (array) $user->roles;
    $role = reset($role); // первая роль

    $limits = [
        'subscriber' => 3,
        'wholesale_customer' => 10,
    ];

    if (!isset($limits[$role])) {
        return $passed; // Неограниченно для других ролей
    }

    // Подсчитываем текущее количество товаров в корзине
    $cart = WC()->cart->get_cart();
    $current_qty = 0;
    foreach ($cart as $cart_item) {
        $current_qty += $cart_item['quantity'];
    }

    $max_qty = $limits[$role];

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

    return $passed;
}

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

Пользователь может изменить количество товаров уже в корзине, поэтому нужно ограничить и эти действия. Используем хук woocommerce_update_cart_validation:

add_filter('woocommerce_update_cart_validation', 'limit_cart_update_by_user_role', 10, 4);
function limit_cart_update_by_user_role($passed, $cart_item_key, $values, $quantity) {
    if (current_user_can('administrator')) {
        return $passed;
    }

    $user = wp_get_current_user();
    $role = (array) $user->roles;
    $role = reset($role);

    $limits = [
        'subscriber' => 3,
        'wholesale_customer' => 10,
    ];

    if (!isset($limits[$role])) {
        return $passed;
    }

    $cart = WC()->cart->get_cart();
    $total_qty = 0;
    foreach ($cart as $key => $cart_item) {
        if ($key === $cart_item_key) {
            $total_qty += $quantity; // обновлённое количество для текущего товара
        } else {
            $total_qty += $cart_item['quantity'];
        }
    }

    if ($total_qty > $limits[$role]) {
        wc_add_notice(sprintf('Общее количество товаров в корзине не может превышать %d.', $limits[$role]), 'error');
        return false;
    }

    return $passed;
}

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

• Зарегистрируйтесь под пользователем с ролью subscriber. Добавьте в корзину 3 товара — работает. Попытка добавить 4-й товар должна вызвать ошибку.
• Повторите тест под wholesale_customer с лимитом 10.
• Под администратором ограничений нет.
• Проверьте изменение количества товаров в корзине — увеличивать можно только до лимита.
• Для проверки ошибок воспользуйтесь встроенными уведомлениями WooCommerce.

Частые ошибки при реализации ограничений и как их исправить

• Проверка роли не срабатывает — убедитесь, что пользователь залогинен, иначе wp_get_current_user() вернёт пустую роль.
• Ошибки при подсчёте количества товаров — суммируйте quantity у всех товаров в корзине, чтобы учитывать текущие позиции.
• Ошибка с повторным добавлением одного и того же товара — WooCommerce объединяет позиции с одинаковым товаром, поэтому подсчёт должен учитывать общую сумму.
• Уведомления не отображаются — проверьте, что тема корректно выводит wc_print_notices().
• Функции не работают на странице корзины — хук woocommerce_update_cart_validation должен срабатывать при обновлении корзины, проверьте правильность подключения кода.

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

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

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