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

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

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

Диагностика проблемы

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

• Сохранены ли данные формы в базе? (WPForms ведёт свои таблицы)
• Имеется ли обработчик, который связывает ID формы и ID заказа WooCommerce?
• Добавлены ли данные из формы в метаполя заказа?
• Отображаются ли метаполя в админке WooCommerce или на странице заказа?

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

1. Добавление формы WPForms на страницу с заказом

Предположим, на странице оформления заказа вставлена WPForms форма с обязательными полями, например, дополнительный комментарий и номер договора.

2. Обработка данных после отправки формы

Используем хук wpforms_process_complete для получения данных формы и связываем их с текущим заказом WooCommerce. Важно, чтобы заказ уже был создан к моменту обработки формы. Часто форму размещают на странице «Спасибо за заказ» или используют AJAX.

3. Добавление метаданных в заказ

Пример кода для functions.php вашей темы или плагина:

add_action('wpforms_process_complete', 'wpforms_add_custom_fields_to_wc_order', 10, 4);
function wpforms_add_custom_fields_to_wc_order($fields, $entry, $form_data, $entry_id) {
    // Получаем ID текущего пользователя
    $user_id = get_current_user_id();

    // Получаем последний заказ пользователя (если несколько заказов, уточните логику)
    $orders = wc_get_orders(array(
        'customer_id' => $user_id,
        'limit' => 1,
        'orderby' => 'date',
        'order' => 'DESC',
    ));

    if(empty($orders)) {
        return; // Заказ не найден
    }

    $order = $orders[0];

    // Пример: поле с ID 3 - номер договора, ID 4 - комментарий
    $contract_number = isset($fields[3]) ? sanitize_text_field($fields[3]['value']) : '';
    $comment = isset($fields[4]) ? sanitize_textarea_field($fields[4]['value']) : '';

    if($contract_number) {
        $order->update_meta_data('contract_number', $contract_number);
    }
    if($comment) {
        $order->update_meta_data('custom_comment', $comment);
    }

    $order->save();
}

4. Отображение данных в админке WooCommerce

Чтобы видеть эти данные в админке заказа, добавим их в метабоксы или на страницу редактирования заказа:

add_action('woocommerce_admin_order_data_after_billing_address', 'display_custom_fields_in_admin_order', 10, 1);
function display_custom_fields_in_admin_order($order) {
    $contract_number = $order->get_meta('contract_number');
    $comment = $order->get_meta('custom_comment');

    if($contract_number) {
        echo '<p><strong>Номер договора:</strong> ' . esc_html($contract_number) . '</p>';
    }
    if($comment) {
        echo '<p><strong>Комментарий клиента:</strong> ' . esc_html($comment) . '</p>';
    }
}

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

• Заполните форму WPForms на странице оформления заказа или после неё.
• Зайдите в админку WooCommerce > Заказы > откройте последний заказ пользователя.
• Проверьте, отображаются ли в заказе дополнительные поля (номер договора, комментарий).
• Убедитесь, что данные сохранены в базе (через phpMyAdmin можно проверить таблицу wp_postmeta с метаполями заказа).

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

• Данные не сохраняются в заказе: возможно, заказ еще не создан при обработке формы. Решение — разместить форму на странице «Спасибо за заказ» или отложить обработку.
• Поля формы изменили ID: после редактирования формы WPForms ID полей может измениться — обновите код обработки.
• Ошибка с получением заказа пользователя: у анонимных пользователей get_current_user_id() возвращает 0. Для гостевых заказов требуется другой способ связывания (например, cookie или session).
• Данные не отображаются в админке: проверьте правильность добавления мета-боксов и используйте функции WooCommerce для вывода метаданных.

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

• Всегда фильтруйте и очищайте данные из формы перед сохранением (используйте sanitize_text_field, sanitize_textarea_field).
• Избегайте чрезмерного обращения к базе данных — кэшируйте ID заказов, если возможно.
• Если форма используется для гостевых заказов, реализуйте уникальный идентификатор сессии для связывания данных.
• Регулярно проверяйте логи ошибок сервера и PHP, чтобы оперативно выявлять проблемы с кодом.

Сравнение способов интеграции WPForms и WooCommerce