安装与快速开始

适用范围:当前适配 Halo 2.26.0 及以上版本的言答Issue。旧版插件的界面与构建方式可能不同。

插件可以用来做什么

言答Issue 为文章、项目、产品、话题或留言建立独立的反馈与讨论入口。先创建「依托主体」,再在主体下创建 Issue;每条 Issue 可以包含描述、标签、经办人和评论。

安装

  1. 确认 Halo 版本满足所安装插件的要求。当前代码版本要求 Halo 2.26.0 或更高版本。
  2. 获取与该 Halo 版本匹配的插件 JAR,在 Halo Console 的插件管理中安装或升级「言答Issue」,然后启用。
  3. 打开「言答Issue」菜单。若没有看到菜单,先检查插件启用状态和当前账号的 Issue 管理权限。
  4. 普通站长安装 JAR 后不需要运行 pnpm,也不需要手工复制前台文件;当前构建流程已经把静态资源包含在 JAR 中。

建立第一个反馈入口

  1. 在「言答Issue」中创建一个依托主体,例如「产品反馈」。
  2. 填写展示名称、主体类型、描述和可见性。文章类型需要选择关联文章;其他类型可以补充介绍内容。
  3. 保存后打开该主体的前台页面,路径形如 /subject/subject-xxxx。
  4. 进入主体的「Issues」页,点击「新建 Issue」。未登录时会先跳转到登录页面。
  5. 填写标题和描述,预览 Markdown 后提交。若账号没有免审核权限,内容可能需要管理员审核后才对外展示。

主体名称中的 subject-xxxx 是系统生成的标识,不是自己填写的展示名称。使用后台实际生成的链接,不要直接照抄示例。

将入口提供给访客

将主体前台链接添加到站点导航、文章链接或其他入口。主体概览用于介绍和统计,/subject/{主体标识}/issues 用于查看问题列表。

如果主题已经适配 Halo 的页面布局契约,插件页面会使用主题布局;未适配时使用 Halo 的兜底布局。

继续阅读:主体管理、发布与处理 Issue。