官方已放弃对该插件的维护，目前该项目由社区维护。

如果觉得不错，希望可以点亮 star 支持一下我~

• 更新日志
• 项目简介
• 功能特性
• 安装指南
• 使用说明
• 配置项说明
• 主题适配与二次开发
• 常见问题
• 原 GitHub 版本记录

• 新增 Argon / Sakurairo / Puock 主题评论验证码适配
• 后台配置界面样式升级为腾讯云风格

• Oyiso 主题评论验证码适配：支持 PJAX / History 导航场景与自定义评论表单提交
• 文档结构调整：主题适配说明拆分到 tencentcloud-captcha/theme-adapters/*，并补充适配器开发指引
• 移除用户体验数据上报相关逻辑与后台开关

tencentcloud-captcha 插件是腾讯云研发并面向 WordPress 站长提供的官方插件，用于在网站的注册、评论、登录、找回密码等模块启用验证码校验，防止机器人注册、垃圾评论及垃圾邮件。

标题	名称
中文名称	腾讯云验证码（CAPTCHA）插件
英文名称	tencentcloud-captcha
最新版本	v1.0.6 (2026.01.07)
适用平台	WordPress
适用产品	腾讯云验证码

• 支持在注册表单中增加验证码
• 支持在评论表单中增加验证码
• 支持用户自定义业务场景
• 支持登录表单增加验证码
• 支持找回密码表单增加验证码
• 支持配置页面验证码测试功能
• 支持本地调试日志功能

1. 克隆仓库：

   git clone https://cnb.cool/makotowu/tencentcloud-wordpress-plugin-captcha.git
   

2. 将 tencentcloud-captcha 目录复制到你的 WordPress 插件目录：

   • 目标路径：/wp-content/plugins/

1. 将 tencentcloud-captcha 目录打包为 zip（zip 根目录必须是 tencentcloud-captcha/）。
2. 登录 WordPress 后台，进入「插件」→「安装插件」→「上传插件」。
3. 上传 zip 并安装后，进入插件列表启用。

• 后台路径：进入「腾讯云设置」→「验证码」。

• 插件配置页面（配置密钥与启用场景）：

  

• 登录页面开启验证码效果：

  

• 忘记密码页面开启验证码效果：

  

• 注册页面开启验证码效果：

  

• 评论页面开启验证码效果：

  

• 配置页面测试验证码功能，并提供本地调试日志功能：

  

• 自定义密钥：插件提供统一密钥管理。在多个腾讯云插件共存时，可以共享 SecretId 和 SecretKey，也支持各插件自定义密钥。
• SecretId / SecretKey：腾讯云 API 密钥，用于调用服务端校验接口。获取入口：https://console.cloud.tencent.com/cam/capi。
• CaptchaAppId / CaptchaAppSecretKey：腾讯云验证码控制台中应用的 AppId 与密钥，需要配对使用。产品文档：https://cloud.tencent.com/document/product/1110/36334。
• 验证码启用场景：配置腾讯云验证码在 WordPress 站点中登录、评论、注册、找回密码等场景中开启。
• 自定义业务场景：开启后可为“登录/注册、评论、找回密码”等不同场景分别配置 AppId/AppSecretKey（留空则回退使用通用 AppId/AppSecretKey）。
• aidEncrypted：启用后会携带加密的 aidEncrypted 参数（需在控制台开启强制校验），可配置密文过期时间（秒）。

• 已支持主题的适配说明与排查：见 theme-adapters/README.md
• Oyiso 主题适配说明：见 oyiso/README.md
• Puock 主题适配说明：见 puock/README.md
• 如何编写新的主题适配器：见 theme-adapters/how-to-write-theme-adapter.md

含义：评论场景已开启验证码校验，但请求体未携带 codeVerifyTicket 或 codeVerifyRandstr。

建议优先参考主题适配排查文档：

• theme-adapters/README.md
• oyiso/README.md

• 支持 PHP 8 并兼容 WordPress 5.8
• 支持配置页面进行验证码测试
• 新增本地调试日志功能

• 支持在 Windows 环境下运行

• 支持在注册表单中增加验证码
• 支持在评论表单中增加验证码
• 支持用户自定义业务场景
• 支持登录表单增加验证码
• 支持找回密码表单增加验证码