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

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

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

Хук woocommerce_checkout_process: что это и когда применять

Хук woocommerce_checkout_process вызывается в момент валидации данных формы оформления заказа, после нажатия кнопки «Оформить заказ», но до создания заказа в базе. Он идеален для добавления своих проверок и генерации ошибок, которые выведутся пользователю.

Пример базового использования хука:

add_action('woocommerce_checkout_process', function() {
    if (empty($_POST['my_custom_field'])) {
        wc_add_notice('Пожалуйста, заполните дополнительное поле.', 'error');
    }
});

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

1. Добавляем поле в форму оформления заказа

Используем хук woocommerce_after_order_notes для вывода поля:

add_action('woocommerce_after_order_notes', function($checkout) {
    woocommerce_form_field('my_custom_field', [
        'type' => 'text',
        'class' => ['my-field-class form-row-wide'],
        'label' => 'Дополнительное поле',
        'placeholder' => 'Введите значение',
        'required' => false,
    ], $checkout->get_value('my_custom_field'));
});

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

Как показано выше, проверяем наличие значения и выводим ошибку:

add_action('woocommerce_checkout_process', function() {
    if (empty($_POST['my_custom_field'])) {
        wc_add_notice('Пожалуйста, заполните дополнительное поле.', 'error');
    }
});

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

Чтобы сохранить поле в заказе, используем хук woocommerce_checkout_update_order_meta:

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

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

Добавим вывод в метабоксе заказа:

add_action('woocommerce_admin_order_data_after_billing_address', function($order) {
    $value = get_post_meta($order->get_id(), '_my_custom_field', true);
    if ($value) {
        echo '<p><strong>Дополнительное поле:</strong> ' . esc_html($value) . '</p>';
    }
});

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

• Откройте страницу оформления заказа и убедитесь, что новое поле отображается.
• Попробуйте оформить заказ, оставив поле пустым — должно появиться сообщение об ошибке.
• Заполните поле и оформите заказ — заказ должен пройти, а значение сохраниться в метаданных.
• Откройте заказ в админке WooCommerce и проверьте отображение дополнительного поля.

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

• Ошибка не отображается: Проверьте, что используете wc_add_notice(..., 'error') внутри хука woocommerce_checkout_process без условий, которые могут прерывать выполнение.
• Данные не сохраняются: Убедитесь, что имя поля совпадает в формах и в $_POST, и что используете update_post_meta с правильным ID заказа.
• Поле не показывается в админке: Проверьте правильность хука — для отображения в админке заказов используйте woocommerce_admin_order_data_after_billing_address или другой подходящий хук.
• Неправильное экранирование: Всегда используйте esc_html() при выводе данных в HTML, чтобы избежать XSS-уязвимостей.

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

• Санитизация входящих данных: Обязательно фильтруйте $_POST данные перед сохранением с помощью sanitize_text_field() или соответствующих функций.
• Минимизируйте нагрузку: Не используйте сложные запросы или тяжелую логику внутри woocommerce_checkout_process, чтобы не замедлять оформление заказа.
• Используйте nonce и проверку прав: Если добавляете сложные поля или интеграции, убедитесь, что проверяете nonce и права пользователя для предотвращения CSRF и несанкционированного доступа.

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