10
Banner Plugin - 首页顶部 Banner 插件
为 Rhex 论坛首页添加自定义顶部 Banner 区域。
功能特点
- 自定义主标题、副标题展示
- 14个标签图标展示（支持主图/备用图降级策略）
- 3个分类导航按钮
- 私信入口链接
- 所有配置均支持动态变量，便于维护
安装
将 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 乐在途中-社区
版本
1.0.1
更新日志
v1.0.1 (2026-05-28)
- ✅ 修复后台配置页输入只能填写一个字符的问题（React 闭包陷阱）
- ✅ 修复前台页面刷新闪烁问题（CSS 完全内联）
- ✅ 修复图标滚动空白问题（图标列表复制实现无缝滚动）
- ✅ 修复图标显示不完整问题（调整容器高度和图标大小）
- ✅ 添加
.topGroup容器，恢复原始布局结构 - ✅ 优化 CSS 样式，使用
clip-path实现圆角 - ✅ 优化后台配置页排版，采用分组卡片式布局
- ✅ 为配置项添加帮助说明文字，提升用户体验
- ✅ 修复分类导航配置区域的布局混乱问题
- ✅ 优化图标设置区域为4列网格布局
- ✅ 新增「重置为默认」按钮
- ✅ 新增后台配置页
- ✅ CSS 字体资源本地化，CSS本地化，移除外部 CDN 依赖
v1.0.0 (初始版本)
- ✅ 自定义主标题、副标题展示
- ✅ 14个标签图标展示（支持主图/备用图降级策略）
- ✅ 3个分类导航按钮
- ✅ 私信入口链接
- ✅ 所有配置均支持动态变量
前台效果展示
后台效果展示
虽然图标和CSS可以自定义，但是建议就使用默认的，因为本地化了。
觉得服务器慢的可以把目录里面的css传到CDN上，用你的CDN链接。
刚刚那一版有个链接忘记改了，重新发一版！！！
附件列表
站内附件
banner-plugin1.0.1.zip
ZIP · 85 KB · 下载 15 积分
登录后可支付 5 积分 获取下载权限
这个用户还没有留下简介。