Banner Plugin - 首页顶部 Banner 插件

为 Rhex 论坛首页添加自定义顶部 Banner 区域。

功能特点

自定义主标题、副标题展示
14个标签图标展示（支持主图/备用图降级策略）
3个分类导航按钮
私信入口链接
所有配置均支持动态变量，便于维护
支持 PC 端和移动端分别控制显示
支持版本检查和更新提示

安装

将 banner-plugin 目录放置于 addons/ 目录下，然后在管理后台启用插件。

配置说明

插件的所有配置项均在 dist/server.mjs 文件的 render() 方法中定义：

基础配置

变量名	说明	示例
`bannerTitle`	横幅主标题第一部分	`"一个永远在"`
`bannerTitle2`	横幅主标题第二部分	`"路上的社区"`
`bannerSubtitle`	横幅副标题	`"https://bbs.o0v0.com"`
`messageUrl`	私信入口链接	`"/messages?conversation=site-chat"`
`messageText`	私信按钮文字	`"进入全站聊天室"`

分类导航配置

变量名	说明
`category1Name` / `category1Url`	第一个分类的名称和链接
`category2Name` / `category2Url`	第二个分类的名称和链接
`category3Name` / `category3Url`	第三个分类的名称和链接

图标配置

变量名	说明
`iconAfterEffects` / `iconSketch` / `iconDocker` 等	各图标的主图 URL
`iconBackupUrl`	备用图标的基础路径
图标降级策略：当主图标加载失败时，自动切换到 `iconBackupUrl + 图标名.png`

样式配置

变量名	说明
`cssUrl`	外部 CSS 样式文件链接

作者

OV 乐在途中-社区

网址：<https://bbs.o0v0.com>

版本

1.1.5

更新日志

v1.1.5 (2026-06-09)

✅ 新增版本检查和更新提示功能
✅ 添加 network:external 权限支持
✅ 管理后台新增版本更新检查卡片
✅ 支持自动检查新版本和手动检查
✅ 显示最新版本号、发布日期和更新内容
✅ 提供新版本下载链接

v1.1.0 (2026-06-03)

✅ 微调CSS样式，让PC和移动端看上去更好
✅ 移动端完整适配，保留原有UI样式
✅ 新增响应式布局，支持平板（≤1200px）和手机（≤768px）
✅ 按钮图标 hover 状态完整显示
✅ 后台配置页新增设备显示控制开关
✅ 支持 PC 端和移动端单独开启/关闭 Banner
✅ 开关默认状态为关闭

v1.0.1 (2026-05-28)

✅ 修复后台配置页输入只能填写一个字符的问题（React 闭包陷阱）
✅ 修复前台页面刷新闪烁问题（CSS 完全内联）
✅ 修复图标滚动空白问题（图标列表复制实现无缝滚动）
✅ 修复图标显示不完整问题（调整容器高度和图标大小）
✅ 添加 .topGroup 容器，恢复原始布局结构
✅ 优化 CSS 样式，使用 clip-path 实现圆角
✅ 优化后台配置页排版，采用分组卡片式布局
✅ 为配置项添加帮助说明文字，提升用户体验
✅ 修复分类导航配置区域的布局混乱问题
✅ 优化图标设置区域为4列网格布局
✅ 新增「重置为默认」按钮
✅ 新增后台配置页
✅ CSS 字体资源本地化，CSS本地化，移除外部 CDN 依赖

v1.0.0 (初始版本)

✅ 自定义主标题、副标题展示
✅ 14个标签图标展示（支持主图/备用图降级策略）
✅ 3个分类导航按钮
✅ 私信入口链接
✅ 所有配置均支持动态变量

前台效果展示

后台效果展示

虽然图标和CSS可以自定义，但是建议就使用默认的，因为是本地化的了。

附件列表

共 1 项

网盘附件

蓝奏云

FILE · 下载 05 积分

登录后可支付 5 积分获取下载权限