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

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

В WooCommerce часто требуется внедрить дополнительную логику перед добавлением товара в корзину. Например, запретить добавление товара, если пользователь не выполнил определённое условие (например, не подтвердил согласие, не указал дополнительное поле или товар запрещён к продаже в его регионе). Стандартного функционала для таких проверок может не хватать, поэтому нужно использовать хуки WooCommerce.

Что делает хук woocommerce_before_add_to_cart_quantity и почему он не подходит

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

Используем правильный хук woocommerce_add_to_cart_validation

Этот фильтр позволяет проверить данные перед добавлением и вернуть false, чтобы запретить добавление товара в корзину. Он принимает параметры:

• $passed — булево, разрешать ли добавление
• $product_id — ID товара
• $quantity — количество
• $variation_id — ID вариации (если есть)
• $variations — массив вариаций

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

add_filter('woocommerce_add_to_cart_validation', 'check_custom_condition_before_add_to_cart', 10, 5); 
function check_custom_condition_before_add_to_cart($passed, $product_id, $quantity, $variation_id = null, $variations = null) {
    if (!isset($_POST['custom_checkbox']) || $_POST['custom_checkbox'] !== 'yes') {
        wc_add_notice(__('Вы должны согласиться с условиями перед добавлением товара в корзину.', 'woocommerce'), 'error');
        return false;
    }
    return $passed;
}

Как добавить чекбокс на страницу товара

add_action('woocommerce_before_add_to_cart_button', 'add_custom_checkbox');
function add_custom_checkbox() {
    echo '<p class="form-row validate-required">';
    echo '<label class="woocommerce-form__label woocommerce-form__label-for-checkbox checkbox">';
    echo '<input type="checkbox" id="custom_checkbox" name="custom_checkbox" value="yes" />';
    echo __('Я согласен с условиями', 'woocommerce');
    echo '</label></p>';
}

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

1. Перейдите на страницу товара.

2. Попробуйте добавить товар в корзину без отметки чекбокса — появится сообщение об ошибке, товар не добавится.

3. Отметьте чекбокс и добавьте товар — товар успешно добавится в корзину.

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

• Отсутствует вывод ошибки wc_add_notice() — пользователь не видит, почему товар не добавлен. Обязательно используйте эту функцию для уведомления.
• Неправильное имя поля чекбокса в $_POST — проверяйте, что имя совпадает и поле передаётся в форме.
• Кэширование форм — при использовании кэш-плагинов убедитесь, что форма и скрипты корректно обновляются.
• Конфликты с темами или плагинами — протестируйте на чистой установке WooCommerce при возникновении ошибок.

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

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

Итоговый чек-лист для внедрения проверки перед добавлением товара в корзину

• Добавить поле в форму (например, чекбокс).
• Использовать хук woocommerce_add_to_cart_validation для проверки условия.
• Выводить ошибки через wc_add_notice().
• Проверять наличие и корректность данных в $_POST.
• Тестировать поведение на разных устройствах и с отключённым кэшем.
• Обеспечить защиту через nonce.