xnx_site_images 站点图片管理

功能

• 将站点 logo/favicon/水印/默认头像/版块图标等图片移至 upload/ 目录管理

• 支持 6 类图片：

- logo_pc（PC 端 Logo）

- logo_mobile（移动端 Logo） - favicon_ico（Favicon .ico） - favicon_apple（Apple 触屏图标） - default_avatar（默认头像） - forum_default（版块默认图标）

• 每类图片独立配置扩展名和大小限制

• 自动注入到前台 header_link_after.htm / footer_js_after.htm

• 版块图标自动通过 model_forum_format_end.php 注入

• 用户默认头像通过 model_user_format_end.php 注入

• 文件存储于 upload/site_images/，系统更新不覆盖

文件结构

plugin/xnx_site_images/
├── conf.json
├── install.php / uninstall.php
├── README.md
├── model/
│   └── SiteImagesService.php          # 核心服务
├── setting.htm / setting.php          # 后台配置页
└── hook/
    ├── header_link_after.htm          # 注入 logo/favicon
    ├── model_forum_format_end.php     # 注入版块图标
    ├── model_user_format_end.php      # 注入默认头像
    ├── index_inc_start.php            # 初始化读取设置
    ├── lang_zh_cn_bbs.php
    ├── lang_zh_tw_bbs.php
    └── lang_en_us_bbs.php

配置流程

1. 后台「插件管理」启用 xnx_site_images

2. 进入「插件设置」→ 上传各类图片

3. 保存后自动生效，前台无需修改模板

扩展说明

SiteImagesService 为纯静态类。

Service 类方法

SiteImagesService::getImageDefs(): array
SiteImagesService::getSettings(): array
SiteImagesService::saveSettings(array $data): bool
SiteImagesService::getUrl(string $key): string
SiteImagesService::hasImage(string $key): bool
SiteImagesService::upload(string $key, string $tmpFile): array
SiteImagesService::remove(string $key): bool

图片项 key 与默认值

| key | 类型 | 允许扩展 | 最大大小 | 默认路径 | |-----|------|---------|---------|---------| | logo_pc | 图片 | png/jpg/svg/webp | 1MB | view/img/logo.png | | logo_mobile | 图片 | png/jpg/svg/webp | 1MB | view/img/logo.png | | favicon_ico | 图标 | ico | 100KB | view/img/favicon.ico | | favicon_apple | 图标 | png | 512KB | view/img/favicon.png | | default_avatar | 图片 | png/jpg/webp | 1MB | view/img/avatar.png | | forum_default | 图片 | png/jpg/svg/webp | 1MB | view/img/forum.png |

版本 1.0.0 | 兼容 Xiuno 1.1+