Discuz!插件 小蚁天气预报（全球版）

小蚁天气全球版是一款专为Discuz!打造的跨境专业天气展示插件，支持PC+手机端，可根据访客IP自动识别所在城市并展示当地天气，同时支持全球固定城市、手动切换城市、天气详情页、未来天气、空气质量、天气预警、生活指数、降水趋势等丰富信息，拥有多种主题样式的独立天气详情页。

插件并不是简单地在论坛顶部放一个温度数字，而是希望把“天气”做成Discuz网站中的一个实用内容入口。

支持简体中文、繁体中文、英语、日语、韩语，无论是全球地方门户、城市论坛、社区网站、生活服务网站，还是综合资讯论坛，都可以通过小蚁天气预报全球报快速增加一个用户每天都可能用到的生活服务功能。

- 支持版本：Discuz! X3.4、X3.5、X5.0、X5.1
- 支持编码：UTF-8
- 简体中文：SC_UTF8
- 繁体中文：TC_UTF8
- 前台语言：简体中文、繁体中文、英语、日语、韩语
- 不支持 GBK
- 演示地址：https://fjxiaoyidzx50.fqlook.cn/global-weather/

#为什么选择小蚁天气全球版？
目前不少Discuz天气插件只是简单调用天气接口，然后显示：伦敦28℃多云，功能非常有限。
而小蚁天气从一开始就是按照一个完整的Discuz天气服务模块来设计。它不仅要“能显示天气”，更注重：定位准确、显示美观、移动端友好、加载快速、后台好管理、兼容Discuz、数据源规范、方便长期运营。对于运营海外论坛的站长来说，安装后基本不需要修改模板，也不需要自己写代码。



主要特点：
- 全球国家、地区和城市天气预报
- 国内版与全球版可同时安装运行
- 支持 QWeather 全球城市搜索
- 支持国家/地区选择和城市搜索兜底
- 支持浏览器经纬度定位、商业 IP 定位、DB-IP City Lite、MaxMind GeoLite2 City
- 中国 IP 可使用 ip2region、qqwry.ipdb 增强
- 支持自动语言识别和手动语言切换
- 支持用户天气收藏夹
- 支持 PC、WAP 页面
- 支持天气详情伪静态地址：
  - /global-weather/
  - /global-weather/城市.html
- 支持 DB-IP City Lite 在线更新和手动上传
- 支持多套天气卡片样式和主题
- 分钟级降水仅在支持的地区和语言环境显示
- 海外无分钟级降水时自动调整空气质量和生活指数布局
- 空气质量、生活指数、未来天气、附近城市天气均已优化显示

#六种天气条样式
插件内置多套天气条视觉风格。
1、跟随模板：白色背景、轻边框、低阴影。适合绝大多数Discuz默认模板及门户模板。
2、现代卡片：更加现代的网站视觉效果。适合门户、科技、综合资讯网站。
3、极简线条：减少背景和装饰。适合简约风格模板。
4、透明玻璃：使用轻透明效果。适合图片背景、科技感模板。
5、深色：适合深色Discuz模板。
6、彩色渐变：视觉更加活跃。适合年轻化、社区化网站。
站长可以直接在后台切换，不需要修改CSS。

#PC和手机端分别优化
很多老式Discuz插件所谓“支持手机端”，实际上只是：把PC页面缩小。小蚁天气不是这样处理。
插件针对PC和WAP分别提供：
PC显示设置以及WAP显示设置，站长可以分别控制。
例如PC支持：论坛首页顶部、版块列表顶部、帖子详情顶部、右下角天气按钮（可调整距离底部多少像素）
手机端可以单独设置：手机版首页、手机版版块页、手机版帖子页、右下角天气按钮（可调整距离底部多少像素）
不会出现PC设置改变以后，手机端布局一起被破坏的问题。
PC天气长条支持自由选择字段，不同论坛模板宽度不同。
有的站长喜欢简洁：福州28℃多云
有的站长希望信息丰富：福州28℃多云·体感30℃·湿度68%·东北风2级·能见度10km，因此PC顶部天气条支持自由勾选字段。
可选择：气图标、城市、当前温度        、天气情况、体感温度、相对湿度、风向、风力、降水、能见度、紫外线、今日最低温、今日最高温、日出、日落
站长可以根据自己模板宽度进行组合。

