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

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

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

Пошаговое решение: как реализовать проверку с помощью хука before_add_to_cart

Шаг 1. Подключаемся к хуку

Хук woocommerce_before_add_to_cart вызывается перед добавлением товара в корзину, принимает массив параметров товара. Для отмены операции нужно использовать функцию wc_add_notice() и возвращать false.

add_action('woocommerce_before_add_to_cart', 'custom_check_before_add_to_cart', 10, 3);

Шаг 2. Реализуем функцию проверки

Пример: запрещаем добавление товара, если пользователь не заполнил поле "Номер телефона" в своём профиле.

function custom_check_before_add_to_cart($product_id, $quantity, $variation_id = 0) {
    $user_id = get_current_user_id();
    if (!$user_id) {
        wc_add_notice('Пожалуйста, войдите в аккаунт для покупки.', 'error');
        return false;
    }
    $phone = get_user_meta($user_id, 'billing_phone', true);
    if (empty($phone)) {
        wc_add_notice('Заполните номер телефона в профиле перед покупкой.', 'error');
        return false;
    }
    return true;
}

Шаг 3. Проверяем работу кода

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

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

• Отключите вход в аккаунт и попытайтесь добавить товар — должно вывести ошибку «Пожалуйста, войдите в аккаунт для покупки.»
• Войдите как пользователь без номера телефона, попытайтесь добавить товар — появится ошибка о необходимости заполнить телефон.
• Войдите как пользователь с заполненным телефоном — товар должен добавляться в корзину без ошибок.

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

• Ошибка: Хук не срабатывает, товар добавляется несмотря на проверку.
  Причина: Использование add_action вместо add_filter, или неверное возвращаемое значение.
  Решение: Для отмены добавления используйте фильтр woocommerce_add_to_cart_validation, а не woocommerce_before_add_to_cart. Пример ниже.
• Ошибка: Сообщения об ошибках не отображаются.
  Причина: Отсутствует вызов wc_add_notice() с типом 'error'.
  Решение: Используйте wc_add_notice('Сообщение', 'error'); для информирования пользователя.
• Ошибка: Проверка не учитывает вариации товара.
  Решение: В функции учитывайте параметр $variation_id и проверяйте его при необходимости.

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

• Обрабатывайте пользовательские данные через безопасные функции WordPress (например, get_user_meta) для предотвращения SQL-инъекций.
• Не делайте сложных запросов в функции проверки — это может замедлить добавление в корзину и ухудшить UX.
• Если проверок много, рассмотрите кеширование результатов или перенос логики на фронтенд с AJAX-подтверждением.

Пример правильной реализации с фильтром woocommerce_add_to_cart_validation

add_filter('woocommerce_add_to_cart_validation', 'custom_validate_add_to_cart', 10, 3);
function custom_validate_add_to_cart($passed, $product_id, $quantity) {
    $user_id = get_current_user_id();
    if (!$user_id) {
        wc_add_notice('Пожалуйста, войдите в аккаунт для покупки.', 'error');
        return false;
    }
    $phone = get_user_meta($user_id, 'billing_phone', true);
    if (empty($phone)) {
        wc_add_notice('Заполните номер телефона в профиле перед покупкой.', 'error');
        return false;
    }
    return $passed;
}

Сравнение подходов: add_action vs add_filter для проверки добавления в корзину