本教程详细介绍了如何在moodle中通过编程方式向用户发送站内消息。内容涵盖了自定义消息提供者的注册、消息对象的构建以及`message_send`函数的调用。文章特别强调了在消息发送后，务必检查moodle站点管理中的通知设置，确保消息提供者已启用，这是确保消息成功送达用户的关键步骤。
Moodle消息系统概述
Moodle提供了一个强大的消息系统，允许插件开发者通过编程方式向用户发送通知、提醒或其他重要信息。理解Moodle的Messaging API是实现这一功能的核心。对于现代Moodle插件开发，我们主要关注Message API，它定义了如何注册消息提供者并发送消息。
一个Moodle插件若要发送自定义消息，必须首先注册为一个“消息提供者”（Message Provider）。这告诉Moodle你的插件能够产生特定类型的消息，并允许管理员配置这些消息的发送方式（例如，是否通过网页弹窗、电子邮件、移动应用等发送）。
注册自定义消息提供者
注册消息提供者是发送自定义消息的第一步。这通常涉及在插件的db目录下创建一个message.php文件，并定义你的消息提供者。
1. 定义消息提供者文件
在你的Moodle插件（例如local_reminder）的db目录下创建或编辑message.php文件，并添加以下内容：
<?php
defined('MOODLE_INTERNAL') || die();
$messageproviders = array (
'datenotification' => array (
// 在这里可以定义消息提供者的进一步配置，例如默认的通知设置等
// 'defaults' => array(
// 'popup' => MESSAGE_PERMITTED, // 允许通过弹出窗口通知
// 'email' => MESSAGE_PERMITTED // 允许通过电子邮件通知
// )
)
);- datenotification是你的消息提供者的唯一标识符（name），它将与你的组件名（component）一起在mdl_message_providers表中注册。
- 你可以根据需要为消息提供者定义默认设置，例如是否允许通过弹出窗口或电子邮件发送。
2. 添加语言字符串
为了让Moodle界面能够正确显示你的消息提供者名称，你需要在插件的语言文件（例如lang/en/local_reminder.php或lang/zh_cn/local_reminder.php）中添加相应的字符串：
$string['messageprovider:datenotification'] = '演示文稿提醒';
这里的messageprovider:datenotification是Moodle识别消息提供者名称的关键。
3. 更新插件以注册提供者
完成上述文件修改后，你需要通过访问Moodle的“通知”页面（yoursite.com/admin/index.php）来更新你的插件。Moodle会在插件更新过程中自动识别并注册新的消息提供者到mdl_message_providers数据库表中。
构建并发送消息
注册消息提供者后，你就可以在插件的任何逻辑中构建并发送消息了。这主要通过实例化\core\message\message对象并调用message_send()函数来完成。
1. 实例化消息对象
创建一个\core\message\message实例，并设置其各项属性：
<?php // 确保在文件顶部引入必要的类 use core_user; use core\message\message; // 假设 $user 是一个 Moodle user 对象，包含要接收消息的用户信息 // 假设 $course_id 是消息相关的课程ID，例如从当前上下文获取或设置为SITEID $eventdata = new message(); $eventdata->component = 'local_reminder'; // 你的插件组件名，必须与db/message.php中定义的组件名一致 $eventdata->name = 'datenotification'; // 消息提供者的名称，与db/message.php中定义的键名一致 $eventdata->userfrom = core_user::get_noreply_user(); // 发送者用户对象，通常使用无回复用户 $eventdata->userto = $user; // 接收者用户对象 $eventdata->subject = '测试消息'; // 消息主题 $eventdata->fullmessage = '这是一条我的测试消息。'; // 纯文本格式的完整消息内容 $eventdata->fullmessageformat = FORMAT_PLAIN; // 消息内容的格式，例如 FORMAT_PLAIN, FORMAT_HTML $eventdata->fullmessagehtml = '<p>这是一条我的测试消息。</p>'; // HTML格式的完整消息内容 $eventdata->smallmessage = ''; // 简短消息，可选，如果为空则通常使用fullmessage的截断版本 $eventdata->courseid = $course_id; // Moodle 3.2+ 版本要求，消息关联的课程ID，可设置为SITEID
关键属性说明：
- component 和 name: 这两个字段必须与你在db/message.php中定义的消息提供者以及mdl_message_providers表中的记录完全匹配。component是你的插件名（如local_reminder），name是你在messageproviders数组中定义的键（如datenotification）。
- userfrom: 建议使用core_user::get_noreply_user()获取一个系统无回复用户作为消息发送者，避免将实际用户暴露为发送者。
- userto: 必须是一个有效的Moodle用户对象，代表消息的接收者。
- fullmessage 和 fullmessagehtml: 提供消息的纯文本和HTML版本，Moodle会根据用户的偏好和发送渠道选择合适的格式。
- courseid: 自Moodle 3.2起，这是一个强制性字段，用于将消息与特定课程关联。如果没有特定的课程关联，可以使用SITEID常量。
2. 发送消息
构建好消息对象后，调用全局函数message_send()来发送它：
$result = message_send($eventdata); // 调试输出，检查发送结果 var_dump($eventdata); // 确认消息对象数据完整 var_dump($result); // 成功发送通常返回消息ID（一个整数），而不是错误
如果message_send()函数返回一个整数（通常是新创建消息的ID），这表明消息已被Moodle系统成功接收并处理。然而，这并不意味着消息已经送达用户。
重要注意事项：验证消息通知设置
这是解决消息未送达问题的关键所在。 即使message_send()返回了消息ID，用户也可能因为Moodle的通知设置而未收到消息。
Moodle允许站点管理员和用户细粒度地控制哪些消息通过何种渠道（例如，网页弹窗、电子邮件、Moodle Mobile应用）发送。如果你的自定义消息提供者未被启用，或者用户禁用了该类型的通知，消息将不会送达。
检查并启用消息提供者
-
管理员层面检查:
- 登录Moodle作为管理员。
- 导航至：站点管理 > 消息 > 通知设置 (或直接访问 yoursite.com/admin/message.php)。
- 在该页面中，查找你的自定义消息提供者（例如，“演示文稿提醒”）。
- 确保该消息提供者在“网页”、“电子邮件”以及其他相关通知方法下被设置为允许或默认开启。
-
用户层面检查:
- 用户也可以在自己的个人资料设置中控制消息通知。
- 导航至：用户菜单 > 首选项 > 消息通知 (或直接访问 yoursite.com/message/preferences.php)。
- 确保你的自定义消息提供者对该用户是启用的。
如果消息提供者在站点级别或用户级别被禁用，即使代码执行成功，消息也不会出现在用户的收件箱中。这是Moodle消息系统的一个重要安全和用户体验特性。
总结
在Moodle中编程发送消息需要清晰地遵循几个步骤：首先，通过在db/message.php中定义并添加语言字符串来注册你的自定义消息提供者，并通过插件更新将其插入数据库。其次，实例化\core\message\message对象，填充所有必要的属性，然后调用message_send()函数。最重要的是，如果在发送后用户未能收到消息，务必检查Moodle的站点管理 > 消息 > 通知设置页面，确认你的消息提供者已正确启用。遵循这些步骤将确保你的插件能够可靠地向Moodle用户发送消息。
