WPForms: решение проблем со сборкой данных формы при использовании WooCommerce

Автор: Константин Крылов | Опубликовано: 05.08.2026

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

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

Основные симптомы:

Поля формы не появляются в деталях заказа;
Данные не передаются в пользовательские поля заказа;
Ошибки при сохранении заказа или его обновлении;
Отсутствие данных в email уведомлениях WooCommerce, даже если форма отправлена.

Пошаговое решение: правильная передача данных из WPForms в заказ WooCommerce

1. Создание пользовательских полей в WooCommerce

Для начала нужно зарегистрировать пользовательские поля в заказе, которые будут хранить данные из WPForms. Это делается через добавление мета-данных к объекту заказа.

add_action('woocommerce_checkout_update_order_meta', 'wpforms_save_custom_fields_to_order');
function wpforms_save_custom_fields_to_order($order_id) {
    if (!empty($_POST['wpforms_field_1'])) {
        update_post_meta($order_id, '_wpforms_field_1', sanitize_text_field($_POST['wpforms_field_1']));
    }
    if (!empty($_POST['wpforms_field_2'])) {
        update_post_meta($order_id, '_wpforms_field_2', sanitize_text_field($_POST['wpforms_field_2']));
    }
}

Замените wpforms_field_1 и wpforms_field_2 на реальные имена полей вашей формы.

2. Прикрепление данных WPForms к заказу при отправке формы

WPForms не передает данные в WooCommerce по умолчанию. Нужно использовать хук wpforms_process_complete для получения данных после успешной отправки формы и прикрепления их к заказу.

add_action('wpforms_process_complete', 'attach_wpforms_data_to_woocommerce_order', 10, 4);
function attach_wpforms_data_to_woocommerce_order($fields, $entry, $form_data, $entry_id) {
    // Проверяем, что это нужная форма
    if ($form_data['id'] != 123) return; // замените 123 на ID вашей формы

    // Получаем ID заказа, например из пользовательского поля или сессии
    $order_id = isset($_SESSION['last_order_id']) ? intval($_SESSION['last_order_id']) : 0;
    if (!$order_id) return;

    // Сохраняем данные формы в мета заказа
    if (!empty($fields[1]['value'])) {
        update_post_meta($order_id, '_wpforms_field_1', sanitize_text_field($fields[1]['value']));
    }
    if (!empty($fields[2]['value'])) {
        update_post_meta($order_id, '_wpforms_field_2', sanitize_text_field($fields[2]['value']));
    }
}

Для этого нужно обеспечить передачу $order_id в сессию или иным способом, чтобы связать форму и заказ.

3. Отображение пользовательских полей в админке WooCommerce

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

add_action('woocommerce_admin_order_data_after_billing_address', 'display_wpforms_order_meta', 10, 1);
function display_wpforms_order_meta($order){
    $field_1 = get_post_meta($order->get_id(), '_wpforms_field_1', true);
    $field_2 = get_post_meta($order->get_id(), '_wpforms_field_2', true);
    if ($field_1) {
        echo '<p><strong>WPForms поле 1:</strong> ' . esc_html($field_1) . '</p>';
    }
    if ($field_2) {
        echo '<p><strong>WPForms поле 2:</strong> ' . esc_html($field_2) . '</p>';
    }
}

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

Создайте тестовый заказ через WooCommerce, отправив форму WPForms с нужными данными;
В админке WooCommerce откройте заказ и убедитесь, что данные из формы отображаются в пользовательских полях;
Проверьте email уведомления на наличие данных из формы (при необходимости добавьте в шаблон письма соответствующие мета-поля);
Убедитесь, что при обновлении заказа данные не теряются.

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

Поля формы не передаются в заказ: проверьте, что имена полей формы совпадают с теми, что используются в коде, и что данные формы реально отправляются.
Данные не сохраняются в мета заказа: убедитесь, что ID заказа доступен при обработке формы (например, через сессию или глобальные переменные).
Конфликты с другими плагинами: временно отключите плагины кэширования и безопасности, которые могут блокировать передачу POST-запросов.
Поля не отображаются в админке WooCommerce: проверьте правильность хука и используйте дебаггер для проверки получения мета-данных.

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

Всегда используйте функции sanitize_text_field() или аналогичные для очистки данных перед сохранением;
Не храните в мета-данных чувствительную информацию без шифрования;
Для больших форм и большого количества данных используйте асинхронную обработку (AJAX) и отложенную запись данных;
Используйте транзиенты или кэширование для частых запросов к мета-данным;
Проверяйте права пользователя при отображении данных в админке.

Сравнение способов передачи данных из WPForms в WooCommerce

Метод	Плюсы	Минусы	Пример
Передача через POST и сохранение в `woocommerce_checkout_update_order_meta`	Простота реализации, работает сразу при оформлении заказа	Ограничено только полями на странице оформления заказа	Первый код в статье
Обработка через хук `wpforms_process_complete` и сохранение в заказ	Гибкость, можно обрабатывать любые формы и связывать с заказами	Требует дополнительной логики для передачи ID заказа	Второй код в статье
Использование плагинов интеграции WPForms и WooCommerce	Автоматизация, готовые решения	Могут быть платными, не всегда подходят под кастомные задачи	Не рассматривается в статье

Решение проблем со сборкой данных формы при использовании WooCommerce