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

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

Частая задача — получить ввод пользователя из калькулятора на странице товара и передать эти значения в заказ WooCommerce. Проблемы обычно связаны с тем, что данные калькулятора не передаются или не сохраняются, и не отображаются в админке или в письмах. Основные причины:

• Отсутствует правильный хук для сохранения метаданных заказа.
• Данные из формы не передаются через POST или AJAX.
• Ошибки в именах полей или в структуре массива данных.
• Неправильное подключение к процессу оформления заказа.

Пошаговое решение: интеграция калькулятора с заказом WooCommerce

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

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

<form class="cart" method="post" enctype='multipart/form-data'>
  <input type="number" name="calc_field_1" value="1" min="1" />
  <input type="number" name="calc_field_2" value="0" min="0" />
  <button type="submit" name="add-to-cart" value="<?php echo get_the_ID(); ?>">Добавить в корзину</button>
</form>

Обратите внимание, что кнопка должна иметь name="add-to-cart" и value с ID товара, чтобы WooCommerce обработал добавление в корзину.

2. Передаем данные калькулятора в корзину и сессию

Добавляем фильтр, который забирает данные из POST и сохраняет их как данные корзины:

add_filter('woocommerce_add_cart_item_data', 'wpcalc_add_calculator_data_to_cart', 10, 3);
function wpcalc_add_calculator_data_to_cart($cart_item_data, $product_id, $variation_id) {
    if (isset($_POST['calc_field_1'])) {
        $cart_item_data['calc_field_1'] = sanitize_text_field($_POST['calc_field_1']);
    }
    if (isset($_POST['calc_field_2'])) {
        $cart_item_data['calc_field_2'] = sanitize_text_field($_POST['calc_field_2']);
    }
    // Чтобы уникализировать позиции в корзине, добавим ключ
    if (!empty($cart_item_data)) {
        $cart_item_data['unique_key'] = md5(microtime().rand());
    }
    return $cart_item_data;
}

3. Отображаем данные калькулятора в корзине и на странице оформления заказа

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

add_filter('woocommerce_get_item_data', 'wpcalc_display_calculator_data_cart', 10, 2);
function wpcalc_display_calculator_data_cart($item_data, $cart_item) {
    if (isset($cart_item['calc_field_1'])) {
        $item_data[] = array(
            'key' => 'Параметр 1',
            'value' => wc_clean($cart_item['calc_field_1'])
        );
    }
    if (isset($cart_item['calc_field_2'])) {
        $item_data[] = array(
            'key' => 'Параметр 2',
            'value' => wc_clean($cart_item['calc_field_2'])
        );
    }
    return $item_data;
}

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

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

add_action('woocommerce_checkout_create_order_line_item', 'wpcalc_add_calculator_data_to_order_items', 10, 4);
function wpcalc_add_calculator_data_to_order_items($item, $cart_item_key, $values, $order) {
    if (isset($values['calc_field_1'])) {
        $item->add_meta_data('Параметр 1', $values['calc_field_1'], true);
    }
    if (isset($values['calc_field_2'])) {
        $item->add_meta_data('Параметр 2', $values['calc_field_2'], true);
    }
}

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

• Добавьте товар с заполненными полями калькулятора в корзину.
• Перейдите на страницу корзины, убедитесь, что параметры отображаются у товара.
• Оформите заказ, перейдите в админку WooCommerce > Заказы > нужный заказ > просмотрите метаданные позиции товара, они должны содержать значения из калькулятора.
• Проверьте письма с подтверждением заказа — данные также должны быть видны в деталях заказа.

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

• Данные не передаются в корзину: проверьте, что поля калькулятора находятся внутри формы с классом cart и кнопка добавления товара имеет name="add-to-cart".
• Данные не отображаются в корзине: проверьте, что фильтр woocommerce_get_item_data подключён и получает правильные ключи массива.
• Данные не сохраняются в заказе: убедитесь, что используете хук woocommerce_checkout_create_order_line_item, а не устаревшие методы.
• Позиции в корзине не уникальны и сливаются: добавьте уникальный ключ unique_key в данные корзины.

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

• Обязательно используйте sanitize_text_field или другие функции очистки для всех входящих данных из формы.
• Не храните слишком большие данные в метаданных заказа — только необходимые параметры.
• При необходимости можно кешировать результаты сложных расчетов с помощью Transients API, чтобы не перегружать сервер.
• Для сложных калькуляторов с динамическими полями используйте AJAX для обновления данных без перезагрузки страницы, но обязательно синхронизируйте данные с корзиной.

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