轻论坛 liteBBS 主题

极简黑白风格的轻论坛主题，前端布局参考 litebbs.com：顶部固定导航栏（Logo / 搜索 / 发帖 / 用户区）+ 三栏主体 —— 左侧固定纵向导航菜单、中间信息流卡片、右侧栏（站点统计 / 公告 / 热门讨论 / 热门标签）。

• 作者：kuakeba.cn
• 类型：主题（type: theme）
• 宿主：community 官方社区插件（需先安装并启用 community）
• 版本：1.0.15

特性

• 顶部固定导航栏 + 左侧固定纵向菜单，移动端自动切换为顶栏 + 抽屉菜单；布局可在后台切换为三栏 / 双栏（无右侧栏）
• 适配官方 community 插件，覆盖 layout / index / topic / forum / page 前台模板，其余页面（会员中心、发帖、登录页等）自动回退宿主模板并继承本主题布局
• 兼容所有 extend 宿主布局的插件前台页（榜单、网盘、签到、VIP 等）：插件页面自动获得顶栏与左侧导航，内容区占满剩余宽度不受信息流限宽影响
• 详情页右侧栏自动展示「关于作者」卡片与热门讨论；单页右侧栏展示页面导航
• 完善的后端配置：外观、首页、侧栏、页脚、高级共 5 组配置，配置页为美化后的独立界面
• 完整登录 / 注册 / 找回密码弹窗，支持图形验证码、邮箱验证码、短信验证码（随宿主开关自动显隐）
• 详情页点赞 / 收藏 / 关注 / 引用回复，全部走宿主既有接口
• SEO：canonical 去跟踪参数、私有页面 noindex、标题 / 描述 / 关键词按页面类型分级回退
• 页脚支持站点简介、多栏菜单、友情链接（自动读取 friends 友情链接插件的已审核数据，插件不可用时回退后台手动配置）、ICP 备案号、Load 耗时统计

安装（不修改任何宿主文件）

1. 将本主题整个目录上传至 themes/liteBBS/
2. 将自动生成的胶水路由文件上传（或等待第 3 步自动生成）：plugins/liteBBS/routes.php
3. 命令行执行一次注册脚本：

php themes/liteBBS/bin/register.php

脚本会幂等完成：补写插件记录 → 注册后台菜单 → 生成路由胶水 → 复制静态资源 → 启用主题。重复执行不会清空任何社区数据。

后台配置

启用后进入后台「轻论坛 → 主题配置」（路由 /admin/community_litebbs/config）：

目录结构

themes/liteBBS/
├── plugin.json            主题元数据（type=theme, host=community）
├── theme.json             主题声明（模板覆盖配置）
├── ThemePlugin.php        主类：配置项 / 菜单注册 / 路由胶水
├── icon.svg / icon.png    图标
├── bin/register.php       CLI 部署脚本
├── controller/admin/      后台配置控制器
├── view/admin/config.html 配置页
├── view/front/            前台模板（layout/index/topic/forum/page）
└── static/theme.css|js    主题样式与脚本

卸载

后台插件管理中卸载本主题即可，会自动清理菜单、路由胶水与公共静态资源，不影响 community 数据。