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

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

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

Проверяем наличие данных в запросе

Для начала убедитесь, что данные калькулятора действительно передаются при добавлении в корзину. Для этого подключите следующий код в functions.php или плагин:

add_action('woocommerce_add_to_cart', function($cart_item_key, $product_id, $quantity, $variation_id, $variation, $cart_item_data) {
    error_log('Cart item data: ' . print_r($cart_item_data, true));
}, 10, 6);

Если в логе wp-content/debug.log данные калькулятора отсутствуют, значит проблема на стороне формы или JS.

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

1. Добавляем поля калькулятора в форму товара

Допустим, калькулятор возвращает числовое значение calculation_result. Добавим скрытое поле в форму товара:

add_action('woocommerce_before_add_to_cart_button', function() {
    ?>
    <input type="hidden" name="calculation_result" id="calculation_result" value="" />
    <script>
    // После расчёта калькулятора обновляем значение поля
    function updateCalculationResult(value) {
        document.getElementById('calculation_result').value = value;
    }
    </script>
    <?php
});

Вызывайте updateCalculationResult из вашего JS калькулятора с актуальным результатом.

2. Добавляем данные в корзину

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

add_filter('woocommerce_add_cart_item_data', function($cart_item_data, $product_id, $variation_id) {
    if (!empty($_REQUEST['calculation_result'])) {
        $cart_item_data['calculation_result'] = sanitize_text_field($_REQUEST['calculation_result']);
        // Генерируем уникальный ключ, чтобы элементы с разными калькуляциями не сливались
        $cart_item_data['unique_key'] = md5(microtime().rand());
    }
    return $cart_item_data;
}, 10, 3);

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

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

add_filter('woocommerce_get_item_data', function($item_data, $cart_item) {
    if (!empty($cart_item['calculation_result'])) {
        $item_data[] = array(
            'key' => 'Результат калькулятора',
            'value' => wc_clean($cart_item['calculation_result'])
        );
    }
    return $item_data;
}, 10, 2);

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

Данные из корзины нужно сохранить при создании заказа:

add_action('woocommerce_checkout_create_order_line_item', function($item, $cart_item_key, $values, $order) {
    if (!empty($values['calculation_result'])) {
        $item->update_meta_data('calculation_result', $values['calculation_result']);
    }
}, 10, 4);

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

• Добавьте товар с заполненным калькулятором в корзину
• Перейдите в корзину, убедитесь, что в описании товара отображается "Результат калькулятора" с корректным значением
• Оформите заказ и в админке WooCommerce перейдите к деталям заказа
• Проверьте, что в строках заказа в метаполях сохранён результат калькулятора

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

• Данные не передаются в корзину: Проверьте, что поле calculation_result присутствует в форме и корректно обновляется JS
• Данные сливаются для одинаковых товаров: Добавьте уникальный ключ (unique_key) в корзину, чтобы WooCommerce различал одинаковые товары с разными параметрами
• Данные не отображаются в заказе: Убедитесь, что используете хук woocommerce_checkout_create_order_line_item для сохранения метаполей
• Данные не проходят очистку: Используйте функции sanitize_text_field и wc_clean для безопасности

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

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

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