, 2010 * @author Bruno Rubio Gayo , 2010 * Centro de Supercomputacion de Galicia (CESGA) * @author Ivan Tcholakov (technical adaptation for Chamilo 1.8.8), 2010 */ class CourseRequestManager { /** * Checks whether a given course code has been already occupied. * * @param string $wanted_course_code the code to be checked * * @return bool * Returns TRUE if there is created: * - a course with the same code OR visual_code (visualcode). * - a course request with the same code as the given one, or * Othewise returns FALSE. */ public static function course_code_exists($wanted_course_code) { if ($code_exists = CourseManager::course_code_exists($wanted_course_code)) { return $code_exists; } $table_course_request = Database::get_main_table(TABLE_MAIN_COURSE_REQUEST); $wanted_course_code = Database::escape_string($wanted_course_code); $sql = sprintf( 'SELECT COUNT(id) AS number FROM %s WHERE visual_code = "%s"', $table_course_request, $wanted_course_code ); $result = Database::fetch_array(Database::query($sql)); return $result['number'] > 0; } /** * Creates a new course request within the database. * * @param string $wanted_code the code for the created in the future course * @param string $title * @param string $description * @param string $category_code * @param string $course_language * @param string $objectives * @param string $target_audience * @param int $user_id * * @return mixed the database id of the newly created course request or FALSE on failure */ public static function create_course_request( $wanted_code, $title, $description, $category_code, $course_language, $objectives, $target_audience, $user_id, $exemplary_content = 0 ) { $wanted_code = trim($wanted_code); $user_id = (int) $user_id; $exemplary_content = (int) $exemplary_content; if ('' == $wanted_code) { return false; } if (self::course_code_exists($wanted_code)) { return false; } if ($user_id <= 0) { return false; } $user_info = api_get_user_info($user_id); if (!is_array($user_info)) { return false; } $tutor_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $course_language); $request_date = api_get_utc_datetime(); $status = COURSE_REQUEST_PENDING; $info = 0; $keys = AddCourse::define_course_keys($wanted_code, ''); if (!count($keys)) { return false; } $visual_code = $keys['currentCourseCode']; $code = $keys['currentCourseId']; $db_name = isset($keys['currentCourseDbName']) ? $keys['currentCourseDbName'] : null; $directory = $keys['currentCourseRepository']; // @todo user entity $sql = sprintf( 'INSERT INTO %s ( code, user_id, course_language, title, description, category_code, tutor_name, visual_code, request_date, objetives, target_audience, status, info, exemplary_content) VALUES ( "%s", "%d", "%s", "%s", "%s", "%s", "%s", "%s", "%s", "%s", "%s", "%s", "%s", "%d");', Database::get_main_table(TABLE_MAIN_COURSE_REQUEST), Database::escape_string($code), $user_id, Database::escape_string($course_language), Database::escape_string($title), Database::escape_string($description), Database::escape_string($category_code), Database::escape_string($tutor_name), Database::escape_string($visual_code), Database::escape_string($request_date), Database::escape_string($objectives), Database::escape_string($target_audience), Database::escape_string($status), Database::escape_string($info), $exemplary_content ); $result_sql = Database::query($sql); if (!$result_sql) { return false; } $last_insert_id = Database::insert_id(); // E-mail notifications. // E-mail language: The platform language seems to be the best choice. $email_language = api_get_setting('platformLanguage'); $email_subject = sprintf(get_lang('CourseRequestEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $code); $email_body = get_lang('CourseRequestMailOpening', null, $email_language)."\n\n"; $email_body .= get_lang('CourseName', null, $email_language).': '.$title."\n"; $email_body .= get_lang('Fac', null, $email_language).': '.$category_code."\n"; $email_body .= get_lang('CourseCode', null, $email_language).': '.$code."\n"; $email_body .= get_lang('Professor', null, $email_language).': '.api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language)."\n"; $email_body .= get_lang('Email', null, $email_language).': '.$user_info['mail']."\n"; $email_body .= get_lang('Description', null, $email_language).': '.$description."\n"; $email_body .= get_lang('Objectives', null, $email_language).': '.$objectives."\n"; $email_body .= get_lang('TargetAudience', null, $email_language).': '.$target_audience."\n"; $email_body .= get_lang('Ln', null, $email_language).': '.$course_language."\n"; $email_body .= get_lang('FillWithExemplaryContent', null, $email_language).': '.($exemplary_content ? get_lang('Yes', null, $email_language) : get_lang('No', null, $email_language))."\n"; // Sending an e-mail to the platform administrator. $email_body_admin = $email_body; $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"; $email_body_admin .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n"; $sender_name_teacher = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, PERSON_NAME_EMAIL_ADDRESS); $sender_email_teacher = $user_info['mail']; $recipient_name_admin = api_get_person_name( api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, PERSON_NAME_EMAIL_ADDRESS ); $recipient_email_admin = api_get_setting('emailAdministrator'); api_mail_html( $recipient_name_admin, $recipient_email_admin, $email_subject, $email_body_admin, $sender_name_teacher, $sender_email_teacher ); // Sending an e-mail to the request. $email_body_teacher = get_lang('Dear', null, $email_language).' '; $email_body_teacher .= api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $email_language).",\n\n"; $email_body_teacher .= $email_body; $email_body_teacher .= "\n".get_lang('Formula', null, $email_language)."\n"; $email_body_teacher .= api_get_person_name( api_get_setting('administratorName'), api_get_setting('administratorSurname'), null, null, $email_language )."\n"; $email_body_teacher .= get_lang('Manager', null, $email_language).' '.api_get_setting('siteName')."\n"; $email_body_teacher .= get_lang('Phone', null, $email_language).': '.api_get_setting('administratorTelephone')."\n"; $email_body_teacher .= get_lang('Email', null, $email_language).': '.api_get_setting('emailAdministrator', null, $email_language)."\n"; $email_body_teacher .= "\n".get_lang('CourseRequestLegalNote', null, $email_language)."\n"; // Swap the sender and the recipient. $sender_name_admin = $recipient_name_admin; $sender_email_admin = $recipient_email_admin; $recipient_name_teacher = $sender_name_teacher; $recipient_email_teacher = $sender_email_teacher; api_mail_html( $recipient_name_teacher, $recipient_email_teacher, $email_subject, $email_body_teacher, $sender_name_admin, $sender_email_admin, null, null, null ); return $last_insert_id; } /** * Updates a given course request in the database. * * @param int $id the id (an integer number) of the corresponding database record * @param string $wanted_code the code for the created in the future course * @param string $title * @param string $description * @param string $category_code * @param string $course_language * @param string $objectives * @param string $target_audience * @param int $user_id * * @return bool returns TRUE on success or FALSE on failure */ public static function update_course_request( $id, $wanted_code, $title, $description, $category_code, $course_language, $objectives, $target_audience, $user_id, $exemplary_content ) { $id = (int) $id; $wanted_code = trim($wanted_code); $user_id = (int) $user_id; $exemplary_content = (bool) $exemplary_content ? 1 : 0; if ('' == $wanted_code) { return false; } if ($user_id <= 0) { return false; } // Retrieve request data $course_request_info = self::get_course_request_info($id); if (!is_array($course_request_info)) { return false; } $code = $wanted_code; $tutor_name = $course_request_info['tutor_name']; $directory = $course_request_info['directory']; $visual_code = $course_request_info['visual_code']; $request_date = $course_request_info['request_date']; $status = $course_request_info['status']; $info = $course_request_info['info']; if ($wanted_code != $course_request_info['code']) { if (self::course_code_exists($wanted_code)) { return false; } $keys = AddCourse::define_course_keys($wanted_code, ''); if (count($keys)) { $visual_code = $keys['currentCourseCode']; $code = $keys['currentCourseId']; $db_name = $keys['currentCourseDbName']; $directory = $keys['currentCourseRepository']; } else { return false; } } if ($user_id != $course_request_info['code']) { $user_info = api_get_user_info($user_id); if (is_array($user_info)) { $tutor_name = api_get_person_name( $user_info['firstname'], $user_info['lastname'], null, null, $course_language ); } else { $user_id = $course_request_info['code']; } } if ($course_language != $course_request_info['course_language']) { $user_info = api_get_user_info($user_id); if (is_array($user_info)) { $tutor_name = api_get_person_name( $user_info['firstname'], $user_info['lastname'], null, null, $course_language ); } } // @todo use entity $sql = sprintf( 'UPDATE %s SET code = "%s", user_id = "%s", directory = "%s", db_name = "%s", course_language = "%s", title = "%s", description = "%s", category_code = "%s", tutor_name = "%s", visual_code = "%s", request_date = "%s", objetives = "%s", target_audience = "%s", status = "%s", info = "%s", exemplary_content = "%s" WHERE id = '.$id, Database::get_main_table(TABLE_MAIN_COURSE_REQUEST), Database::escape_string($code), intval($user_id), Database::escape_string($directory), Database::escape_string($db_name), Database::escape_string($course_language), Database::escape_string($title), Database::escape_string($description), Database::escape_string($category_code), Database::escape_string($tutor_name), Database::escape_string($visual_code), Database::escape_string($request_date), Database::escape_string($objectives), Database::escape_string($target_audience), Database::escape_string($status), Database::escape_string($info), Database::escape_string($exemplary_content) ); $result_sql = Database::query($sql); return false !== $result_sql; } /** * Deletes a given course request. * * @param int $id the id (an integer number) of the corresponding database record * * @return bool returns TRUE on success or FALSE on failure */ public static function delete_course_request($id) { $id = (int) $id; $sql = "DELETE FROM ".Database::get_main_table(TABLE_MAIN_COURSE_REQUEST)." WHERE id = ".$id; $result = Database::query($sql); return false !== $result; } /** * Returns the number of course requests in the course_request table (optionally matching a status). * * @param int $status * * @return bool */ public static function count_course_requests($status = null) { $course_table = Database::get_main_table(TABLE_MAIN_COURSE_REQUEST); if (is_null($status)) { $sql = "SELECT COUNT(id) AS number FROM ".$course_table; } else { $status = (int) $status; $sql = "SELECT COUNT(id) AS number FROM ".$course_table." WHERE status = ".$status; } $result = Database::fetch_array(Database::query($sql)); if (is_array($result)) { return $result['number']; } return false; } /** * Gets all the information about a course request using its database id as an access key. * * @param int $id the id (an integer number) of the corresponding database record * * @return string|bool returns the requested data as an array or FALSE on failure */ public static function get_course_request_info($id) { $id = (int) $id; $sql = "SELECT * FROM ".Database::get_main_table(TABLE_MAIN_COURSE_REQUEST)." WHERE id = ".$id; $result = Database::query($sql); if (Database::num_rows($result) > 0) { return Database::fetch_array($result); } return false; } /** * Gets the code of a given course request using its database id as an access key. * * @param int $id the id (an integer number) of the corresponding database record * * @return string|bool returns the requested requested code or FALSE on failure */ public static function get_course_request_code($id) { $id = (int) $id; $sql = "SELECT code FROM ".Database::get_main_table(TABLE_MAIN_COURSE_REQUEST)." WHERE id = ".$id; $result = Database::query($sql); if (Database::num_rows($result) > 0) { $result_array = Database::fetch_array($result, 'NUM'); if (is_array($result_array)) { return $result_array[0]; } } return false; } /** * Accepts a given by its id course request. The requested course gets created immediately after the request acceptance. * * @param int $id the id (an integer number) of the corresponding database record * * @return string|bool returns the code of the newly created course or FALSE on failure */ public static function accept_course_request($id) { $id = (int) $id; // Retrieve request's data $course_request_info = self::get_course_request_info($id); if (!is_array($course_request_info)) { return false; } // Make all the checks again before the new course creation. /*if (CourseManager::course_code_exists($wanted_code)) { return false; }*/ $user_id = (int) $course_request_info['user_id']; if ($user_id <= 0) { return false; } $user_info = api_get_user_info($user_id); if (!is_array($user_info)) { return false; } // Create the requested course $params = []; $params['title'] = $course_request_info['title']; $params['course_language'] = $course_request_info['course_language']; $params['exemplary_content'] = intval($course_request_info['exemplary_content']) > 0; $params['wanted_code'] = $course_request_info['code']; $params['user_id'] = $course_request_info['user_id']; $params['tutor_name'] = api_get_person_name($user_info['firstname'], $user_info['lastname']); if (!empty($course_request_info['category_code'])) { $category = CourseCategory::getCategory($course_request_info['category_code']); $categoryId = (int) $category['id']; $params['course_categories'] = [$categoryId]; } $course = CourseManager::create_course($params); if (null !== $course) { // Mark the request as accepted. $sql = "UPDATE ".Database::get_main_table(TABLE_MAIN_COURSE_REQUEST)." SET status = ".COURSE_REQUEST_ACCEPTED." WHERE id = ".$id; Database::query($sql); // E-mail notification. // E-mail language: The platform language seems to be the best choice $email_language = api_get_setting('platformLanguage'); $email_subject = sprintf( get_lang('CourseRequestAcceptedEmailSubject', null, $email_language), '['.api_get_setting('siteName').']', $course->getCode() ); $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 ), $course->getCode(), $course->getCode(), api_get_course_url($course->getId()) )."\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 = api_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']; api_mail_html( $recipient_name, $recipient_email, $email_subject, $email_body, $sender_name, $sender_email ); return $course->getCode(); } return false; } /** * Rejects a given course request. * * @param int $id the id (an integer number) of the corresponding database record * * @return bool returns TRUE on success or FALSE on failure */ public static function reject_course_request($id) { $id = (int) $id; // Retrieve request's data $course_request_info = self::get_course_request_info($id); if (!is_array($course_request_info)) { return false; } $user_id = intval($course_request_info['user_id']); if ($user_id <= 0) { return false; } $user_info = api_get_user_info($user_id); if (!is_array($user_info)) { return false; } $code = $course_request_info['code']; $sql = "UPDATE ".Database::get_main_table(TABLE_MAIN_COURSE_REQUEST)." SET status = ".COURSE_REQUEST_REJECTED." WHERE id = ".$id; if (false === Database::query($sql)) { return false; } // E-mail notification. // E-mail language: The platform language seems to be the best choice. $email_language = api_get_setting('platformLanguage'); $email_subject = sprintf(get_lang('CourseRequestRejectedEmailSubject', 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('CourseRequestRejectedEmailText', null, $email_language), $code)."\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 = api_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']; api_mail_html( $recipient_name, $recipient_email, $email_subject, $email_body, $sender_name, $sender_email ); return true; } /** * Asks the author (through e-mail) for additional information about the given course request. * * @param int $id the database primary id of the given request * * @return bool returns TRUE on success or FALSE on failure */ public static function ask_for_additional_info($id) { $id = (int) $id; // Retrieve request's data $course_request_info = self::get_course_request_info($id); if (!is_array($course_request_info)) { return false; } $user_id = intval($course_request_info['user_id']); if ($user_id <= 0) { return false; } $user_info = api_get_user_info($user_id); if (!is_array($user_info)) { return false; } $code = $course_request_info['code']; $info = intval($course_request_info['info']); // Error is to be returned on a repeated attempt for asking additional information. if (!empty($info)) { return false; } // E-mail notification. // E-mail language: The platform language seems to be the best choice. $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"; $email_body .= "\n".get_lang('Formula', null, $email_language)."\n"; $email_body .= api_get_person_name(api_get_setting('administratorName'), api_get_setting('administratorSurname'))."\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')."\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 = api_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']; $result = api_mail_html( $recipient_name, $recipient_email, $email_subject, $email_body, $sender_name, $sender_email ); if (!$result) { return false; } // Marking the fact that additional information about the request has been asked. $sql = "UPDATE ".Database::get_main_table(TABLE_MAIN_COURSE_REQUEST)." SET info = 1 WHERE id = ".$id; $result = false !== Database::query($sql); return $result; } /** * Checks whether additional information about the given course request has been asked. * * @param int $id the database primary id of the given request * * @return 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 > 0)"; $result = Database::num_rows(Database::query($sql)); return !empty($result); } }