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