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

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

В WooCommerce часто требуется расширять данные заказа, добавляя пользовательские поля или вычисляемые значения. Например, нужно сохранить дополнительную информацию, которую пользователь вводит на странице оформления заказа, или вычислить скидку и сохранить её в метаданных. Без правильного использования хуков данные могут не сохраняться или обновляться некорректно.

Выбор правильного хука для обновления метаданных заказа

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

• woocommerce_checkout_update_order_meta — вызывается после сохранения данных заказа, позволяет добавить или изменить метаданные.
• woocommerce_checkout_create_order — более ранний хук, позволяет изменять объект заказа перед его сохранением.
• woocommerce_checkout_update_user_meta — для обновления данных пользователя, не заказа.

В большинстве случаев для добавления или изменения метаданных заказа лучше использовать woocommerce_checkout_update_order_meta.

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

Рассмотрим пример, когда нужно сохранить в заказе дополнительное поле delivery_instructions, введённое пользователем на странице оформления.

1. Добавляем поле в форму оформления заказа

add_action('woocommerce_after_order_notes', 'add_delivery_instructions_checkout_field');
function add_delivery_instructions_checkout_field( $checkout ) {
    echo '<div id="delivery_instructions_field">';
    woocommerce_form_field( 'delivery_instructions', array(
        'type'          => 'textarea',
        'class'         => array('form-row-wide'),
        'label'         => __('Инструкции по доставке'),
        'placeholder'   => __('Введите дополнительные инструкции для курьера'),
        'required'      => false,
    ), $checkout->get_value( 'delivery_instructions' ));
    echo '</div>';
}

2. Валидируем поле (опционально)

add_action('woocommerce_checkout_process', 'validate_delivery_instructions_field');
function validate_delivery_instructions_field() {
    if ( isset($_POST['delivery_instructions']) && strlen(trim($_POST['delivery_instructions'])) > 500 ) {
        wc_add_notice( __('Инструкции по доставке не должны превышать 500 символов.'), 'error' );
    }
}

3. Сохраняем данные в метаданных заказа

add_action('woocommerce_checkout_update_order_meta', 'save_delivery_instructions_order_meta');
function save_delivery_instructions_order_meta( $order_id ) {
    if ( ! empty( $_POST['delivery_instructions'] ) ) {
        update_post_meta( $order_id, '_delivery_instructions', sanitize_textarea_field( $_POST['delivery_instructions'] ) );
    }
}

4. Отображаем данные в админке заказа

add_action('woocommerce_admin_order_data_after_billing_address', 'display_delivery_instructions_admin_order', 10, 1);
function display_delivery_instructions_admin_order($order){
    $instructions = get_post_meta( $order->get_id(), '_delivery_instructions', true );
    if ( $instructions ) {
        echo '<p><strong>Инструкции по доставке:</strong> ' . esc_html( $instructions ) . '</p>';
    }
}

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

• Перейдите на страницу оформления заказа и заполните поле «Инструкции по доставке».
• Завершите оформление заказа.
• В административной панели WooCommerce откройте заказ и убедитесь, что дополнительное поле отображается с введённым текстом.
• Для проверки сохранения метаданных можно использовать сниппет: var_dump(get_post_meta($order_id, '_delivery_instructions', true)); в шаблоне или через WP CLI.

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

• Данные не сохраняются в заказе: убедитесь, что используете правильный хук woocommerce_checkout_update_order_meta и что имя поля в форме совпадает с ключом в $_POST.
• Ошибка валидации не срабатывает: проверьте, что функция привязана к хуку woocommerce_checkout_process и правильно вызывает wc_add_notice.
• Поля не отображаются в админке: проверьте правильность использования хука woocommerce_admin_order_data_after_billing_address и что метаданные действительно сохранены.
• Проблемы с безопасностью: всегда используйте функции санитизации данных, например sanitize_textarea_field, чтобы избежать XSS и других уязвимостей.

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

• Не храните в метаданных слишком большие объёмы данных — это может замедлить загрузку заказов в админке.
• Используйте правильные префиксы для ключей метаданных, например, начинайте с подчеркивания (_delivery_instructions), чтобы избежать отображения в пользовательских полях.
• Санитизируйте и валидируйте пользовательский ввод на стороне сервера, чтобы избежать уязвимостей.
• Для сложных данных рассмотрите использование пользовательских таблиц, если метаданные становятся слишком объёмными или частыми для выборок.

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