WooCommerce: как использовать хуки для дополнительной валидации на этапе оформления заказа

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

Стандартные проверки WooCommerce на этапе оформления заказа покрывают базовые сценарии — правильность email, заполненность обязательных полей, корректность адреса. Однако в реальных проектах часто требуется добавить собственные правила валидации — например, проверять формат пользовательских полей, ограничивать выбор товаров по условию или блокировать оформление для определённых групп пользователей.

Без дополнительной валидации возможны ошибки, создающие неудобства для клиентов или проблемы при обработке заказов. Важно уметь внедрять свои проверки корректно, чтобы не ломать стандартный процесс и отображать понятные сообщения об ошибках.

Основные хуки WooCommerce для валидации

Для расширения валидации на этапе оформления используются следующие хуки:

• woocommerce_checkout_process — запуск вашей функции во время обработки формы оформления заказа. Ваша задача — проверить нужные данные и в случае ошибки добавить сообщение.
• woocommerce_checkout_update_order_meta — используется для сохранения дополнительных данных в заказе, если требуется.
• woocommerce_after_checkout_validation — современный хук с доступом к объекту данных и аргументам, позволяет выполнять валидацию с доступом к контексту.

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

Предположим, что мы добавили на страницу оформления заказа поле «Номер договора» (custom_contract_number), и хотим проверить, что оно не пустое и соответствует формату — только цифры, длина 8 символов.

1. Добавляем поле на страницу оформления

add_action('woocommerce_after_order_notes', 'add_custom_contract_field');
function add_custom_contract_field( $checkout ) {
    woocommerce_form_field( 'custom_contract_number', array(
        'type'          => 'text',
        'class'         => array('form-row-wide'),
        'label'         => __('Номер договора'),
        'placeholder'   => __('Введите номер договора (8 цифр)'),
        'required'      => true,
    ), $checkout->get_value( 'custom_contract_number' ));
}

2. Добавляем валидацию при оформлении заказа

add_action('woocommerce_checkout_process', 'validate_custom_contract_field');
function validate_custom_contract_field() {
    if ( isset($_POST['custom_contract_number']) ) {
        $contract_number = trim($_POST['custom_contract_number']);
        if ( ! preg_match('/^\d{8}$/', $contract_number) ) {
            wc_add_notice( __('Номер договора должен содержать ровно 8 цифр.'), 'error' );
        }
    } else {
        wc_add_notice( __('Пожалуйста, введите номер договора.'), 'error' );
    }
}

3. Сохраняем значение в метаданные заказа

add_action('woocommerce_checkout_update_order_meta', 'save_custom_contract_field');
function save_custom_contract_field( $order_id ) {
    if ( ! empty($_POST['custom_contract_number']) ) {
        update_post_meta( $order_id, '_custom_contract_number', sanitize_text_field($_POST['custom_contract_number']) );
    }
}

4. Отображаем поле в админке заказа

add_action('woocommerce_admin_order_data_after_billing_address', 'display_custom_contract_field_admin', 10, 1);
function display_custom_contract_field_admin($order){
    $contract_number = get_post_meta( $order->get_id(), '_custom_contract_number', true );
    if ($contract_number) {
        echo '<p><strong>Номер договора:</strong> ' . esc_html($contract_number) . '</p>';
    }
}

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

• Перейдите на страницу оформления заказа и убедитесь, что поле «Номер договора» отображается.
• Попробуйте отправить заказ без заполнения поля — должна появиться ошибка с сообщением.
• Введите неправильный формат (например, 1234) — снова должна появиться ошибка.
• Введите корректный номер (например, 12345678) — оформление заказа должно пройти, а в админке заказа в разделе биллинга появится сохранённый номер договора.

Частые ошибки при дополнительной валидации и как их исправить

• Ошибка: Сообщения об ошибках не показываются.
  Причина: Не вызван wc_add_notice с параметром 'error' или добавлено вне хука woocommerce_checkout_process.
  Решение: Убедитесь, что валидация выполняется именно в хуке woocommerce_checkout_process и сообщения добавляются через wc_add_notice('error').
• Ошибка: Значение поля не сохраняется в заказе.
  Причина: Отсутствует код сохранения или неправильный ключ мета.
  Решение: Используйте хук woocommerce_checkout_update_order_meta, обязательно применяйте sanitize_text_field для очистки данных.
• Ошибка: Поле не отображается на странице оформления.
  Причина: Неправильный хук для добавления поля или ошибка в параметрах.
  Решение: Используйте хук woocommerce_after_order_notes или woocommerce_checkout_fields для добавления полей, проверьте правильность параметров в woocommerce_form_field.

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

• Обязательно фильтруйте и проверяйте все данные из формы, даже если поле обязательное.
• Используйте sanitize_text_field перед сохранением в метаданные заказа.
• Добавляйте минимально необходимую валидацию, чтобы не замедлять процесс оформления.
• Для сложной логики валидации рассмотрите использование AJAX для предварительной проверки без перезагрузки страницы.

Сравнение способов добавления валидации в WooCommerce