You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					
					
						
							551 lines
						
					
					
						
							26 KiB
						
					
					
				
			
		
		
	
	
							551 lines
						
					
					
						
							26 KiB
						
					
					
				<?php
 | 
						|
/* For licensing terms, see /license.txt */
 | 
						|
 | 
						|
/**
 | 
						|
 * Course request manager
 | 
						|
 * @package chamilo.library
 | 
						|
 *
 | 
						|
 * @author José Manuel Abuin Mosquera <chema@cesga.es>, 2010
 | 
						|
 * @author Bruno Rubio Gayo <brubio@cesga.es>, 2010
 | 
						|
 * Centro de Supercomputacion de Galicia (CESGA)
 | 
						|
 *
 | 
						|
 * @author Ivan Tcholakov <ivantcholakov@gmail.com> (technical adaptation for Chamilo 1.8.8), 2010
 | 
						|
 */
 | 
						|
 | 
						|
define(COURSE_REQUEST_PENDING,  0);
 | 
						|
define(COURSE_REQUEST_ACCEPTED, 1);
 | 
						|
define(COURSE_REQUEST_REJECTED, 2);
 | 
						|
 | 
						|
class CourseRequestManager {
 | 
						|
 | 
						|
    /**
 | 
						|
     * Checks whether a given course code has been already occupied.
 | 
						|
     * @param string $wanted_course_code    The code to be checked.
 | 
						|
     * @return string
 | 
						|
     * 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 $objetives
 | 
						|
     * @param string $target_audience
 | 
						|
     * @param int/string $user_id
 | 
						|
     * @return int/bool                 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, $objetives, $target_audience, $user_id, $exemplary_content) {
 | 
						|
 | 
						|
        $wanted_code = trim($wanted_code);
 | 
						|
        $user_id = (int)$user_id;
 | 
						|
        $exemplary_content = (bool)$exemplary_content ? 1 : 0;
 | 
						|
 | 
						|
        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 = define_course_keys($wanted_code, '', $_configuration['db_prefix']);
 | 
						|
        if (!count($keys)) {
 | 
						|
            return false;
 | 
						|
        }
 | 
						|
        $visual_code = $keys['currentCourseCode'];
 | 
						|
        $code = $keys['currentCourseId'];
 | 
						|
        $db_name = $keys['currentCourseDbName'];
 | 
						|
        $directory = $keys['currentCourseRepository'];
 | 
						|
 | 
						|
        $sql = sprintf('INSERT INTO %s (
 | 
						|
                code, user_id, directory, db_name,
 | 
						|
                course_language, title, description, category_code,
 | 
						|
                tutor_name, visual_code, request_date,
 | 
						|
                objetives, target_audience, status, info, exemplary_content)
 | 
						|
            VALUES (
 | 
						|
                "%s", "%s", "%s", "%s",
 | 
						|
                "%s", "%s", "%s", "%s",
 | 
						|
                "%s", "%s", "%s",
 | 
						|
                "%s", "%s", "%s", "%s", "%s");', Database::get_main_table(TABLE_MAIN_COURSE_REQUEST),
 | 
						|
                Database::escape_string($code), Database::escape_string($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($objetives), Database::escape_string($target_audience), Database::escape_string($status), Database::escape_string($info), Database::escape_string($exemplary_content));
 | 
						|
        $result_sql = Database::query($sql);
 | 
						|
 | 
						|
        if (!$result_sql) {
 | 
						|
            return false;
 | 
						|
        }
 | 
						|
        $last_insert_id = Database::get_last_insert_id();
 | 
						|
 | 
						|
        // E-mail notifications.
 | 
						|
 | 
						|
        // 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('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).': '.$objetives."\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 = get_setting('emailAdministrator');
 | 
						|
 | 
						|
        @api_mail($recipient_name_admin, $recipient_email_admin, $email_subject, $email_body_admin, $sender_name_teacher, $sender_email_teacher);
 | 
						|
 | 
						|
        // Sending an e-mail to the requestor.
 | 
						|
 | 
						|
        $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($recipient_name_teacher, $recipient_email_teacher, $email_subject, $email_body_teacher, $sender_name_admin, $sender_email_admin);
 | 
						|
 | 
						|
        return $last_insert_id;
 | 
						|
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Updates a given course request in the database.
 | 
						|
     * @param int/string $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 $objetives
 | 
						|
     * @param string $target_audience
 | 
						|
     * @param int/string $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, $objetives, $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's 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'];
 | 
						|
        $db_name = $course_request_info['db_name'];
 | 
						|
        $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 = define_course_keys($wanted_code, '', $_configuration['db_prefix']);
 | 
						|
            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);
 | 
						|
            }
 | 
						|
        }
 | 
						|
 | 
						|
        $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), Database::escape_string($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($objetives), Database::escape_string($target_audience), Database::escape_string($status), Database::escape_string($info), Database::escape_string($exemplary_content));
 | 
						|
        $result_sql = Database::query($sql);
 | 
						|
 | 
						|
        return $result_sql !== false;
 | 
						|
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Deletes a given course request.
 | 
						|
     * @param int/string $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 $result !== false;
 | 
						|
    }
 | 
						|
 | 
						|
    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/string $id              The id (an integer number) of the corresponding database record.
 | 
						|
     * @return array/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/string $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/string $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.
 | 
						|
 | 
						|
        $wanted_code = $course_request_info['code'];
 | 
						|
        if (CourseManager::course_code_exists($wanted_code)) {
 | 
						|
            return false;
 | 
						|
        }
 | 
						|
 | 
						|
        $title = $course_request_info['title'];
 | 
						|
        $category_code = $course_request_info['category_code'];
 | 
						|
        $course_language = $course_request_info['course_language'];
 | 
						|
        $exemplary_content = intval($course_request_info['exemplary_content']) > 0;
 | 
						|
 | 
						|
        $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;
 | 
						|
        }
 | 
						|
        $tutor_name = api_get_person_name($user_info['firstname'], $user_info['lastname'], null, null, $course_language);
 | 
						|
 | 
						|
        // Create the requested course.
 | 
						|
 | 
						|
        $keys = define_course_keys($wanted_code, '', $_configuration['db_prefix']);
 | 
						|
        if (!count($keys)) {
 | 
						|
            return false;
 | 
						|
        }
 | 
						|
        $visual_code = $keys['currentCourseCode'];
 | 
						|
        $code = $keys['currentCourseId'];
 | 
						|
        $db_name = $keys['currentCourseDbName'];
 | 
						|
        $directory = $keys['currentCourseRepository'];
 | 
						|
        $expiration_date = time() + $firstExpirationDelay;
 | 
						|
        prepare_course_repository($directory, $code);
 | 
						|
        update_Db_course($db_name);
 | 
						|
        $pictures_array = fill_course_repository($directory, $exemplary_content);
 | 
						|
        fill_Db_course($db_name, $directory, $course_language, $pictures_array, $exemplary_content);
 | 
						|
        register_course($code, $visual_code, $directory, $db_name, $tutor_name, $category_code, $title, $course_language, $user_id, $expiration_date);
 | 
						|
 | 
						|
        // 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 = $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;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Rejects a given course request.
 | 
						|
     * @param int/string $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 (Database::query($sql) === false) {
 | 
						|
            return false;
 | 
						|
        }
 | 
						|
 | 
						|
        // E-mail notification.
 | 
						|
 | 
						|
        // 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('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 = 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 true;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Asks the author (through e-mail) for additional information about the given course request.
 | 
						|
     * @param int/string $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 = $course_language;
 | 
						|
        //$email_language = api_get_interface_language();
 | 
						|
        $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'), 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;
 | 
						|
 | 
						|
        $result = @api_mail($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 = Database::query($sql) !== false;
 | 
						|
 | 
						|
        return $result;
 | 
						|
    }
 | 
						|
 | 
						|
    /**
 | 
						|
     * Checks whether additional information about the given course request has been asked.
 | 
						|
     * @param int/string $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);
 | 
						|
    }
 | 
						|
 | 
						|
}
 | 
						|
 |