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

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

В WooCommerce стандартное добавление товара в корзину не всегда покрывает все бизнес-требования. Часто нужно проверить определённые условия (например, наличие определённых продуктов, пользовательские роли, лимиты по количеству), или изменить данные товара на лету перед тем, как он попадёт в корзину.

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

Пошаговое решение: использование хука woocommerce_before_add_to_cart для реализации проверок

В WooCommerce есть несколько хуков, которые участвуют в процессе добавления товара в корзину. Для вмешательства до добавления товара лучше всего подходит фильтр woocommerce_add_to_cart_validation. Он позволяет отменить добавление товара и показать сообщение об ошибке.

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

add_filter('woocommerce_add_to_cart_validation', 'wpstuff_limit_product_quantity', 10, 3);
function wpstuff_limit_product_quantity($passed, $product_id, $quantity) {
    $max_quantity = 3; // Максимум 3 штуки товара
    $current_quantity = WC()->cart->get_cart_item_quantities()[$product_id] ?? 0;

    if (($current_quantity + $quantity) > $max_quantity) {
        wc_add_notice('Вы не можете добавить в корзину больше 3 единиц этого товара.', 'error');
        return false;
    }
    return $passed;
}

В этом коде перед добавлением проверяется, сколько данного товара уже в корзине, и если итоговое количество больше 3, добавление отменяется с показом ошибки.

Использование хука woocommerce_before_add_to_cart_button для вывода дополнительной информации на странице товара

Если нужно показать на странице товара предупреждение или дополнительную информацию перед кнопкой "Добавить в корзину", используйте хук woocommerce_before_add_to_cart_button:

add_action('woocommerce_before_add_to_cart_button', 'wpstuff_show_custom_message');
function wpstuff_show_custom_message() {
    echo '<p style="color:red; font-weight:bold;">Обратите внимание: максимальное количество товара для покупки – 3 шт.</p>';
}

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

• Перейдите на страницу товара и убедитесь, что под кнопкой "Добавить в корзину" отображается ваше сообщение.
• Попробуйте добавить в корзину больше 3 единиц товара. При попытке добавить 4-й товар должно появиться сообщение об ошибке и добавление должно быть отменено.
• Проверьте, что при добавлении допустимого количества товар успешно попадает в корзину.

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

• Ошибка: Добавление товара не блокируется, хотя условие возвращает false.
  Причина: Функция должна возвращать $passed (true/false), обязательно учитывайте все параметры.
• Ошибка: Сообщение об ошибке не отображается.
  Причина: Не вызван wc_add_notice() с типом 'error'. Проверьте, что функция вызывается до редиректа.
• Ошибка: Неправильно подсчитывается количество товаров в корзине.
  Причина: Используйте WC()->cart->get_cart_item_quantities() для корректного подсчёта, не считайте напрямую массив корзины.
• Ошибка: Код добавлен в неправильный файл или не подключён.
  Решение: Добавляйте код в functions.php дочерней темы или создайте отдельный плагин.

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

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

Сравнение вариантов реализации