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

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

Хук woocommerce_before_add_to_cart — это действие, которое срабатывает непосредственно перед добавлением товара в корзину. Он позволяет выполнить дополнительные проверки или модификации данных товара, например, проверить пользовательские поля, доступность товара по определённым условиям, или предотвратить добавление в корзину с сообщением об ошибке.

В каких случаях нужен этот хук?

• Проверка кастомных атрибутов товара, которые не проверяет стандартный WooCommerce
• Ограничение добавления товара в корзину для определённых пользователей или ролей
• Блокировка добавления товара при несоблюдении определённых условий (например, минимальный заказ, наличие сертификата)
• Вывод предупреждений или ошибок до добавления в корзину

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

Если вы реализовали пользовательскую проверку, но она не срабатывает, проверьте следующие моменты:

• Правильно ли подключён хук (add_action или add_filter)
• Используете ли вы именно woocommerce_before_add_to_cart, а не похожие хуки (например, woocommerce_add_to_cart_validation)
• Работает ли функция, не вызывает ли она фатальные ошибки
• Правильно ли возвращаете результат (например, валидация должна возвращать true или false)

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

Рассмотрим пример, когда нужно проверить, что пользователь ввёл в поле с именем «Серийный номер» уникальное значение (например, не должно повторяться в заказах).

1. Создаём поле ввода на странице товара

add_action('woocommerce_before_add_to_cart_button', function() {
    echo '<p class="form-field serial-number"><label for="serial_number">Серийный номер</label><input type="text" id="serial_number" name="serial_number" required /></p>';
});

2. Добавляем проверку поля через хук woocommerce_add_to_cart_validation

Этот хук более подходящий для валидации, потому что может вернуть false и остановить добавление товара.

add_filter('woocommerce_add_to_cart_validation', function($passed, $product_id, $quantity) {
    if (empty($_POST['serial_number'])) {
        wc_add_notice('Пожалуйста, введите серийный номер.', 'error');
        return false;
    }
    $serial = sanitize_text_field($_POST['serial_number']);

    // Проверка на уникальность: поиск в мета-данных заказов
    $args = [
        'limit' => -1,
        'status' => ['completed', 'processing'],
    ];
    $orders = wc_get_orders($args);
    foreach ($orders as $order) {
        foreach ($order->get_items() as $item) {
            if ($item->get_meta('serial_number') === $serial) {
                wc_add_notice('Этот серийный номер уже использовался в другом заказе.', 'error');
                return false;
            }
        }
    }

    return true;
}, 10, 3);

3. Сохраняем серийный номер в мета-данные позиции заказа

add_action('woocommerce_add_order_item_meta', function($item_id, $values) {
    if (!empty($_POST['serial_number'])) {
        wc_add_order_item_meta($item_id, 'serial_number', sanitize_text_field($_POST['serial_number']));
    }
}, 10, 2);

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

1. Откройте страницу товара, проверьте наличие поля «Серийный номер» под кнопкой «Добавить в корзину».
2. Попробуйте добавить товар без заполнения поля — должно появиться сообщение ошибки.
3. Добавьте товар с уникальным серийным номером — товар добавится в корзину.
4. Попробуйте добавить товар с повторяющимся серийным номером — появится ошибка.

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

• Использование неправильного хука для валидации: woocommerce_before_add_to_cart — это действие, не позволяющее остановить добавление. Для валидации используйте woocommerce_add_to_cart_validation.
• Неочищенные данные из формы: Используйте sanitize_text_field или другие функции очистки, чтобы избежать XSS и ошибок.
• Отсутствие сохранения данных в заказе: Чтобы данные из формы не потерялись, используйте хук woocommerce_add_order_item_meta.
• Проверка уникальности работает медленно: При большом количестве заказов используйте оптимизированные запросы к базе данных с мета-запросами или создайте отдельную таблицу.

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

• Используйте nonce-поля в форме для защиты от CSRF:

  wp_nonce_field('serial_number_nonce_action', 'serial_number_nonce');

  И проверяйте их в обработчике.
• Кэшируйте результаты проверки уникальности серийных номеров: Если список большой, храните список в transient и обновляйте раз в сутки.
• Минимизируйте количество запросов к базе данных: При проверке уникальности используйте WP_Query с мета-запросами, а не полный перебор заказов.

Таблица сравнения вариантов реализации проверки поля перед добавлением в корзину