Course: Add email setting to notify students on manual course subscription - refs #3398

Author: christianbeeznest

public/main/course_info/infocours.php

@@ -325,6 +325,23 @@
 );
 $globalGroup[get_lang('E-mail teacher when a new user auto-subscribes')] = $group;
 
+$group = [];
+$group[] = $form->createElement(
+    'radio',
+    'email_alert_student_on_manual_subscription',
+    get_lang('E-mail student when he is subscribed to the course'),
+    get_lang('Enable'),
+    1
+);
+$group[] = $form->createElement(
+    'radio',
+    'email_alert_student_on_manual_subscription',
+    null,
+    get_lang('Disable'),
+    0
+);
+$globalGroup[get_lang('E-mail student when he is subscribed to the course')] = $group;
+
 $group = [];
 $group[] = $form->createElement(
     'radio',
@@ -923,6 +940,10 @@
     $values['student_delete_own_publication'] = 0;
 }
 
+if (!isset($values['email_alert_student_on_manual_subscription'])) {
+    $values['email_alert_student_on_manual_subscription'] = 0;
+}
+
 $documentAutoLaunch = api_get_course_setting('enable_document_auto_launch');
 $lpAutoLaunch = api_get_course_setting('enable_lp_auto_launch');
 $exerciseAutoLaunch = api_get_course_setting('enable_exercise_auto_launch');

public/main/inc/lib/course.lib.php

@@ -913,17 +913,24 @@ public static function subscribeUser(
                     )
                 );
 
-                $subject = get_lang('You have been enrolled in the course').' '.$course->getTitle();
-                $message = sprintf(get_lang('Hello %s, you have been enrolled in the course %s.'), UserManager::formatUserFullName($user, true), $course->getTitle());
+                $sendToStudent = (int) api_get_course_setting('email_alert_student_on_manual_subscription', $course);
+                if (1 === $sendToStudent) {
+                    $subject = get_lang('You have been enrolled in the course').' '.$course->getTitle();
+                    $message = sprintf(
+                        get_lang('Hello %s, you have been enrolled in the course %s.'),
+                        UserManager::formatUserFullName($user, true),
+                        $course->getTitle()
+                    );
 
-                MessageManager::send_message_simple(
-                    $userId,
-                    $subject,
-                    $message,
-                    api_get_user_id(),
-                    false,
-                    true
-                );
+                    MessageManager::send_message_simple(
+                        $userId,
+                        $subject,
+                        $message,
+                        api_get_user_id(),
+                        false,
+                        true
+                    );
+                }
 
                 $send = (int) api_get_course_setting('email_alert_to_teacher_on_new_user_in_course', $course);
 
@@ -5301,6 +5308,7 @@ public static function getCourseSettingVariables(AppPlugin $appPlugin = null)
             'email_alert_students_on_new_homework',
             // Get send_mail_setting (auth)from table
             'email_alert_to_teacher_on_new_user_in_course',
+            'email_alert_student_on_manual_subscription',
             'enable_lp_auto_launch',
             'enable_exercise_auto_launch',
             'enable_document_auto_launch',