1. 为什么需要在 Contact Form 7 中获取 Referer
背景与意义
Referer URL 是 HTTP 请求头的一部分，用于标识表单提交的来源页面。在使用 Contact Form 7 时，获取 Referer 可以提升表单的可追溯性、用于 反垃圾邮件、防护以及来源统计等场景。
为了确保在表单提交时能获取到该信息，通常需要把 Referer 的数据注入到表单字段之中，并在邮件模板中引用该字段。此处的实现思路包含两种主流路径：前端注入与 服务端钩子注入，各有优劣与适用场景。
2. 前端实现：在页面提交前将 Referer 注入到表单字段
前端字段准备与页面脚本要点
第一步是在 CF7 表单中新增一个隐藏字段，用来承载 Referer 值。你可以在表单编辑中添加如下字段：隐藏字段 name="referer"
第二步使用一个简单的前端脚本，在页面加载完成时把 document.referrer 或当前页面 URL 写入该隐藏字段，确保在提交时随表单数据一起发送。
document.addEventListener('DOMContentLoaded', function() {var forms = document.querySelectorAll('form.wpcf7-form');forms.forEach(function(form) {var input = form.querySelector('input[name="referer"]');if (input) {input.value = document.referrer || window.location.href;}});
});3. 服务端实现：CF7 钩子与邮件模板整合
wpcf7_posted_data 钩子使用要点
CF7 提供了一个强大的 wpcf7_posted_data 过滤器，你可以在服务器端把 HTTP_REFERER 值注入到提交数据中，并在邮件模板中使用该字段的标签 [referer]。
通过以下代码，将 Referer 数据写入提交数据中，使得邮件模板能够直接显示该来源。
add_filter('wpcf7_posted_data', 'cf7_add_referer_to_posted', 10, 2);
function cf7_add_referer_to_posted($posted, $form){if (!isset($posted['referer'])) {$posted['referer'] = isset($_SERVER['HTTP_REFERER']) ? $_SERVER['HTTP_REFERER'] : '';}return $posted;
}在 CF7 的邮件模板中引用该字段即可，例如在邮件正文中加入 [referer]，就会把实际的 Referer 值显示出来。注意，若来源页面带有敏感信息，请在邮件中对 Referer 做隐私处理或裁剪。
4. 附加注意与替代方案
调试要点与隐私安全
在实现过程中，请确保隐藏字段的名称与提交数据中的字段名完全一致，以便 CF7 能正确识别与传递。调试时可在浏览器的网络面板查看 POST 数据，确认 referer 字段已被包含在提交之中。
关于隐私，请注意 Referer 可能包含敏感信息，如完整的 URL、令牌和查询参数。生产环境应对日志与邮件进行必要的遮掩或只记录域名等降级信息，确保合规性。
下面是一个简要的总结性要点，帮助你快速回顾各实现要点：Referer 是提交来源标识，CF7 提供前端注入隐藏字段、以及服务端通过 wpcf7_posted_data 注入数据的两种常用方法，最终可在邮件模板中通过 [referer] 标签显示出来源信息。
