Contact Form 7创建带UID的隐藏输入及提交后获取失败问题求助

问题背景 #

需要为Contact Form 7表单添加唯一ID（lead-id）隐藏字段，表单提交后通过CURL将数据同步到CRM系统，以便后续通过该ID检索数据。目前遇到两个问题：

1. 在wpcf7_mail_sent钩子中无法获取lead-id字段的值
2. 尝试通过wpcf7_init钩子生成隐藏输入，但前端HTML中不显示该字段

错误代码示例 #

获取字段值的错误代码

add_action( 'wpcf7_mail_sent', 'on_cf7_submit' );

function on_cf7_submit( $contact_form ){
    $submission = WPCF7_Submission::get_instance();  
    $id = $submission->get_posted_data('lead-id'); // 无法获取值
    $fullName = $submission->get_posted_data('your-name');  
    $email = $submission->get_posted_data('your-email');
    $phone = $submission->get_posted_data('your-phone');
    // ... 后续CURL逻辑
}

生成隐藏字段的错误代码

add_action( 'wpcf7_init', 'init_form' );

function init_form( $tag ) {
    $id = uniqid(rand());
    return "<input type='hidden' name='lead-id' value='$id' />";
}

解决方案 #

1. 正确生成唯一隐藏字段 #

wpcf7_init钩子用于初始化CF7的自定义标签，无法直接输出HTML内容。改用自定义短码的方式生成隐藏字段：

// 注册短码生成唯一隐藏字段
add_shortcode('lead_id_field', 'generate_lead_id_field');
function generate_lead_id_field() {
    // 生成高唯一性的ID，第二个参数true增加随机熵
    $unique_id = uniqid('', true);
    // 用esc_attr确保值安全输出
    return '<input type="hidden" name="lead-id" value="' . esc_attr($unique_id) . '" />';
}

使用方法：打开CF7的表单编辑器，在需要插入隐藏字段的位置添加短码 [lead_id_field]，保存后前端表单会自动生成对应的隐藏输入。

2. 正确获取提交的lead-id值 #

确保字段已正确生成并提交后，修改获取逻辑，先验证提交实例存在，再安全获取字段值：

add_action('wpcf7_mail_sent', 'on_cf7_submit_send_to_crm');
function on_cf7_submit_send_to_crm($contact_form) {
    $submission = WPCF7_Submission::get_instance();
    // 若提交实例不存在则直接返回
    if (!$submission) return;

    $posted_data = $submission->get_posted_data();
    // 安全获取字段值，避免未定义索引报错
    $lead_id = isset($posted_data['lead-id']) ? $posted_data['lead-id'] : '';
    $fullName = isset($posted_data['your-name']) ? $posted_data['your-name'] : '';
    $email = isset($posted_data['your-email']) ? $posted_data['your-email'] : '';
    $phone = isset($posted_data['your-phone']) ? $posted_data['your-phone'] : '';

    // 仅当lead-id存在时执行CURL同步
    if (!empty($lead_id)) {
        // 替换为你的CRM API地址
        $crm_api_url = 'https://your-crm-domain.com/api/leads';
        $payload = json_encode([
            'lead_id' => $lead_id,
            'full_name' => $fullName,
            'email' => $email,
            'phone' => $phone
        ]);

        // 初始化CURL
        $ch = curl_init($crm_api_url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        // 执行请求并获取响应
        $response = curl_exec($ch);
        curl_close($ch);

        // 可根据CRM返回的响应做后续处理
        // var_dump($response);
    }
}

问题原因说明 #

• 隐藏字段生成失败：wpcf7_init钩子的作用域不对，该钩子用于注册CF7自定义标签，而非直接输出表单元素，返回的HTML不会被渲染到表单中。
• 字段值获取失败：原代码未验证$submission实例是否存在，且若字段未正确生成提交，自然无法获取到值；改用数组安全访问的方式可避免报错，并确保值的有效性。

内容的提问来源于stack exchange，提问作者Vašek Chadt