【插件】微信口令解锁内容（子比主题适配）

==========================================================

微信口令解锁内容（子比主题适配） 安装使用说明

作者：启点无盘网络 插件主页：https://www.028wp.com 版本：1.2.0

适用环境：WordPress 5.5+ / PHP 7.2+ / 子比主题 V9 ==========================================================

【插件功能简介】

———————————————————-

在文章中用短代码包裹需要隐藏的内容，读者看到的是一个 “扫码关注公众号 → 回复关键词 → 获取口令 → 输入口令解锁” 的卡片。输入正确口令后，隐藏内容通过 AJAX 加载显示， 验证成功后在有效期内无需重复输入。 卡片样式完全跟随子比主题：主题主色、浅色/暗色模式自动适配。 隐藏内容在验证前不会出现在网页源代码中，兼容页面缓存。 ———————————————————-

一、安装插件

———————————————————-

方法一：后台上传（推荐）

1. 登录 WordPress 后台，进入「插件 → 安装插件」。

2. 点击顶部「上传插件」，选择文件 wxlock-wechat-unlock.zip 点击「现在安装」。

3. 安装完成后点击「启用插件」。

方法二：FTP/面板手动安装

1. 解压 wxlock-wechat-unlock.zip， 得到 wxlock-wechat-unlock 文件夹。

2. 将该文件夹上传到网站的 /wp-content/plugins/ 目录下。

3. 后台「插件」列表中找到“微信口令解锁内容”，点击启用。 【更新插件 / 覆盖安装】

1. 后台「插件」列表中先“停用”旧版，再点“删除”。 （文章里的短代码不会受影响，请放心删除。）

2. 上传新版 zip 并启用。

3. 如果网站使用了 WP Rocket、LiteSpeed、宝塔缓存或 CDN， 请清理一次页面缓存；浏览器按 Ctrl + F5 强制刷新。

* 自 1.2 版本起，资源已按文件修改时间自动防缓存。

———————————————————-

二、后台基础配置

———————————————————-

进入「设置 → 微信口令解锁」，依次填写：

1. 全局口令：读者需要输入的密码（如 2024）。

2. 公众号二维码：点“上传/选择图片”，上传关注用二维码。

3. 公众号名称：如“XX资源网”。

4. 回复关键词：引导读者回复的关键词（如“密码”）。

5. 提示文案、输入框占位文字、按钮文字等可按需修改。

6. 解锁有效期：验证成功后记住状态的天数。 填写完成后点“保存”。

———————————————————-

三、配置微信公众号自动回复（微信端）

———————————————————-

1. 登录微信公众平台（mp.weixin.qq.com）。

2. 进入「自动回复 → 关键词自动回复」。

3. 新建规则：关键词填上面设置的“回复关键词”， 回复内容填上面设置的“全局口令”。 读者关注公众号后回复关键词，即会自动收到口令。

———————————————————-

四、在文章中使用

———————————————————-

最基础的写法：

单篇文章单独设置口令： 完整参数示例：

短代码参数说明：

┌──────────┬──────────────────────────────────────┐

│ pwd │ 本模块的口令，留空用全局口令 │

│ qrcode │ 本模块专用二维码，留空用全局二维码 │

│ keyword │ 引导回复的关键词（别名 reply） │

│ tip │ 自定义提示语，支持 {keyword} │ │

│ 和 {wechat} 占位符 │

│ wechat │ 本模块专用公众号名称 │

└──────────┴──────────────────────────────────────┘

———————————————————-

五、编辑器里的“微信解锁”按钮

———————————————————-

子比主题前台投稿编辑器、后台经典编辑器工具栏上都有 「微信解锁」按钮：

· 先选中要隐藏的文字，再点按钮 → 自动用短代码包裹；

· 不选中直接点按钮 → 插入占位短代码， 且“在此输入需要隐藏的内容”已被选中，直接打字替换即可。

· 经典编辑器“文本”模式工具栏也有快捷按钮。

· 古腾堡（区块）编辑器请添加“简码”区块， 手动输入

。

按钮样式跟随主题：暗色工具栏下自动变浅色， hover 显示主题主色。

———————————————————-

六、主题跟随说明

———————————————————-

· 卡片背景、边框、文字、输入框、按钮颜色全部读取 子比主题变量，修改主题配色或切换深色模式后自动变化。

· 二维码图片本身固定为白底，属于扫码识别的正常需要。

· 暗色模式下卡片应为深灰底、浅色文字、主题色按钮； 若发现卡片仍是白底白字，请参考第一节【更新插件】 完成覆盖安装并清理缓存。

———————————————————-

七、安全机制

———————————————————-

· 未验证前前端网页源代码中不含任何隐藏内容。

· AJAX 请求带 nonce 校验，防止跨站请求伪造。

· 口令使用 hash_equals 恒定时间比较。

· 同一 IP 错误尝试限流（10 分钟内最多 20 次）。

· 解锁状态使用 HMAC-SHA256 签名 Cookie，无法伪造。

———————————————————-

八、常见问题

———————————————————-

Q：更新后样式没变化（白底、文字看不清）？

A：基本是缓存问题。删除旧版重装新版，清理页面缓存/CDN， 浏览器 Ctrl+F5 强刷。

自查：按 F12 用元素检查点击卡片外层 div， 能看到 data-ver=”1.2.0″ 即为新版。

Q：卡片提示“管理员尚未配置解锁口令”？ A：请到「设置 → 微信口令解锁」填写全局口令， 或在短代码中加 pwd 参数。

Q：一篇文章可以放多个解锁模块吗？

A：可以，每个模块可分别设置口令，互不影响。

Q：隐藏内容会不会被搜索引擎或查看源代码看到？

A：不会。内容保存在服务器，验证通过后才通过 AJAX 返回； 同时与静态页面缓存兼容。

Q：删除插件后文章里的短代码怎么办？

A：短代码是普通文本，删除插件不会自动删除， 如需彻底移除请手动清理文章中的