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 内置了完整的二十四节气时间表。这个时间表基于最新的农历计算规则，精确到天。

插件每天自动检测当前日期是否对应某个节气。如果匹配，就在你指定的位置显示提醒。如果今天不是节气，它显示距离下一个节气的倒计时天数。

核心机制分三步：

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 把农历变成了网站的一种自动运转机制。它不

名词解释