# 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 把農曆變成了網站的一種自動運轉機制。它不 ### 名詞解釋