社区榜单运维

一、插件简介

社区榜单（ranklist）汇总社区用户在各维度的排名，提供 活跃榜、主题榜、获赞榜、积分榜、金币榜 五个榜单，支持时间范围筛选，并在社区顶部导航提供「榜单」入口。

数据来源于社区帖子、回复与用户积分/金币字段（或流水），无需单独业务表。

• 前台入口：顶部导航「榜单」（约 /ranklist，伪静态下常见 /ranklist.html）
• 后台入口：无独立后台菜单；配置在 应用中心 → 社区榜单 → 配置

前台 URL 受社区伪静态影响，路径后可能带 .html 等后缀。

二、核心能力

时间范围： 全部时间、近 7 天、近 30 天（部分逻辑兼容 week 本周）。

展示： 排名、头像、昵称、等级徽章、统计文案、前三名奖牌样式；可跳转用户主页。

三、依赖与安装

建议环境：

• 必须安装并启用 社区（community） 插件（帖子、回复、积分数据）
• 积分榜/金币榜周期统计依赖 community_coin_log 表（含 currency 列时更准确）

安装步骤：

1. 应用中心安装并启用「社区榜单」
2. 配置页面标题、副标题、每榜人数
3. 确认社区顶部导航出现「榜单」
4. 访问 /ranklist 验证五个 Tab 数据

数据表： 无独立表；只读社区与用户表。

四、应用中心基础配置

路径：应用中心 → 社区榜单 → 配置

五、后台/重点配置

无后台业务管理页。榜单规则由 RanklistService 代码定义，不可在后台改公式。

若需调整：

• 修改 plugins/ranklist/service/RanklistService.php 中各 board 统计逻辑
• 或通过社区运营策略间接影响（发帖、积分发放）

六、前台用户流程

1. 点击导航 榜单 进入榜单页
2. 切换 Tab：活跃 / 主题 / 获赞 / 积分 / 金币
3. （若页面提供）切换时间范围：全部 / 7 天 / 30 天
4. 查看排名列表，点击用户进入其 个人主页

七、后台审核与运维

无审核。运维建议：

• 定期关注异常刷榜（可结合社区风控、积分规则）
• 大站点注意榜单查询性能（依赖社区表索引）

八、特殊说明

8.1 路由

8.2 钩子与导航

• 安装时 CommunityNavService::ensurePluginNav('ranklist')
• 卸载时移除导航项

8.3 活跃分公式

active_score = topic_count × 2 + reply_count × 3（在选定时间范围内统计）。

8.4 管理员作者

user_id=0 的历史数据会尝试解析为管理员展示（社区主理等等级样式）。

九、推荐上线清单

1. 启用榜单并设置标题文案
2. 确认社区有足够帖子/用户数据，避免空榜
3. 检查导航链接与伪静态后缀
4. 抽查五个榜单与周期切换是否正确
5. 验证用户主页链接可打开

十、常见问题

Q：榜单页 404？ 检查「启用榜单」与 ranklist 插件是否安装；路由是否加载。

Q：积分榜/金币榜周期数据为空？ 可能 community_coin_log 无记录或缺少 currency 列；全部时间榜仍读用户当前余额。

Q：导航没有「榜单」？ 重新安装插件或调用 RanklistPlugin::ensureNavItem() 纠正导航。

Q：排名与预期不符？ 核对各榜统计口径（活跃分公式、仅统计 status=1 且未删除的帖/回）。