# DaoHang 影视导航主题简介
## 主题定位
DaoHang 影视导航主题是一款适配 Xiuno 4.x 的影视资源导航插件，用于把论坛首页改造成轻量导航入口页。主题内置在线影视、网盘资源、BT 磁力三类导航内容，并支持在后台维护分类按钮、站点列表、SEO 信息和参考链接。
当前默认参考站点为：https://dyxs.locbb.eu.org
## 主要功能
1. 首页导航模块
首页顶部展示独立导航面板，包含站点名称、站点介绍、分类按钮、站点卡片、导航说明和参考链接。
2. 三类资源分组
默认提供三个分类入口：
- 在线
- 网盘
- 磁力
每个分类都有独立站点文本框，方便批量维护。
3. 站点卡片展示
每个站点按卡片形式展示，包含站点名称、简介、主站链接和备用链接。备用链接为空时会显示暂无备用。
4. 后台可配置
后台插件设置支持修改：
- 首页是否展示
- 站点名称
- 站点介绍
- 三个分类按钮名称
- 三个分类站点列表
- SEO 标题、关键词、描述
- 导航说明
- 参考链接
5. 首页输出精简
当前主题配置为首页只输出导航模块。导航页脚之后的论坛列表、侧栏、分页等内容已取消输出，首页更接近纯导航页。
## 站点录入格式
后台每个分类的站点列表按行录入，一行一个站点：
```text
名称|主站|备用|简介
```
示例：
```text
示例站|https://example.com|https://backup.example.com|示例资源站说明
```
备用链接和简介可以留空：
```text
示例站|https://example.com||站点简介
```
## 文件结构
```text
DaoHang_theme/
├── conf.json 插件基础信息和 hook 配置
├── install.php 安装初始化
├── setting.php 后台设置逻辑
├── include/daohang.func.php 默认配置、站点解析、卡片渲染函数
├── hook/ Xiuno hook 文件
├── css/daohang.css 前台导航样式
├── js/daohang.js 前台分类切换脚本
└── view/htm/setting.htm 后台设置页面
```
## 安装使用
1. 将目录放到：
```text
plugin/DaoHang_theme
```
2. 进入 Xiuno 后台插件管理。
3. 安装并启用“DaoHang影视导航主题”。
4. 进入插件设置页，按需要修改站点名称、分类按钮、站点列表和 SEO 信息。
5. 保存后刷新首页查看效果。
## 兼容说明
- 适配 Xiuno 4.x。
- 默认使用 UTF-8 编码。
- 资源样式通过 `css/daohang.css` 加载。
- 分类切换通过 `js/daohang.js` 完成。
- 资源链接来自公开互联网索引，插件只做导航展示，不存储、不分发具体影视内容。
## 维护建议
1. 上线前请检查所有站点链接可用性。
2. 建议按站点定位删减默认资源，避免首页内容过多。
3. 定期检查备用链接是否失效。
4. 修改中文文案时保持 UTF-8 编码，避免中文乱码。
5. 如需恢复论坛首页列表，需要调整 `hook/index_start.htm` 中导航模块后的截断输出逻辑。