Использование хука woocommerce_checkout_update_order_meta для добавления данных к заказу в WooCommerce

Что такое хук woocommerce_checkout_update_order_meta и зачем он нужен

Хук woocommerce_checkout_update_order_meta вызывается в процессе оформления заказа, когда создаются или обновляются метаданные заказа. Его основное назначение — добавить или изменить произвольные данные (метаполя) в объекте заказа на этапе оформления. Это полезно, если нужно сохранить дополнительные данные, введённые пользователем в кастомных полях, либо добавить внутренние метки для последующей обработки.

Диагностика: как понять, что данные не сохраняются

Если вы добавили кастомные поля на страницу оформления, но данные не отображаются в админке заказа или не сохраняются в базе, проверьте следующие моменты:

• Код, который сохраняет метаданные, подключён и вызывается ли хук;
• Используется ли правильный синтаксис для добавления метаполя (update_post_meta или методы объекта WC_Order);
• Правильно ли передаются данные из формы (проверьте $_POST);
• Нет ли конфликтов с другими плагинами, которые могут перезаписывать метаданные;
• Правильно ли указан идентификатор заказа ($order_id).

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

Рассмотрим пример, когда на странице оформления добавлено поле "Номер налоговой декларации" (tax_declaration_number), которое нужно сохранить в метаданные заказа.

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

add_action('woocommerce_after_order_notes', 'add_tax_declaration_number_field');
function add_tax_declaration_number_field( $checkout ) {
    woocommerce_form_field( 'tax_declaration_number', array(
        'type'          => 'text',
        'class'         => array('tax-declaration-number form-row-wide'),
        'label'         => __('Номер налоговой декларации'),
        'placeholder'   => __('Введите ваш номер'),
        'required'      => false,
    ), $checkout->get_value( 'tax_declaration_number' ));
}

2. Сохраняем данные в заказ с помощью хука

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

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

add_action( 'woocommerce_admin_order_data_after_billing_address', 'display_tax_declaration_number_admin_order', 10, 1 );
function display_tax_declaration_number_admin_order( $order ){
    $tax_number = get_post_meta( $order->get_id(), 'tax_declaration_number', true );
    if ( $tax_number ) {
        echo '<p><strong>Номер налоговой декларации:</strong> ' . esc_html( $tax_number ) . '</p>';
    }
}

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

После добавления кода:

• Откройте страницу оформления заказа и проверьте, что поле "Номер налоговой декларации" отображается;
• Заполните поле и завершите заказ;
• В панели администратора WooCommerce откройте созданный заказ;
• Под адресом оплаты найдите блок с дополнительной информацией и убедитесь, что там отображается введённое значение;
• Можно проверить напрямую в базе данных: в таблице wp_postmeta для post_id равного ID заказа должно быть метаполе tax_declaration_number с введённым значением.

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

• Данные не сохраняются: возможно, не подключена функция сохранения к хуку woocommerce_checkout_update_order_meta или неправильно указан параметр $order_id. Проверьте, что функция привязана именно к этому хуку.
• Поле не отображается в админке: проверьте, что используете правильный хук для вывода — woocommerce_admin_order_data_after_billing_address или woocommerce_admin_order_data_after_shipping_address, и корректно получаете данные через get_post_meta.
• Безопасность данных: всегда используйте sanitize_text_field при сохранении и esc_html при выводе, чтобы избежать XSS-уязвимостей.
• Конфликты с другими плагинами: если метаданные перезаписываются, попробуйте отключить сторонние плагины и проверить повторно.

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

• Сохраняйте только необходимые данные, избегайте хранения больших объёмов информации в метаполях заказа.
• Используйте нативные хуки WooCommerce для гарантированной совместимости и производительности.
• Регулярно проверяйте базу данных на предмет неиспользуемых метаполей — например, с помощью плагина Clearfy Pro можно автоматически оптимизировать метаданные.
• При необходимости массового обновления заказов используйте WooCommerce REST API, чтобы не нагружать сайт тяжелыми запросами.

Сравнение способов добавления данных в заказ WooCommerce