SHOPAGG CMS 插件 免费

hCaptcha表单验证码

适用于灯塔CMS(Lighthouse CMS)的免费 hCaptcha 插件,保护联系表单与产品询单,支持服务端验证、独立保护开关、浅色/深色与标准/紧凑外观、故障策略和自定义验证失败提示。提供中文 Key 获取指引及真实后台设置截图。

当前版本

v1.0.1

累计安装

0

用户评分

暂无评分

更新时间

2026-10-22

应用截图

查看应用界面与主要功能

资源介绍

hCaptcha 表单验证码:为联系留言与产品询单增加人机验证

适用于灯塔CMS(Lighthouse CMS)的免费插件,为网站前台联系表单和产品询单接入 hCaptcha。通过前台验证码组件与服务端校验,帮助减少自动化垃圾留言和无效询单,让团队更专注于真实采购沟通。当前版本 1.0.1。

适用场景

  • 制造业工厂官网:保护“联系我们”留言入口,减少批量推广与机器人提交。
  • 外贸公司与 B2B 产品目录:在产品询价路径增加验证步骤,帮助筛选自动化提交。
  • 已有灯塔CMS网站:希望通过插件接入验证,而不直接修改标准主题中的表单模板。

本插件针对联系表单与产品询单,不提供登录、注册、支付或所有第三方表单的通用保护,也不承诺完全消除垃圾信息。

功能亮点

  • 两类表单独立开关:分别选择是否保护联系表单(POST /contact)与产品询单(POST /inquiry),根据业务需要启用。
  • 前台组件自动插入:读取页面中的匹配表单,在提交按钮前显示 hCaptcha;标准提交路径下通常无需修改主题。重复处理时会识别已插入的组件,避免重复插入。
  • 服务端验证:不只检查前台是否勾选,还会调用 hCaptcha 的 siteverify 接口,只有返回 success 为 true 才继续正常提交处理。
  • 后台可调外观:验证码支持浅色、深色两种主题,以及标准、紧凑两种尺寸,便于适应不同网站背景和表单空间。
  • 故障策略可选:验证服务不可用时可选择“阻止提交(推荐)”或“允许提交”。允许策略只针对网络超时、非正常 HTTP 响应或无效 JSON 等服务异常;缺少或未通过验证码的提交仍会被阻止。
  • 自定义验证失败提示:可维护验证码未完成或校验失败时的提示文案。服务暂不可用时另有固定提示。
  • 中文接入指引:两个 Key 输入框下方提供官方网址、获取步骤、域名填写示例和密钥安全提醒。

后台设置项目

设置页提供 Site Key、Secret Key、联系表单保护、产品询单保护、验证码主题、验证码尺寸、验证服务不可用时的处理方式及验证失败提示,共八项配置。Secret Key 使用密码输入框。安装后仍需填写自己的正式密钥并保存,插件不会自动申请 hCaptcha 账号或生成正式密钥。

去哪里获取 Site Key 和 Secret Key

  1. 登录官方控制台:打开 hCaptcha Dashboard,注册或登录自己的 hCaptcha 账号。
  2. 获取站点公钥:进入 Sites(站点),新增或打开站点,保存后复制 Site Key / Sitekey,填入插件的“hCaptcha Site Key(站点公钥)”。
  3. 配置网站域名:如控制台提供 Domain allowlisting,建议添加实际域名,例如 example.com;不要填写 https://、端口或页面路径。
  4. 获取服务端密钥:同一账号下打开 Settings(设置),查找 Secret Key / Siteverify Secret。使用已安全保存的密钥;尚未生成时点击 Generate New Secret,立即复制保存并填入“hCaptcha Secret Key(服务端密钥)”。
  5. 保存并测试:选择需要保护的表单并保存,然后到前台联系页或产品详情完成验证码,实际提交一次测试。

官方参考:密钥获取指南、开发者文档。控制台菜单名称可能调整,以官方页面为准。

安全提醒与常见问题

  • Site Key 是站点公钥,可发送到访客浏览器;Secret Key 仅用于服务端验证,不要互换,也不要将 Secret Key 写入前端、公开仓库或公开截图。
  • 两个 Key 应来自同一个 hCaptcha 账号。Google reCAPTCHA 与 Cloudflare Turnstile 的密钥不能直接用于本插件。
  • 任一 Key 未填写时,插件不会介入表单保护。因此“插件已启用”或“设置已保存”不代表验证码已经生效。
  • 重新生成 Secret Key 后,使用旧密钥的网站需要同步更新。不要为了查看密钥而随意重新生成。
  • README 中的官方测试密钥仅用于测试,不提供真实反垃圾保护,正式网站必须替换为自己的正式密钥。

后台设置截图

三张截图依次展示:① 完整后台设置页;② Site Key / Secret Key 获取说明;③ 表单保护、外观与故障策略。截图使用当前 1.0.1 插件配置、系统实际后台设置模板和默认选项在隔离环境渲染,两个 Key 均留空,不包含客户数据库、登录凭据或真实密钥。演示环境不提供保存功能,正式站点按正常后台流程保存。

安装与兼容要求

通过灯塔CMS(Lighthouse CMS)后台应用商店安装或更新插件,再进入插件设置填写密钥。需要灯塔CMS 1.3.0 或以上、PHP 8.1 或以上及 cURL 扩展。已有安装应通过插件更新流程升级,以刷新数据库中保存的设置说明;无需卸载或清空原有 Key 与表单配置。

插件匹配提交路径为 /contact 和 /inquiry 的 HTML 表单,并支持系统子目录路径处理。自定义提交地址、AJAX JSON 请求、动态生成或第三方表单可能需要额外适配,不能仅凭安装插件判断已覆盖这些场景。

网络连接与费用说明

本插件在 SHOPAGG 应用商店免费提供。hCaptcha 是独立的第三方服务,其账号方案、服务条款及可能产生的费用以官方为准,插件免费不等于包含所有 hCaptcha 付费能力。前台需访问 hCaptcha 官方 JavaScript 服务,服务器需访问验证接口,不支持完全离线验证。

验证时会向 hCaptcha 发送验证码令牌、站点公钥和服务端密钥;若能取得有效访客 IP,也会发送该 IP 辅助验证。请结合网站面向的地区与实际业务维护隐私告知及第三方服务说明。

1.0.1 更新内容

新增后台官方 Key 获取网址、中文申请步骤、域名填写及密钥安全提醒,同步完善 README。验证码注入、服务端校验、表单保护开关与故障策略保持不变。本次商店图文更新继续使用已发布的 1.0.1 原始 ZIP,不新增版本。

版本记录

最近发布的版本和兼容信息

版本 1.0.1

2026-10-22
需要 PHP 8.1+

完善后台插件设置:新增 hCaptcha 官方控制台、Sites 与 Settings 获取网址;详细说明 Site Key / Secret Key 的申请、域名配置与填写步骤,补充密钥保密、重新生成及正式环境使用提醒。同步更新 README,保持验证码校验及表单保护逻辑不变,保留已有设置。

版本 1.0.0

2026-08-11

更多同类应用

继续浏览适用于相同网站程序的资源

查看全部
Electronic模版
SHOPAGG CMS 主题 ¥999.00

Electronic模版

v1.2.0 · SHOPAGG

适合工业电气、电子元器件制造行业使用b2b网站模板,支持手机、平板和桌面设备的响应式布局,并提供可视化模板区块配置。网站管理员可以在...

0 次安装 在 SHOPAGG CMS 后台安装