WPDate 農曆萬年曆插件 2.0 正式上線：節氣提醒與傳統節日功能全面升級

這個插件是什麼

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² 免衝突模式
電子郵件技術支持

購買方式：在插件設置頁面點擊”升級到高級版”，跳轉到官網支付頁面。支持支付寶和微信支付。付費後激活碼即時發放。

中文網站的農曆剛需

一個非遺文化博客，每天有 3000 次訪問。讀者來查某個傳統節日的具體日期，或者想了解”今天是什麼節氣”。如果博客只能顯示公曆日期，讀者的體驗就會斷掉——他們要打開另一個網站查農曆。

農業類站點同樣。假設你運營一個茶葉電商網站，春茶上市需要配合”清明””穀雨”節氣推廣。如果網站不能自動顯示當前節氣，你只能在每個節氣到來前手動更新促銷信息。每年 24 次手動操作，成本不低。

傳統解決方案有三種，每種都有自己的問題：

方案一：手動更新。 在文章或頁面裏硬編碼節氣日期。每年都要改，容易忘，容易出錯。2025 年清明是 4 月 4 日，2026 年是 4 月 5 日——如果忘記更新，日期就錯了。

方案二：靜態表格。 放一張全年節氣表在頁腳。用户得自己比對今天的日期，體驗很差。而且表格佔地方，在手機上更難看。

方案三：第三方 API¹。 調用外部天氣或日曆 API 獲取農曆數據。問題是 API 可能收費、可能宕機、可能停服。你的網站依賴別人的服務器，每多一層依賴就多一層風險。

WPDate 2.0 解決這三個問題。農曆數據存在本地，不依賴外部 API。節氣自動匹配，不需要手動更新。展示方式通過區塊編輯器自由控制，不佔固定位置。

節氣提醒怎麼工作

WPDate 2.0 內置了完整的二十四節氣時間表。這個時間表基於最新的農曆計算規則，精確到天。

插件每天自動檢測當前日期是否對應某個節氣。如果匹配，就在你指定的位置顯示提醒。如果今天不是節氣，它顯示距離下一個節氣的倒計時天數。

核心機制分三步：

數據匹配：插件內置 2020-2040 年的節氣日期數據。當前日期與數據庫比對，確認是否命中。
提醒觸發：命中後，提醒區塊自動更新內容。從”距離下一個節氣 X 天”變成”今日節氣：穀雨”。
樣式渲染：提醒內容通過區塊模板渲染，適配當前主題的 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 日），區塊自動切換為”今日小滿”。發佈者不需要再次編輯文章。

擴展用法：全站頁眉節氣標識

如果想在整個網站的每一頁都顯示節氣提示，不限於某一篇文章：

進入外觀 → 站點編輯器（前提是主題支持全站編輯）
點擊頁眉模板部件
在站點標題右側插入節氣提醒區塊
選擇”簡潔模式”，只顯示節氣名稱
設置提前提醒為”0 天”（只在當天提醒）
字號調小，與站點標題風格一致
保存模板

全站生效。訪客瀏覽任何頁面，都能在頁眉看到”今日穀雨”或”今日小滿”。一個文化類網站用這個配置後，用户反饋”打開網站就知道今天是什麼節氣了，感覺很接地氣”。

開發者鈎子與自定義擴展

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

Test Translate Bridge

WordPress 網站被植入惡意代碼的 7 個信號（附排查方法）