盘搜主题（pansou）

面向社区插件（community）的网盘资源搜索风格主题，视觉。

依赖

• 宿主：community 插件（>=1.0.0）
• 可选：pansou_search 插件（提供全网资源聚合接口 /pansou-search/api）

功能

• 首页：Hero 大搜索框、热门词、分类与快捷入口、每日封面墙（可配置数量/开关）
• 搜索页：

 - 顶部搜索工具条（再次搜索）

 - 排序切换：综合（最新回复）/ 最新发布 / 精华优先（复用宿主 tab 参数）

 - 搜索联想下拉（/pansou-suggest?kw=，仅站内标题）

 - 浏览器本地搜索历史（localStorage，最多 10 条，可清空）

 - 网盘类型筛选、全网资源来源筛选

 - 全网资源提取码点击复制

• 页脚：免责声明、ICP/公安备案、统计代码

后台配置

安装主题后，在「插件列表 → 盘搜主题 → 主题配置」进入：

/admin/community_pansou/config

页面分 5 组：基础信息、首页设置、搜索设置、页脚设置、SEO 与统计。

「搜索设置」同时维护 pansou_search 插件参数（启用、源站地址、搜索源、超时、缓存、结果上限、代理），并可在页面内测试聚合接口。

保存接口：POST /admin/community_pansou/save，保存后自动清理前台整页缓存。

胶水路由

遵循 duanju 主题的胶水模式：主题安装/升级时由 ThemePlugin::writeGlueRoutesFile() 幂等写入

plugins/pansou/routes.php，宿主仅扫描该文件注册路由；控制器与视图全部位于 themes/pansou/。

卸载时删除该文件，不改动任何宿主文件。

路由清单：

目录结构

themes/pansou/
├── ThemePlugin.php          # 主题入口：菜单 / 胶水路由 / 配置 schema / 安装卸载
├── plugin.json
├── theme.json
├── controller/
│   ├── admin/Base.php       # 后台控制器基类（视图指向主题内）
│   ├── admin/Index.php      # 主题配置读取与保存
│   └── front/Api.php        # 搜索联想接口
├── view/
│   ├── admin/config.html    # 自建配置页
│   └── front/{layout,index,topic,page}.html
└── static/theme.css

缓存说明

模板与样式在运行时由 ThemeResolver 合并到 runtime/theme_front/pansou。

修改模板/样式后需清理：

runtime/theme_front/
runtime/temp/

主题版本号变更会触发前端 CSS 缓存刷新。

作者

kuakeba.cn