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

Почему важно сохранять данные калькулятора в метаполях заказа WooCommerce

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

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

Типичные симптомы:

• Поля калькулятора не отображаются в админке заказа.
• Данные не передаются в письма клиенту или администратору.
• При обновлении заказа данные теряются.

Часто причина — неправильное сохранение данных, например, попытка записать их в $_POST без хука сохранения заказа или отсутствие сериализации.

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

Шаг 1. Добавление данных калькулятора в метаполя при создании заказа

Используйте хук woocommerce_checkout_create_order для добавления данных в объект заказа сразу при его создании, чтобы избежать потери данных при валидации или перезаписи.

add_action('woocommerce_checkout_create_order', 'save_calculator_data_to_order_meta', 20, 2);
function save_calculator_data_to_order_meta($order, $data) {
    if (isset($_POST['calculator_result'])) {
        $calculator_result = sanitize_text_field($_POST['calculator_result']);
        $order->update_meta_data('calculator_result', $calculator_result);
    }
}

Шаг 2. Отображение данных калькулятора в админке заказа

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

add_action('woocommerce_admin_order_data_after_order_details', 'display_calculator_data_in_admin_order');
function display_calculator_data_in_admin_order($order) {
    $calculator_result = $order->get_meta('calculator_result');
    if (!empty($calculator_result)) {
        echo '<p><strong>Результат калькулятора:</strong> ' . esc_html($calculator_result) . '</p>';
    }
}

Шаг 3. Добавление данных калькулятора в письмо клиенту

Для вставки данных в письмо используйте фильтр woocommerce_email_order_meta_fields:

add_filter('woocommerce_email_order_meta_fields', 'add_calculator_data_to_email', 10, 3);
function add_calculator_data_to_email($fields, $sent_to_admin, $order) {
    $calculator_result = $order->get_meta('calculator_result');
    if (!empty($calculator_result)) {
        $fields['calculator_result'] = array(
            'label' => __('Результат калькулятора', 'woocommerce'),
            'value' => $calculator_result,
        );
    }
    return $fields;
}

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

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

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

• Данные не сохраняются в заказе: возможно, используете хук woocommerce_checkout_update_order_meta, который не всегда срабатывает при создании заказа; предпочтительнее woocommerce_checkout_create_order.
• Данные очищаются при обновлении заказа: убедитесь, что в коде нет перезаписи метаполей без проверки существующих значений.
• Поля калькулятора не проходят валидацию или передаются пустыми: проверьте, что имена полей в форме совпадают с теми, что обрабатываются в PHP, и что данные проходят очистку через sanitize_text_field или другие функции.

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

• Всегда фильтруйте и проверяйте пользовательские данные перед сохранением в метаполя.
• Для сложных структур используйте сериализацию JSON перед сохранением и json_decode при чтении.
• Если калькулятор генерирует массивы данных, используйте update_meta_data('key', wp_json_encode($array)) и декодируйте при выводе.
• Минимизируйте работу с базой, вызывая обновление метаполей один раз в нужном хуке, а не в нескольких местах.

Сравнение вариантов сохранения данных калькулятора в заказах WooCommerce