course_request.lib.php 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667
  1. <?php
  2. /* For licensing terms, see /license.txt */
  3. /**
  4. * Course request manager
  5. * @package chamilo.library
  6. *
  7. * @author José Manuel Abuin Mosquera <chema@cesga.es>, 2010
  8. * @author Bruno Rubio Gayo <brubio@cesga.es>, 2010
  9. * Centro de Supercomputacion de Galicia (CESGA)
  10. *
  11. * @author Ivan Tcholakov <ivantcholakov@gmail.com> (technical adaptation for Chamilo 1.8.8), 2010
  12. *
  13. * @package chamilo.library
  14. */
  15. class CourseRequestManager
  16. {
  17. /**
  18. * Checks whether a given course code has been already occupied.
  19. * @param string $wanted_course_code The code to be checked.
  20. * @return string
  21. * Returns TRUE if there is created:
  22. * - a course with the same code OR visual_code (visualcode).
  23. * - a course request with the same code as the given one, or
  24. * Othewise returns FALSE.
  25. */
  26. public static function course_code_exists($wanted_course_code)
  27. {
  28. if ($code_exists = CourseManager::course_code_exists($wanted_course_code)) {
  29. return $code_exists;
  30. }
  31. $table_course_request = Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST);
  32. $wanted_course_code = Database::escape_string($wanted_course_code);
  33. $sql = sprintf('SELECT COUNT(id) AS number FROM %s WHERE visual_code = "%s"', $table_course_request, $wanted_course_code);
  34. $result = Database::fetch_array(Database::query($sql));
  35. return $result['number'] > 0;
  36. }
  37. /**
  38. * Creates a new course request within the database.
  39. * @param string $wanted_code The code for the created in the future course.
  40. * @param string $title
  41. * @param string $description
  42. * @param string $category_code
  43. * @param string $course_language
  44. * @param string $objetives
  45. * @param string $target_audience
  46. * @param int/string $user_id
  47. * @return int/bool The database id of the newly created course request or FALSE on failure.
  48. */
  49. public static function create_course_request(
  50. $wanted_code,
  51. $title,
  52. $description,
  53. $category_code,
  54. $course_language,
  55. $objetives,
  56. $target_audience,
  57. $user_id,
  58. $exemplary_content
  59. ) {
  60. global $_configuration;
  61. $wanted_code = trim($wanted_code);
  62. $user_id = (int)$user_id;
  63. $exemplary_content = (bool)$exemplary_content ? 1 : 0;
  64. if ($wanted_code == '') {
  65. return false;
  66. }
  67. if (self::course_code_exists($wanted_code)) {
  68. return false;
  69. }
  70. if ($user_id <= 0) {
  71. return false;
  72. }
  73. $user_info = api_get_user_info($user_id);
  74. if (!is_array($user_info)) {
  75. return false;
  76. }
  77. $tutor_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $course_language);
  78. $request_date = api_get_utc_datetime();
  79. $status = COURSE_REQUEST_PENDING;
  80. $info = 0;
  81. $keys = define_course_keys($wanted_code, '');
  82. if (!count($keys)) {
  83. return false;
  84. }
  85. $visual_code = $keys['currentCourseCode'];
  86. $code = $keys['currentCourseId'];
  87. $db_name = isset($keys['currentCourseDbName']) ? $keys['currentCourseDbName'] : null;
  88. $directory = $keys['currentCourseRepository'];
  89. $sql = sprintf('INSERT INTO %s (
  90. code, user_id, directory, db_name,
  91. course_language, title, description, category_code,
  92. tutor_name, visual_code, request_date,
  93. objetives, target_audience, status, info, exemplary_content)
  94. VALUES (
  95. "%s", "%s", "%s", "%s",
  96. "%s", "%s", "%s", "%s",
  97. "%s", "%s", "%s",
  98. "%s", "%s", "%s", "%s", "%s");', Database::get_main_table(TABLE_MAIN_COURSE_REQUEST),
  99. Database::escape_string($code), Database::escape_string($user_id), Database::escape_string($directory), Database::escape_string($db_name),
  100. Database::escape_string($course_language), Database::escape_string($title), Database::escape_string($description), Database::escape_string($category_code),
  101. Database::escape_string($tutor_name), Database::escape_string($visual_code), Database::escape_string($request_date),
  102. Database::escape_string($objetives), Database::escape_string($target_audience), Database::escape_string($status), Database::escape_string($info), Database::escape_string($exemplary_content));
  103. $result_sql = Database::query($sql);
  104. if (!$result_sql) {
  105. return false;
  106. }
  107. $last_insert_id = Database::get_last_insert_id();
  108. // E-mail notifications.
  109. // E-mail language: The platform language seems to be the best choice.
  110. //$email_language = $course_language;
  111. //$email_language = api_get_interface_language();
  112. $email_language = api_get_setting('platformLanguage');
  113. $email_subject = sprintf(get_lang('CourseRequestEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $code);
  114. $email_body = get_lang('CourseRequestMailOpening', null, $email_language)."\n\n";
  115. $email_body .= get_lang('CourseName', null, $email_language).': '.$title."\n";
  116. $email_body .= get_lang('Fac', null, $email_language).': '.$category_code."\n";
  117. $email_body .= get_lang('CourseCode', null, $email_language).': '.$code."\n";
  118. $email_body .= get_lang('Professor', null, $email_language).': '.api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language)."\n";
  119. $email_body .= get_lang('Email', null, $email_language).': '.$user_info['mail']."\n";
  120. $email_body .= get_lang('Description', null, $email_language).': '.$description."\n";
  121. $email_body .= get_lang('Objectives', null, $email_language).': '.$objetives."\n";
  122. $email_body .= get_lang('TargetAudience', null, $email_language).': '.$target_audience."\n";
  123. $email_body .= get_lang('Ln', null, $email_language).': '.$course_language."\n";
  124. $email_body .= get_lang('FillWithExemplaryContent', null, $email_language).': '.($exemplary_content ? get_lang('Yes', null, $email_language) : get_lang('No', null, $email_language))."\n";
  125. // Sending an e-mail to the platform administrator.
  126. $email_body_admin = $email_body;
  127. $email_body_admin .= "\n".get_lang('CourseRequestPageForApproval', null, $email_language).' '.api_get_path(WEB_CODE_PATH).'admin/course_request_edit.php?id='.$last_insert_id."\n";
  128. $email_body_admin .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n";
  129. $sender_name_teacher = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, PERSON_NAME_EMAIL_ADDRESS);
  130. $sender_email_teacher = $user_info['mail'];
  131. $recipient_name_admin = api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, PERSON_NAME_EMAIL_ADDRESS);
  132. $recipient_email_admin = get_setting('emailAdministrator');
  133. $userInfo = api_get_user_info($user_id);
  134. $additionalParameters = array(
  135. 'smsType' => ClockworksmsPlugin::NEW_COURSE_SUGGESTED_TEACHER,
  136. 'userId' => $user_id,
  137. 'userUsername' => $userInfo['username']
  138. );
  139. api_mail_html(
  140. $recipient_name_admin,
  141. $recipient_email_admin,
  142. $email_subject,
  143. $email_body_admin,
  144. $sender_name_teacher,
  145. $sender_email_teacher,
  146. null,
  147. null,
  148. null,
  149. $additionalParameters
  150. );
  151. // Sending an e-mail to the requestor.
  152. $email_body_teacher = get_lang('Dear', null, $email_language).' ';
  153. $email_body_teacher .= api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language).",\n\n";
  154. $email_body_teacher .= $email_body;
  155. $email_body_teacher .= "\n".get_lang('Formula', null, $email_language)."\n";
  156. $email_body_teacher .= api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, null, $email_language)."\n";
  157. $email_body_teacher .= get_lang('Manager', null, $email_language).' '.api_get_setting('siteName')."\n";
  158. $email_body_teacher .= get_lang('Phone', null, $email_language).': '.api_get_setting('administratorTelephone')."\n";
  159. $email_body_teacher .= get_lang('Email', null, $email_language).': '.api_get_setting('emailAdministrator', null, $email_language)."\n";
  160. $email_body_teacher .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n";
  161. // Swap the sender and the recipient.
  162. $sender_name_admin = $recipient_name_admin;
  163. $sender_email_admin = $recipient_email_admin;
  164. $recipient_name_teacher = $sender_name_teacher;
  165. $recipient_email_teacher = $sender_email_teacher;
  166. $additionalParameters = array(
  167. 'smsType' => ClockworksmsPlugin::COURSE_OPENING_REQUEST_CODE_REGISTERED,
  168. 'userId' => $user_info['user_id'],
  169. 'courseCode' => $wanted_code
  170. );
  171. api_mail_html(
  172. $recipient_name_teacher,
  173. $recipient_email_teacher,
  174. $email_subject,
  175. $email_body_teacher,
  176. $sender_name_admin,
  177. $sender_email_admin,
  178. null,
  179. null,
  180. null,
  181. $additionalParameters
  182. );
  183. return $last_insert_id;
  184. }
  185. /**
  186. * Updates a given course request in the database.
  187. * @param int/string $id The id (an integer number) of the corresponding database record.
  188. * @param string $wanted_code The code for the created in the future course.
  189. * @param string $title
  190. * @param string $description
  191. * @param string $category_code
  192. * @param string $course_language
  193. * @param string $objetives
  194. * @param string $target_audience
  195. * @param int/string $user_id
  196. * @return bool Returns TRUE on success or FALSE on failure.
  197. */
  198. public static function update_course_request(
  199. $id,
  200. $wanted_code,
  201. $title,
  202. $description,
  203. $category_code,
  204. $course_language,
  205. $objetives,
  206. $target_audience,
  207. $user_id,
  208. $exemplary_content
  209. ) {
  210. $id = (int)$id;
  211. $wanted_code = trim($wanted_code);
  212. $user_id = (int)$user_id;
  213. $exemplary_content = (bool)$exemplary_content ? 1 : 0;
  214. if ($wanted_code == '') {
  215. return false;
  216. }
  217. if ($user_id <= 0) {
  218. return false;
  219. }
  220. // Retrieve request data
  221. $course_request_info = self::get_course_request_info($id);
  222. if (!is_array($course_request_info)) {
  223. return false;
  224. }
  225. $code = $wanted_code;
  226. $tutor_name = $course_request_info['tutor_name'];
  227. $directory = $course_request_info['directory'];
  228. $db_name = $course_request_info['db_name'];
  229. $visual_code = $course_request_info['visual_code'];
  230. $request_date = $course_request_info['request_date'];
  231. $status = $course_request_info['status'];
  232. $info = $course_request_info['info'];
  233. if ($wanted_code != $course_request_info['code']) {
  234. if (self::course_code_exists($wanted_code)) {
  235. return false;
  236. }
  237. $keys = define_course_keys($wanted_code, '');
  238. if (count($keys)) {
  239. $visual_code = $keys['currentCourseCode'];
  240. $code = $keys['currentCourseId'];
  241. $db_name = $keys['currentCourseDbName'];
  242. $directory = $keys['currentCourseRepository'];
  243. } else {
  244. return false;
  245. }
  246. }
  247. if ($user_id != $course_request_info['code']) {
  248. $user_info = api_get_user_info($user_id);
  249. if (is_array($user_info)) {
  250. $tutor_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $course_language);
  251. } else {
  252. $user_id = $course_request_info['code'];
  253. }
  254. }
  255. if ($course_language != $course_request_info['course_language']) {
  256. $user_info = api_get_user_info($user_id);
  257. if (is_array($user_info)) {
  258. $tutor_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $course_language);
  259. }
  260. }
  261. $sql = sprintf('UPDATE %s SET
  262. code = "%s", user_id = "%s", directory = "%s", db_name = "%s",
  263. course_language = "%s", title = "%s", description = "%s", category_code = "%s",
  264. tutor_name = "%s", visual_code = "%s", request_date = "%s",
  265. objetives = "%s", target_audience = "%s", status = "%s", info = "%s", exemplary_content = "%s"
  266. WHERE id = '.$id, Database::get_main_table(TABLE_MAIN_COURSE_REQUEST),
  267. Database::escape_string($code),
  268. intval($user_id),
  269. Database::escape_string($directory),
  270. Database::escape_string($db_name),
  271. Database::escape_string($course_language),
  272. Database::escape_string($title),
  273. Database::escape_string($description),
  274. Database::escape_string($category_code),
  275. Database::escape_string($tutor_name),
  276. Database::escape_string($visual_code),
  277. Database::escape_string($request_date),
  278. Database::escape_string($objetives),
  279. Database::escape_string($target_audience),
  280. Database::escape_string($status),
  281. Database::escape_string($info),
  282. Database::escape_string($exemplary_content)
  283. );
  284. $result_sql = Database::query($sql);
  285. return $result_sql !== false;
  286. }
  287. /**
  288. * Deletes a given course request.
  289. * @param int/string $id The id (an integer number) of the corresponding database record.
  290. * @return bool Returns TRUE on success or FALSE on failure.
  291. */
  292. public static function delete_course_request($id)
  293. {
  294. $id = (int)$id;
  295. $sql = "DELETE FROM ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)." WHERE id = ".$id;
  296. $result = Database::query($sql);
  297. return $result !== false;
  298. }
  299. /**
  300. * @param null $status
  301. * @return bool
  302. */
  303. public static function count_course_requests($status = null)
  304. {
  305. $course_table = Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST);
  306. if (is_null($status)) {
  307. $sql = "SELECT COUNT(id) AS number FROM ".$course_table;
  308. } else {
  309. $status = (int)$status;
  310. $sql = "SELECT COUNT(id) AS number FROM ".$course_table." WHERE status = ".$status;
  311. }
  312. $result = Database::fetch_array(Database::query($sql));
  313. if (is_array($result)) {
  314. return $result['number'];
  315. }
  316. return false;
  317. }
  318. /**
  319. * Gets all the information about a course request using its database id as an access key.
  320. * @param int/string $id The id (an integer number) of the corresponding database record.
  321. * @return array/bool Returns the requested data as an array or FALSE on failure.
  322. */
  323. public static function get_course_request_info($id)
  324. {
  325. $id = (int)$id;
  326. $sql = "SELECT *
  327. FROM ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)."
  328. WHERE id = ".$id;
  329. $result = Database::query($sql);
  330. if (Database::num_rows($result) > 0) {
  331. return Database::fetch_array($result);
  332. }
  333. return false;
  334. }
  335. /**
  336. * Gets the code of a given course request using its database id as an access key.
  337. * @param int/string $id The id (an integer number) of the corresponding database record.
  338. * @return string/bool Returns the requested requested code or FALSE on failure.
  339. */
  340. public static function get_course_request_code($id)
  341. {
  342. $id = (int)$id;
  343. $sql = "SELECT code
  344. FROM ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)."
  345. WHERE id = ".$id;
  346. $result = Database::query($sql);
  347. if (Database::num_rows($result) > 0) {
  348. $result_array = Database::fetch_array($result, 'NUM');
  349. if (is_array($result_array)) {
  350. return $result_array[0];
  351. }
  352. }
  353. return false;
  354. }
  355. /**
  356. * Accepts a given by its id course request. The requested course gets created immediately after the request acceptance.
  357. * @param int/string $id The id (an integer number) of the corresponding database record.
  358. * @return string/bool Returns the code of the newly created course or FALSE on failure.
  359. */
  360. public static function accept_course_request($id)
  361. {
  362. $id = (int)$id;
  363. // Retrieve request's data
  364. $course_request_info = self::get_course_request_info($id);
  365. if (!is_array($course_request_info)) {
  366. return false;
  367. }
  368. // Make all the checks again before the new course creation.
  369. /*if (CourseManager::course_code_exists($wanted_code)) {
  370. return false;
  371. }*/
  372. $user_id = (int)$course_request_info['user_id'];
  373. if ($user_id <= 0) {
  374. return false;
  375. }
  376. $user_info = api_get_user_info($user_id);
  377. if (!is_array($user_info)) {
  378. return false;
  379. }
  380. // Create the requested course
  381. $params = array();
  382. $params['title'] = $course_request_info['title'];
  383. $params['course_category'] = $course_request_info['category_code'];
  384. $params['course_language'] = $course_request_info['course_language'];
  385. $params['exemplary_content'] = intval($course_request_info['exemplary_content']) > 0;
  386. $params['wanted_code'] = $course_request_info['code'];
  387. $params['user_id'] = $course_request_info['user_id'];
  388. $params['tutor_name'] = api_get_person_name($user_info['firstname'], $user_info['lastname']);
  389. $course_info = CourseManager::create_course($params);
  390. if (!empty($course_info)) {
  391. // Mark the request as accepted.
  392. $sql = "UPDATE ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)."
  393. SET status = ".COURSE_REQUEST_ACCEPTED."
  394. WHERE id = ".$id;
  395. Database::query($sql);
  396. // E-mail notification.
  397. // E-mail language: The platform language seems to be the best choice
  398. $email_language = api_get_setting('platformLanguage');
  399. $email_subject = sprintf(get_lang('CourseRequestAcceptedEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $course_info['code']);
  400. $email_body = get_lang('Dear', null, $email_language).' ';
  401. $email_body .= api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language).",\n\n";
  402. $email_body .= sprintf(get_lang('CourseRequestAcceptedEmailText', null, $email_language), $wanted_code, $course_info['code'], api_get_path(WEB_COURSE_PATH).$course_info['directory'].'/')."\n";
  403. $email_body .= "\n".get_lang('Formula', null, $email_language)."\n";
  404. $email_body .= api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, null, $email_language)."\n";
  405. $email_body .= get_lang('Manager', null, $email_language).' '.api_get_setting('siteName')."\n";
  406. $email_body .= get_lang('Phone', null, $email_language).': '.api_get_setting('administratorTelephone')."\n";
  407. $email_body .= get_lang('Email', null, $email_language).': '.api_get_setting('emailAdministrator', null, $email_language)."\n";
  408. $email_body .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n";
  409. $sender_name = api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, PERSON_NAME_EMAIL_ADDRESS);
  410. $sender_email = get_setting('emailAdministrator');
  411. $recipient_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, PERSON_NAME_EMAIL_ADDRESS);
  412. $recipient_email = $user_info['mail'];
  413. $extra_headers = 'Bcc: '.$sender_email;
  414. $additionalParameters = array(
  415. 'smsType' => ClockworksmsPlugin::COURSE_OPENING_REQUEST_CODE_APPROVED,
  416. 'userId' => $user_id,
  417. 'courseCode' => $course_info['code']
  418. );
  419. api_mail_html(
  420. $recipient_name,
  421. $recipient_email,
  422. $email_subject,
  423. $email_body,
  424. $sender_name,
  425. $sender_email,
  426. null,
  427. null,
  428. null,
  429. $additionalParameters
  430. );
  431. return $course_info['code'];
  432. }
  433. return false;
  434. }
  435. /**
  436. * Rejects a given course request.
  437. * @param int/string $id The id (an integer number) of the corresponding database record.
  438. * @return bool Returns TRUE on success or FALSE on failure.
  439. */
  440. public static function reject_course_request($id)
  441. {
  442. $id = (int)$id;
  443. // Retrieve request's data
  444. $course_request_info = self::get_course_request_info($id);
  445. if (!is_array($course_request_info)) {
  446. return false;
  447. }
  448. $user_id = intval($course_request_info['user_id']);
  449. if ($user_id <= 0) {
  450. return false;
  451. }
  452. $user_info = api_get_user_info($user_id);
  453. if (!is_array($user_info)) {
  454. return false;
  455. }
  456. $code = $course_request_info['code'];
  457. $sql = "UPDATE ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)." SET status = ".COURSE_REQUEST_REJECTED." WHERE id = ".$id;
  458. if (Database::query($sql) === false) {
  459. return false;
  460. }
  461. // E-mail notification.
  462. // E-mail language: The platform language seems to be the best choice.
  463. $email_language = api_get_setting('platformLanguage');
  464. $email_subject = sprintf(get_lang('CourseRequestRejectedEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $code);
  465. $email_body = get_lang('Dear', null, $email_language).' ';
  466. $email_body .= api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language).",\n\n";
  467. $email_body .= sprintf(get_lang('CourseRequestRejectedEmailText', null, $email_language), $code)."\n";
  468. $email_body .= "\n".get_lang('Formula', null, $email_language)."\n";
  469. $email_body .= api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, null, $email_language)."\n";
  470. $email_body .= get_lang('Manager', null, $email_language).' '.api_get_setting('siteName')."\n";
  471. $email_body .= get_lang('Phone', null, $email_language).': '.api_get_setting('administratorTelephone')."\n";
  472. $email_body .= get_lang('Email', null, $email_language).': '.api_get_setting('emailAdministrator', null, $email_language)."\n";
  473. $email_body .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n";
  474. $sender_name = api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, PERSON_NAME_EMAIL_ADDRESS);
  475. $sender_email = get_setting('emailAdministrator');
  476. $recipient_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, PERSON_NAME_EMAIL_ADDRESS);
  477. $recipient_email = $user_info['mail'];
  478. $extra_headers = 'Bcc: '.$sender_email;
  479. $additionalParameters = array(
  480. 'smsType' => ClockworksmsPlugin::COURSE_OPENING_REQUEST_CODE_REJECTED,
  481. 'userId' => $user_id,
  482. 'courseCode' => $code
  483. );
  484. api_mail_html(
  485. $recipient_name,
  486. $recipient_email,
  487. $email_subject,
  488. $email_body,
  489. $sender_name,
  490. $sender_email,
  491. null,
  492. null,
  493. null,
  494. $additionalParameters
  495. );
  496. return true;
  497. }
  498. /**
  499. * Asks the author (through e-mail) for additional information about the given course request.
  500. * @param int/string $id The database primary id of the given request.
  501. * @return bool Returns TRUE on success or FALSE on failure.
  502. */
  503. public static function ask_for_additional_info($id)
  504. {
  505. $id = (int)$id;
  506. // Retrieve request's data
  507. $course_request_info = self::get_course_request_info($id);
  508. if (!is_array($course_request_info)) {
  509. return false;
  510. }
  511. $user_id = intval($course_request_info['user_id']);
  512. if ($user_id <= 0) {
  513. return false;
  514. }
  515. $user_info = api_get_user_info($user_id);
  516. if (!is_array($user_info)) {
  517. return false;
  518. }
  519. $code = $course_request_info['code'];
  520. $info = intval($course_request_info['info']);
  521. // Error is to be returned on a repeated attempt for asking additional information.
  522. if (!empty($info)) {
  523. return false;
  524. }
  525. // E-mail notification.
  526. // E-mail language: The platform language seems to be the best choice.
  527. $email_language = api_get_setting('platformLanguage');
  528. $email_subject = sprintf(get_lang('CourseRequestAskInfoEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $code);
  529. $email_body = get_lang('Dear', null, $email_language).' ';
  530. $email_body .= api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language).",\n\n";
  531. $email_body .= sprintf(get_lang('CourseRequestAskInfoEmailText', null, $email_language), $code)."\n";
  532. $email_body .= "\n".get_lang('Formula', null, $email_language)."\n";
  533. $email_body .= api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, null, $email_language)."\n";
  534. $email_body .= get_lang('Manager', null, $email_language).' '.api_get_setting('siteName')."\n";
  535. $email_body .= get_lang('Phone', null, $email_language).': '.api_get_setting('administratorTelephone')."\n";
  536. $email_body .= get_lang('Email', null, $email_language).': '.api_get_setting('emailAdministrator', null, $email_language)."\n";
  537. $email_body .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n";
  538. $sender_name = api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, PERSON_NAME_EMAIL_ADDRESS);
  539. $sender_email = get_setting('emailAdministrator');
  540. $recipient_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, PERSON_NAME_EMAIL_ADDRESS);
  541. $recipient_email = $user_info['mail'];
  542. $extra_headers = 'Bcc: '.$sender_email;
  543. $additionalParameters = array(
  544. 'smsType' => ClockworksmsPlugin::COURSE_OPENING_REQUEST_CODE,
  545. 'userId' => $user_id,
  546. 'courseCode' => $code
  547. );
  548. $result = api_mail_html(
  549. $recipient_name,
  550. $recipient_email,
  551. $email_subject,
  552. $email_body,
  553. $sender_name,
  554. $sender_email,
  555. null,
  556. null,
  557. null,
  558. $additionalParameters
  559. );
  560. if (!$result) {
  561. return false;
  562. }
  563. // Marking the fact that additional information about the request has been asked.
  564. $sql = "UPDATE ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)." SET info = 1 WHERE id = ".$id;
  565. $result = Database::query($sql) !== false;
  566. return $result;
  567. }
  568. /**
  569. * Checks whether additional information about the given course request has been asked.
  570. * @param int/string $id The database primary id of the given request.
  571. * @return bool Returns TRUE if additional information has been asked or FALSE otherwise.
  572. */
  573. public static function additional_info_asked($id)
  574. {
  575. $id = (int)$id;
  576. $sql = "SELECT id FROM ".Database :: get_main_table(TABLE_MAIN_COURSE_REQUEST)."
  577. WHERE (id = ".$id." AND info > 0)";
  578. $result = Database::num_rows(Database::query($sql));
  579. return !empty($result);
  580. }
  581. }