插件概述



该插件适用于 Discuz! X 论坛，能够在特定版块发布新帖或产生新回复时，向管理员邮箱发送通知邮件。通过此插件，管理员可以及时了解论坛动态，提升管理效率。插件支持自定义邮件模板和样式，并允许灵活配置监控版块及通知类型。

功能特性



1. 版块选择：用户可指定需要监控的版块，当这些版块有新帖或回复时会触发通知。
2. 通知类型：支持新帖通知与新回复通知，两种类型可独立启用或关闭。
3. 邮箱设置：支持添加多个管理员邮箱，每个邮箱一行填写。
4. 自定义模板：提供个性化邮件主题和内容模板编辑功能，支持变量替换以实现动态内容展示。
5. 主题色设置：用户可根据站点风格调整邮件的主题颜色，确保邮件外观与网站一致。
6. BBCode解析：智能解析帖子中的BBCode代码，确保引用、链接等格式正确显示。
7. 日志记录：详细记录所有邮件发送情况，方便管理员排查问题。

安装要求



- Discuz! X3.0 或更高版本（建议使用X3.5及以上版本）。
- PHP 5.6 或更高版本。
- 已正确配置 Discuz! 的邮件发送功能。

使用说明



1. 开启的版块：选择需要监控的版块，支持多选；若留空，则默认监控所有版块。
2. 通知邮箱：填写接收通知的管理员邮箱地址，多个邮箱间用换行分隔。
3. 邮件主题色：根据站点风格选择适合的颜色，用于邮件中的按钮、边框及链接元素。
4. 新帖通知：开启或关闭新帖发布通知功能。
5. 新帖通知标题：自定义新帖通知邮件的标题。
6. 新帖通知内容：编辑新帖通知邮件的内容模板，支持变量替换。
7. 新回复通知：开启或关闭新回复通知功能。
8. 新回复通知标题：自定义新回复通知邮件的标题。
9. 新回复通知内容：编辑新回复通知邮件的内容模板，支持变量替换。

在定制邮件内容时，可使用以下变量，插件将自动替换为实际内容：

{sitename} - 站点名称
{forumname} - 版块名称
{threadtitle} - 帖子标题
{message} - 帖子或回复内容
{username} - 发帖或回复用户名

常见问题



1. 邮件未成功发送
   - 确认 Discuz! 的邮件发送功能已正确配置（路径：管理中心 > 站长 > 邮件设置）。
   - 检查管理员邮箱地址格式是否正确。
   - 查看服务器是否有邮件发送频率或数量限制。

2. 插件无法正常工作
   - 确认已选择需要监控的版块。
   - 确认已启用相应的通知类型（新帖或新回复）。
   - 检查是否填写了有效的管理员邮箱。
   - 查阅系统日志，查找相关错误信息。

3. BBCode显示异常
   - 插件支持基础BBCode解析，包括引用、链接、颜色、字体大小、粗体、斜体和下划线。
   - 若涉及复杂自定义BBCode，可能显示不正常，需进一步开发定制。

4. 自定义变量未生效
   - 确保变量名称正确，包括大小写及花括号。
   - 变量必须完全匹配才能被替换，例如： {username}。

调试方法



如需进行调试，可取消`hook.class.php`文件中以下代码的注释：

```php
// $this->write_log('插件初始化，配置加载: ' . print_r($this->config, true));
```

日志文件存储路径为`data/log/plugin_domi_adminnotify_日期.log`，可供查阅调试信息。