一、Ding Pusher 是什么？
Ding Pusher 是一款专为 WordPress 设计的钉钉机器人自动推送插件，可在文章发布、更新或自定义文章类型变化时自动推送消息到钉钉群。插件内置去重机制、失败重试、新用户提醒等实用功能，适合个人博客与企业站点使用。
二、Ding Pusher 核心功能
1. 钉钉机器人多维度配置
- Webhook 地址配置：支持钉钉机器人 Webhook 地址输入与格式校验。
- 安全验证：支持关键词、加签、IP 白名单三种安全方式。
- 消息类型：支持文本、链接、Markdown 三种消息类型。
- 模板自定义：支持自定义文章推送和用户提示模板。
- 触发场景：支持新文章发布、文章更新、自定义文章类型推送。
2. 去重机制
- 多维度去重标识：按 post_ID 与“文章标题 + 发布时间”双重去重。
- 去重记录管理：支持手动标记/取消标记。
- 去重记录清理：可配置保留时长，自动清理过期记录。
3. 新用户提示
- 双场景提示：新用户注册与插件首次激活都会发送提示。
- 模板自定义：支持自定义新用户提示模板。
- 推送开关：可单独启用或关闭。
4. 推送容错与重试机制
- 失败自动重试：推送失败后自动重试，间隔指数回退。
- 失败记录与提示：记录失败原因便于排查。
- 手动重推：支持单篇或批量手动重推。
三、Ding Pusher 安装方法（两种方式）
方法一：后台上传安装（推荐）
- 下载插件压缩包
- 进入 WordPress 后台 → 插件 → 安装插件 → 上传插件
- 选择压缩包 → 安装 → 激活
方法二：FTP 上传安装
- 解压插件
- 上传到
/wp-content/plugins/ - 后台激活插件
四、Ding Pusher 配置步骤
1. 创建钉钉机器人并获取 Webhook
- 打开钉钉群 → 群设置 → 智能群助手 → 添加机器人
- 选择 自定义机器人
- 配置安全方式（关键词 / 加签 / IP 白名单）
- 复制 Webhook 地址
2. 在 WordPress 后台配置 Ding Pusher
进入 Ding Pusher → 设置：
- 粘贴 Webhook
- 选择安全验证方式并填写对应信息
- 选择消息类型（文本 / 链接 / Markdown）
- 编辑推送模板
- 开启需要的触发场景
- 保存设置
3. 发送测试消息验证配置
在设置页点击 发送测试消息，检查钉钉群是否收到。
五、推送记录管理与手动推送
进入 Ding Pusher → 推送记录：
- 查看所有已推送 / 未推送文章
- 可 取消标记 让文章重新进入推送队列
- 可 清理所有记录
手动触发推送方式：
- 未推送文章：重新发布即可触发
- 已推送文章：取消标记 → 重新发布
六、常见问题（FAQ）
Q：钉钉推送失败怎么办？
A：检查 Webhook、安全验证方式、服务器网络、WordPress 日志。
Q：如何重新推送已推送的文章？
A：在推送记录页取消标记 → 重新发布。
Q：支持哪些文章类型？
A：默认支持文章（post），可在设置中开启自定义文章类型。
Q：如何调整推送频率？
A：在 设置 → 高级设置 → 推送间隔 中修改。
八、更新日志
v1.0.3
- 修复了主入口文件中的默认中文文案乱码
- 加强了核心层 Webhook 校验逻辑
- 改造导出下载链路为受控下载
v1.0.2
- XLSX 导出加入 ZipArchive/PclZip 兼容与可用性提示。
- 语言加载更稳定，完善英文翻译与帮助页面。
- 帮助页补充快速开始、配置清单与排查说明。
v1.0.1
- 重构插件主入口，拆分核心类与更新器类。
- 补充
uninstall.php卸载清理逻辑。 - 优化后台设置页文案与默认模板。
- 修复版本文件与部分推送流程细节。
v1.0.0
- 初始版本发布。
- 实现新文章自动推送。
- 支持去重机制。
- 支持新用户提示。
- 支持 WordPress 原生自动更新。
- 支持多种消息类型。
七、技术支持与许可证
- 插件文档：https://github.com/Lexo0522/Ding-Pusher
- 问题反馈：https://github.com/Lexo0522/Ding-Pusher/issues
- 联系作者：kate522@88.com
许可证：GPL2（可自由使用、二次开发）
欢迎提交 Issue 或 Pull Request 帮助改进插件。
感谢您使用 Ding Pusher 插件。如有问题或建议，欢迎联系我们。
Comments
Discussion