$supportuser->email = $CFG->supportemail ? $CFG->supportemail : $admin->email;
$supportuser->firstname = $CFG->supportname ? $CFG->supportname : $admin->firstname;
$supportuser->lastname = $CFG->supportname ? '' : $admin->lastname;
+ // emailstop could be hard coded "false" to ensure error reports are sent
+ // but then admin's would have to alter their messaging preferences to temporarily stop them
+ $supportuser->emailstop = $admin->emailstop;
$supportuser->maildisplay = true;
/// Send the message and redirect
if (empty($fields)) {
$fields = 'u.id, u.confirmed, u.username, u.firstname, u.lastname, '.
- 'u.maildisplay, u.mailformat, u.maildigest, u.email, u.city, '.
+ 'u.maildisplay, u.mailformat, u.maildigest, u.email, u.emailstop, u.city, '.
'u.country, u.picture, u.idnumber, u.department, u.institution, '.
'u.lang, u.timezone, u.lastaccess, u.mnethostid, r.name AS rolename, r.sortorder';
}
debugging('Attempt to force message delivery to user who has "'.$processor->name.'" output unconfigured', DEBUG_NORMAL);
}
+ // Warn developers that necessary data is missing regardless of how the processors are configured
+ if (!isset($eventdata->userto->emailstop)) {
+ debugging('userto->emailstop is not set. Retrieving it from the user table');
+ $eventdata->userto->emailstop = $DB->get_field('user', 'emailstop', array('id'=>$eventdata->userto->id));
+ }
+
// Populate the list of processors we will be using
if ($permitted == 'forced' && $userisconfigured) {
- // We force messages for this processor, so use this processor unconditionally if user has configured it
+ // An admin is forcing users to use this message processor. Use this processor unconditionally.
$processorlist[] = $processor->name;
} else if ($permitted == 'permitted' && $userisconfigured && !$eventdata->userto->emailstop) {
- // User settings are permitted, see if user set any, otherwise use site default ones
+ // User has not disabled notifications
+ // See if user set any notification preferences, otherwise use site default ones
$userpreferencename = 'message_provider_'.$preferencebase.'_'.$userstate;
if ($userpreference = get_user_preferences($userpreferencename, null, $eventdata->userto->id)) {
if (in_array($processor->name, explode(',', $userpreference))) {
--- /dev/null
+This files describes API changes in /message/ messaging system,
+information provided here is intended especially for developers.
+
+=== 2.2 ===
+
+required changes:
+* lib/messagelib.php message_send($eventdata)
+ $eventdata->userto should contain a property called "emailstop", $eventdata->userto->emailstop
+ If it is absent it will be retrieved from the user table causing an additional database query
u.maildigest,
u.imagealt,
u.email,
+ u.emailstop,
u.city,
u.country,
u.lastaccess,
}
return $return;
-}
\ No newline at end of file
+}
}
// check for notifications required
- $notifyfields = 'u.id, u.username, u.firstname, u.lastname, u.idnumber, u.email, ' .
+ $notifyfields = 'u.id, u.username, u.firstname, u.lastname, u.idnumber, u.email, u.emailstop, ' .
'u.lang, u.timezone, u.mailformat, u.maildisplay';
$groups = groups_get_all_groups($course->id, $submitter->id);
if (is_array($groups) && count($groups) > 0) {