本文详解如何通过隐藏字段与 wpcf7_form_elements 过滤器，在 contact form 7 表单中生成并传递动态值（如随机数），使其既出现在发送的邮件正文中，也可被后端 php 脚本读取。方法轻量、无需插件，兼容主流 wordpress 环境。
本文详解如何通过隐藏字段与 wpcf7_form_elements 过滤器，在 contact form 7 表单中生成并传递动态值（如随机数），使其既出现在发送的邮件正文中，也可被后端 php 脚本读取。方法轻量、无需插件，兼容主流 wordpress 环境。
在 Contact Form 7 中，默认的 [hidden] 字段仅支持静态值（如 [hidden my-field "static-value"]），无法直接嵌入 PHP 动态内容（如 rand() 或 uniqid()）。但借助 WordPress 的钩子机制，我们可以在表单渲染前动态替换占位符，从而实现「伪动态隐藏字段」——该字段的值将真实参与表单提交，并完整呈现在通知邮件和 $_POST 数据中。
✅ 正确实现步骤
1. 在表单编辑器中添加带占位符的隐藏字段
进入 WordPress 后台 → Contact Form 7 → 编辑对应表单，在表单字段区域插入以下代码：
[hidden random-id "RANDOM_ID"]
⚠️ 注意：引号内必须是纯文本占位符（如 "RANDOM_ID"），不能写成 "[random]" 或 <?php echo rand(); ?> —— CF7 不解析 PHP，仅作字符串渲染。
2. 在主题的 functions.php 中注册过滤器
将以下代码添加至当前启用主题的 functions.php 文件末尾（推荐使用子主题避免更新丢失）：
// 动态注入隐藏字段值：替换表单 HTML 中的占位符
add_filter('wpcf7_form_elements', 'cf7_inject_dynamic_value', 10, 1);
function cf7_inject_dynamic_value($form) {
// 生成唯一随机值（可根据需求调整）
$dynamic_value = uniqid('REF_', true); // 更推荐：带前缀+微秒级唯一ID
// $dynamic_value = rand(100000, 999999); // 或纯六位随机数
// 执行全局替换（区分大小写，确保占位符完全匹配）
$form = str_replace('RANDOM_ID', esc_attr($dynamic_value), $form);
return $form;
}✅ 关键说明：
- esc_attr() 确保输出安全，防止 XSS 或 HTML 注入；
- uniqid('REF_', true) 比 rand() 更可靠，避免重复冲突，适合用作订单号、工单 ID 等场景；
- 替换发生在表单 HTML 渲染阶段，因此该值会真实写入 <input type="hidden"> 的 value 属性，可被邮件模板和后端 $_POST['random-id'] 正常获取。
3. 在邮件模板中调用该字段
进入表单「邮件」设置页，在「邮件正文」区域直接使用：
您的参考编号：[random-id]
CF7 会自动将提交时的 random-id 值填入此处，收件人将看到真实的动态值（如 REF_65a1b2c3d4e5f6.78901234）。
4. 在自定义 PHP 处理脚本中读取（如 process-form.php）
若需在独立 PHP 文件中处理该值，请确保已接收 POST 数据：
if (isset($_POST['random-id'])) {
$ref_id = sanitize_text_field($_POST['random-id']);
error_log("Received ref ID: " . $ref_id); // 示例日志
// 后续业务逻辑：存入数据库、调用 API 等
}⚠️ 注意事项与最佳实践
- 不要使用 wpcf7_before_send_mail 替换邮件内容：该钩子作用于邮件生成阶段，无法影响表单 $_POST 值，会导致邮件与后端接收到的值不一致。
- 避免在多个表单中复用相同占位符：如需多表单支持，建议为每个表单设计唯一占位符（如 FORMA_RANDOM, FORMB_TOKEN），并在函数中条件判断。
- 安全性提醒：动态值若用于敏感场景（如权限令牌），请配合服务端校验与过期机制，勿仅依赖前端生成。
- 调试技巧：临时在 cf7_inject_dynamic_value 函数中添加 error_log('Injected: ' . $dynamic_value); 查看实际生成值。
通过以上配置，您即可零插件、高兼容地为 Contact Form 7 注入任意 PHP 可生成的动态值，并确保其一致性贯穿表单提交、邮件通知与后端处理全流程。
