- 游客评论开启时，回复与主评一致可发；关闭时前台显示「去登录」引导，不再空表单提交失败
- 列表引用块 enrichment 对齐 JSON `data` 列表；配置保存同步游客等级权限行
- 盖楼视觉：楼号 `#N`、嵌套竖线轨与卡片层级，替代纯缩进
- 游客昵称输入、字数计数、待审内联提示、已赞态；点赞/加载失败人话
- 列表按「每页条数」先显示主楼，可「加载更多」；后台评论管理支持一键通过全部待审
- 安装演示：主评 + 回复楼中楼样例
文档扩展
文档评论
文档评论、回复与点赞；可按会员权限、敏感词过滤，并支持后台审核。
商品属性
品牌官方插件
语言PHP 8.1+
数据库MySQL 5.7+ / MariaDB
环境PivArk 1.5+ · weapp 标装
类型文档扩展
版本v1.0.0
编码UTF-8
交付方式官方插件 · 授权安装
商品介绍
这个插件能帮你做什么？
当你希望访客在文章、资料页底部直接讨论、提问、点赞时，评论插件帮你零开发上线完整互动区——支持游客/会员、回复楼中楼、先审后发，后台一键审核。
适合新闻资讯、产品说明、下载资料页、会员社区等需要「看完就能留言」的场景。
典型场景
什么时候会生效？
| 情况 | 前台表现 |
|---|---|
插件已启用，模板已放 | 显示评论表单与列表 |
| 开启「先审后发」 | 新评论待后台通过后展示 |
| 关闭游客评论 | 未登录访客只能浏览，不能提交 |
| 模板未放置标签 | 该页不出现评论区块 |
站长怎么用？
- 在插件中心安装并启用「评论」。
- 打开「基础设置」：顶部数据概览可查看评论总数、待审核与已通过；下方配置开关、敏感词与会员等级权限。
- 在文档详情模板正文下方加入一行
（详见「前台调用说明」）。 - 在「评论管理」审核、删除不当内容；支持按文档、状态筛选。
访客在前台看到什么？
- 评论列表（昵称、时间、内容、点赞数）；
- 回复按钮与楼中楼结构；
- 未配置或未启用时：整块不出现，不影响页面其它内容。
常见问题
- 为什么前台没有评论框？ 检查插件是否启用、模板是否含
、当前页是否为文档详情。 - 评论提交了看不到？ 可能开启了先审后发，到「评论管理」通过即可。
使用说明
功能简介（前端向）
评论数据按当前文档 document_id 自动关联。推荐在详情页模板正文下方放置 ；需要自定义列表或 SPA 时可调 REST 接口。
推荐写法（模板标签）
系统会自动传入当前文档 ID，无需手写 id 属性。
自定义容器（可选属性）
| 属性 | 说明 | 示例 |
|---|---|---|
id | 文档 ID（默认当前页） | |
page_size | 每页条数 | |
REST API
| 接口 | 说明 |
|---|---|
GET /api/v1/plugins/doc_comment/list/{document_id}?page=1 | 分页拉取评论列表 JSON |
POST /api/v1/plugins/doc_comment/submit | 提交评论（需登录或按配置允许游客） |
GET /api/v1/plugins/doc_comment/list/123?page=1
前台效果示意
.pv-comment 相关类名。先审后发时，API 提交成功不代表立即可见；需后台审核通过后才会出现在列表接口中。
升级日志
- 文档评论、回复与点赞
- 会员等级权限、敏感词过滤与后台审核
- 前台 `` 标签挂载
- 开源标装（MIT）可二次开发
购买与安装
按下列步骤开通并安装到客户站；下方为交付、授权与售后摘要。
交易须知
- 交付形式官方插件 · 授权安装；经应用市场安装，不提供独立源码包下载。
- 授权范围插件授权绑定单个站点域名；小程序类套餐规则以对应说明为准。
- 退款规则官方插件下单后 24 小时内可申请退款（已安装也可退）。入口在订单详情「申请退款」。
- 官方保障PivArk 官方直营：提供安装指导、版本升级与技术支持。