2.20.0 LTS

[ruibaby]

⚠️ 重要提示

• 此版本重构了登录相关的页面，登录入口从 /console/login 改为了 /login。
• 在重构登录页面的过程中，也改动了登录授权相关的逻辑和 API，请在升级之后进行以下操作：
  • 升级所有登录认证相关的插件。
  • 重新在 用户 -> 身份认证 页面启用和排序三方认证方式。
• 角色的 登录之后默认跳转位置 设置选项在此版本已移除，建议使用 /login?redirect_uri= 代替。
• 出于安全考虑，此版本在生产环境下默认禁用了 Basic Auth 的认证方式，如有需要可以通过添加 halo.security.basic-auth.disabled=false 启动参数来启用。

新特性

• 支持用户在个人中心上传和访问自己的附件（需要具有对应权限）。 by @guqing in feat: allow users to manage their attachments in uc #6731
• 支持在个人中心的文章管理界面删除用户创建的文章。 by @guqing in feat: support deleting posts in user center #6729
• 重构登录、注册相关的页面。 by @JohnNiang in Add support for customizing login and logout pages #6488
  • 登录、注册相关页面改为由后端渲染页面，提供统一的访问入口。
  • 提升页面加载性能。
  • 优化登录、注册相关页面的交互逻辑。
  • 登录、注册等页面支持通过主题或者插件提供。

破坏性更新

• 移除角色的 登录之后默认跳转位置 设置选项。 by @ruibaby in refactor: remove redirect-on-login setting option from role editing form #6776
• 生产环境下默认禁用 Basic Auth 的认证方式。 by @guqing in feat: add config option to allow disabling Basic authentication #6689

功能优化

• 优化密码输入框的明文切换图标的状态显示。 by @ruibaby in refactor: improve password input toggle button state display #6800
• 在用户选择组件中不再显示匿名与已删除用户。 by @LIlGG in pref: remove anonymous and ghost users from the userSelect #6781
• 备份时排除全文索引目录 indices，防止恢复之后因为索引文件问题无法启动。 by @ruibaby in refactor: exclude indices directory during backup #6753
• 修复文章编辑页面标题输入框中，英文字符可能会被隐藏的问题。 by @YttriumC in fix: prevent hidden English characters in post title input #6749
• 优化系统初始化流程以适配新的登录流程。 by @guqing in refactor: system initialization process to adapt to the new login method #6739
• 为系统默认的存储策略添加保护措施，不允许删除。 by @ruibaby in feat: disallow deletion of system-protected attachment policies #6735
• 备份时忽略缩略图目录以减少文件大小。 by @guqing in refactor: exclude thumbnail directories when backup #6725
• 代码注入功能忽略对错误页面和登录注册等页面的注入。 by @guqing in refactor: head and footer tag injection to skip error pages #6709
• 简化页面回收站的页面标题。 by @ruibaby in refactor: simplify page title of deleted page #6708
• 优化默认编辑器的加载方式，防止出现灰屏闪烁的问题。 by @ruibaby in refactor: remove async loading logic for editor #6707
• 提升页面访问速度。 by @guqing in perf: replace concatMap to flatMapSequential to improve parallelism and efficiency #6706
• 统一空状态界面中操作按钮的风格。 by @ruibaby in refactor: unified empty state UI action button styles #6704
• 支持自动绑定 OAuth2 登录用户。 by @JohnNiang in Support binding OAuth2 user automatically #6702
• 修复系统未启动完全时访问页面出错的问题。 by @guqing in feat: add index build state as readiness check indicator #6700
• 修复文章封面图链接包含空格时主题端会因为生成缩略图错误而无法访问的问题。 by @guqing in fix: thumbnail generation for URI string containing spaces #6698
• 允许通过 halo.security.basic-auth.disabled=true 配置来禁用 Basic Auth 认证，在 2.20 版本生产环境下默认禁用了 Basic Auth。 by @guqing in feat: add config option to allow disabling Basic authentication #6689
• 优化文件类型检测并支持根据文件名作为决策依据。 by @guqing in refactor: optimize file type detection and support decision-making based on file name #6675
• 新增 API 用于以 JSON 格式获取和更新插件和主题的配置。 by @guqing in feat: support JSON-based retrieval and update for theme and plugin configs #6661
• 修复 external-url 配置带了尾部斜杠导致邮件通知的查看通知链接无法访问的问题。 by @guqing in refactor: remove trailing slash in site url for notification #6660
• 支持利用参数 language 切换地域语言。 by @JohnNiang in Support changing locale using query language #6658
• 解决重启后可能无法更新附件链接的问题。 by @JohnNiang in Update attachment permalink only when handler is available #6641
• 当存储策略的配置变更后自动触发关联附件的状态（如访问链接等）更新。 by @guqing in Trigger attachment status update on storage policy config change #6639
• 优化根据 URI 生成缩略图时的请求头，修复可能因为无法访问原图导致无法正常生成的问题。 by @guqing in refactor: optimize request headers when generating thumbnails from URI #6628
• 禁止非管理员回复未通过审核的评论。 by @guqing in refactor: prevent replies to comments that are pending approval #6622
• 优化 Formkit Select 组件在多选状态下的待选中状态。 by @LIlGG in pref: improve hover and pre-selection state for formkit select #6607
• 为 FormKit Select 组件远程查询增加指定 Key 的字段。 by @LIlGG in pref: add parameter to formkit select component for remote search by specific field #6591
• 当生成缩略图时如果原图尺寸小于请求尺寸则返回原图以保持其质量。 by @guqing in refactor: preserve original image if smaller than requested thumbnail size #6582
• 优化模板渲染时所需的内存。 by @JohnNiang in Add chunked transfer support for rendering templates #6580
• 优化在内存紧张时 Console 端无法加载插件资源的问题。 by @JohnNiang in Generate JS and CSS bundle with fixed buffer size #6573