#天气图标支持多种颜色
插件内置完整Qweather天气图标资源。并支持：智能多色、蓝色、橙色、绿色、紫色、灰色、深色、自定义颜色
例如晴天可以显示黄色太阳。雨天显示蓝色天气图标。阴天显示灰蓝色。不同天气状态一眼就能区分。

#独立天气详情页面
小蚁天气并不是只有论坛顶部天气条。插件自带完整天气详情页。
默认访问：
/plugin.php?id=fjxiaoyi_weather_global:detail
还可以配置伪静态，例如：
/weather_global/
指定地区：
/weather_global/101230101.html
因此对于地方门户来说，可以直接增加一个：天气频道。甚至可以在网站主导航中加入：首页·新闻·房产·招聘·天气，让天气真正成为网站内容体系的一部分。

#支持Discuz网站导航和头部
天气详情页可以选择：使用独立页面或者：显示Discuz网站头部导航，开启后，用户进入天气页面仍然可以看到原网站：LOGO、导航栏、用户登录状态、网站整体结构，视觉上不会像跳到一个第三方网站。

#天气接口
天气接口采用QWeather，插件天气数据基于QWeather。使用：JWT认证（普通API官方将在2027年下线）。

#高性能缓存架构
天气插件最容易出现的问题就是：天气接口一慢，整个论坛都跟着慢。小蚁天气专门针对这个问题优化。论坛首页、帖子页等全局页面：不会因为天气缓存过期，就直接同步等待外部天气接口。插件优先读取本地天气缓存。
采用多级天气缓存，不同天气数据变化速度不同。例如当前天气更新较快，而日出日落一天基本不会变化。因此插件不是简单设置一个统一缓存时间，而是针对不同天气类型进行缓存。这样既可以降低QWeatherAPI调用量，也可以提高天气页面加载速度。

#针对Discuz应用中心规范持续优化
小蚁天气不是简单“能运行就提交”。插件针对Discuz应用中心审核规范进行了专门整改。目前已经重点优化：
插件目录规范
永久数据目录
缓存目录
上传处理
生命周期脚本
系统表操作
外部API请求
SSRF防护
私钥管理
目录权限
AJAX刷新
全局Hook性能
IPv4/IPv6数据库
第三方开源许可说明
对于长期运营网站来说，这一点非常重要。

#第三方组件来源透明
插件不会偷偷内置来源不明的IP数据库。默认IP定位采用：ip2region（支持一键更新），并保留对应开源许可证。支持DB-IP City Lite 全球城市数据库。
天气图标采用：QWeatherIcons，并保留对应CCBY4.0授权说明。
对于需要额外使用第三方IP数据库的站长，插件只提供兼容能力，由站长自行取得相关数据文件。

#购买插件后，还需支付哪些费用？
不包含天气API费用本，插件属于：Discuz天气系统插件。天气数据由站长自行申请QWeather服务（每个月有50000的免费请求数，对于小站够用了）。插件本身不会出售或转售QWeather数据。具体API免费额度、套餐和调用限制以QWeather官方账户实际显示为准。
和风天气价格标准请参考：https://dev.qweather.com/docs/finance/pricing/

配置指南：https://www.fjxiaoyi.com/product-16.html?tab=help

v1.3.8 更新日志

- 修复 PC 端天气组件跳转链接偶发多出 &mobile=2 的问题：插件异步刷新请求携带的 mobile=0/1 参数此前被误判为手机端，导致电脑上点击顶部天气、Logo 后紧凑天气、悬浮天气会进入手机版详情地址。
- 设备识别改为只依据 Discuz 自身的手机状态（IN_MOBILE / $_G['mobile']）

v1.3.7 更新日志

- 修复IP定位小概率失效问题

v1.3.6 更新日志

- 修复海外国家空气指数图标缺失问题

v1.3.5 更新日志：
- 增加 X3.4、X3.5、X5.0、X5.1 站点的全球伪静态规则。
- 完善全球国家、地区和城市选择器。
- 完善多语言天气指数和地区名称回退机制。
- 优化 PC/WAP 天气卡片、空气质量、生活指数和附近城市布局。
- 保留 DB-IP City Lite 在线更新、手动上传和商业 IP API 配置能力。