Как использовать хук WooCommerce before_add_to_cart для дополнительной логики при добавлении товара в корзину

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

Хук woocommerce_before_add_to_cart срабатывает непосредственно перед добавлением товара в корзину. Это позволяет внедрить дополнительную логику: проверить данные товара, изменить параметры, остановить добавление или добавить кастомные действия.

Частые задачи с этим хуком — проверка пользовательских условий, установка ограничений, логирование, изменение количества или цены товара до помещения в корзину.

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

Если в вашем магазине WooCommerce нужно:

• Запретить добавление товара при определённых условиях (например, по роли пользователя или наличию другого товара в корзине);
• Автоматически изменять количество или параметры товара в корзине;
• Добавлять метаданные к товару в корзине на этапе добавления;
• Логировать попытки добавления товара для аналитики.

И при этом стандартных настроек WooCommerce или плагинов недостаточно, хук woocommerce_before_add_to_cart — правильный выбор.

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

Рассмотрим задачу: запретить добавление товара с ID 123 пользователям, не имеющим роль «подписчик».

1. Подключаемся к хуку в файле functions.php вашей темы или в плагине:

add_action('woocommerce_before_add_to_cart', 'check_user_role_before_add_to_cart', 10, 1);

2. Создаём функцию проверки роли и прерывания добавления товара:

function check_user_role_before_add_to_cart($product_id) {
    // Проверим ID товара
    if ($product_id == 123) {
        // Получим текущего пользователя
        $user = wp_get_current_user();
        if (!in_array('subscriber', (array) $user->roles)) {
            // Добавим сообщение об ошибке
            wc_add_notice('Добавление этого товара разрешено только для подписчиков.', 'error');
            // Остановим выполнение, чтобы товар не добавился
            wp_safe_redirect(wc_get_cart_url());
            exit;
        }
    }
}

3. Сохраняем изменения и проверяем.

Как проверить, что решение работает

• Зайдите на страницу товара с ID 123 под пользователем без роли «подписчик» и нажмите «Добавить в корзину».
• Должно появиться сообщение об ошибке, и пользователь останется без изменений в корзине.
• Под пользователем с ролью «подписчик» товар добавится в корзину без проблем.
• Проверьте, что после перенаправления не происходит добавления товара через URL, например, ?add-to-cart=123.

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

• Ошибка: Товар добавляется, несмотря на проверку.
  Причина: Неправильное использование хука, отсутствие exit; после редиректа.
  Решение: Добавьте exit; после wp_safe_redirect() для остановки скрипта.
• Ошибка: Сообщение об ошибке не отображается.
  Причина: Отсутствие вызова wc_print_notices() в шаблоне корзины или темы.
  Решение: Убедитесь, что в теме выводятся уведомления WooCommerce.
• Ошибка: Функция не срабатывает на AJAX-запросах.
  Причина: При AJAX-обработке добавления товара хук может не вызываться.
  Решение: Используйте дополнительные хуки, например woocommerce_add_to_cart_validation для проверки в AJAX.

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

Если нужно всегда добавлять товар с количеством 2, можно использовать фильтр woocommerce_add_to_cart_quantity:

add_filter('woocommerce_add_to_cart_quantity', 'set_quantity_two', 10, 2);
function set_quantity_two($quantity, $product_id) {
    if ($product_id == 123) {
        return 2;
    }
    return $quantity;
}

Сравнение вариантов решения задачи ограничения добавления товара

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

• Используйте серверные проверки, не доверяйте только JS-валидации.
• Всегда проверяйте права пользователя через wp_get_current_user() или current_user_can().
• При редиректах после ошибки используйте wp_safe_redirect() и завершающий exit;.
• Для сложной логики лучше использовать фильтр woocommerce_add_to_cart_validation, так как он универсальнее и корректно работает с AJAX.
• Минимизируйте количество проверок в хуках для сохранения производительности.