预设插件
管理页「插件配置」里内置了一批租户级预设插件。它们不需要装 npm 包,开启开关、保存配置即可生效;与通过 PluginRegistry 注册的扩展插件一起出现在左侧列表。
入口:管理 → 插件配置。左侧选中插件后,在「配置 / 说明 / 日志」之间切换;改完点「保存配置」。
预设 vs 扩展插件
| 预设插件 | 扩展插件(Registry) | |
|---|---|---|
| 来源 | 产品内置,配置存在 tenant_metadata.plugin_config | 代码注册进 PluginRegistry |
| 启用方式 | 列表开关 → 写 enabled | 管理 API / 注册表 setStatus |
| 配置界面 | 插件配置页专用面板 | 视插件实现而定 |
| 审计日志 | 配置变更记为 tenant.plugin.<id>.* | 注册、状态变更等 runtime 审计 |
日志页可按「当前插件 / 全部插件」筛选;当前插件按 registry 名(如 campux-plugin-markdown-render)匹配。
Markdown 渲染
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-markdown-render |
| 风险 | 低 |
| 作用 | 投稿正文按 Markdown 渲染展示 |
支持语法:**加粗**、*斜体*、`代码`、- 列表、[链接](url)、引用等。
不支持:表格、自定义 HTML(会被过滤/转义);图片语法不会渲染为图,请用投稿页的图片上传。
关闭后稿件按纯文本展示。已渲染的历史稿件不会因开关而改变存储内容。
多彩投稿
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-color-selection |
| 风险 | 中 |
| 作用 | 为投稿配置背景色 / 文字色预设色板 |
- 背景色、文字色各最多约 10 个预设(名称、标识 value、十六进制色)
- 标识(value)用于落库与前端匹配,尽量保持稳定,不要频繁改 value
- 投稿页出现选色入口;稿件墙按预设渲染彩色卡片
- 修改预设后需保存配置;已发布稿件不追溯改色
建议保持至少 3 组可用搭配,并避免对比度过低(如米黄底 + 白字)。
字体选择
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-font-selection |
| 风险 | 低 |
| 作用 | 在固定字体库中勾选投稿页可用字体 |
- 字体库随服务端内置,不引入外部字体源
- 默认字体(
default)为浏览器系统字体,一般建议保留 - 至少启用 1 款;白名单为空时投稿页会隐藏字体入口并提示
修改白名单不追溯已发布稿件。
匿名头像
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-anonymous-avatar |
| 风险 | 中 |
| 作用 | 匿名投稿可选头像;支持内置池与自定义 SVG |
- 可从内置 SVG 头像中勾选
- 可粘贴自定义 SVG 源码(注意内容安全,仅建议管理员维护)
- 开启后投稿页在匿名模式下出现头像选择
Bot 多彩消息
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-bot-stylish-messages |
| 风险 | 低 |
| 作用 | 自定义机器人关键反馈语句(多彩文案) |
常见类型包括:
| 类型 | 场景 | 占位符 |
|---|---|---|
| 投稿成功 | 私聊投稿完成 | {id} |
| 审核通过 | 通知作者 | {id} |
| 审核拒绝 | 通知作者 | {id}、{reason} |
| 撤回成功 | 撤回完成 | {id} |
| 发布成功 | 已发到墙号 | {id}、{externalId} |
同一类型可配多条,发送时随机挑选。关闭后使用系统默认文案。
投票竞选
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-campaigns |
| 风险 | 中 |
| 作用 | 用户发起竞选/投票,审核通过后在服务页公开 |
- 投稿页出现「发起竞选」入口
- 支持封面/选项图、仅管理可见等开关(视版本配置)
- 经审核群或网页审核通过后,服务页可浏览并投票
- 投票明细、发起人信息会进入租户数据,请按隐私要求运营
聚合登录
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-aggregate-login |
| 风险 | 中 |
| 作用 | 绑定第三方身份后,用 QQ / 微信 / 支付宝等登录本墙 |
- 不会自动建号:未绑定的第三方身份无法直接进入
- 用户需先有本地账号,再到「服务 → 账户设置 → 第三方登录」绑定
- 需配置第三方 AppId / AppKey 等;密钥属租户配置,注意权限
- 登录页会展示已勾选的第三方入口
接口地址等请按聚合服务文档填写,保存前建议先测连通性。
意见反馈
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-feedback |
| 风险 | 中 |
| 作用 | 投稿页顶部意见反馈入口,提交后通知审核群 |
- 开启后投稿页最上方出现「意见反馈」入口
- 用户填写最多 500 字文字意见并提交
- 意见先保存到站点;墙号在线且已开启「审核群通知」时同步到审核群
- 通知失败时意见仍已保存,仅提示无法送达审核群
建议先在墙号配置审核群,并开启审核群通知。
Bot 异常通知
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-bot-alert |
| 风险 | 中 |
| 作用 | 登录态失效自动刷新失败时邮件通知管理员 |
- 开启后,当 QZone 登录态失效且自动刷新失败时,向配置的收件邮箱发送异常通知
- 需配置 SMTP 服务器、端口、发件邮箱、账号密码/授权码
- 收件邮箱支持多个(点击「新增收件邮箱」逐个添加,最多 20 个)
- 保存设置前会先发送测试邮件,测试通过后才允许保存
- 提供「发送测试邮件」按钮,测试邮件标题为「测试」
广播通知
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-broadcast |
| 风险 | 中 |
| 作用 | 投稿页发起带时效的校园广播通知;广播员标记已广播,管理员可修改或下架 |
- 开启后投稿页顶部出现「广播通知」胶囊,服务页出现通知墙入口
- 发起时需选择生效时长(可在插件配置里维护快选时长预设),到期自动结束
- 广播员:只有被授予广播员(
broadcaster)身份的成员可以标记通知已广播;该身份选项仅在插件开启时出现在「管理 → 用户」的角色下拉中(已是广播员的成员不受影响) - 广播计数、发起人与作者信息接入租户与用户数据;管理员可在通知墙修改或下架
毕业去向
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-graduation |
| 风险 | 中 |
| 作用 | 投稿页填写届 / 级与学历,提交毕业去向,审核通过后进入服务页统计视图 |
- 开启后投稿页顶部出现「毕业去向」胶囊,服务页出现毕业去向入口
- 填写项:届(毕业年份)、级(入学年份)、学历、毕业去向(学校 / 单位全称);毕业年份不得早于入学年份
- 提交后进入待审核,由审核群或网页端通过 / 驳回;同一用户最多保留一条「待审核 + 已通过」记录,不能重复提交
- 审核通过后计入服务页统计视图:用户列表、学校列表、时间视图、搜索(用户列表仅展示已通过记录)
- 毕业信息(届 / 级 / 学历 / 去向)与作者 QQ 关联,仅供审核员与本人查阅,请按隐私要求运营
评论管理
| 项 | 说明 |
|---|---|
| 标识 | campux-plugin-comment-management |
| 风险 | 中 |
| 作用 | 网页端通过墙号删除已发布稿件在 QQ 空间的评论 |
- 开启后,「稿件 → 已发布」卡片下的评论列表出现「删除」按钮
- 删除操作通过墙号(说说作者)调用 QQ 空间接口执行,删除后不可恢复
- 删除成功后自动刷新该稿件的评论列表;操作记入稿件日志与审计日志(
post.comment.delete) - 独立开关「允许用户删除自己稿件下的评论」:开启后普通用户可删自己稿件下的评论,关闭时仅管理员可删
- 评论列表由 QZone 数据定时刷新,刚发表尚未同步的评论暂无删除按钮;历史评论(无 id)同样不显示
启用与保存
- 在左侧列表打开插件开关(立即改 registry/预设启用状态,并同步刷新租户元数据)
- 在右侧「配置」改参数
- 点 保存配置 写入租户配置
开关与保存都会立即生效:例如投稿页顶部的插件胶囊、「管理 → 用户」里广播员角色选项的显隐,会随广播通知插件的开关即时变化,无需手动刷新页面。
仅开开关未保存配置时,部分字段仍可能是默认值。日志页可核对最近变更(操作人、前后值)。