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

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

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

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

Для добавления кастомных полей в форму оформления заказа WooCommerce применяются следующие хуки:

• woocommerce_before_order_notes — выводит содержимое перед полем с заметками к заказу.
• woocommerce_checkout_update_order_meta — обработка и сохранение данных пользовательских полей после отправки формы.
• woocommerce_admin_order_data_after_billing_address — вывод пользовательских данных в админке заказа.
• woocommerce_checkout_fields — фильтр для модификации массива полей оформления заказа, например, для добавления новых.

Пошаговое решение: добавляем поле "ИНН клиента" в оформление заказа

1. Добавим поле в форму оформления заказа через фильтр woocommerce_checkout_fields:

add_filter('woocommerce_checkout_fields', function($fields) {
    $fields['billing']['billing_inn'] = [
        'type'        => 'text',
        'label'       => 'ИНН клиента',
        'placeholder' => 'Введите ИНН',
        'required'    => true,
        'class'       => ['form-row-wide'],
        'priority'    => 120,
    ];
    return $fields;
});

2. Сохраним значение поля при оформлении заказа через хук woocommerce_checkout_update_order_meta:

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

3. Отобразим значение ИНН в админке заказа для менеджера через хук woocommerce_admin_order_data_after_billing_address:

add_action('woocommerce_admin_order_data_after_billing_address', function($order){
    $inn = get_post_meta($order->get_id(), '_billing_inn', true);
    if ($inn) {
        echo '<p><strong>ИНН клиента:</strong> ' . esc_html($inn) . '</p>';
    }
});

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

• Перейдите на страницу оформления заказа и убедитесь, что новое поле «ИНН клиента» отображается и отмечено как обязательное.
• Оформите тестовый заказ, заполнив поле валидными данными.
• В админке WooCommerce откройте созданный заказ и проверьте, что значение ИНН отображается в разделе с адресом оплаты.
• Попробуйте оформить заказ без заполнения поля — форма должна не пропустить.

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

• Поле не отображается в форме
  Проверьте, что фильтр woocommerce_checkout_fields правильно возвращает массив полей и что ключи вложены корректно (например, billing для платежных данных).
• Данные не сохраняются
  Убедитесь, что в обработчике woocommerce_checkout_update_order_meta проверяется наличие поля в $_POST, а данные перед сохранением фильтруются через sanitize_text_field.
• Поле не отображается в админке
  Проверьте правильность использования объекта $order и функции get_post_meta с правильным ключом мета-данных.
• Ошибка валидации поля
  Если поле обязательное, добавьте проверку в woocommerce_checkout_process и вывод ошибки через wc_add_notice.

Пример валидации обязательного поля ИНН

add_action('woocommerce_checkout_process', function() {
    if (empty($_POST['billing_inn'])) {
        wc_add_notice('Пожалуйста, введите ИНН клиента.', 'error');
    }
});

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

• Всегда фильтруйте и валидируйте данные из $_POST перед сохранением в базу.
• Используйте префиксы для мета-ключей, чтобы избежать конфликтов с другими плагинами.
• Для больших форм и сложных полей рассмотрите использование JavaScript для динамической валидации на клиенте.
• Минимизируйте добавление слишком большого количества кастомных полей, чтобы не замедлять процесс оформления заказа.

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