WooCommerce: использование хука woocommerce_add_to_cart_validation для проверки товара при добавлении в корзину

Что такое хук woocommerce_add_to_cart_validation и зачем он нужен

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

Диагностика проблемы: когда нужно использовать этот хук

Часто в WooCommerce требуется добавить логику, которую стандартные настройки не покрывают. Например:

• Запретить добавление товара при отсутствии нужного пользовательского поля
• Ограничить количество товаров в корзине по определённым правилам
• Проверить пользовательские метаданные перед добавлением товара

Без использования этого хука такие проверки реализовать сложно или невозможно без вмешательства в ядро WooCommerce.

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

Рассмотрим пример: запретим добавлять в корзину больше 3 штук товара с ID 123. Если пользователь пытается добавить больше, появится сообщение об ошибке.

add_filter('woocommerce_add_to_cart_validation', 'check_max_quantity_for_product', 10, 3);
function check_max_quantity_for_product($passed, $product_id, $quantity) {
    $max_quantity = 3;
    $target_product_id = 123;

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

Как добавить код

Этот код можно вставить в файл functions.php вашей дочерней темы или в плагин для кастомных функций.

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

1. Перейдите на страницу товара с ID 123.
2. Попробуйте добавить в корзину 2 товара, затем ещё 2. При попытке добавить больше 3 штук в сумме должно появиться сообщение об ошибке, и добавление не произойдёт.
3. Проверьте корзину — количество товара не превысит 3.

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

• Ошибка: сообщение об ошибке не появляется
  Проверьте, что вызов wc_add_notice() находится внутри условия и что хук подключён с приоритетом 10 и 3 аргументами.
• Ошибка: условие не срабатывает для вариаций
  В случае вариаций нужно проверять ID вариации (variation_id) вместо product_id. Можно использовать $cart_item['variation_id'].
• Ошибка: добавление происходит несмотря на ошибку
  Обязательно возвращайте false из функции, чтобы отменить добавление товара.

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

• Не используйте этот хук для тяжёлых операций, так как он вызывается при каждом добавлении товара в корзину и может замедлить процесс.
• Для более сложных проверок используйте transient или кэширование результатов, если данные приходят из внешних источников.
• Всегда используйте wc_add_notice() для вывода ошибок — это стандартный способ оповещения пользователя в WooCommerce.

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

Метод	Плюсы	Минусы	Рекомендации
Хук woocommerce_add_to_cart_validation	Простой, встроенный в WooCommerce, позволяет прервать добавление	Ограничен контекстом добавления товара, требует правильного возврата значения	Использовать для большинства проверок при добавлении товара
JS проверка на клиенте	Быстро, не нагружает сервер	Можно обойти, небезопасно, не останавливает серверный процесс	Дополнять серверную проверку, а не заменять
Кастомные плагины для валидации	Более гибкие, могут включать сложные правила	Сложнее поддерживать, возможны конфликты	Использовать при необходимости расширенной логики