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

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

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

Использование этого хука позволяет гибко расширять стандартную проверку WooCommerce без необходимости изменять ядро или шаблоны, что важно для обновляемости и надежности сайта.

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

В WooCommerce базовая валидация затрагивает обязательные поля, формат email и т.п. Однако часто нужны дополнительные проверки, например:

• Проверка суммы минимального заказа в зависимости от роли пользователя
• Блокировка выбора определенных способов доставки при определенных условиях
• Проверка пользовательских полей, добавленных через кастомные формы
• Валидация по сторонним API, например, проверка адреса

Если эти проверки не внедрить, пользователь может оформить заказ с некорректными данными, что приведет к ошибкам в обработке, возвратам или дополнительной ручной работе.

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

1. Подключаем функцию к хуку

add_action('woocommerce_checkout_process', 'custom_checkout_field_validation');

2. Реализуем функцию проверки

function custom_checkout_field_validation() {
    // Пример: проверяем, что поле "Номер паспорта" заполнено и содержит 10 цифр
    if ( isset($_POST['passport_number']) ) {
        $passport = sanitize_text_field($_POST['passport_number']);
        if ( !preg_match('/^\d{10}$/', $passport) ) {
            wc_add_notice(__('Введите корректный номер паспорта из 10 цифр.'), 'error');
        }
    } else {
        wc_add_notice(__('Поле номер паспорта обязательно для заполнения.'), 'error');
    }

    // Пример: минимальная сумма заказа для роли "оптовик"
    if ( current_user_can('wholesale_customer') ) {
        $minimum = 5000; // в валюте магазина
        if ( WC()->cart->total < $minimum ) {
            wc_add_notice(sprintf(__('Минимальная сумма заказа для оптовиков — %s.'), wc_price($minimum)), 'error');
        }
    }
}

Как проверить, что проверка работает правильно

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

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

• Ошибка: Ошибки не отображаются, хотя wc_add_notice вызывается.
  Причина: Возможно, функция вызывается слишком рано или не подключена к хуку woocommerce_checkout_process.
  Решение: Убедитесь, что add_action вызывается в правильном хуке (например, в functions.php темы или плагина) и без ошибок.
• Ошибка: Проверка игнорируется при использовании сторонних плагинов оформления заказа.
  Причина: Плагины могут менять порядок или логику валидации.
  Решение: Проверьте совместимость плагинов, возможно, придется использовать другие хуки или интегрироваться с API плагина.
• Ошибка: При добавлении сложной логики проверка сильно замедляет оформление.
  Решение: Оптимизируйте код, избегайте тяжелых запросов в функции или переносите их в асинхронные процессы, если возможно.

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

• Всегда используйте sanitize_text_field() или аналогичные функции для очистки данных из $_POST.
• Не делайте валидацию зависимой от фронтенда — проверка должна быть серверной, чтобы исключить обход через инструменты разработчика.
• Избегайте тяжелых внешних запросов при проверке — если они необходимы, кэшируйте результаты или используйте WP-Cron для предварительной проверки.
• Добавляйте понятные и локализованные сообщения об ошибках, чтобы пользователь понимал, что исправить.
• Проверяйте совместимость с кеширующими плагинами и сервисами, так как ошибки могут не отображаться при агрессивном кэшировании.

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