Feature #2099 - Course validation: Implementing e-mail notifications for accepted courses/trainings.

main/inc/lib/course_request.lib.php

@@ -277,10 +277,34 @@ class CourseRequestManager {
         $sql = "UPDATE ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)." SET status = ".COURSE_REQUEST_ACCEPTED." WHERE id = ".$id;
         Database::query($sql);
 
-        // TODO: Prepare and send notification e-mail messages.
+        // E-mail notification.
 
-        return $code;
+        // E-mail language: The platform language seems to be the best choice.
+        //$email_language = $course_language;
+        //$email_language = api_get_interface_language();
+        $email_language = api_get_setting('platformLanguage');
+
+        $email_subject = sprintf(get_lang('CourseRequestAcceptedEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $wanted_code);
+
+        $email_body = get_lang('Dear', null, $email_language).' ';
+        $email_body .= api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language).",\n\n";
+        $email_body .= sprintf(get_lang('CourseRequestAcceptedEmailText', null, $email_language), $wanted_code, $code, api_get_path(WEB_COURSE_PATH).$directory.'/')."\n";
+        $email_body .= "\n".get_lang('Formula', null, $email_language)."\n";
+        $email_body .= api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, null, $email_language)."\n";
+        $email_body .= get_lang('Manager', null, $email_language).' '.api_get_setting('siteName')."\n";
+        $email_body .= get_lang('Phone', null, $email_language).': '.api_get_setting('administratorTelephone')."\n";
+        $email_body .= get_lang('Email', null, $email_language).': '.api_get_setting('emailAdministrator', null, $email_language)."\n";
+        $email_body .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n";
+
+        $sender_name = api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, PERSON_NAME_EMAIL_ADDRESS);
+        $sender_email = get_setting('emailAdministrator');
+        $recipient_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, PERSON_NAME_EMAIL_ADDRESS);
+        $recipient_email = $user_info['mail'];
+        $extra_headers = 'Bcc: '.$sender_email;
 
+        @api_mail($recipient_name, $recipient_email, $email_subject, $email_body, $sender_name, $sender_email);
+
+        return $code;
     }
 
     /**
@@ -340,6 +364,7 @@ class CourseRequestManager {
         $email_language = api_get_setting('platformLanguage');
 
         $email_subject = sprintf(get_lang('CourseRequestAskInfoEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $code);
+
         $email_body = get_lang('Dear', null, $email_language).' ';
         $email_body .= api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language).",\n\n";
         $email_body .= sprintf(get_lang('CourseRequestAskInfoEmailText', null, $email_language), $code)."\n";
@@ -374,12 +399,10 @@ class CourseRequestManager {
      * @return array/bool                 Returns TRUE if additional information has been asked or FALSE otherwise.
      */
     public static function additional_info_asked($id) {
-
         $id = (int)$id;
         $sql = "SELECT id FROM ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)." WHERE (id = ".$id." AND info = 1)";
         $result = Database::num_rows(Database::query($sql));
         return !empty($result);
-
     }
 
 }

main/lang/bulgarian/create_course.inc.php

@@ -138,4 +138,6 @@ $PleaseActivateCourseValidationFeature = "Функцията \"Одобрява
 $CourseRequestLegalNote = "Информацията в тази заявка е защитена; тя може да служи само за обслужване на процедурата по откриване на нов учебен курс в нашия учебен портал; тя не може да бъде разкривана пред трети страни.";
 $CourseRequestAskInfoEmailSubject = "%s Искане за допълнителна информация относно заявката за нов курс %s";
 $CourseRequestAskInfoEmailText = "Получихме вашата заявка за нов курс с код %s. За да я разгледаме за одобрение, ние се нуждаем от допълнителна информация.\n\nМоля, изпратете ни информация относно съдържанието на курса (описание), относно целите на курса и относно курсистите (целевата аудитория). Ако е приложимо, споменете институцията или организационното звено, от чието име сте подали заявката.";
+$CourseRequestAcceptedEmailSubject = "%s Заявката за нов курс %s е одобрена";
+$CourseRequestAcceptedEmailText = "Вашата заявка %s е одобрена. Създаден е нов курс %s за който сте регистрирани като преподавател.\n\nМожете да получите достъп до своя курс оттук: %s";
 ?>

main/lang/english/create_course.inc.php

@@ -138,4 +138,5 @@ $PleaseActivateCourseValidationFeature = "The \"Training validation\" feature is
 $CourseRequestLegalNote = "The information of this training request is considered as protected; it can be used only for serving the procedure of opening a new training within our training portal; it should not be revealed to third parties.";
 $CourseRequestAskInfoEmailSubject = "%s A request for additional information about the training request %s";
 $CourseRequestAskInfoEmailText = "We have received your request for a new training with code %s. But before we consider it for approval we need some additional information.\n\nPlease, provide brief information about the training content (description), the objectives, the students or the users that are to be involved in the proposed training. If it is applicable, mention the name of the institution or the unit on which behalf you made the training request.";
+$CourseRequestAcceptedEmailSubject = "%s The training request %s has been approved";
 ?>