michael-milette / moodle-local_mailtest
eMailTest 是一个 Moodle 本地插件，可以帮助诊断 SMTP 邮件连接问题。
Requires
- composer/installers: ~1.0
README
Moodle 本地 eMailTest 插件
目录
基本概述
Moodle 的 eMailTest 模块允许管理员测试 Moodle 的电子邮件系统。如果由于任何原因无法发送电子邮件，将显示 SMTP 对话的跟踪。
一旦发送了测试电子邮件，您需要检查您的收件箱以确认电子邮件是否成功投递。此插件不会为您完成此操作。
要求
此插件需要 Moodle 2.5+、3.x+ 或 4.x+，可从以下链接获取 https://moodle.org
下载 Moodle eMail Test
Moodle eMail Test 的最新稳定版本可从以下链接获取：https://moodle.org/plugins/local_mailtest
最新开发版本可在以下链接找到：https://github.com/michael-milette/moodle-local_mailtest
安装
像其他插件一样，将插件安装到以下文件夹
/local/mailtest
有关安装 Moodle 插件的详细信息，请参阅 https://docs.moodle.org/en/Installing_plugins
更新此插件无需特殊考虑。
使用方法
目前此插件没有可配置的设置。
local_mailtest 插件设计允许管理员测试 Moodle，以确保电子邮件消息系统配置正确。
安装后，以 Moodle 管理员身份登录，然后点击
Home > Site Administration > Server > eMail Test
输入您想要发送消息的收件人电子邮件地址，然后点击[发送测试消息]按钮。
如果 Moodle 成功发送了电子邮件消息，您将看到一个消息，说明“成功 - 测试消息已成功发送到 SMTP 服务器”。如果无法发送电子邮件，将显示 Moodle 和 SMTP 服务器之间的对话。
更新
更新此插件无需特殊考虑。
第一个公开的 BETA 版本于 2015-11-01 发布。现在此插件被认为是稳定的。
有关随后发布的更多信息，请参阅 CHANGELOG.md。
卸载
通过以下方式卸载插件
主页 > 管理 > 站点管理 > 插件 > 管理插件 > eMail Test
...然后点击卸载。您可能还需要手动删除以下文件夹
/local/mailtest
限制
目前没有已知的限制。
语言支持
此插件支持英语。如果您已安装一个或多个额外的 Moodle 语言包，还包括对法语等语言的支持。
如果您需要尚未支持的其他语言，请随时使用位于 https://lang.moodle.org/ 的 Moodle AMOS 翻译工具包进行贡献。
此插件尚未针对从右到左（RTL）语言支持进行测试。如果您想使用此插件并需要与RTL语言一起使用，而它无法正常工作，请随时准备一个pull request并提交到项目页面：
https://github.com/michael-milette/moodle-local_mailtest
常见问题解答（FAQ）
常见问题
为什么使用eMailTest时会遇到500服务器错误？
此插件已在数百个网站上进行了广泛测试和使用。如果您遇到此错误，则可能是您的服务器上存在文件所有者/组权限问题，需要解决。
为什么它说Moodle已成功发送测试消息，但我没有收到电子邮件？
这可能是由于多种原因，包括但不限于：
- 您的php.ini文件中PHP邮件设置不正确（如果您尚未配置Moodle的SMTP设置）。
- 您可能有防病毒软件或防火墙阻止了电子邮件通信。
- 接收您电子邮件的邮件服务器可能丢弃来自您站点的电子邮件。
- 测试电子邮件可能被反垃圾邮件过滤器阻止。请检查您的垃圾邮件文件夹。
我如何找到应使用的正确电子邮件设置？
联系您的网络管理员或您的网络托管提供商。这些设置通常与您用于电子邮件客户端的设置相同，但管理员可能需要添加特殊设置，以允许从您的support和no-reply电子邮件地址发送电子邮件。
为什么测试电子邮件无法成功发送？
您的SMTP电子邮件设置不正确或邮件服务器拒绝来自您的Moodle站点的电子邮件。请阅读您发送测试消息时显示的整个通信对话框。它通常会提供一些有关问题可能出在哪里的提示。
PHP Mail和Moodle SMTP Mail之间的区别是什么？
如果您没有在Moodle中配置邮件设置，Moodle将把电子邮件投递任务转交给PHP的内置邮件系统。其设置通常位于您的服务器PHP.INI文件中。如果您在Moodle中配置了SMTP设置，它将尝试直接将电子邮件发送到本地SMTP服务器。
我如何使用此工具从其他电子邮件地址发送电子邮件？
您不能。这是为了防止该工具被用于发送垃圾邮件。如果确实需要，您可以暂时测试以下“发件人”地址之一：
- 您的用户帐户
- 支持
- 无回复
- 主要管理员
我的电子邮件在Moodle 3.2之前的版本中正常工作。在升级到Moodle 3.2或更高版本后，为什么我的站点无法发送电子邮件？
从Moodle 3.2开始，在许多情况下不再可选使用无回复电子邮件地址。您需要确保它现在已正确配置。某些邮件服务器甚至可能仅在实际上是有效电子邮件地址的情况下才允许连接。
为什么我会看到一条关于cron至少24小时未运行的消息？
重要 - 请参阅https://docs.moodle.org/en/Cron。如果消息中包含链接，单击它将导致Moodle立即尝试发送队列中的消息。然而，未来的消息仍然不会自动发送。单击链接而不是配置cron只会将通知隐藏24小时，之后它将返回，直到您解决这个问题。
如果您由于某些原因无法设置自动cron作业且看不到链接，您可以通过转到“网站管理”>“安全”>“网站策略”并取消选中“仅通过命令行执行cron”来启用链接并允许远程运行cron作业。为了额外的安全性，还可以设置“远程访问cron密码”。
为什么即使在关闭调试的情况下，我仍然在通信日志中看到一些调试代码？
在发送邮件之前，Moodle 会进行一些验证，并且可以显示一些有用的信息，因此我们已经启用了最小限度的调试信息显示。信息行以 email_to_user 开头。您可以忽略信息行后面的行号引用。
无论我使用哪个“发件人”电子邮件地址，测试邮件总是来自同一个电子邮件地址。为什么？
这很可能是您邮件服务器上的一个设置。要确认发送邮件时使用的电子邮件地址，请在尝试发送邮件后查看状态消息的底部。如果测试邮件成功送达，您还可以尝试回复测试消息并查看“收件人”电子邮件地址。您不需要实际发送回复。
我不确定问题是出在 Moodle 上，还是我的邮件服务器或防火墙上。我该怎么办？
首先，问题很可能不是出在 Moodle 上。Moodle 在世界上的几乎所有国家都有组织在使用。如果真的有问题，现在就会有人提出。尽管如此，可能是您的电子邮件设置。要找出问题是否可能是您的 Moodle 设置或防火墙，或者是否是您的邮件服务器，请尝试将 Moodle 设置为使用 Gmail 作为您的邮件服务器。如果它能正常工作，那么很可能是您的电子邮件设置。如果它不能正常工作，可能是有防火墙阻止了电子邮件流量，或者您的邮件服务器配置不正确。
我如何使用 Gmail 从 Moodle 发送 SMTP 邮件？
Gmail 需要您创建一个 App 密码 以发送 Moodle 的邮件。
有关更多详细信息以及一些限制，请参阅 Moodle 关于 Gmail 邮件设置 的文档。
所有的设置似乎都是正确的。我还能尝试什么？
尽管您已尽力，但有时您会发现需要在 SMTP 服务器的地址后面添加一个 :端口号。例如：smtp.example.com:587
有什么安全考虑吗？
此插件的使用仅限于 Moodle 站点管理员，并允许他们通过只有他们可以访问的受限网页表单提交电子邮件。
其他问题
这里没有涵盖到您的问题？如果您仍然找不到答案，请在 Moodle 论坛提交您的问题，或在 Github 上打开一个新问题：
https://github.com/michael-milette/moodle-local_mailtest/issues
贡献
如果您有兴趣提供帮助，请查看我们的 贡献指南，了解我们的行为准则以及向我们提交 pull 请求的过程。
贡献者
Michael Milette - 作者和主要开发者
非常感谢以下贡献者。（如果我在列表中遗漏了您，请告诉我）
- laurentdavid：修复了 Moodle 4.4（2024）中的过时字符串。
待办功能
如果您有任何建议，请告诉我们。
此插件的开发动机
此插件的开发是通过我们在 Moodle 开发方面的经验和 Moodle 支持论坛中的评论激发的，并得到了 TNG Consulting Inc. 的支持。
更多信息
有关 local_mailtest 插件的更多信息、支持或报告错误，请访问项目页面：
https://github.com/michael-milette/moodle-local_mailtest
许可证
版权所有 © 2015-2024 TNG Consulting Inc. - https://www.tngconsulting.ca/
此文件是 Moodle 的 MailTest/eMailTest 的一部分 - https://moodle.org/
eMailTest 是免费软件：您可以重新分发它，也可以根据自由软件基金会发布的 GNU 通用公共许可证的条款对其进行修改，无论是许可证的第 3 版，还是（根据您的选择）任何后续版本。
eMailTest的发行是希望它能派上用场，但没有任何保证；甚至没有关于其商业性或适用于特定目的的暗示性保证。有关详细信息，请参阅GNU通用公共许可证。
您应该已经收到了与eMailTest一起的GNU通用公共许可证副本。如果没有收到，请参阅https://gnu.ac.cn/licenses/。