WooCommerce: как использовать order meta для добавления и вывода дополнительных данных заказа

Что такое WooCommerce order meta и зачем она нужна

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

Диагностика задачи: когда и зачем использовать order meta

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

• Какие дополнительные данные нужно сохранить с заказом?
• Как эти данные будут вводиться — на странице оформления заказа, в админке или автоматически?
• Нужно ли вывести эти данные клиенту или менеджеру?

Пример задачи: добавить поле «Пожелания к заказу» на страницу оформления

Реализуем добавление текстового поля для ввода пожеланий, сохраним его в order meta и выведем в админке и в письме клиенту.

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

add_action('woocommerce_after_order_notes', 'add_custom_checkout_field');
function add_custom_checkout_field( $checkout ) {
    echo '<div id="custom_checkout_field">';
    woocommerce_form_field( 'order_wishes', array(
        'type'          => 'textarea',
        'class'         => array('order-wishes form-row-wide'),
        'label'         => __('Пожелания к заказу'),
        'placeholder'   => __('Введите ваши пожелания'),
        ), $checkout->get_value( 'order_wishes' ) );
    echo '</div>';
}

2. Проверка обязательности и валидация поля

add_action('woocommerce_checkout_process', 'validate_custom_checkout_field');
function validate_custom_checkout_field() {
    if ( ! $_POST['order_wishes'] ) {
        wc_add_notice( __('Пожалуйста, заполните поле пожеланий к заказу.'), 'error' );
    }
}

3. Сохранение данных в meta заказа

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

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

add_action('woocommerce_admin_order_data_after_billing_address', 'display_custom_order_meta_in_admin', 10, 1);
function display_custom_order_meta_in_admin( $order ) {
    $wishes = get_post_meta( $order->get_id(), 'order_wishes', true );
    if ( $wishes ) {
        echo '<p><strong>Пожелания к заказу:</strong> ' . esc_html( $wishes ) . '</p>';
    }
}

5. Добавление данных в письмо клиенту

add_filter('woocommerce_email_order_meta_fields', 'add_custom_order_meta_to_email', 10, 3);
function add_custom_order_meta_to_email( $fields, $sent_to_admin, $order ) {
    $wishes = get_post_meta( $order->get_id(), 'order_wishes', true );
    if ( $wishes ) {
        $fields['order_wishes'] = array(
            'label' => __('Пожелания к заказу'),
            'value' => esc_html( $wishes ),
        );
    }
    return $fields;
}

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

1. Перейдите на страницу оформления заказа и убедитесь, что поле «Пожелания к заказу» отображается и является обязательным.
2. Оформите тестовый заказ, заполнив поле.
3. В админке WooCommerce откройте заказ и проверьте, что пожелания отображаются под адресом биллинга.
4. Проверьте письмо, которое приходит клиенту — в разделе с метаданными заказа должна отображаться ваша дополнительная информация.

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

• Поле не сохраняется: убедитесь, что имя поля в $_POST совпадает с используемым ключом, и что функция update_post_meta вызывается с правильным ID заказа.
• Данные не отображаются в письме: проверьте, что фильтр woocommerce_email_order_meta_fields зарегистрирован и возвращает нужные поля.
• Валидация не срабатывает: проверьте подключение хука woocommerce_checkout_process и отсутствие ошибок синтаксиса.

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

• Используйте функции sanitize_textarea_field или аналогичные для очистки данных перед сохранением.
• Не храните в order meta избыточные данные. Оставляйте только необходимое для работы.
• Для сложных форм с множеством полей лучше использовать отдельные таблицы или кастомные типы записей, чтобы не загромождать метаданные заказа.

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