问题修复

• 修复未登录情况下依然能够访问登出页面的问题。 by @JohnNiang in Fix the problem of accessing logout page without authentication #6812
• 修复创建用户表单的用户名长度校验不生效的问题。 by @ruibaby in fix: username length validation in user creation form is not working #6806
• 修复 Code 输入框在模态框（VModal）组件中无法正常全屏显示的问题。 by @ruibaby in fix: resolve issue with code input can not displaying fullscreen in modal component #6787
• 为 Code Input 设置默认高度，修复全屏按钮被遮挡的问题。 by @ruibaby in fix: style issue of the fullscreen button in Code input #6785
• 修复恢复备份后可能会因为与恢复之前存在的数据冲突导致无法启动的问题。 by @guqing in fix: unique index conflict issue after backup restoration preventing startup #6701
• 修复部分设备或者浏览器下，输入框中的下划线可能无法正常显示的问题。 by @ruibaby in fix: resolve issue with underline not displaying in input field #6694
• 修复在 FireFox 浏览器下的编辑器中无法通过粘贴文件上传的问题。 by @ruibaby in fix: resolve issue with editor not detecting image paste in Firefox #6693
• 修复文件上传时类型校验失效的问题。 by @guqing in fix: correct file mime type validation parameter to restore functionality #6673
• 修复编辑器中有序列表的样式问题。 by @ruibaby in fix: correct ordered list styling issue in editor #6656
• 修复主题端区域和语言解析错误的问题。 by @JohnNiang in Fix the problem of resolving locale context by language parameter #6647
• 解决当 FormKit Select 组件中的 options 延迟设置时无法正常回显的问题。 by @LIlGG in fix: resolve incorrect display of options in formkit selector with async data #6629
• 修复 FormKit Select 组件中布尔值的显示问题。 by @LIlGG in fix: correct boolean value display issue in formkit selector component #6624
• 修复取消用户角色后无法正常渲染用户列表的问题。 by @JohnNiang in Prevent null role while getting permissions #6612
• 解决 FormKit Select 组件在值变更时不会发出事件及修改选项值的问题。 by @LIlGG in fix: formkit select component not emitting event or updating selection on value change #6602
• 修复 GIF 缩略图生成只会保留第一帧的问题。 by @guqing in fix: skip thumbnail generation for GIF images #6597
• 解决无法为 FormKit Select 组件的选项设置禁用的问题。 by @LIlGG in fix: resolve issue with disabled property in options not working #6595
• 解决在默认编辑器中添加表格报错的问题。 by @LIlGG in fix: resolve error when adding tables in default editor #6587
• 解决 FormKit 选择器回显数据异常的问题。 by @LIlGG in fix: formkit selector not listening to data after defaulting to first option #6571
• 修复重启后无法搜索部分文档的问题。 by @JohnNiang in Fix the problem that Lucene lock is held by VM #6570
• 修复仅分配菜单权限时菜单页面报 403 错误的问题。 by @guqing in fix: resolve 403 error on menu page when system config access is missing #6688
• 修复可配置无效的外部访问地址的问题。 by @JohnNiang in Fix the problem of being able to configure invalid external URL #6840
• 修复竖向图片生成缩略图后会丢失方向信息展示为横向图片的问题。 by @guqing in fix: vertical images are rotated to horizontal when generating thumbnails #6842

开发者相关

• Dialog API 支持传入 uniqueId，以限制同一时间仅打开一个。 by @ruibaby in feat: add support for setting uniqueId in Dialog to prevent duplicate creation #6737
• 主题支持通过 ${site.version} 得到 Halo 版本号。 by @guqing in feat: add Halo version variable to theme model #6677
• 支持在插件中操作渲染结果。 by @JohnNiang in Provide ElementTagProcessor to handle element tag in plugin #6670
• 为主题端切换地区语言提供支持。 by @JohnNiang in Support changing locale #6657
• 支持在主题中通过 Thymeleaf 默认行为实现国际化。 by @JohnNiang in Support resolving i18n message with standard way #6648
• 允许在插件使用 CryptoService 和 RateLimiterRegistry。 by @JohnNiang in Expose CryptoService and RateLimiterRegistry to plugins #6638
• 为 FormKit 添加菜单选择输入类型。 by @ruibaby in feat: add menu select form item #6642

依赖更新

• 升级编辑器依赖 Tiptap 的版本至 2.8.x。 by @ruibaby in chore: bump tiptap version to 2.8.x #6777
• 升级依赖 jsoup 至 1.18.1。 by @JohnNiang in Upgrade to jsoup 1.18.1 #6765
• 升级依赖 Lucene 至 9.12.0。 by @JohnNiang in Upgrade to Lucene 9.12.0 #6763
• 升级依赖 Guava 至 33.3.1-jre。 by @JohnNiang in Upgrade to Guava 33.3.1-jre #6762
• 升级至 Gradle 8.10.2。 by @JohnNiang in Upgrade to Gradle 8.10.2 #6755
• 升级 UI 项目的 Vue 版本至 3.5.x。 by @ruibaby in chore: bump vue version to 3.5 #6696
• 升级 Spring Boot 至 3.4.0-M3。 by @JohnNiang in Upgrade to Spring Boot 3.4.0-M3 #6687

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

• https://www.halo.run/store/apps
• https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.19.0...v2.20.0

---

This discussion was created from the release 2.20.0 LTS.