# XiaochenNav

**Repository Path**: xiaochenip/xiaochen-nav

## Basic Information

- **Project Name**: XiaochenNav
- **Description**: 小辰导航主题是一个wordpress简约实用的网址导航主题，聚合常用搜索、工具网站、学习资源、影视娱乐、设计素材、开发文档等各类优质网址。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-11
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小辰导航 XiaochenNav

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

![小辰导航主题预览](./screenshot.png)

- **仓库地址**：https://gitee.com/xiaochenip/xiaochen-nav
- **当前版本**：v1.0.0
- **开源协议**：GPL v2 or later
- **图标资源**：[Bootstrap Icons](https://icons.getbootstrap.com/) 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](./CHANGELOG.md)。