Skip to content

Releases: Tim0x0/halo-plugin-bbs

Release list

v1.1.1

v1.1.1 Latest
Latest

Choose a tag to compare

View all tags
@Tim0x0 Tim0x0 released this 18 Sep 05:48
v1.1.1
fcd4369

🐛 修复

  • 深色模式下评论区不跟随切换：同步官方评论组件的 data-color-scheme，并把评论区配色对齐 BBS（#2）

📋 完整更新日志

Assets 3
Loading

v1.1.0

v1.1.0

Choose a tag to compare

View all tags
@Tim0x0 Tim0x0 released this 17 Sep 17:17
v1.1.0
9ea0fbc

✨ 新增

  • 最佳答案：问答帖可把某条顶层评论设为最佳答案（Console / UC 评论弹窗）。设上时同步「已解决」；取消最佳答案不取消已解决，取消已解决会清掉最佳答案。详情页在正文与评论区之间展示该楼
  • 评论楼号：顶层评论按发表顺序写入冻号（楼主 1、评论从 2；待审占号，置顶不改号，删除不重排）。锁定帖只读评论区展示楼号
  • 新评论通知：帖子收到新评论走 Halo 官方通知中心（作者自评不发）。楼中楼回复沿用官方「有人回复了我」。邮件随用户通知偏好，不想收可关掉「我的帖子收到新评论」
  • Release 自动发帖：发帖逻辑拆为可复用工作流，其他仓库可直接引用，把 GitHub Release 说明同步为 BBS 公告。接入方式见 README

🔧 改进

  • 详情页 Hero 徽标与列表同口径：问答未解决用问号圆标，已解决换成线框勾
  • 前台可切换浅色 / 深色 / 跟随系统（只影响 BBS 自身配色，不改评论编辑器）
  • 详情页目录只扫楼主正文（不含最佳答案）；滚动高亮按顶栏下阅读线对齐，上滚 / 点目录不再错一格

🐛 修复

  • 评论弹窗「最佳答案」标签使用 Halo VTag 不支持的 theme="success"，改为 primary（否则前端类型检查失败）
  • 发帖工作流按别名查找已有帖时未读取接口响应，重跑同一版本会重复建帖

📋 完整更新日志

Loading

v1.0.0

v1.0.0

Choose a tag to compare

View all tags
@Tim0x0 Tim0x0 released this 04 Sep 02:57
v1.0.0
dd6b608

🎉 首个版本发布！

为 Halo 提供社区论坛功能：讨论 + 问答 + 公告 + 两级分类，适合博客站旁的隔离社区。

在线演示：blog.timxs.com/bbs（同时是互动增强的演示插件——帖子列表 / 详情已接入装扮与用户卡）

✨ 功能特性

  • 帖子类型：讨论 / 问答 / 公告（仅管理端可发），三类帖必须归属分类
  • 问答闭环：作者与版主可标记「已解决」，列表徽标区分未解决 / 已解决
  • 两级分类：Iconify 图标 + 独立分类色 + slug + 封面，拖拽排序；板块级配置（置顶帖上首页、版主角色）仅一级分类可设
  • 审核流（可选）：草稿 / 待审核 / 已发布 / 已驳回；可配置「编辑已发布是否重新审核」；驳回后重提永远重审；审核中可显式「取消提交」退回草稿；软删除进回收站
  • 版主体系：全站版主（bbs-moderate）+ 分区版主（一级分类指定角色，只管辖自己分类树）
  • 置顶与锁定：置顶在所属分类页浮顶、可选上首页（独立开关 + 权重）；锁定帖禁评论、禁作者编辑 / 删除，历史评论只读
  • 编辑历史：基于 Halo 核心 Snapshot 版本链，历史版本查看、并排对照、恢复
  • 评论：接入 Halo 官方评论体系，详情页由「评论组件」插件渲染；评论管理复用 Halo 后台「评论」页
  • 全文搜索：接入 Halo 搜索，已发布帖子可被站点全局搜索搜到
  • RSS：经 plugin-feed 输出全站与一级分类订阅源
  • 前台：Flarum 风格两栏布局——分类树 + 紧凑列表，圆标（公告 / 置顶 / 未解决）+ 线框（已解决 / 锁定），桌面 / 窄屏自适应
  • 互动增强集成（可选）：帖子页装扮（头像框 / 称号 / 勋章 / 悬浮名片）、作者名链接优先用用户卡跳转模板、发帖数贡献到名片统计
  • 站内通知：审核通过 / 驳回走 Halo 官方通知中心
  • 面向主题：Finder（${bbs}）+ 匿名公开 REST API，可覆盖 bbs.html / bbs_post.html 模板
  • 安全：正文 HTML 服务端白名单净化，SVG 图标零 URL / 零事件属性

📋 环境要求

  • Halo >= 2.25.0
  • JDK 21（自行构建）

📦 安装方式

下载 plugin-bbs-1.0.0.jar，在 Halo 后台 → 插件 → 安装 → 上传并启用。

🔧 配置说明

  1. 创建分类（必须先行）：「BBS 社区 → 帖子列表 → 分类」，帖子必须归属分类，一个分类都没建时用户发不了帖
  2. 分配角色：发帖权已聚合给所有登录用户，无需配置；版主 / 管理角色手动分配
  3. 安装评论组件：评论区必需（未装则评论区为空，其余正常）；可选装互动增强（装扮）与 plugin-feed（RSS）
  4. 外观与审核：插件设置里配品牌（标题 / Logo / 主题色）、审核开关（默认提交即发布）
  5. 访问前台 /bbs 验证

⚠️ 注意事项

  • 先建分类再开放发帖——没有分类时用户侧无法发帖
  • 评论的登录 / 审核策略由「系统设置 → 评论」统一控制
  • 「后台查看」权限不要授给普通用户，否则对方能进管理后台看到草稿 / 待审核 / 回收站
  • 可选依赖（互动增强 / plugin-feed）缺席时自动降级，不影响插件启动与运行
  • 公告仅管理端可发；用户不能置顶、不能锁定

📚 文档

  • 主题开发指南：模板覆盖、Finder 方法、公开 REST API
  • README：使用说明、权限模型、插件设置

反馈：BBS 社区

Loading