一、简介
位置 : assets/themes/Xenforo/ — 这是 模板主题 (覆盖整站 HTML),不是纯 CSS 主题。
- 风格 :复刻 XenForo 2 默认风 — 深蓝导航`#1f4e79` + 白色卡片 + 橙点缀`#e99721` , config.json 声明名称/作者/版本/主色。
- 规模 :30 个模板 + 单个 xenforo.css (约 42 KB,391 条规则),覆盖首页(官网/社区/CMS)、论坛列表与板块、帖子详情与编辑、发帖、博客列表/详情/编辑、消息(写信/收件箱/已发/查看)、通知、搜索、标签、个人主页、主题设置、认证页(登录/注册/忘记/重置)与 404/429。
- 技术口径 :类名统一`xen-*` ,复用核心`mn-*` 工具类;配色只覆盖`.xen-body-page` 上的`--mn-*` /`--xen-*` 变量,因此核心组件自动跟随换肤。 不引第三方 JS/CSS ,交互走内置 Alpine.js + htmx。PC 与移动 同一套 HTML ,断点 1024 / 900 / 600 px。
- 零侵入 :无安装脚本、无数据库改动、无迁移任务,纯目录即插即用。
二、安装
1. 放目录 :整个`Xenforo` 目录拷到站点`assets/themes/Xenforo` (与`modern` 同级)。目录名即「主题键」,`?preview_theme=` 里必须写`Xenforo` 。
2. 自动发现,无需导入 :`Theme::getAvailable()` 会扫描`assets/themes/*` ,只要有`config.json` 或目录内含`.php` ,即注册为主题;后台立刻出现主题卡片。
3. 设为站点默认 :后台`/admin/themes` (路由见 index.php )→ 点该卡片「设为默认」(POST`/admin/themes/default` )→ 写入`default_theme=Xenforo` 并清空静态页缓存。
4. 或用户自行切换 :前台`/theme-settings` → 选主题 → 保存。登录用户写`users` 表,游客写 cookie。
5. 或只做预览 :任意 URL 追加`?preview_theme=Xenforo` ,仅本次请求生效、不影响他人(后台主题卡片上的「预览」按钮就是这个链接)。
主题生效优先级 :`?preview_theme` > 用户选择 > 游客`site_theme` cookie > 站点`default_theme` >`DEFAULT_THEME` 。
注意:若站点开了「夜间自动切换」,夜间时段会强制走`modern-night` (本主题没有夜间版)。



