# 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 查询