WP Forms数据同步至WooCommerce结账字段及用户创建问题

核心问题 #

原代码仅处理已登录用户的表单数据保存，但活动注册场景下，用户提交表单时通常还没有WordPress账户，导致数据根本无法存入用户元数据，后续结账页自然无法自动填充。同时代码缺少自动创建用户账户的核心逻辑。

修正后的完整代码 #

// 提交WP Forms表单时创建用户并保存数据到用户元数据
add_action('wpforms_process_complete', 'save_wpforms_data_and_create_user', 10, 4);
function save_wpforms_data_and_create_user($fields, $entry, $form_data, $entry_id) {
    // 仅针对目标表单（替换为你的WP Forms表单ID）
    $target_form_id = 123; // 改成你实际的表单ID
    if ($form_data['id'] !== $target_form_id) {
        return;
    }

    // 提取表单字段数据（根据你的实际字段ID调整）
    $first_name = isset($fields[6]['first']) ? sanitize_text_field($fields[6]['first']) : '';
    $last_name = isset($fields[6]['last']) ? sanitize_text_field($fields[6]['last']) : '';
    $email = isset($fields[37]['value']) ? sanitize_email($fields[37]['value']) : '';
    $phone = isset($fields[7]['value']) ? sanitize_text_field($fields[7]['value']) : '';

    // 验证必填字段
    if (empty($first_name) || empty($last_name) || empty($email)) {
        return;
    }

    // 检查邮箱是否已存在用户
    $existing_user = get_user_by('email', $email);
    if ($existing_user) {
        $user_id = $existing_user->ID;
    } else {
        // 创建新用户
        $username = sanitize_user(str_replace(' ', '', $first_name . $last_name) . rand(100,999));
        $password = wp_generate_password(12, false);
        $user_id = wp_create_user($username, $password, $email);

        // 设置用户基本信息
        wp_update_user(array(
            'ID' => $user_id,
            'first_name' => $first_name,
            'last_name' => $last_name
        ));

        // 可选：发送账户创建通知邮件给用户
        wp_new_user_notification($user_id, null, 'both');
    }

    // 保存表单字段到用户元数据
    update_user_meta($user_id, 'wpforms_first_name', $first_name);
    update_user_meta($user_id, 'wpforms_last_name', $last_name);
    update_user_meta($user_id, 'wpforms_email', $email);
    update_user_meta($user_id, 'wpforms_phone', $phone);

    // 保存其他自定义字段（根据你的需求调整）
    $custom_fields = array(
        14 => 'mcm_number',
        16 => 'specialisation',
        41 => 'specializations',
        17 => 'institution',
        18 => 'designation'
    );
    foreach ($custom_fields as $field_id => $meta_key) {
        if (isset($fields[$field_id]['value'])) {
            update_user_meta($user_id, 'wpforms_' . $meta_key, sanitize_text_field($fields[$field_id]['value']));
        }
    }

    // 可选：自动登录新创建的用户
    wp_set_current_user($user_id);
    wp_set_auth_cookie($user_id);
}

// 自动填充WooCommerce结账字段
add_filter('woocommerce_checkout_get_value', 'populate_woocommerce_checkout_fields', 10, 2);
function populate_woocommerce_checkout_fields($value, $input) {
    // 如果字段已有值或用户未登录，直接返回原内容
    if (!empty($value) || !is_user_logged_in()) {
        return $value;
    }

    $user_id = get_current_user_id();
    // 字段映射：WooCommerce字段 => WP Forms用户元数据键
    $field_mapping = array(
        'billing_first_name' => 'wpforms_first_name',
        'billing_last_name'  => 'wpforms_last_name',
        'billing_email'      => 'wpforms_email',
        'billing_phone'      => 'wpforms_phone'
    );

    if (isset($field_mapping[$input])) {
        $meta_value = get_user_meta($user_id, $field_mapping[$input], true);
        return !empty($meta_value) ? $meta_value : $value;
    }

    return $value;
}

// 调试：检查用户元数据是否正确保存（仅在结账页显示，可删除）
add_action('wp_footer', 'debug_user_meta_on_checkout');
function debug_user_meta_on_checkout() {
    if (is_checkout() && is_user_logged_in()) {
        $user_id = get_current_user_id();
        $debug_info = array(
            '用户ID' => $user_id,
            '名字' => get_user_meta($user_id, 'wpforms_first_name', true),
            '姓氏' => get_user_meta($user_id, 'wpforms_last_name', true),
            '邮箱' => get_user_meta($user_id, 'wpforms_email', true),
            '电话' => get_user_meta($user_id, 'wpforms_phone', true)
        );
        error_log('结账页用户元数据调试：' . print_r($debug_info, true));
    }
}

关键修改说明 #

1. 新增用户创建逻辑：

   • 检查提交的邮箱是否已存在用户，不存在则自动生成账户
   • 设置用户基本姓名信息，可选发送账户通知邮件
   • 支持自动登录新用户，优化后续结账流程体验

2. 移除已登录限制：

   • 删除原代码中is_user_logged_in()的判断，确保未登录用户提交表单时也能保存数据并创建账户

3. 表单ID过滤：

   • 增加表单ID判断，避免所有WP Forms表单触发此逻辑，需替换为你的实际表单ID（在WP Forms编辑页面可查看）

4. 字段ID验证：

   • 请确认代码中的字段ID（如6、37、7等）与你WP Forms表单中的实际字段ID一致（可通过表单编辑页面的"字段选项"查看）

5. 数据安全处理：

   • 使用sanitize_text_field()、sanitize_email()等函数清理用户输入，避免安全风险

测试步骤 #

1. 将修正后的代码添加到主题的functions.php文件，或使用代码片段插件（如Code Snippets）
2. 替换代码中的表单ID和字段ID为你的实际值
3. 用未登录状态提交WP Forms注册表单，检查是否自动创建用户
4. 进入WooCommerce结账页，查看字段是否自动填充
5. 查看WordPress错误日志（wp-content/debug.log，需开启WP_DEBUG）确认调试信息是否正确

内容的提问来源于stack exchange，提问作者Vinay Singh