Add an action trigger for course completion

Timely and reliable tracking of course completions is essential in our use case. It would be very useful to send an email to an admin email address every time a course take or re-take status changes to 'Completed'. Thus notification of course completions is more fail safe if LMS admins have record of course completions both in their email and with online reports. It is paramount that we do not lose successful course completions.

I propose a call to drupal_mail_send($message) whenever a course registration status changes to 'Completed' whether pass or fail. An optional "Notification Email Address" could be added to admin/settings/scorm_cloud/settings. If the field is set, emails are sent. If the field is blank, emails are not sent.

The code could be something like...

$registration = array containing information about the course registration;
if ($registration->status_before_launch != $registration->status_after_launch &&
$registration->status_after_launch == "completed" &&
valid_email_address($scorm_cloud_email) ) {
profile_load_profile(&$user); // this is needed to load $user with the admin defined profile fields
$message['id'] = "course_notification";
$message['to'] = $scorm_cloud_email; // value from admin/settings/scorm_cloud/settings
$message['subject'] = $site_name . ": " . $user->email . " completed course " . $registration->coursename;
$message['body'] = "
USER: " . print_r($user,TRUE) . "

COURSE: " . print_r($registration,TRUE)
drupal_mail_send($message);
}