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

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

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

Как определить роль пользователя и лимит товаров

Для начала нам потребуется получить текущую роль пользователя и задать для каждой роли свой лимит на количество товаров в корзине. Для этого в WooCommerce можно использовать класс WC()->cart и функции WordPress для определения роли:

function get_cart_limit_by_role() {
    if ( is_user_logged_in() ) {
        $user = wp_get_current_user();
        // Пример лимитов
        $limits = array(
            'retail_customer' => 5,  // Розничный покупатель - до 5 товаров
            'wholesale_customer' => 50, // Оптовик - до 50 товаров
            'administrator' => 1000 // Админ без ограничений
        );
        foreach ( $user->roles as $role ) {
            if ( isset( $limits[ $role ] ) ) {
                return $limits[ $role ];
            }
        }
    }
    // Для гостей - минимальный лимит
    return 3;
}

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

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

add_filter( 'woocommerce_add_to_cart_validation', 'limit_cart_items_by_role', 10, 3 );
add_action( 'woocommerce_check_cart_items', 'check_cart_limit_on_update' );

function limit_cart_items_by_role( $passed, $product_id, $quantity ) {
    $limit = get_cart_limit_by_role();
    $current_count = WC()->cart->get_cart_contents_count();
    if ( ( $current_count + $quantity ) > $limit ) {
        wc_add_notice( sprintf( 'Вы не можете добавить больше %d товаров в корзину.', $limit ), 'error' );
        return false;
    }
    return $passed;
}

function check_cart_limit_on_update() {
    $limit = get_cart_limit_by_role();
    $current_count = WC()->cart->get_cart_contents_count();
    if ( $current_count > $limit ) {
        wc_add_notice( sprintf( 'Ваша корзина превышает лимит в %d товаров. Пожалуйста, удалите лишние позиции.', $limit ), 'error' );
    }
}

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

Чтобы убедиться, что ограничение работает:

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

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

• Неверное определение роли пользователя: убедитесь, что у пользователя действительно есть роли, используйте wp_get_current_user(). Если роли отсутствуют, функция возвращает лимит для гостей.
• Не срабатывает проверка при обновлении корзины: хук woocommerce_check_cart_items вызывается при загрузке страницы корзины, убедитесь, что корзина обновляется корректно.
• Лимит не учитывает текущее количество в корзине: важно суммировать текущее количество и добавляемое в момент проверки.
• Конфликты с кешированием: если у вас активирован кеш страниц, убедитесь, что страницы с корзиной не кешируются, иначе пользователь может видеть некорректные данные.

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

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

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