# xyi_zankuang 站况插件
首页展示站点统计卡片：最新注册用户、今日帖子数/回复数、总帖子数/回复数/用户数，以及最新付费主题（可选）。
## 功能
- 最新注册用户：取 `user` 表 `create_date` 最新的一条，显示头像与昵称
- 今日数据：当日发帖数、当日回复数
- 总计数据：总帖子数、总回复数、总用户数
- 最新付费主题：`paylist` 表中最新一条 `type=1` 付费主题（表不存在时自动隐藏该卡片）
## 要求
- XIUNOX 核心版本 1.1.x（`bbs_version` 字段校验）
- 推荐 PHP 8.0+（核心本身要求）
## 安装
1. 后台 → 插件管理 → 上传插件，选择 `xyi_zankuang.zip`
2. 启用插件
3. 若首页未生效，清除 `tmp/` 编译缓存（`rm -f tmp/route_*.php tmp/view_htm_*.htm tmp/*.inc.php`）
## 目录结构
```
xyi_zankuang/
├── conf.json # 插件配置
├── icon.png # 插件图标
└── hook/
├── index_page_end.htm # 首页底部统计卡片模板
├── lang_zh_cn_bbs.php # 简体中文语言键
├── lang_zh_tw_bbs.php # 繁体中文语言键
└── lang_en_us_bbs.php # 英文语言键
```
## 语言键
| 键 | 说明 |
|---|---|
| `xyi_latest_user` | 最新注册用户标题 |
| `xyi_today_threads` | 今日帖子数 |
| `xyi_today_posts` | 今日回复数 |
| `xyi_total_threads` | 总帖子数 |
| `xyi_total_posts` | 总回复数 |
| `xyi_total_users` | 总用户数 |
| `xyi_latest_paid` | 最新付费主题标题 |
## 开发说明
- 插件前缀统一为 `xyi_`（conf.json id、PHP 变量、语言键）
- 用户信息显示走核心业务层 `user_read_cache()`，显示名取 `display_name`
- 头像统一用核心 `avatar_component()`
- 链接用 `user_url()` / `thread_url()`
- 所有输出经 `esc_html()` / `esc_attr()` 转义
- 计数数据取自 `runtime` 全局变量，无额外 DB 查询
版本：v1.0.0
适用版本：1.1
开发者：轩逸
