首页最新用户排行
在论坛首页主内容区顶部展示最新注册的用户头像列表，让新成员被看见，让社区增长被感知。
v1.0.0 Xiuno BBS ≥ 1.1 插件 Plugin 无依赖
01 / OVERVIEW
插件概览
「首页最新用户排行」通过 index_main_start 钩子挂载到论坛首页主内容区的最上方，调用 user_find() 接口按注册时间倒序拉取最新 30 位用户，以头像网格的形式平铺展示。
卡片头部同时呈现注册会员总数与当前在线人数两项社区指标，使访客在进入首页的第一时间就能感知社区的活跃度与增长态势。整个插件仅由一个钩子文件和一份配置构成，不覆盖任何系统模板，不依赖其他插件，安装即生效。
02 / FEATURES
核心功能
围绕"发现新成员"这一目标，插件提供了展示、统计与交互三方面的能力。
最新用户头像墙
按注册时间倒序拉取 30 位最新成员，以自适应换行的头像网格平铺展示，新注册的用户始终排在最前。
社区数据统计
卡片头部内嵌注册会员总数与当前在线人数，访客一眼即可了解社区规模与实时活跃度。
头像悬浮提示
每个头像绑定 Tooltip，鼠标悬停即可显示用户昵称，无需点击即可识别身份，降低浏览成本。
一键访问用户主页
点击任意头像即跳转至对应用户的个人主页，方便老成员认识新人、发起互动，促进社区破冰。
头像组件自适应
优先调用 avatar_component_from_data() 渲染头像组件，不存在时自动降级为原生 img 标签，兼容不同主题环境。
零侵入式挂载
仅通过钩子注入，不覆盖任何系统模板文件，不依赖其他插件，卸载后首页恢复原状，干净无残留。
03 / HOW IT WORKS
工作原理
插件的核心逻辑集中在一个钩子文件中，从数据获取到视图渲染一气呵成。
1. 注册钩子
在 conf.json 中声明挂载点 index_main_start.htm，权重值为 10。该挂载点位于首页主内容区的起始位置，确保排行卡片出现在帖子列表上方。
2. 拉取最新用户
调用 user_find() 接口，以 uid 倒序排序、每页 30 条的方式获取最新注册用户。该接口内部自动触发 user_format，为每位用户生成 display_name 和 avatar_url 等展示字段。
3. 渲染头像网格
使用 Flexbox 布局将头像以 gap: 10px 的间距平铺排列，每个头像包裹在带 Tooltip 的链接中，指向对应用户的个人主页路由 url('user-uid')。
4. 注入社区统计
卡片头部读取 $runtime['users'] 和 $runtime['onlines'] 两个全局运行时变量，分别展示注册总数与当前在线人数，在线人数为零时自动隐藏。
04 / SPECS
技术规格
插件元信息与挂载关系一览，均来自 conf.json。
插件名称 | 首页最新用户排行 |
版本号 | 1.0.0 |
适用 BBS 版本 | 1.1 及以上 |
类型 | plugin |
挂载钩子 | index_main_start.htm（权重 10） |
覆盖文件 | 无 |
前置依赖 | 无 |
核心接口 | user_find() · user_format |
展示数量 | 最新 30 位用户 |
UI 框架 | Bootstrap 5 · Tabler Icons |
05 / INSTALL
安装与使用
三步完成安装，无需任何代码改动。
上传插件目录
将 leostudio_user_rank 整个文件夹上传至论坛的 plugin/ 目录下，确保 conf.json 与 hook/ 目录位于该文件夹根层。
后台安装启用
进入论坛后台「插件管理」，在未安装列表中找到「首页最新用户排行」，点击安装并启用。
刷新首页查看效果
打开论坛首页，最新用户排行卡片将出现在主内容区顶部。如需卸载，在后台禁用并删除即可，首页恢复原状。
版本：v1.0.0
适用版本：1.1
开发者：leostudio
