上传接口
All checks were successful
continuous-integration/drone/push Build is passing

This commit is contained in:
yiqiu
2025-12-28 13:12:07 +08:00
parent 82e1ee9ad2
commit 46d751cd33
3 changed files with 14 additions and 122 deletions

View File

@@ -3,17 +3,17 @@
此插件演示如何通过后台插件的方式为 BlackFruit-UI 主题提供可配置能力支持设置导航、页脚、站点信息、SEO、首页轮播、友情链接、荣誉资质、反馈类型以及右侧浮窗并提供 `/console/v1/theme/config` 接口与前端联动。
## 功能
- **图片上传**: 插件自带独立的上传接口 `POST /{DIR_ADMIN}/v1/upload`,支持jpg、png、gif、webp、svg等格式,最大10MB
- 后台界面`template/admin/index.html`通过表单 + JSON 的方式维护主题参数
- SEO、站点基础信息企业名称、电话、备案、协议链接、产品链接等
- 首页轮播 Banner支持图片上传
- 友情链接friendly_link
- 企业荣誉honor支持图片上传
- 反馈类型feedback_type
- 右侧浮窗side / side_floating_window支持图标上传
- 复杂导航结构header_nav/footer_nav可在"高级配置 (JSON)"中维护子菜单支持图标上传。
- 接口 `GET/POST /{DIR_ADMIN}/v1/theme/config` 提供配置读取与保存
- 前台接口 `GET /console/v1/theme/config` 输出与 `/console/v1/common` 同结构的数据BlackFruit-UI 可以直接接入
- **图片上传**: 依赖业务系统的全局上传接口 `/{DIR_ADMIN}/v1/upload``/console/v1/upload`,与官方示例插件保持一致
- 后台界面(`template/admin/index.html`)通过表单 + JSON 的方式维护主题参数:
- SEO、站点基础信息(企业名称、电话、备案、协议链接、产品链接等);
- 首页轮播 Banner(支持图片上传);
- 友情链接(friendly_link);
- 企业荣誉(honor,支持图片上传);
- 反馈类型(feedback_type);
- 右侧浮窗(side / side_floating_window,支持图标上传);
- 复杂导航结构(header_nav/footer_nav)可在"高级配置 (JSON)"中维护,子菜单支持图标上传。
- 接口 `GET/POST /{DIR_ADMIN}/v1/theme/config` 提供配置读取与保存;
- 前台接口 `GET /console/v1/theme/config` 输出与 `/console/v1/common` 同结构的数据,BlackFruit-UI 可以直接接入;
- 插件安装时创建 `addon_theme_configurator` 表并写入默认配置。
## 目录