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配置能力。