Discuz!插件 小蚁天气预报（国内版）

#小蚁天气Discuz插件

让天气真正融入你的Discuz网站，不是给Discuz加一个天气数字，而是给网站增加一套完整的本地天气服务。
和风天气每月免费提供5万次天气预报请求，普通站长够用了。
演示站：https://fjxiaoyidzx50.fqlook.cn/
小蚁天气是一款专为Discuz!打造的专业天气展示插件，支持PC+手机端，可根据访客IP自动识别所在城市并展示当地天气，同时支持固定城市、手动切换城市、天气详情页、未来天气、空气质量、天气预警、生活指数、降水趋势等丰富信息，拥有多种主题样式的独立天气详情页。
插件并不是简单地在论坛顶部放一个温度数字，而是希望把“天气”做成Discuz网站中的一个实用内容入口。
无论是地方门户、城市论坛、社区网站、生活服务网站，还是综合资讯论坛，都可以通过小蚁天气快速增加一个用户每天都可能用到的生活服务功能。

#为什么选择小蚁天气？

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

#核心优势

1、IP自动定位：访客打开网站后，可自动识别所在城市并展示本地天气，无需手动选择。
2、ip2region默认定位引擎：默认采用开源ip2region数据库，支持IPv4/IPv6，可在后台一键更新。
3、支持区县级增强定位：站长可自行购买商业IP定位服务（价格很便宜），或上传兼容的qqwry.ipdb数据库（需自行解决商业授权），在数据支持的情况下进一步识别区县。
4、QWeather专业天气数据（未来会支持更多的天气预报接口）：支持实时天气、逐小时天气、未来预报、空气质量、天气预警、生活指数、日出日落、降水趋势等信息。
5、PC+WAP双端适配：不是简单缩小PC页面，而是针对手机端单独优化展示逻辑和浮动入口。
6、多个显示位置自由控制：支持论坛首页、版块列表、帖子详情、页面顶部、全局悬浮等位置。
7、多套天气主题：内置现代卡片、极简线条、透明玻璃、深色、渐变等多种风格，可适配不同Discuz模板。
8、独立天气详情页：可将天气做成网站中的独立生活服务频道，而不仅是一条天气横幅。
9、行政区切换：用户可以从省、市、区县层级选择天气地区。
10、附近城市天气：详情页支持展示周边城市天气，增强本地生活属性。
11、顶部降水趋势图：可展示未来降水趋势，让天气信息更加直观。
12、高性能缓存机制：论坛页面优先读取本地缓存，避免每次访问都同步请求天气接口。
13、异步天气刷新：缓存过期后通过AJAX更新天气，尽量避免外部API拖慢论坛打开速度。
14、支持伪静态天气页面：可将天气详情页设置为/weather/、/weather/101230101.html等更友好的地址。
15、适配DiscuzX3.4/X3.5/X5.0/X5.1。

#访客打开论坛后，会看到什么？

例如一位来自福州的用户进入网站。
系统自动识别访客所在城市后，可在论坛顶部显示：
☀福州28℃多云
体感30℃·湿度68%·东北风2级
今日25℃/32℃
用户如果只是想快速看天气，到这里已经足够。
如果点击天气区域，则可以进入完整天气详情页。
详情页可以进一步看到：
1、当前天气：大字号温度、天气状况、体感温度、当天最高最低温。
2、今日天气：风向、风力、湿度、降水、能见度、紫外线、日出、日落等信息集中展示。
3、未来降水趋势：通过柱状趋势展示未来一段时间的降雨变化。
4、逐小时天气：查看接下来数小时气温、天气、降水等变化。
5、未来天气：查看未来数天天气趋势。
6、空气质量：查看AQI等空气质量信息。
7、天气预警：当地存在高温、暴雨、大风、台风等预警时，可在天气页面展示。
8、生活指数：根据天气提供相关生活参考。
9、附近城市天气：在天气详情页面底部查看附近地区天气。
这样，一个原本只有简单“天气温度”的小功能，就变成了网站中的一个完整生活服务模块。

#六种天气条样式

插件内置多套天气条视觉风格。
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:detail
还可以配置伪静态，例如：
/weather/
指定地区：
/weather/101230101.html
因此对于地方门户来说，可以直接增加一个：天气频道。甚至可以在网站主导航中加入：首页·新闻·房产·招聘·天气，让天气真正成为网站内容体系的一部分。

#支持Discuz网站导航和头部

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

#天气接口

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

#高性能缓存架构

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

#针对Discuz应用中心规范持续优化

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

#第三方组件来源透明

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

#购买插件后，还需支付哪些费用？

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

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