Использование WooCommerce хуков для расширения логики оформления заказа

Диагностика задачи: зачем расширять процесс оформления заказа в WooCommerce

Часто возникает необходимость добавить кастомную логику при оформлении заказа в WooCommerce — например, проверять дополнительные условия, изменять данные заказа, добавлять уведомления или интегрировать сторонние сервисы. Для этого используются хуки WooCommerce, которые позволяют внедрять код без правки ядра плагина.

Основные хуки для работы с процессом оформления заказа

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

• woocommerce_checkout_process — запуск перед проверкой данных формы, подходит для валидации;
• woocommerce_checkout_update_order_meta — сохранение дополнительных данных в мета заказа после оформления;
• woocommerce_thankyou — выполнение действий после успешного оформления;
• woocommerce_before_checkout_form и woocommerce_after_checkout_form — вывод кастомного контента в форму заказа;
• woocommerce_checkout_order_processed — событие после создания заказа, но до оплаты.

Пример: валидация на поле "Номер лицензии"

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

add_action('woocommerce_checkout_process', 'validate_license_number_field');
function validate_license_number_field() {
    if (empty($_POST['license_number']) || strlen($_POST['license_number']) !== 10) {
        wc_add_notice('Пожалуйста, введите корректный номер лицензии из 10 символов.', 'error');
    }
}

Сохранение кастомного поля в метаданных заказа

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

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

1. Добавьте поле в форму оформления заказа с помощью хука woocommerce_after_order_notes:

add_action('woocommerce_after_order_notes', 'add_license_number_checkout_field');
function add_license_number_checkout_field($checkout) {
    echo '<div id="license_number_field">';
    woocommerce_form_field('license_number', array(
        'type'          => 'text',
        'class'         => array('form-row-wide'),
        'label'         => __('Номер лицензии'),
        'placeholder'   => __('Введите номер лицензии из 10 символов'),
        'required'      => true,
    ), $checkout->get_value('license_number'));
    echo '</div>';
}

2. Добавьте функцию валидации поля (пример выше).
3. Сохраните данные в метаданные заказа (пример выше).
4. Отобразите сохранённые данные в деталях заказа в админке:

add_action('woocommerce_admin_order_data_after_billing_address', 'display_license_number_in_admin_order', 10, 1);
function display_license_number_in_admin_order($order) {
    $license_number = get_post_meta($order->get_id(), '_license_number', true);
    if ($license_number) {
        echo '<p><strong>Номер лицензии:</strong> ' . esc_html($license_number) . '</p>';
    }
}

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

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

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

• Ошибка: Поле не отображается на странице оформления.
  Причина: Хук для добавления поля подключён неправильно.
  Решение: Проверьте правильность подключения функции к woocommerce_after_order_notes и что тема поддерживает стандартные хуки WooCommerce.
• Ошибка: Валидация не срабатывает и заказ проходит с пустым или неверным полем.
  Причина: Функция валидации не подключена к woocommerce_checkout_process или не вызывает wc_add_notice с типом 'error'.
  Решение: Проверьте, что хук установлен и уведомления об ошибках выводятся.
• Ошибка: Данные не сохраняются в заказе.
  Причина: Отсутствует хук сохранения или неправильный ключ мета.
  Решение: Используйте woocommerce_checkout_update_order_meta и sanitize входные данные.

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

• Всегда используйте функции очистки данных, например, sanitize_text_field() перед сохранением пользовательских данных.
• Не храните в мета данные, которые можно получить из стандартных полей заказа, чтобы избежать избыточности.
• Для вывода дополнительных полей в админке используйте хуки WooCommerce, не меняйте ядро плагина.
• Проверяйте совместимость с используемой темой и другими плагинами, чтобы избежать конфликтов.
• Для сложных валидаций можно использовать AJAX, чтобы улучшить UX, но не заменяйте серверную проверку.

Сравнение способов добавления кастомной логики в оформление заказа