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