一个专业的 Typecho 文章内容隐藏插件,支持隐藏文字、图片、附件等内容,访客评论后即可查看。采用三重安全检测机制,确保内容安全。
- ✅ 多类型内容隐藏:支持隐藏文字、图片、链接、附件、代码块、伸缩框等任意内容
- ✅ 权限管理:管理员和文章作者可直接查看隐藏内容
- ✅ 持久化记忆:评论过的用户永久可见该文章的隐藏内容
- ✅ 游客友好:支持游客无需登录即可评论
- ✅ 编辑器集成:提供快捷插入按钮,简化使用流程
- 🛡️ 三重安全检测:Cookie + localStorage + 数据库验证
- 🛡️ 防绕过设计:无法通过清除浏览器数据绕过限制
- 🛡️ 跨设备同步:基于数据库的权限验证,支持多设备访问
- 🛡️ IP 级别追踪:游客评论基于 IP 地址进行权限管理
- 🎨 响应式设计:适配各种设备屏幕尺寸
- 🎨 现代化界面:使用渐变、阴影等现代 CSS 特性
- 🎨 内容预览:可选显示隐藏内容的前 30 个字符
- 🎨 自定义提示:支持自定义隐藏内容的提示文本
- 🔧 调试模式:支持测试和问题排查
- 🔧 兼容性强:支持 Typecho 1.2.1 和 PHP 7.4、8.0
- 🔧 易于配置:后台可视化配置界面
# 克隆仓库
git clone https://github.com/BXCQ/XuanSecret.git
# 或下载 ZIP 文件
wget https://github.com/BXCQ/XuanSecret/archive/master.zip- 点击右侧 Releases 下载最新版本
- 或点击 Code → Download ZIP 下载源码
-
上传文件
/usr/plugins/XuanSecret/ ├── Plugin.php # 主插件文件 ├── static/ │ ├── style.css # 样式文件 │ └── script.js # 脚本文件 ├── README.md # 说明文档 └── LICENSE # 开源协议 -
启用插件
- 进入 Typecho 后台管理
- 导航至「控制台」→「插件管理」
- 找到 XuanSecret 插件并点击「启用」
-
配置插件
- 点击「设置」进入配置页面
- 根据需要调整各项参数
这是公开的内容,所有人都可以看到。
[secret]
这是隐藏的内容,需要评论后才能查看。
支持任意 Markdown 语法和 HTML 标签。
[/secret]
这里又是公开内容。-
使用快捷按钮
- 在文章编辑页面底部找到「插入隐藏内容」按钮
- 选择要隐藏的文本后点击按钮
- 自动生成对应的隐藏标签
-
手动输入
- 直接在编辑器中输入
[secret]和[/secret]标签 - 在标签之间放置要隐藏的内容
- 直接在编辑器中输入
| 检测层级 | 技术实现 | 检测方式 | 安全级别 | 绕过难度 |
|---|---|---|---|---|
| 第 1 层 | Browser Cookie | 客户端快速识别 | 低 | 🔴 可清除 |
| 第 2 层 | localStorage | 浏览器本地存储备份 | 低 | 🔴 可清除 |
| 第 3 层 | Database Query | 服务器端数据库真实性验证 | 高 | 🟢 无法绕过 |
SELECT COUNT(coid) as count
FROM table.comments
WHERE cid = ? AND status = 'approved' AND authorId = ?SELECT COUNT(coid) as count
FROM table.comments
WHERE cid = ? AND status = 'approved' AND ip = ?- 提示文本:自定义隐藏内容的提示信息
- 评论次数要求:设置查看内容所需的评论次数
- 游客评论设置:是否允许游客无需登录即可评论
- 内容预览功能:显示隐藏内容的前 30 个字符
- 调试模式:支持 URL 参数调试和问题排查
- 智能内容识别:自动判断内容是 HTML 还是 Markdown,避免对已解析的 HTML 进行二次 Markdown 解析
- 代码块格式保护:移除 CSS 中对代码块的强制样式覆盖,保持主题原有的代码块格式
- 解析逻辑优化:已评论用户直接移除标签保留内部 HTML,未评论用户智能处理预览内容
- Ajax 处理改进:根据内容类型智能选择输出方式,避免重复解析导致的格式错误
- 样式隔离:插件样式不再影响原生 Markdown 代码块的显示效果
- HTML 结构简化:减少不必要的 HTML 包装,保持内容的原始结构
- 主题兼容性:确保与各种主题的代码高亮插件完美配合
- 服务器:支持 PHP 7.4+ 的 Web 服务器
- 框架:Typecho 1.2.1 或更新版本
- 数据库:MySQL 5.7+ 或 MariaDB 10.2+
- 浏览器:支持现代浏览器(Chrome 60+、Firefox 55+、Safari 12+、Edge 79+)
-
插件启用后没有任何效果?
- 检查文件结构和权限设置
- 重新启用插件
- 临时更换默认主题测试
-
为什么评论提交后内容仍然隐藏?
- 检查浏览器安全设置
- 后台确认评论审核状态
- 刷新页面或重新访问文章
-
如何验证插件功能是否正常?
- 使用调试参数
?xuansecret_test_uncommented=1 - 应该能看到隐藏状态的提示界面
- 使用调试参数
更多问题解决方案请查看 详细文档
本项目采用 MIT License 开源协议。
⭐ 如果这个项目对您有帮助,请给我们一个 Star!