小辰导航 XiaochenNav

简约实用的 WordPress 网址导航主题：分类导航、网站投稿、服务端点击排行榜、明暗主题、可视化后台设置，开箱即用。

• 仓库地址：https://gitee.com/xiaochenip/xiaochen-nav
• 当前版本：v1.0.0
• 开源协议：GPL v2 or later
• 图标资源：Bootstrap Icons v1.11.3（MIT License，免费可商用，字体自托管）

---

功能特性

前台展示

• 响应式卡片式导航布局，适配桌面与移动端
• 左侧分类导航栏，支持一键收起 / 展开（默认展开）
• 全站关键词搜索（标题、描述）
• 浅色 / 暗色主题切换，跟随系统并记忆用户选择
• 右侧栏模块：最新收录、热门分类、点击排行、站点信息卡片，均可在后台独立开关
• 分类图标与站点 LOGO 在明暗主题下自动切换

网站管理

• 自定义文章类型「网址」（nav_link）与分类法「网址分类」（nav_category）
• 后台编辑页集成「网站信息」面板：链接、评级、图标、描述一处录入
• 卡片排序规则：评级高者靠前，同评级按最后更新时间倒序
• 分类图标可视化选择器：内置 2000+ Bootstrap Icons，支持中文搜索
• favicon 四级自动降级获取： 自定义图标 → 站点自身 favicon → 备用服务 → 内置占位图

网站投稿

• 独立投稿页，支持标题、链接、分类、评级、描述、图标
• 登录用户提交后直接发布；游客提交自动进入待审核
• 同一 URL 自动去重，后台审核后上线

点击排行榜

• 服务端点击量统计（按日明细 + 总量，自动清理 60 天前数据）
• 完整排行榜弹窗：日榜 / 周榜 / 月榜 / 总榜 TOP 30
• 前三名金、银、铜奖牌样式，侧栏实时显示 TOP 5

主题设置（后台独立菜单「主题设置」）

设置页	配置项
常规设置	默认主题模式、favicon 备用服务、兜底图标 URL
站点 LOGO	亮色 / 暗色 × 横版 / 方形，共 4 套，媒体库上传
侧边栏设置	四个模块显示开关；卡片标题、简介、QQ、版权、ICP 备案号全部可编辑

---

环境要求

• WordPress 5.5+
• PHP 7.2+
• 任意固定链接结构均可（主题自动适配投稿页等页面地址）

---

安装方法

1. 后台进入 外观 → 主题 → 上传主题，选择 XiaochenNav.zip 安装并启用； 或将压缩包解压后的 XiaochenNav 目录上传到 wp-content/themes/。
2. 启用后自动创建「网站投稿」页面（slug: submit）。
3. 进入 网址 → 网址分类 添加分类，网址 → 添加新网址 录入网站。
4. 访问首页即可看到导航；进入 主题设置 配置 LOGO、侧边栏与文案。

---

REST API

所有接口挂在 /wp-json/nav/v1/ 下（朴素固定链接时为 /index.php/wp-json/nav/v1/）：

方法	路径	说明
POST	/links	添加网址（登录直发 / 游客待审核，URL 去重）
POST	/click	点击量上报 { "id": 文章ID }
GET	/rankings?period=day|week|month|total&limit=30	点击排行榜

---

技术栈

• WordPress REST API、PHP、原生 JavaScript（无前端构建依赖）
• Tailwind CSS（CDN 引入）
• Bootstrap Icons v1.11.3（MIT，自托管 woff2 字体）

---

更新日志

详见 CHANGELOG.md。