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

Проблема: необходимость добавить или изменить метаданные заказа во время оформления

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

Диагностика проблемы

Основные сложности при работе с метаданными заказа:

• Выбор правильного хука, который сработает после создания заказа.
• Корректное сохранение данных в базе.
• Обработка пользовательских данных из формы оформления.

Если метаданные не сохраняются, проверьте:

• Используете ли хук, который выполняется после создания объекта WC_Order.
• Правильность вызова методов update_meta_data и save.
• Передаются ли данные из формы корректно и валидируются.

Пошаговое решение: добавление метаданных с помощью хука woocommerce_checkout_update_order_meta

Этот хук срабатывает после того, как заказ создан и передан в обработку. Он принимает ID заказа, что позволяет получить объект заказа и обновить его метаданные.

add_action('woocommerce_checkout_update_order_meta', 'wpurok_add_custom_order_meta', 10, 1);
function wpurok_add_custom_order_meta($order_id) {
    if (isset($_POST['my_custom_field']) && !empty($_POST['my_custom_field'])) {
        $custom_value = sanitize_text_field($_POST['my_custom_field']);
        $order = wc_get_order($order_id);
        $order->update_meta_data('my_custom_field', $custom_value);
        $order->save();
    }
}

В этом примере мы берем данные из дополнительного поля формы оформления my_custom_field, очищаем и сохраняем в метаданные заказа. Если поля нет или оно пустое, метаданные не обновляются.

Добавление пользовательского поля в форму оформления

Чтобы поле my_custom_field было в форме checkout, добавьте:

add_action('woocommerce_after_order_notes', 'wpurok_add_custom_checkout_field');
function wpurok_add_custom_checkout_field($checkout) {
    woocommerce_form_field('my_custom_field', array(
        'type' => 'text',
        'class' => array('my-field-class form-row-wide'),
        'label' => __('Дополнительная информация'),
        'placeholder' => __('Введите данные'),
        'required' => false,
    ), $checkout->get_value('my_custom_field'));
}

Валидация пользовательского поля

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

add_action('woocommerce_checkout_process', 'wpurok_validate_custom_checkout_field');
function wpurok_validate_custom_checkout_field() {
    if (isset($_POST['my_custom_field']) && strlen(trim($_POST['my_custom_field'])) > 100) {
        wc_add_notice(__('Поле "Дополнительная информация" не может превышать 100 символов.'), 'error');
    }
}

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

Чтобы убедиться, что метаданные успешно добавлены:

1. Оформите тестовый заказ, заполнив дополнительное поле.
2. В админке WooCommerce в разделе заказов откройте созданный заказ.
3. Проверьте вкладку "Дополнительные данные" или используйте отладчик, например, через консоль браузера или плагины для просмотра метаданных.

Также можно вывести метаданные на странице благодарности или в письме:

add_action('woocommerce_thankyou', 'wpurok_display_custom_order_meta', 20);
function wpurok_display_custom_order_meta($order_id) {
    $order = wc_get_order($order_id);
    $value = $order->get_meta('my_custom_field');
    if ($value) {
        echo '<p><strong>Дополнительная информация:</strong> ' . esc_html($value) . '</p>';
    }
}

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

• Метаданные не сохраняются: возможно, не вызван метод $order->save(). Проверьте, что после update_meta_data вызывается save().
• Данные не проходят в обработчик: убедитесь, что имя поля в форме совпадает с ключом в $_POST.
• Хук не срабатывает: используйте woocommerce_checkout_update_order_meta, а не более ранние хуки, так как объект заказа должен быть создан.
• Нет валидации или неправильная валидация: добавьте проверку в woocommerce_checkout_process, чтобы избежать некорректных данных.

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

• Всегда используйте функции санитизации данных (sanitize_text_field, esc_html и т.п.) перед сохранением и выводом.
• Минимизируйте объем данных в метаданных, чтобы не раздувать базу.
• Для сложных данных используйте сериализацию или JSON, но будьте осторожны с размером и структурой.
• Если нужно массово обновлять метаданные, делайте это через WP CLI или пакетные скрипты, чтобы не нагружать сайт.

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

Метод	Плюсы	Минусы
Хук woocommerce_checkout_update_order_meta	Прост в реализации, срабатывает сразу после создания заказа	Только для данных из checkout
Использование save_post_shop_order	Можно обновлять метаданные в любое время при сохранении заказа	Сложнее контролировать момент добавления и данные формы
Плагин для пользовательских полей (ACF, WooCommerce Checkout Field Editor)	Удобный интерфейс, автоматическая интеграция	Дополнительная нагрузка, ограниченная гибкость