# WPDate 農曆萬年曆外掛 2.0 正式上線：節氣提醒與傳統節日功能全面升級 *Published:* 2026-05-26 *Author:* 殼殼蟲 這個外掛是什麼 ------- WPDate 農曆萬年曆外掛 2.0 是一個 WordPress 時間展示工具。它在公曆-農曆轉換的基礎上，新增了節氣自動提醒和傳統節日管理功能。 目標使用者是運營中文文化類、農業類、生活類網站的站長。這些網站不能只用公曆——使用者看農曆、查節氣是剛需。 和 1.0 版本相比，2.0 不再只是”農曆查詢工具”。它變成了一個能自動感知時間、主動提醒節氣變化的智慧模組。你不需要手動更新任何東西，外掛會自動匹配當前日期對應的節氣，並在你指定的位置顯示提醒。 現在能用什麼、接下來有什麼 ------------- **當前可用（2.0.0 版本，2026 年 5 月釋出）：** - 完整的公曆-農曆互轉，覆蓋 1900-2100 年 - 二十四節氣自動識別與提醒 - 傳統節日管理（春節、端午、中秋等 15 個主要節日） - 節日倒計時區塊 - 4 個區塊編輯器專用區塊：農曆日期、節氣提醒、節日列表、節日倒計時 - 側邊欄小工具支援 - theme.json 樣式相容 **下一版本（2.1，預計 2026 年第三季度）：** - 遊標懸停提示增強 - 節氣詳情彈出卡片 - 自定義節日匯入功能 **遠期規劃（2.5，2027 年初）：** - 生辰八字推算模組 - 黃曆宜忌查詢 - 農曆日程管理整合 定價與獲取方式 ------- WPDate 2.0 基礎版免費。你可以從 WordPress 外掛目錄直接搜尋”WPDate”安裝，或訪問 WordPress.org 外掛頁面下載。 付費高階版定價 199 元/年，包含以下功能： - 資料來源更新保障（基於最新農曆規則） - 30+ 傳統節日模板 - 自定義提醒樣式編輯器 - CSS[2](#5b57858e) 免衝突模式 - 電子郵件技術支援 購買方式：在外掛設定頁面點選”升級到高階版”，跳轉到官網支付頁面。支援支付寶和微信支付。付費後啟用碼即時發放。 中文網站的農曆剛需 --------- 一個非遺文化部落格，每天有 3000 次訪問。讀者來查某個傳統節日的具體日期，或者想了解”今天是什麼節氣”。如果部落格只能顯示公曆日期，讀者的體驗就會斷掉——他們要開啟另一個網站查農曆。 農業類站點同樣。假設你運營一個茶葉電商網站，春茶上市需要配合”清明””穀雨”節氣推廣。如果網站不能自動顯示當前節氣，你只能在每個節氣到來前手動更新促銷資訊。每年 24 次手動操作，成本不低。 傳統解決方案有三種，每種都有自己的問題： **方案一：手動更新。** 在文章或頁面裡硬編碼節氣日期。每年都要改，容易忘，容易出錯。2025 年清明是 4 月 4 日，2026 年是 4 月 5 日——如果忘記更新，日期就錯了。 **方案二：靜態表格。** 放一張全年節氣表在頁尾。使用者得自己比對今天的日期，體驗很差。而且表格佔地方，在手機上更難看。 **方案三：第三方 API[1](#180145d2)。** 呼叫外部天氣或日曆 API 獲取農曆資料。問題是 API 可能收費、可能宕機、可能停服。你的網站依賴別人的伺服器，每多一層依賴就多一層風險。 WPDate 2.0 解決這三個問題。農曆資料存在本地，不依賴外部 API。節氣自動匹配，不需要手動更新。展示方式透過區塊編輯器自由控制，不佔固定位置。 節氣提醒怎麼工作 -------- WPDate 2.0 內建了完整的二十四節氣時間表。這個時間表基於最新的農曆計算規則，精確到天。 外掛每天自動檢測當前日期是否對應某個節氣。如果匹配，就在你指定的位置顯示提醒。如果今天不是節氣，它顯示距離下一個節氣的倒計時天數。 **核心機制分三步：** 1. **資料匹配**：外掛內建 2020-2040 年的節氣日期資料。當前日期與資料庫比對，確認是否命中。 2. **提醒觸發**：命中後，提醒區塊自動更新內容。從”距離下一個節氣 X 天”變成”今日節氣：穀雨”。 3. **樣式渲染**：提醒內容透過區塊模板渲染，適配當前主題的 CSS 變數。 **可配置項：** - 提前提醒天數（0-15 天）：設為 3 天，距離節氣還有 3 天時就開始提醒 - 顯示風格：簡潔模式（僅節氣名稱）或詳細模式（節氣名稱 + 日期 + 簡釋） - 提醒位置：頁首、側邊欄、文章底部，或任意區塊位置 - 字型和顏色：繼承主題預設樣式，也支援自定義 假設一箇中醫養生部落格在側邊欄放置了節氣提醒區塊。穀雨前 3 天，側邊欄顯示”距穀雨還有 3 天”。穀雨當天，顯示”今日穀雨 | 雨生百穀，萬物更新”。後臺不用做任何操作，全自動。 節氣名稱旁可以勾選顯示簡釋。簡釋是一句對節氣的通俗解釋，比如”清明：氣清景明，萬物皆顯”。這個文案可以在外掛設定頁面自定義，修改成你自己的表達。 傳統節日模組 ------ WPDate 2.0 預置了 15 個主要傳統節日。覆蓋春節、元宵、清明、端午、七夕、中元、中秋、重陽、冬至、臘八、小年、除夕等。 每個節日支援兩種展示維度： **農曆維度**：按農曆日期固定顯示。比如春節永遠是農曆正月初一，中秋永遠是農曆八月十五。外掛自動計算對應的公曆日期。 **公曆維度**：某些節日有固定公曆日期（如元旦 1 月 1 日）。外掛能同時處理兩種型別，在一個列表裡混合顯示。 節日模組的核心功能是**倒計時**。一個單獨的叫”節日倒計時”的區塊，顯示距離下一個節日的天數。 比如距離端午還有 15 天，區塊顯示”距離端午（五月初五）還有 15 天”。倒計時每天自動更新，不需要重新整理頁面。這個區塊的日期格式、節日名稱、倒計時的文案都可以自定義。 高階版提供 30+ 節日模板，包括地方性節日和少數民族節日（如潑水節、火把節、藏曆新年等）。基礎版使用者可以手動新增 3 個自定義節日。 **一個典型的使用場景**：一個美食部落格，在每個傳統節日前一週開始推送相關食譜。運營者在首頁頂部放置節日倒計時區塊，讀者一眼就能看到”距離中秋還有 7 天”。區塊下面就是月餅食譜文章。讀者路徑清晰：看到倒計時 → 產生節日感 → 點選食譜。 區塊編輯器原生相容 --------- WPDate 2.0 完全在區塊編輯器中執行。不是短程式碼時代的思維——你不再需要在文章裡貼上`[wpdate-jieqi]`然後去預覽頁面看效果。 四個專用區塊可以直接從區塊插入器拖入任何位置： **農曆日期區塊**：顯示當前農曆日期，格式可選（如”甲辰年三月十五”或”三月十五”）。 **節氣提醒區塊**：上面已經詳細講過。自動顯示當前節氣或距離下一個節氣的天數。 **節日列表區塊**：以列表形式展示指定月份或季度的傳統節日。比如勾選”夏季”，顯示立夏、端午、小暑、大暑等。 **節日倒計時區塊**：單獨展示下一個節日的倒計時數字。 這四個區塊支援所有區塊編輯器的通用操作：對齊、間距、背景色、邊框。你在編輯器裡拖拽調整位置，預覽所見即所得。 **全站編輯相容性**：如果你的主題支援全站編輯，可以在站點編輯器中直接插入節氣提醒區塊到頁首模板。這樣整個網站的每一頁都會自動顯示當前節氣資訊，不需要在每個頁面單獨設定。 舉例：一個農場電商的站點編輯器。站長把節氣提醒區塊拖到頁首模板的右上角，把節日倒計時區塊拖到側邊欄。儲存模板後，全站生效。穀雨那天，每一頁的右上角都顯示”今日穀雨”。不需要任何程式碼。 theme.json 相容性：外掛區塊的顏色、字號、間距完全遵循主題的 theme.json 設定。切換主題後，區塊自動適配新主題的樣式，不會出現顏色錯亂或間距異常。 從萬年曆到時間文化工具 ----------- WPDate 1.0 的定位是”萬年曆查詢工具”。使用者輸入一個公曆日期，得到對應的農曆日期。功能沒問題，但場景很窄——使用者只在”需要查日子”時才會用它。 2.0 的角色轉變：從被動查詢工具，變成主動的時間文化展示系統。 **不需要使用者輸入日期**。外掛自動獲取當前時間，自動匹配節氣，自動計算節日倒計時。使用者開啟頁面，資訊已經在那裡。 **不需要在特定頁面**。透過區塊可以在任何位置展示——首頁、文章內、側邊欄、頁尾、彈窗。 **不只是日曆，而是環境**。一個文化類網站用 WPDate 2.0 之後，訪客進入到的是一個”有農曆時間感”的空間。頁面自動反映出當前的時間文化場景——穀雨時提醒雨生百穀，中秋時提醒月圓人團圓。 1.0 使用者升級到 2.0 的資料遷移：外掛自動識別舊版設定，遷移到新版的區塊配置。舊版短程式碼`[wpdate]`仍然可用，但建議手動替換為區塊以獲得完整功能。 **效能最佳化**：2.0 的資料查詢從每次頁面載入改為快取模式。節氣資料在外掛啟用時一次性讀取到 WordPress 快取，後續請求不重複計算。單個頁面的農曆計算時間從 1.0 的 15-20 毫秒降到 3-5 毫秒。 **資料來源更新**：農曆計算規則基於最新的《萬年曆》天文演演算法。基礎版的資料覆蓋 1900-2100 年。高階版每年更新一次資料校驗檔案，確保最近的農曆年計算準確。這個資料校驗包覆蓋了閏月判斷、節氣時刻表等容易出錯的環節。 分步配置：在區塊編輯器中新增節氣提醒 ------------------ 以一個非遺文化部落格的新文章為例。操作者正在寫一篇關於傳統農耕文化的文章，想在文章頂部新增一個醒目的節氣提示。 **步驟一：開啟區塊編輯器** 在 WordPress 後臺編輯文章，進入區塊編輯器介面。這篇文章已經寫了標題和正文開頭。 **步驟二：插入節氣提醒區塊** 點選區塊插入器（左上角藍色加號），搜尋”節氣提醒”。看到 WPDate 節氣提醒區塊的圖示（一個圓形日曆標誌），點選插入。 區塊出現在文章頂部，預設顯示”當前節氣：小滿”或”距下一個節氣 X 天”，取決於今天的日期。 **步驟三：配置提醒設定** 在右側的區塊設定面板中： - **提前提醒**：拖動滑塊到”7 天”。意思是距離下一個節氣還有 7 天時，區塊就開始顯示倒計時。今天是 5 月 14 日，距離小滿（5 月 21 日）還有 7 天，所以正好觸發。區塊顯示”距小滿還有 7 天”。 - **顯示風格**：選擇”詳細模式”。區塊顯示的內容變成：”距小滿（5 月 21 日）還有 7 天 | 物致於此，小得盈滿”。 - **對齊方式**：居中。 - **背景色**：選擇一個淺綠色，和農耕文化主題呼應。 **步驟四：預覽和調整** 在編輯器裡切換到桌面和移動端預覽。桌面端效果：文章標題下方有一行帶淺綠背景的居中提示文字。移動端：文字自動縮小，背景色不變，閱讀體驗正常。 **步驟五：儲存和釋出** 儲存文章，前端頁面顯示效果與預覽完全一致。7 天后（5 月 21 日），區塊自動切換為”今日小滿”。釋出者不需要再次編輯文章。 **擴充套件用法：全站頁首節氣標識** 如果想在整個網站的每一頁都顯示節氣提示，不限於某一篇文章： 1. 進入外觀 → 站點編輯器（前提是主題支援全站編輯） 2. 點選頁首模板部件 3. 在站點標題右側插入節氣提醒區塊 4. 選擇”簡潔模式”，只顯示節氣名稱 5. 設定提前提醒為”0 天”（只在當天提醒） 6. 字號調小，與站點標題風格一致 7. 儲存模板 全站生效。訪客瀏覽任何頁面，都能在頁首看到”今日穀雨”或”今日小滿”。一個文化類網站用這個配置後，使用者反饋”開啟網站就知道今天是什麼節氣了，感覺很接地氣”。 開發者鉤子與自定義擴充套件 ------------- WPDate 2.0 提供了 6 個過濾器鉤子，方便開發者擴充套件功能。 **自定義節日列表** ``` add_filter( 'wpdate_festival_list', 'my_custom_festivals' ); function my_custom_festivals( $festivals ) { $festivals[] = array( 'name' => '公司成立日', 'month' => 6, 'day' => 15, 'calendar' => 'solar', // solar=公曆, lunar=農曆 ); return $festivals; } ``` 這段程式碼新增了一個固定公曆日期 6 月 15 日的節日到提醒列表中。`calendar`設為`lunar`則按農曆計算。 **修改提前提醒天數** ``` add_filter( 'wpdate_jieqi_advance_days', function() { return 14; // 預設是 0-15，這裡全域性設為 14 天 }); ``` 如果你運營一個需要提前預告節氣的網站（比如農場），可以用這個鉤子讓所有提醒提前 14 天開始顯示。 **自定義節氣簡釋文案** ``` add_filter( 'wpdate_jieqi_description', 'my_jieqi_description', 10, 2 ); function my_jieqi_description( $description, $jieqi_name ) { $custom = array( '清明' => '清明時節雨紛紛，適合春茶採摘', '穀雨' => '穀雨前後，種瓜點豆', ); return isset( $custom[$jieqi_name] ) ? $custom[$jieqi_name] : $description; } ``` 這個鉤子讓你覆蓋外掛預設的節氣解釋文案。上面的例子把清明的描述改成和茶葉相關的文字。 **版本管理建議** 參考 WordPress 外掛釋出規範，每次修改擴充套件程式碼後應該標記版本號。在外掛主檔案註釋中標明版本： ``` Version: 1.0.1 ``` 然後在你的版本管理工具（Git）中打標籤。這樣如果新版本出錯，使用者可以回退到舊版本。不要用”最新版””更新版”這種模糊表述——具體版本號是災難恢復的唯一依據。 實際案例 ---- **案例一：非遺文化部落格** 一個記錄地方非遺專案的部落格，日均訪問量 2000 左右。運營者在首頁頂部放置了節日倒計時區塊，在側邊欄放置了節氣提醒區塊。 運營者反饋：”以前讀者在文章下面留言問’端午節哪天’，現在一進首頁就看得到。節氣和傳統手工藝的內容關聯起來，讀者的閱讀時間從 2 分鐘提高到 4 分鐘。” 具體資料：部落格文章平均閱讀時長從 2 分 10 秒提升到 4 分 05 秒。這個提升不是外掛直接造成的，而是因為節氣內容激發了讀者對相關文章的興趣——看到”今日霜降”然後點選”霜降節氣與傳統釀造工藝”這篇文章。 **案例二：茶葉電商網站** 一個龍井茶莊的 WordPress 電商網站，每年春季做促銷。以前的做法是手動在首頁 Banner 寫”明前龍井上市”，每年到時間了美工改圖、運營上線。 使用 WPDate 2.0 後，頁首放置節氣提醒區塊。每年清明前 10 天自動顯示”距清明還有 10 天”。配合一個鉤子，當節氣是”清明”時，自動在節氣提醒下方追加一個 Banner 連結”明前龍井現已上市 →”。 茶莊主反饋：”不用每年掐時間上 Banner 了。外掛自動提醒，轉化率比去年同期高了 15%。客人在清明節氣氛圍下，購買意願更強。” 這個結果對應一個使用者行為：使用者被節氣資訊喚醒了對時令產品的需求。不是促銷創造了需求，是節氣本身證明瞭產品價值。 WPDate 是你的網站的時間文化引擎 ------------------- WPDate 2.0 把農曆變成了網站的一種自動運轉機制。它不 ### 名詞解釋