Как использовать WooCommerce order meta для кастомизированных отчетов

Что такое order meta в WooCommerce и зачем его использовать

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

Диагностика: как понять, что order meta нужны в отчетах

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

SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = ORDER_ID;

Где ORDER_ID — ID конкретного заказа. Если там есть нужные ключи, их можно использовать в отчетах.

Пошаговое решение: как добавить и вывести order meta в кастомном отчете

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

Пример добавления дополнительного поля "Номер сертификата" на страницу оформления заказа и сохранения значения в order meta:

add_action('woocommerce_after_order_notes', function($checkout) {
    echo '<div id="custom_certificate_field"><h2>Дополнительная информация</h2>';
    woocommerce_form_field('certificate_number', [
        'type' => 'text',
        'class' => ['certificate-number form-row-wide'],
        'label' => 'Номер сертификата',
        'required' => false,
    ], $checkout->get_value('certificate_number'));
    echo '</div>';
});

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

2. Получаем order meta для отчетов

Создаем кастомный WP_Query для заказов и выводим нужные метаданные:

$args = [
    'post_type' => 'shop_order',
    'post_status' => ['wc-completed', 'wc-processing'],
    'posts_per_page' => -1,
];

$orders = new WP_Query($args);

if ($orders->have_posts()) {
    echo '<table><thead><tr><th>ID заказа</th><th>Покупатель</th><th>Номер сертификата</th></tr></thead><tbody>';
    while ($orders->have_posts()) {
        $orders->the_post();
        $order_id = get_the_ID();
        $order = wc_get_order($order_id);
        $certificate = get_post_meta($order_id, 'certificate_number', true);
        $customer_name = $order->get_billing_first_name() . ' ' . $order->get_billing_last_name();

        echo "<tr><td>{$order_id}</td><td>{$customer_name}</td><td>{$certificate}</td></tr>";
    }
    echo '</tbody></table>';
    wp_reset_postdata();
} else {
    echo 'Заказы не найдены.';
}

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

• Оформите тестовый заказ, заполнив поле "Номер сертификата".
• Перейдите на страницу с кастомным отчетом, где выводится таблица заказов с этим полем.
• Убедитесь, что в таблице отображается введенное значение.
• Проверьте в базе данных, что meta_key "certificate_number" добавлен для данного заказа.

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

• Поле не сохраняется в order meta: Проверьте, правильно ли подключен хук woocommerce_checkout_update_order_meta и совпадает ли имя поля формы с ключом в $_POST.
• Пустое значение в отчете: Возможно, заказ не содержит метаданных, или неправильно получаете их через get_post_meta. Проверьте ID заказа и ключ метаданных.
• Отчет не выводится: Убедитесь, что WP_Query возвращает заказы с нужным статусом и что в шаблоне нет ошибок PHP.

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

• Всегда фильтруйте и санитизируйте данные из форм перед записью в базу: sanitize_text_field(), intval() и т.п.
• Если отчет содержит много заказов, реализуйте пагинацию или выборку по датам, чтобы не перегружать сервер.
• Кешируйте результаты отчетов, если данные не меняются часто — например, с помощью Transients API.
• Ограничьте доступ к отчету только администраторам или определенным ролям пользователя через проверку current_user_can().

Сравнение вариантов реализации кастомных отчетов WooCommerce