# wp-notice

**Repository Path**: JsToCode/wp-notice

## Basic Information

- **Project Name**: wp-notice
- **Description**: WordPress博客评论留言推送工具，可以推送至Bark，企业微信，钉钉，飞书等渠道！
- **Primary Language**: PHP
- **License**: LGPL-2.1
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-12-15
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 评论通知推送（wp-notice）

为 WordPress 站点的文章评论与留言板评论提供即时通知推送，支持企业微信、Bark、钉钉、飞书四种渠道。带有后台设置页面、测试消息、一键启用/关闭，以及留言板页面识别与调试日志。

## 功能特点
- 支持 `企业微信 / Bark / 钉钉 / 飞书` 四种通知渠道
- 后台可视化配置，含一键发送测试消息
- 留言板页面 ID 识别，将对应页面评论标记为“留言板”
- 可选调试日志，写入 `error_log`，便于排查
- 国际化支持（`Text Domain: wp-notice`）

## 安装
- 方法一：将本项目上传到服务器的 `wp-content/plugins/wp-notice` 目录
- 方法二：后台「插件」→「安装插件」→「上传插件」，选择打包的 `wp-notice` 压缩包
- 在后台插件列表启用「评论通知推送」

## 快速开始
- 后台左侧菜单进入「评论通知推送」设置页
- 勾选要启用的渠道并填写对应的 `Webhook/URL`
  - 企业微信：群机器人 `Webhook`
  - Bark：你的 `Bark` 推送 `URL`（一般形如 `https://api.day.app/<your-key>/`）
  - 钉钉：群机器人 `Webhook`
  - 飞书：群机器人 `Webhook`
- 可选：填写「留言板识别（页面 ID）」为逗号分隔的页面 ID（例：`12,34`）
- 点击「保存配置并发送测试消息」验证是否能收到推送

## 使用说明
- 插件会在有新评论时自动推送，包含站点名、文章标题、作者、评论内容、文章链接等信息
- Bark 渠道发送纯文本；企业微信/钉钉/飞书使用 Markdown/消息卡片格式
- 推送内容长度做适度截断，保证消息可读性

## 常见问题
- 未收到推送
  - 检查是否勾选了对应渠道的启用开关
  - 校验 `Webhook/URL` 是否正确、是否能从服务器访问外网
  - 服务器防火墙或网络策略是否阻断出站 HTTP 请求
  - 在设置中启用「调试日志」，查看 `error_log` 定位原因
- 留言板识别
  - 在「留言板识别（页面 ID）」输入页面 ID，插件会将这些页面的评论标记为“留言板”，用于消息体显示

## 国际化
- 插件加载语言文件路径为 `languages` 目录
- 如需提供新的语言包，请将对应的 `.mo/.po` 文件放入该目录

## 许可
- 见项目根目录的 `LICENSE`

## 作者
- 作者：坚果大叔（`Author URI: https://cuixinxin.cn`）