免费 [XenForo] Avatar Gallery —— 头像库/头像画廊插件 v1.0.0

插件简介​

Avatar Gallery 是一款 XenForo 头像库插件，可为你的论坛提供一个零配置、自动分类的头像选择画廊。

插件会自动扫描服务器指定目录中的图片，并在用户选择头像时展示一个“头像库”，让用户可以从你准备好的头像合集里快速挑选。
整个过程无需手动添加数据库记录，也不需要复杂的后台设置。

---

核心功能亮点​

自动扫描（动态发现）​

你只需要把头像图片 拖放/上传到指定文件夹，插件就会自动识别并加入头像库。

---

自动分类（原生标签页）​

插件会根据文件夹名称自动生成标签页分类：

• 根目录下的图片 → 显示在 默认（Default） 标签
• 放在 Zombies/ 文件夹 → 自动生成 Zombies 标签
• 放在 Retro/ 文件夹 → 自动生成 Retro 标签

---

自适应风格（亮/暗色主题完美融合）​

基于 XenForo 原生样式属性构建，能自动适配你当前的主题（包括浅色/深色风格），不需要额外适配。

---

性能优化（缓存机制）​

为了性能，插件会缓存头像文件列表：
如果你新增图片后暂时没显示，清理缓存或等待 最多 1 小时即可生效。

---

安装方法（官方步骤）​

1. 上传插件
   
   • 将压缩包内 upload 目录的内容上传到 XenForo 根目录
2. 后台安装
   
   • 进入 AdminCP → Add-ons，找到 AvatarGallery 点击安装
3. 上传头像图片
   
   • 进入服务器目录：data/gallery_avatars/Global/
   • 上传头像图片（支持 JPG / PNG / GIF / WEBP）
   • （可选）创建文件夹如 Heroes、Villains 自动分类成标签页

---

常见问题（FAQ）​

Q：如何修改标签页名称？​

A：直接重命名文件夹即可，例如修改：
data/gallery_avatars/Global/ 下的目录名，标签页名称会自动同步更新。

Q：上传了图片但没显示？​

A：插件有缓存机制，清理缓存或等待最长 1 小时更新即可。

Q：会影响用户自己上传头像吗？​

A：不会。用户仍然可以正常上传自定义头像，头像库只是额外提供一个“可选头像合集”。

---

兼容信息​

• 适配 XenForo：2.3