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

Что такое хук before_add_to_cart в WooCommerce и зачем он нужен

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

Когда применять before_add_to_cart

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

Диагностика: как понять, что проверка не срабатывает

Если ваша логика на before_add_to_cart не работает, проверьте:

• Подключён ли ваш код к хуку именно woocommerce_before_add_to_cart, а не к похожему
• Используете ли правильные параметры и возвращаете ли необходимые значения
• Не конфликтует ли код с другими плагинами или темой
• Логируются ли ошибки в error_log или debug.log

Для диагностики добавьте простой лог в функцию:

add_action('woocommerce_before_add_to_cart', function() {
    error_log('before_add_to_cart хук сработал');
});

Если в логе нет сообщения, значит хук не вызывается или есть ошибка в подключении.

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

Допустим, нужно запретить добавление товара, если у пользователя роль "subscriber" и товар имеет атрибут "restricted" со значением "yes".

add_action('woocommerce_before_add_to_cart', 'check_user_role_and_product_attribute', 10, 1);
function check_user_role_and_product_attribute($product_id) {
    if(current_user_can('subscriber')) {
        $product = wc_get_product($product_id);
        $attributes = $product->get_attributes();
        if(isset($attributes['restricted'])) {
            $terms = wc_get_product_terms($product_id, 'pa_restricted', array('fields' => 'slugs'));
            if(in_array('yes', $terms)) {
                wc_add_notice(__('Вы не можете добавить этот товар в корзину.'), 'error');
                wp_safe_redirect(wc_get_cart_url());
                exit; // Прекратить выполнение, чтобы товар не добавился
            }
        }
    }
}

Обратите внимание:

• Используем wc_add_notice для сообщения об ошибке
• Редиректим на страницу корзины с помощью wp_safe_redirect и exit
• Проверяем именно атрибут товара через таксономию pa_restricted

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

Чтобы убедиться, что проверка работает:

1. Авторизуйтесь под пользователем с ролью "subscriber" (или назначьте нужную роль тестовому аккаунту).
2. Попробуйте добавить в корзину товар с атрибутом restricted=yes.
3. Должна появиться ошибка и пользователь останется без изменения корзины.
4. Для остальных пользователей и товаров добавление должно проходить без ошибок.

Если ошибки не видно, проверьте, активирован ли вывод уведомлений WooCommerce, и нет ли конфликтов с кэшами.

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

• Хук не срабатывает: Возможно, подключение функции не в том файле или в неверном хуке. Проверьте приоритет и место подключения (лучше в functions.php или в плагине).
• Редирект происходит, но товар всё равно добавляется: Не забудьте вызвать exit; после редиректа, чтобы остановить дальнейшее выполнение.
• Атрибуты товара не проверяются корректно: Удостоверьтесь, что используете правильный slug атрибута (с префиксом pa_) и что он действительно есть у товара.
• Сообщение об ошибке не отображается: Убедитесь, что в шаблонах темы есть вызов wc_print_notices() или используйте стандартные шаблоны WooCommerce.

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

• Не используйте тяжелые запросы и циклы внутри хука — это влияет на скорость добавления товара.
• Проверяйте права пользователя через current_user_can(), а не напрямую роли, чтобы не ломать расширения ролей.
• Для сложных проверок используйте transient или кэширование, чтобы не нагружать сервер повторными запросами.
• Обрабатывайте редиректы аккуратно, чтобы избежать циклов и конфликтов с другими плагинами.

Сравнение вариантов реализации дополнительной проверки товара