HTML区块管理插件

在前台多个位置插入自定义HTML内容。

功能特性

• 支持14个前台显示位置
• 后台可视化管理界面
• 每个区块可独立启用/禁用
• 支持排序控制显示顺序
• 可选的实时HTML预览（默认关闭以提升性能）
• 数据库存储，完美支持 Docker 环境，容器重启数据不丢失
• 优化的后台加载性能
• 自动检查更新功能
• 完整的更新日志展示

更新检查

插件支持自动检查更新。更新信息从 https://gx.o0v0.com/html-blocks-update.txt 获取。

更新文件格式

txt
version: 1.1.0
releaseDate: 2026-06-09
updateUrl: https://bbs.o0v0.com/posts/5
changelog: |
  - 添加版本检查功能
  - 优化更新检测界面
  - 改进错误处理机制

支持的位置

首页

• home.right.top - 首页右栏顶部
• home.right.middle - 首页右栏中部
• home.right.bottom - 首页右栏底部
• feed.page.before - 首页内容流主体前
• feed.main.before - 首页内容流列表前

全局布局

• layout.footer.before - 全局页脚前
• layout.footer.after - 全局页脚后
• layout.body.start - body起始处

帖子详情

• post.sidebar.top - 帖子详情右栏顶部

节点页

• board.right.top - 节点页右栏顶部
• board.right.middle - 节点页右栏中部
• board.right.bottom - 节点页右栏底部

分区页

• zone.content.before - 分区页帖子流前
• zone.hero.before - 分区页顶部介绍区前

安装方法

1. 将 html-blocks 目录放到 addons/ 目录下
2. 在后台管理页面启用插件
3. 访问 /admin/addons/html-blocks 进行管理

使用方法

1. 访问后台管理页面
2. 点击"新建区块"
3. 填写标题、选择显示位置、输入HTML内容
4. 保存后即可在前台对应位置显示

目录结构

text
html-blocks/
├── addon.json          # 插件清单
├── dist/
│   └── server.mjs      # 服务端入口
├── assets/
│   └── admin-client.js # 后台管理界面
└── README.md

权限要求

• slot:register - 注册插槽
• page:admin - 后台页面
• api:admin - 后台API
• config:read - 读取配置
• config:write - 写入配置
• network:external - 网络请求（用于检查更新）

更新日志

v1.1.0 (2026-06-09)

• 添加版本检查功能
• 支持从远程获取更新信息
• 新增更新检查管理卡片
• 显示完整更新日志和下载链接
• 自动检查并提示新版本
• 优化用户体验和错误处理

v1.0.1 (2026-06-08)

• 改用数据库存储 HTML 区块数据，完美解决 Docker 环境下数据持久化问题
• 容器重启或更新后保存的 HTML 内容不会丢失
• 优化后台管理界面加载性能，HTML预览默认关闭
• 修复后台管理界面加载慢的问题
• 调整 HTML 编辑器布局，预览效果垂直排列显示

v1.0.0 (2025-06-04)

• 初始版本发布
• 支持14个前台显示位置
• 后台可视化管理界面
• HTML源码编辑 + 实时预览
• 区块启用/禁用控制
• 排序功能
• 完整的增删改查功能

Copyright OV 乐在途中-社区 <https://bbs.o0v0.com>
前台展示：

后台展示：

Copyright OV 乐在途中-社区 https://bbs.o0v0.com