外观
校对日期:2026-11-17。适用于社区版及全部商业版(AI 审核、AI 拟稿和维护敏感词库需标准版)。
评论 是访客在文章页下发表的短评,挂在某篇文章上;留言 是站点的留言板,访客按类型(咨询、建议等)留言,工作人员在控制台答复。 两者都在 互动 菜单里管理:互动 → 评论管理、互动 → 留言管理。
两者共用一套状态:已审核、未审核、已屏蔽。前台只显示“已审核”的内容。
在 配置 → 站点设置 → 评论设置 里设置,每个站点各自一份:
评论图片的大小和张数在 配置 → 全局设置 → 上传设置 里,与投稿图片等会员上传共用:“会员图片最大长度”(默认 5 MB;为 0 则按“图片最大长度”,两者都设了取较小的)、 “会员每日图片上限”(默认 50 张,各处会员上传合计),填 0 为不限。
默认主题的文章页底部是评论区:输入文字,点“发表评论”。登录会员还可以:
@用户名
评论区只列已审核的评论。接口支持回复:提交时带上被回复评论的 parentId,回复只有一层,回复别人的回复会归到顶层评论下。默认主题没有回复按钮。
parentId
会员在个人中心的“我的评论”(/settings/comment)里能看到自己全部状态的评论,并可删除;删除时连同这条评论下的回复一起删掉。
/settings/comment
进入 互动 → 评论管理。表格上方的页签按状态筛选:全部、已审核、未审核、已屏蔽;可按 评论内容 或 ID 查询。 控制台首页的“待办”里有“未审核评论”胶囊,点开就是“未审核”页签。
isRecommended
文章的“评论次数”(模板里是 article.comments)只计已审核的评论,评论审核通过、屏蔽或删除时随之增减。
article.comments
评论第一次变为“已审核”时(直接显示或审核通过),系统发出会员通知:被回复的评论作者收到“评论回复”,被 @ 的用户收到“@提及”, 关注了这篇文章的会员收到“关注文章新评论”。同一个人只收一条,评论者本人不收;之后再改状态不会重发。
/message-board
/message-board/create
/message-board/{id}
子目录站点的地址前面加上子目录,如 /en/message-board。站点关闭了留言时这三个页面都打不开。需要登录而访客未登录时,打不开留言表单,也不能提交。
/en/message-board
各项的长度上限:标题 150 字,联系人、昵称 30 字,电话、邮箱 50 字,地址 150 字。公开接口不返回联系人、电话、邮箱、地址和 IP,默认主题的页面也不显示它们。
进入 互动 → 留言管理。页签和 状态修改为、删除 的用法与评论管理相同;可按 留言标题、留言类型 或 ID 查询,列表的 是否回复 列显示有没有答复。 控制台首页的“待办”里有“未审核留言”胶囊。
点 编辑 打开一条留言:
答复不改变状态。 留言要在前台显示,须是“已审核”;只写了答复的“未审核”留言,前台仍然看不到。留言的答复和状态变化都不会通知留言人。
点 新增 可以在控制台录入一条留言,留言用户记为当前操作员。新增的留言同样是“未审核”;新增时设置的 是否推荐 不会保存,答复也要在新增后编辑时填写。
点 类型管理,在对话框里 新增、编辑、删除 类型,拖动行首的图标调整顺序(前台的类别按这个顺序排列)。每个类型有 名称(30 字以内)和 描述(300 字以内)。 留言类型属于当前站点。类型下还有留言时不能删除,先删掉这些留言或把它们改成别的类型。
敏感词:评论的内容、留言的标题和内容在提交时都会对照敏感词库检查。命中的评论强制进“未审核”,即使站点关闭了“是否需要审核”;留言本来就是“未审核”。 提交者不会收到任何提示,看到的是正常的提交结果,以免暴露词库。词库在 配置 → 敏感词 里维护(标准版),所有站点共用。
验证码:评论的场景是 comment,留言是 messageBoard。同一 IP 一小时内的提交未达到 配置 → 全局设置 → 验证码 的“免验证提交次数”(默认 3)时不显示验证码, 浏览器在后台完成一次计算即可提交;达到后弹出滑块等可见验证。评论和留言分开计数。默认主题的评论框在第一次点进输入框时才加载验证组件。 设置项和第三方验证码见验证码。
comment
messageBoard
在 配置 → 全局设置 里配置好 AI 服务商,再在 配置 → 站点设置 → AI功能 里把 审核模式 设为“标记”或“自动处置”,每条评论和留言提交后都会在后台交给模型分类:
服务商配置、判定类别、阈值和失败处理见 AI 功能的“评论与留言的 AI 审核”一节。
在 用户 → 角色管理 给角色分配权限时,相关节点如下:
默认主题的相关模板:评论区在 templates/article.html(产品、下载等其它文章模板没有评论区),个人中心的“我的评论”是 templates/mem_settings_comment.html; 留言板是 templates/sys_message_board.html(列表)、sys_message_board_form.html(表单)、sys_message_board_item.html(详情,模板里可用 messageBoard)。 默认主题在 article.allowComment && site.comment.enabled 时显示评论区,并按 site.comment.loginRequired、site.comment.imageEnabled 决定显示表单和图片按钮。 留言内容是纯文本,输出时要转义(默认主题用 bbcode());回复内容是保存时已清理过的 HTML,按原样输出。
templates/article.html
templates/mem_settings_comment.html
templates/sys_message_board.html
sys_message_board_form.html
sys_message_board_item.html
article.allowComment && site.comment.enabled
site.comment.loginRequired
site.comment.imageEnabled
bbcode()
CommentList
CommentPage
articleId
userId
status
0
MessageBoardList
MessageBoardPage
typeId
isReplied
MessageBoardTypeList
条数、分页和排序参数见模板标签与 API 的通用参数。接口:
${api}/comment
${api}/comment/page
articleId、text、parentId、images
captcha、captchaToken、website
${api}/comment/my/page?status=
${api}/comment/{id}
${api}/upload/image-upload
${api}/message-board
${api}/message-board/page
${api}/message-board/{id}
siteId、typeId、title、text、contact、nickname、phone、email、address、open
${api}/message-board-type
ID 是雪花 ID,超出 JavaScript 的安全整数范围:articleId、siteId、typeId 在脚本里按字符串处理和提交(模板里写 '${article.id?c}'),不能转成数字。
siteId
'${article.id?c}'
article.html
评论与留言
评论 是访客在文章页下发表的短评,挂在某篇文章上;留言 是站点的留言板,访客按类型(咨询、建议等)留言,工作人员在控制台答复。 两者都在 互动 菜单里管理:互动 → 评论管理、互动 → 留言管理。
两者共用一套状态:已审核、未审核、已屏蔽。前台只显示“已审核”的内容。
一、评论
1.1 开启评论
在 配置 → 站点设置 → 评论设置 里设置,每个站点各自一份:
评论图片的大小和张数在 配置 → 全局设置 → 上传设置 里,与投稿图片等会员上传共用:“会员图片最大长度”(默认 5 MB;为 0 则按“图片最大长度”,两者都设了取较小的)、 “会员每日图片上限”(默认 50 张,各处会员上传合计),填 0 为不限。
1.2 访客怎么评论
默认主题的文章页底部是评论区:输入文字,点“发表评论”。登录会员还可以:
@用户名,或直接输入。被提及的用户会收到通知,每条评论最多通知 5 人,用户名须完全一致。评论区只列已审核的评论。接口支持回复:提交时带上被回复评论的
parentId,回复只有一层,回复别人的回复会归到顶层评论下。默认主题没有回复按钮。会员在个人中心的“我的评论”(
/settings/comment )里能看到自己全部状态的评论,并可删除;删除时连同这条评论下的回复一起删掉。1.3 审核与管理
进入 互动 → 评论管理。表格上方的页签按状态筛选:全部、已审核、未审核、已屏蔽;可按 评论内容 或 ID 查询。 控制台首页的“待办”里有“未审核评论”胶囊,点开就是“未审核”页签。
isRecommended挑选,默认主题没有用到。文章的“评论次数”(模板里是
article.comments )只计已审核的评论,评论审核通过、屏蔽或删除时随之增减。评论第一次变为“已审核”时(直接显示或审核通过),系统发出会员通知:被回复的评论作者收到“评论回复”,被 @ 的用户收到“@提及”, 关注了这篇文章的会员收到“关注文章新评论”。同一个人只收一条,评论者本人不收;之后再改状态不会重发。
二、留言
2.1 开启留言
2.2 访客怎么留言
/message-board/message-board/create /message-board/{id} 子目录站点的地址前面加上子目录,如
/en/message-board 。站点关闭了留言时这三个页面都打不开。需要登录而访客未登录时,打不开留言表单,也不能提交。各项的长度上限:标题 150 字,联系人、昵称 30 字,电话、邮箱 50 字,地址 150 字。公开接口不返回联系人、电话、邮箱、地址和 IP,默认主题的页面也不显示它们。
2.3 审核与答复
进入 互动 → 留言管理。页签和 状态修改为、删除 的用法与评论管理相同;可按 留言标题、留言类型 或 ID 查询,列表的 是否回复 列显示有没有答复。 控制台首页的“待办”里有“未审核留言”胶囊。
点 编辑 打开一条留言:
isRecommended挑选。答复不改变状态。 留言要在前台显示,须是“已审核”;只写了答复的“未审核”留言,前台仍然看不到。留言的答复和状态变化都不会通知留言人。
点 新增 可以在控制台录入一条留言,留言用户记为当前操作员。新增的留言同样是“未审核”;新增时设置的 是否推荐 不会保存,答复也要在新增后编辑时填写。
2.4 留言类型
点 类型管理,在对话框里 新增、编辑、删除 类型,拖动行首的图标调整顺序(前台的类别按这个顺序排列)。每个类型有 名称(30 字以内)和 描述(300 字以内)。 留言类型属于当前站点。类型下还有留言时不能删除,先删掉这些留言或把它们改成别的类型。
三、敏感词与验证码
敏感词:评论的内容、留言的标题和内容在提交时都会对照敏感词库检查。命中的评论强制进“未审核”,即使站点关闭了“是否需要审核”;留言本来就是“未审核”。 提交者不会收到任何提示,看到的是正常的提交结果,以免暴露词库。词库在 配置 → 敏感词 里维护(标准版),所有站点共用。
验证码:评论的场景是
comment,留言是messageBoard。同一 IP 一小时内的提交未达到 配置 → 全局设置 → 验证码 的“免验证提交次数”(默认 3)时不显示验证码, 浏览器在后台完成一次计算即可提交;达到后弹出滑块等可见验证。评论和留言分开计数。默认主题的评论框在第一次点进输入框时才加载验证组件。 设置项和第三方验证码见验证码。四、AI 审核(标准版)
在 配置 → 全局设置 里配置好 AI 服务商,再在 配置 → 站点设置 → AI功能 里把 审核模式 设为“标记”或“自动处置”,每条评论和留言提交后都会在后台交给模型分类:
服务商配置、判定类别、阈值和失败处理见 AI 功能的“评论与留言的 AI 审核”一节。
五、权限
在 用户 → 角色管理 给角色分配权限时,相关节点如下:
六、主题开发
默认主题的相关模板:评论区在
templates/article.html (产品、下载等其它文章模板没有评论区),个人中心的“我的评论”是templates/mem_settings_comment.html ; 留言板是templates/sys_message_board.html (列表)、sys_message_board_form.html (表单)、sys_message_board_item.html (详情,模板里可用messageBoard)。 默认主题在article.allowComment && site.comment.enabled 时显示评论区,并按site.comment.loginRequired 、site.comment.imageEnabled 决定显示表单和图片按钮。 留言内容是纯文本,输出时要转义(默认主题用bbcode());回复内容是保存时已清理过的 HTML,按原样输出。CommentList/CommentPagearticleId、userId、parentId、isRecommended、status(默认0,即已审核);默认按评论时间倒序MessageBoardList/MessageBoardPagetypeId、userId、isReplied、isRecommended、status(默认0);默认按留言时间倒序。只取公开的留言,userId是当前登录用户本人时也取其不公开的留言MessageBoardTypeList条数、分页和排序参数见模板标签与 API 的通用参数。接口:
${api}/comment、${api}/comment/page CommentList(status除外)${api}/commentarticleId、text、parentId、images,加上人机验证的captcha、captchaToken、website(场景comment)${api}/comment/my/page?status= ${api}/comment/{id} ${api}/upload/image-upload ${api}/message-board 、${api}/message-board/page MessageBoardList(status除外)${api}/message-board/{id} ${api}/message-board siteId、typeId、title、text、contact、nickname、phone、email、address、open,加上captcha、captchaToken、website(场景messageBoard)${api}/message-board-type ID 是雪花 ID,超出 JavaScript 的安全整数范围:
articleId、siteId、typeId在脚本里按字符串处理和提交(模板里写'${article.id?c}' ),不能转成数字。七、常见问题
article.html模板(产品、下载等模板没有评论区)。相关文档