【XiunoX插件】主题美化 1.0.0

一级用户组

主题美化插件(xnx_theme)

在后台一键设置网站主题:多套预设配色方案、强制明暗模式、自定义主题色与自定义 CSS,并支持前台用户自选主题。

## 功能

- 主题方案:内置 7 套预设配色(海洋蓝 / 森林绿 / 日落橙 / 紫罗兰 / 暗夜紫 / 樱花粉 / 水墨灰),每套均含明亮与暗黑两组配色,基于 CSS 变量覆盖核心主题,不修改任何核心文件。
- 明暗模式:可强制全站明亮 / 暗黑 / 跟随系统,或继承系统默认设置(用户可自选)。
- 用户自选:开启后,前台导航栏「主题」下拉菜单会出现「主题方案」选择区,用户选择保存在浏览器本地;关闭后全站固定后台方案(同时隐藏系统自带主题切换按钮)。
- 自定义主题色:填写 #rrggbb 主色(或使用取色器),覆盖全站按钮、链接、高亮等主色,自动生成 hover 变体。
- 自定义 CSS:向全站 <head> 注入自定义样式,可覆盖任意元素。

## 安装

1. 将 xnx_theme 目录放入网站 plugin/ 目录。
2. 后台「插件」列表找到「主题美化」,点击安装并启用。
3. 点击「设置」进入主题设置页进行配置。

## 文件说明

<br>plugin/xnx_theme/<br>├── conf.json # 插件清单<br>├── install.php # 安装:写入默认配置<br>├── uninstall.php # 卸载:清除配置<br>├── setting.php # 后台设置页逻辑<br>├── lib/theme_defs.php # 预设主题定义 + 配置读写辅助<br>├── view/htm/setting.htm # 后台设置页 UI<br>└── hook/<br> ├── header_bootstrap_after.htm # 注入主题 CSS(覆盖核心 theme.css)<br> ├── header_body_start.htm # 同步应用 data-xn-theme / 强制明暗模式(防闪烁)<br> ├── footer_js_after.htm # 前台「主题方案」切换器<br> └── lang_zh_cn_bbs.php # 语言键(zh-cn)<br>

## 说明与限制

- 预设主题通过 data-xn-theme 属性 + CSS 变量生效,与核心的 data-bs-theme(明暗)、data-theme(品牌色)机制兼容;使用预设方案时配色以预设为准。
- 自定义 CSS 提交时会被 strip_tags 过滤(与核心插件设置一致),请勿在样式中包含 < 字符。
- 配置保存在站点设置(bbs_kv)的 xnx_theme 键中,卸载插件时自动清除。
- 版本兼容:XIUNOX 1.1.x(bbs_version: 1.1)。

最新回复

请先登录后再回复 登录

uid:47 一级用户组
关注
发帖 5
评论 1
粉丝 0
关注 0
发新帖
目录
【XiunoX插件】主题美化 1.0.0