Kate522 钉钉推送通知程序 文档

English

当前稳定版本：v1.0.4

Kate522 Notifier for DingTalk 是一款 WordPress 插件，能够自动检测新发布的文章并将其推送到钉钉机器人。该插件还支持新用户注册通知、消息去重、记录管理以及数据导出功能。

主要功能

• 钉钉机器人配置：支持 Webhook 及安全验证（关键词/签名/IP 白名单）。
• 触发场景：支持新文章发布、文章更新以及新用户注册的触发推送。
• 模板与占位符：支持文本、链接、Markdown 等多种消息模板。
• 去重与记录管理：支持标记、清除记录，以及导出 CSV / XLSX 文件。
• 导出文件自动清理：导出的文件默认保留 24 小时后自动删除。
• 失败重试机制：推送失败时会记录日志并支持重试。
• 多语言支持：包含帮助页面及双语用户界面支持。

安装方法

1. 后台上传：进入 WordPress 后台的“插件” → “安装插件” → “上传插件”，选择 ZIP 文件上传并启用。
2. FTP 上传：解压后上传至 wp-content/plugins/ 目录，随后在 WordPress 后台激活插件。

配置步骤

1. 创建一个钉钉群机器人，并复制其 Webhook 地址。
2. 进入 WordPress 后台的“Kate522 Notifier for DingTalk” → “设置”页面，填入 Webhook 地址。
3. 选择安全验证方式，并填写关键词、签名或 IP 白名单。
4. 选择消息类型和模板，然后保存设置。
5. 发送测试消息以验证配置是否正确。

使用说明

• 在“推送记录”中查看已推送的文章。
• 可对记录进行标记、取消标记或清除操作。
• 从记录页面导出 CSV 或 XLSX 格式的数据。

导出注意事项

• 格式支持：同时支持 CSV 和 XLSX 两种格式。
• 环境依赖：导出 XLSX 格式需要服务器支持 ZipArchive 或 PclZip 扩展；若不支持，请使用 CSV 格式导出。
• 文件保留：导出文件默认保留 24 小时，之后会自动清理。

常见问题 (FAQ)

问：如果推送失败怎么办？
答： 请检查 Webhook 地址是否正确、安全设置是否匹配，以及服务器网络是否能正常访问钉钉接口。

问：为什么没有推送记录？
答： 记录仅在推送成功后生成。请先触发一次推送，并检查日志信息。

问：XLSX 导出不可用怎么办？
答： 请确认服务器上是否已启用 ZipArchive 或 PclZip 扩展，或者改用 CSV 格式导出。

更新日志 (Changelog)

v1.0.4

• 修复了插件入口及后台页面的文字乱码问题。
• 修正了引导文件路径，确保插件能正常加载。
• 修复了导致后台渲染受阻的设置页面语法问题。

v1.0.3

• 修复了主入口文件中默认中文文本的乱码问题。
• 加强了核心层 Webhook 的验证逻辑。
• 将导出下载流程转变为受控下载。

v1.0.2

• 增加了 XLSX 导出对 ZipArchive/PclZip 的兼容性及更清晰的可用性提示。
• 改进了本地化加载、英文翻译及帮助页面内容。
• 扩展了帮助页面，增加了快速入门指南和故障排除说明。

v1.0.1

• 重构了插件入口及核心类。
• 增加了卸载清理功能，并优化了后台文案。
• 修复了部分推送流程中的问题。

v1.0.0

• 初始版本发布。
• 增加了新文章推送、去重功能及新用户通知。
• 增加了多种消息类型支持。

支持信息

• 插件文档：https://github.com/Lexo0522/Ding-Pusher
• 问题反馈：https://github.com/Lexo0522/Ding-Pusher/issues
• 联系作者：kate522@88.com

许可证

本插件采用 GPLv2 或更高版本许可证，详情请参阅 LICENSE 文件。