, Ghent University * @assert ('') === false */ public static function get_course_information($course_code) { return Database::fetch_array( Database::query( "SELECT *, id as real_id FROM ".Database::get_main_table(TABLE_MAIN_COURSE)." WHERE code = '".Database::escape_string($course_code)."'" ), 'ASSOC' ); } /** * Returns a list of courses. Should work with quickform syntax. * * @param int $from Offset (from the 7th = '6'). Optional. * @param int $howmany Number of results we want. Optional. * @param string $orderby The column we want to order it by. Optional, defaults to first column. * @param string $orderdirection The direction of the order (ASC or DESC). Optional, defaults to ASC. * @param int $visibility the visibility of the course, or all by default * @param string $startwith If defined, only return results for which the course *title* begins with this * string * @param string $urlId The Access URL ID, if using multiple URLs * @param bool $alsoSearchCode An extension option to indicate that we also want to search for course codes * (not *only* titles) * @param array $conditionsLike * @param array $onlyThisCourseList * * @return array */ public static function get_courses_list( $from = 0, $howmany = 0, $orderby = 'title', $orderdirection = 'ASC', $visibility = -1, $startwith = '', $urlId = null, $alsoSearchCode = false, $conditionsLike = [], $onlyThisCourseList = [] ) { $courseTable = Database::get_main_table(TABLE_MAIN_COURSE); $sql = "SELECT course.*, course.id as real_id FROM $courseTable course "; if (!empty($urlId)) { $table = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_COURSE); $sql .= " INNER JOIN $table url ON (url.c_id = course.id) "; } $visibility = (int) $visibility; if (!empty($startwith)) { $sql .= "WHERE (title LIKE '".Database::escape_string($startwith)."%' "; if ($alsoSearchCode) { $sql .= "OR code LIKE '".Database::escape_string($startwith)."%' "; } $sql .= ') '; if (-1 !== $visibility) { $sql .= " AND visibility = $visibility "; } } else { $sql .= 'WHERE 1 '; if (-1 !== $visibility) { $sql .= " AND visibility = $visibility "; } } if (!empty($urlId)) { $urlId = (int) $urlId; $sql .= " AND access_url_id = $urlId"; } if (!empty($onlyThisCourseList)) { $onlyThisCourseList = array_map('intval', $onlyThisCourseList); $onlyThisCourseList = implode("','", $onlyThisCourseList); $sql .= " AND course.id IN ('$onlyThisCourseList') "; } $allowedFields = [ 'title', 'code', ]; if (count($conditionsLike) > 0) { $sql .= ' AND '; $temp_conditions = []; foreach ($conditionsLike as $field => $value) { if (!in_array($field, $allowedFields)) { continue; } $field = Database::escape_string($field); $value = Database::escape_string($value); $simple_like = false; if ($simple_like) { $temp_conditions[] = $field." LIKE '$value%'"; } else { $temp_conditions[] = $field.' LIKE \'%'.$value.'%\''; } } $condition = ' AND '; if (!empty($temp_conditions)) { $sql .= implode(' '.$condition.' ', $temp_conditions); } } if (empty($orderby)) { $sql .= ' ORDER BY title '; } else { if (in_array($orderby, ['title'])) { $sql .= " ORDER BY `".Database::escape_string($orderby)."` "; } else { $sql .= ' ORDER BY title '; } } $orderdirection = strtoupper($orderdirection); if (!in_array($orderdirection, ['ASC', 'DESC'])) { $sql .= 'ASC'; } else { $sql .= 'ASC' === $orderdirection ? 'ASC' : 'DESC'; } $howmany = (int) $howmany; if (!empty($howmany)) { $sql .= ' LIMIT '.$howmany; } else { $sql .= ' LIMIT 1000000'; //virtually no limit } if (!empty($from)) { $from = intval($from); $sql .= ' OFFSET '.intval($from); } else { $sql .= ' OFFSET 0'; } $data = []; $res = Database::query($sql); if (Database::num_rows($res) > 0) { while ($row = Database::fetch_assoc($res)) { $data[] = $row; } } return $data; } /** * Returns the status of a user in a course, which is COURSEMANAGER or STUDENT. * * @param int $userId * @param int $courseId * * @return int|bool the status of the user in that course (or false if the user is not in that course) */ public static function getUserInCourseStatus($userId, $courseId) { $courseId = (int) $courseId; $userId = (int) $userId; if (empty($courseId)) { return false; } $result = Database::fetch_array( Database::query( "SELECT status FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE c_id = $courseId AND user_id = $userId" ) ); if (empty($result['status'])) { return false; } return $result['status']; } /** * @param int $userId * @param int $courseId * * @return mixed */ public static function getUserCourseInfo($userId, $courseId) { $sql = "SELECT * FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE c_id = ".intval($courseId)." AND user_id = ".intval($userId); return Database::fetch_array(Database::query($sql)); } /** * @param int $userId * @param int $courseId * @param bool $isTutor * * @return bool */ public static function updateUserCourseTutor($userId, $courseId, $isTutor) { $table = Database::escape_string(TABLE_MAIN_COURSE_USER); $courseId = (int) $courseId; $isTutor = (int) $isTutor; $sql = "UPDATE $table SET is_tutor = '".$isTutor."' WHERE user_id = ".$userId." AND c_id = ".$courseId; $result = Database::query($sql); if (Database::affected_rows($result) > 0) { return true; } return false; } /** * @param int $userId * @param int $courseId * * @return mixed */ public static function get_tutor_in_course_status($userId, $courseId) { $userId = intval($userId); $courseId = intval($courseId); $result = Database::fetch_array( Database::query( "SELECT is_tutor FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE c_id = $courseId AND user_id = $userId" ) ); return $result['is_tutor']; } /** * Unsubscribe one or more users from a course. * * @param mixed user_id or an array with user ids * @param string course code * @param int session id * * @return bool * * @assert ('', '') === false */ public static function unsubscribe_user($user_id, $course_code, $session_id = 0) { if (empty($user_id)) { return false; } if (!is_array($user_id)) { $user_id = [$user_id]; } if (0 == count($user_id)) { return false; } if (!empty($session_id)) { $session_id = (int) $session_id; } else { $session_id = api_get_session_id(); } if (empty($course_code)) { return false; } $userList = []; // Cleaning the $user_id variable if (is_array($user_id)) { $new_user_id_list = []; foreach ($user_id as $my_user_id) { $new_user_id_list[] = (int) $my_user_id; } $new_user_id_list = array_filter($new_user_id_list); $userList = $new_user_id_list; $user_ids = implode(',', $new_user_id_list); } else { $user_ids = (int) $user_id; $userList[] = $user_id; } $course_info = api_get_course_info($course_code); $course_id = $course_info['real_id']; // Unsubscribe user from all groups in the course. $sql = "DELETE FROM ".Database::get_course_table(TABLE_GROUP_USER)." WHERE c_id = $course_id AND user_id IN (".$user_ids.")"; Database::query($sql); $sql = "DELETE FROM ".Database::get_course_table(TABLE_GROUP_TUTOR)." WHERE c_id = $course_id AND user_id IN (".$user_ids.")"; Database::query($sql); // Erase user student publications (works) in the course - by André Boivin // @todo this should be handled by doctrine. /*if (!empty($userList)) { foreach ($userList as $userId) { // Getting all work from user $workList = getWorkPerUser($userId); if (!empty($workList)) { foreach ($workList as $work) { $work = $work['work']; // Getting user results if (!empty($work->user_results)) { foreach ($work->user_results as $workSent) { deleteWorkItem($workSent['id'], $course_info); } } } } } }*/ // Unsubscribe user from all blogs in the course. /*$sql = "DELETE FROM ".Database::get_course_table(TABLE_BLOGS_REL_USER)." WHERE c_id = $course_id AND user_id IN ($user_ids)"; Database::query($sql); $sql = "DELETE FROM ".Database::get_course_table(TABLE_BLOGS_TASKS_REL_USER)." WHERE c_id = $course_id AND user_id IN ($user_ids)"; Database::query($sql);*/ // Deleting users in forum_notification and mailqueue course tables $sql = "DELETE FROM ".Database::get_course_table(TABLE_FORUM_NOTIFICATION)." WHERE c_id = $course_id AND user_id IN ($user_ids)"; Database::query($sql); $sql = "DELETE FROM ".Database::get_course_table(TABLE_FORUM_MAIL_QUEUE)." WHERE c_id = $course_id AND user_id IN ($user_ids)"; Database::query($sql); // Unsubscribe user from the course. if (!empty($session_id)) { foreach ($userList as $uid) { SessionManager::unSubscribeUserFromCourseSession($uid, $course_id, $session_id); // check if a user is register in the session with other course $sql = "SELECT user_id FROM ".Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER)." WHERE session_id = $session_id AND user_id = $uid"; $rs = Database::query($sql); if (0 == Database::num_rows($rs)) { SessionManager::unsubscribe_user_from_session($uid, $session_id); } } $user_id = api_get_user_id(); Event::addEvent( LOG_UNSUBSCRIBE_USER_FROM_COURSE, LOG_COURSE_CODE, $course_code, api_get_utc_datetime(), $user_id, $course_id, $session_id ); } else { $sql = "DELETE FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE user_id IN ($user_ids) AND relation_type <> ".COURSE_RELATION_TYPE_RRHH." AND c_id = $course_id"; Database::query($sql); // add event to system log $user_id = api_get_user_id(); Event::addEvent( LOG_UNSUBSCRIBE_USER_FROM_COURSE, LOG_COURSE_CODE, $course_code, api_get_utc_datetime(), $user_id, $course_id ); foreach ($userList as $userId) { $userInfo = api_get_user_info($userId); Event::addEvent( LOG_UNSUBSCRIBE_USER_FROM_COURSE, LOG_USER_OBJECT, $userInfo, api_get_utc_datetime(), $user_id, $course_id ); } } if ('true' === api_get_setting('session.catalog_course_subscription_in_user_s_session')) { // Also unlink the course from the users' currently accessible sessions /** @var Course $course */ $course = Container::getCourseRepository()->findOneBy([ 'code' => $course_code, ]); if (is_null($course)) { return false; } /** @var Chamilo\CoreBundle\Entity\User $user */ foreach (UserManager::getRepository()->matching( Criteria::create()->where(Criteria::expr()->in('id', $userList)) ) as $user) { foreach ($user->getCurrentlyAccessibleSessions() as $session) { $session->removeCourse($course); // unsubscribe user from course within this session SessionManager::unSubscribeUserFromCourseSession($user->getId(), $course->getId(), $session->getId()); } } try { Database::getManager()->flush(); } catch (\Doctrine\ORM\OptimisticLockException $exception) { Display::addFlash( Display::return_message( get_lang('InternalDatabaseError').': '.$exception->getMessage(), 'warning' ) ); return false; } } return true; } /** * @param string $courseCode * @param int $status * * @return bool */ public static function autoSubscribeToCourse($courseCode, $status = STUDENT) { if (api_is_anonymous()) { return false; } $course = Container::getCourseRepository()->findOneBy(['code' => $courseCode]); if (null === $course) { return false; } $visibility = (int) $course->getVisibility(); if (in_array($visibility, [ Course::CLOSED, //Course::REGISTERED, Course::HIDDEN, ])) { Display::addFlash( Display::return_message( get_lang('SubscribingNotAllowed'), 'warning' ) ); return false; } // Private course can allow auto subscription if (Course::REGISTERED === $visibility && false === $course->getSubscribe()) { Display::addFlash( Display::return_message( get_lang('Subscribing not allowed'), 'warning' ) ); return false; } $userId = api_get_user_id(); if ('true' === api_get_setting('session.catalog_course_subscription_in_user_s_session')) { $user = api_get_user_entity($userId); $sessions = $user->getCurrentlyAccessibleSessions(); if (empty($sessions)) { // user has no accessible session if ($user->getSessionsAsStudent()) { // user has ancient or future student session(s) but not available now Display::addFlash( Display::return_message( get_lang('CanNotSubscribeToCourseUserSessionExpired'), 'warning' ) ); return false; } // user has no session at all, create one starting now $numberOfDays = (int) api_get_setting('session.user_s_session_duration'); try { $duration = new DateInterval(sprintf('P%dD', $numberOfDays)); } catch (Exception $exception) { Display::addFlash( Display::return_message( get_lang('WrongNumberOfDays').': '.$numberOfDays.': '.$exception->getMessage(), 'warning' ) ); return false; } $endDate = new DateTime(); $endDate->add($duration); $session = new SessionEntity(); $session->setTitle( sprintf(get_lang('FirstnameLastnameCourses'), $user->getFirstname(), $user->getLastname()) ); $session->setAccessEndDate($endDate); $session->setCoachAccessEndDate($endDate); $session->setDisplayEndDate($endDate); $session->setSendSubscriptionNotification(false); $adminId = (int) api_get_setting('session.session_automatic_creation_user_id'); $session->addSessionAdmin(api_get_user_entity($adminId)); $session->addUserInSession(0, $user); Database::getManager()->persist($session); try { Database::getManager()->flush(); } catch (\Doctrine\ORM\OptimisticLockException $exception) { Display::addFlash( Display::return_message( get_lang('InternalDatabaseError').': '.$exception->getMessage(), 'warning' ) ); return false; } $accessUrlRelSession = new AccessUrlRelSession(); $accessUrlRelSession->setUrl(api_get_url_entity()); $accessUrlRelSession->setSession($session); Database::getManager()->persist($accessUrlRelSession); try { Database::getManager()->flush(); } catch (\Doctrine\ORM\OptimisticLockException $exception) { Display::addFlash( Display::return_message( get_lang('InternalDatabaseError').': '.$exception->getMessage(), 'warning' ) ); return false; } } else { // user has at least one accessible session, let's use it $session = $sessions[0]; } // add chosen course to the user session $session->addCourse($course); Database::getManager()->persist($session); try { Database::getManager()->flush(); } catch (\Doctrine\ORM\OptimisticLockException $exception) { Display::addFlash( Display::return_message( get_lang('InternalDatabaseError').': '.$exception->getMessage(), 'warning' ) ); return false; } // subscribe user to course within this session SessionManager::subscribe_users_to_session_course([$userId], $session->getId(), $course->getCode()); return true; } return self::subscribeUser($userId, $course->getId(), $status, 0); } /** * Checks if the current user can subscribe to a given course. */ public static function canUserSubscribeToCourse(string $courseCode): bool { if (api_is_anonymous()) { return false; } $course = Container::getCourseRepository()->findOneBy(['code' => $courseCode]); if (null === $course) { return false; } $visibility = (int) $course->getVisibility(); if (in_array($visibility, [ Course::CLOSED, Course::HIDDEN, ])) { return false; } if (Course::REGISTERED === $visibility && false === $course->getSubscribe()) { return false; } $userId = api_get_user_id(); $sql = "SELECT * FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE user_id = $userId AND relation_type <> ".COURSE_RELATION_TYPE_RRHH." AND c_id = ".$course->getId(); if (Database::num_rows(Database::query($sql)) > 0) { return false; } if (SUBSCRIBE_NOT_ALLOWED === (int) $course->getSubscribe()) { return false; } $extraFieldValue = new ExtraFieldValue('course'); $value = $extraFieldValue->get_values_by_handler_and_field_variable( $course->getId(), 'max_subscribed_students' ); if (!empty($value) && isset($value['value']) && '' !== $value['value']) { $maxStudents = (int) $value['value']; $count = CourseManager::get_user_list_from_course_code( $courseCode, 0, null, null, STUDENT, true, false ); if ($count >= $maxStudents) { return false; } } if ('true' === api_get_setting('session.catalog_course_subscription_in_user_s_session')) { $user = api_get_user_entity($userId); $sessions = $user->getCurrentlyAccessibleSessions(); if (empty($sessions) && $user->getSessionsAsStudent()) { return false; } } return true; } /** * Subscribe a user to a course. No checks are performed here to see if * course subscription is allowed. * * @param int $userId * @param int $courseId * @param int $status (STUDENT, COURSEMANAGER, COURSE_ADMIN, NORMAL_COURSE_MEMBER) * @param int $sessionId * @param int $userCourseCategoryId * @param bool $checkTeacherPermission * * @return bool True on success, false on failure * * @assert ('', '') === false */ public static function subscribeUser( $userId, $courseId, $status = STUDENT, $sessionId = 0, $userCourseCategoryId = 0, $checkTeacherPermission = true ) { $userId = (int) $userId; $status = (int) $status; if (empty($userId) || empty($courseId)) { return false; } $course = api_get_course_entity($courseId); if (null === $course) { Display::addFlash(Display::return_message(get_lang('This course doesn\'t exist'), 'warning')); return false; } $user = api_get_user_entity($userId); if (null === $user) { Display::addFlash(Display::return_message(get_lang('This user doesn\'t exist'), 'warning')); return false; } $courseCode = $course->getCode(); $userCourseCategoryId = (int) $userCourseCategoryId; $sessionId = empty($sessionId) ? api_get_session_id() : (int) $sessionId; $status = STUDENT === $status || COURSEMANAGER === $status ? $status : STUDENT; if (!empty($sessionId)) { SessionManager::subscribe_users_to_session_course( [$userId], $sessionId, $courseCode ); return true; } else { // Check whether the user has not been already subscribed to the course. $sql = "SELECT * FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE user_id = $userId AND relation_type <> ".COURSE_RELATION_TYPE_RRHH." AND c_id = $courseId "; if (Database::num_rows(Database::query($sql)) > 0) { Display::addFlash(Display::return_message(get_lang('Already registered in course'), 'warning')); return false; } if ($checkTeacherPermission && !api_is_course_admin()) { // Check in advance whether subscription is allowed or not for this course. if (SUBSCRIBE_NOT_ALLOWED === (int) $course->getSubscribe()) { Display::addFlash(Display::return_message(get_lang('Subscription not allowed'), 'warning')); return false; } } if (STUDENT === $status) { // Check if max students per course extra field is set $extraFieldValue = new ExtraFieldValue('course'); $value = $extraFieldValue->get_values_by_handler_and_field_variable( $courseId, 'max_subscribed_students' ); if (!empty($value) && isset($value['value']) && '' !== $value['value']) { $maxStudents = (int) $value['value']; $count = self::get_user_list_from_course_code( $courseCode, 0, null, null, STUDENT, true, false ); if ($count >= $maxStudents) { Display::addFlash( Display::return_message( get_lang( 'The maximum number of student has already been reached, it is not possible to subscribe more student.' ), 'warning' ) ); return false; } } } $maxSort = api_max_sort_value(0, $userId) + 1; $insertId = self::insertUserInCourse( $user, $course, ['status' => $status, 'sort' => $maxSort, 'user_course_cat' => $userCourseCategoryId] ); if ($insertId) { Display::addFlash( Display::return_message( sprintf( get_lang('User %s has been registered to course %s'), UserManager::formatUserFullName($user, true), $course->getTitle() ) ) ); $send = (int) api_get_course_setting('email_alert_to_teacher_on_new_user_in_course', $course); if (1 === $send) { self::email_to_tutor( $userId, $courseId, false ); } elseif (2 === $send) { self::email_to_tutor( $userId, $courseId, true ); } $subscribe = (int) api_get_course_setting('subscribe_users_to_forum_notifications', $course); if (1 === $subscribe) { /*$forums = get_forums(0, true, $sessionId); foreach ($forums as $forum) { set_notification('forum', $forum->getIid(), false, $userInfo, $courseInfo); }*/ } return true; } return false; } } /** * Get the course id based on the original id and field name in the * extra fields. Returns 0 if course was not found. * * @param string $original_course_id_value * @param string $original_course_id_name * * @return int Course id * * @assert ('', '') === false */ public static function get_course_code_from_original_id( $original_course_id_value, $original_course_id_name ) { $t_cfv = Database::get_main_table(TABLE_EXTRA_FIELD_VALUES); $table_field = Database::get_main_table(TABLE_EXTRA_FIELD); $extraFieldType = EntityExtraField::COURSE_FIELD_TYPE; $original_course_id_value = Database::escape_string($original_course_id_value); $original_course_id_name = Database::escape_string($original_course_id_name); $sql = "SELECT item_id FROM $table_field cf INNER JOIN $t_cfv cfv ON cfv.field_id=cf.id WHERE variable = '$original_course_id_name' AND value = '$original_course_id_value' AND cf.item_type = $extraFieldType "; $res = Database::query($sql); $row = Database::fetch_object($res); if ($row) { return $row->item_id; } else { return 0; } } /** * Gets the course code from the course id. Returns null if course id was not found. * * @param int $id Course id * * @return string Course code * @assert ('') === false */ public static function get_course_code_from_course_id($id) { $table = Database::get_main_table(TABLE_MAIN_COURSE); $id = intval($id); $sql = "SELECT code FROM $table WHERE id = $id "; $res = Database::query($sql); $row = Database::fetch_object($res); if ($row) { return $row->code; } else { return null; } } /** * Add the user $userId visibility to the course $courseCode in the catalogue. * * @author David Nos (https://github.com/dnos) * * @param int $userId the id of the user * @param string $courseCode the course code * @param int $visible (optional) The course visibility in the catalogue to the user (1=visible, 0=invisible) * * @return bool true if added succesfully, false otherwise */ public static function addUserVisibilityToCourseInCatalogue( $userId, $courseCode, $visible = 1 ) { $debug = false; $userTable = Database::get_main_table(TABLE_MAIN_USER); $courseUserTable = Database::get_main_table(TABLE_MAIN_COURSE_CATALOGUE_USER); $visible = (int) $visible; if (empty($userId) || empty($courseCode) || ($userId != strval(intval($userId)))) { return false; } $courseCode = Database::escape_string($courseCode); $courseInfo = api_get_course_info($courseCode); $courseId = $courseInfo['real_id']; // Check in advance whether the user has already been registered on the platform. $sql = "SELECT status FROM ".$userTable." WHERE user_id = $userId "; if (0 == Database::num_rows(Database::query($sql))) { return false; // The user has not been registered to the platform. } // Check whether the user has already been registered to the course visibility in the catalogue. $sql = "SELECT * FROM $courseUserTable WHERE user_id = $userId AND visible = $visible AND c_id = $courseId"; if (Database::num_rows(Database::query($sql)) > 0) { return true; // The visibility of the user to the course in the catalogue does already exist. } // Register the user visibility to course in catalogue. $params = [ 'user_id' => $userId, 'c_id' => $courseId, 'visible' => $visible, ]; return Database::insert($courseUserTable, $params); } /** * Remove the user $userId visibility to the course $courseCode in the catalogue. * * @author David Nos (https://github.com/dnos) * * @param int $userId the id of the user * @param string $courseCode the course code * @param int $visible (optional) The course visibility in the catalogue to the user (1=visible, 0=invisible) * * @return bool true if removed succesfully or register not found, false otherwise */ public static function removeUserVisibilityToCourseInCatalogue( $userId, $courseCode, $visible = 1 ) { $courseUserTable = Database::get_main_table(TABLE_MAIN_COURSE_CATALOGUE_USER); if (empty($userId) || empty($courseCode) || ($userId != strval(intval($userId)))) { return false; } $courseCode = Database::escape_string($courseCode); $courseInfo = api_get_course_info($courseCode); $courseId = $courseInfo['real_id']; // Check whether the user has already been registered to the course visibility in the catalogue. $sql = "SELECT * FROM $courseUserTable WHERE user_id = $userId AND visible = $visible AND c_id = $courseId"; if (Database::num_rows(Database::query($sql)) > 0) { $cond = [ 'user_id = ? AND c_id = ? AND visible = ? ' => [ $userId, $courseId, $visible, ], ]; return Database::delete($courseUserTable, $cond); } else { return true; // Register does not exist } } /** * @param string $code * * @return bool if there already are one or more courses * with the same code OR visual_code (visualcode), false otherwise */ public static function course_code_exists($code) { $code = Database::escape_string($code); $sql = "SELECT COUNT(*) as number FROM ".Database::get_main_table(TABLE_MAIN_COURSE)." WHERE code = '$code' OR visual_code = '$code'"; $result = Database::fetch_array(Database::query($sql)); return $result['number'] > 0; } /** * @param int $userId * @param string $keyword * * @return array an array with the course info of all the courses (real and virtual) * of which the current user is course admin */ public static function get_course_list_of_user_as_course_admin($userId, $keyword = ''): array { $user = api_get_user_entity($userId); if (null === $user) { return []; } $url = api_get_url_entity(); $repo = Container::getCourseRepository(); return $repo->getCoursesInfoByUser($user, $url, COURSEMANAGER, $keyword); } /** * @param int $userId * @param array $courseInfo * * @return bool|null */ public static function isUserSubscribedInCourseAsDrh($userId, $courseInfo) { $userId = intval($userId); if (!api_is_drh()) { return false; } if (empty($courseInfo) || empty($userId)) { return false; } $courseId = intval($courseInfo['real_id']); $table = Database::get_main_table(TABLE_MAIN_COURSE_USER); $sql = "SELECT * FROM $table WHERE user_id = $userId AND relation_type = ".COURSE_RELATION_TYPE_RRHH." AND c_id = $courseId"; $result = Database::fetch_array(Database::query($sql)); if (!empty($result)) { // The user has been registered in this course. return true; } } /** * Check if user is subscribed inside a course. * * @param int $userId * @param string $course_code , if this parameter is null, it'll check for all courses * @param bool $in_a_session True for checking inside sessions too, by default is not checked * @param int $session_id * * @return bool $session_id true if the user is registered in the course, false otherwise */ public static function is_user_subscribed_in_course( $userId, $course_code = null, $in_a_session = false, $session_id = 0 ) { $userId = (int) $userId; $session_id = (int) $session_id; if ('true' === api_get_setting('session.catalog_course_subscription_in_user_s_session')) { // with this option activated, only check whether the course is in one of the users' sessions $course = Container::getCourseRepository()->findOneBy([ 'code' => $course_code, ]); if (is_null($course)) { return false; } $user = api_get_user_entity($userId); if (is_null($user)) { return false; } foreach ($user->getSessionsAsStudent() as $session) { if ($session->hasCourse($course)) { return true; } } return false; } if (empty($session_id)) { $session_id = api_get_session_id(); } $condition_course = ''; if (isset($course_code)) { $courseInfo = api_get_course_info($course_code); if (empty($courseInfo)) { return false; } $courseId = $courseInfo['real_id']; $condition_course = " AND c_id = $courseId"; } $sql = "SELECT * FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE user_id = $userId AND relation_type<>".COURSE_RELATION_TYPE_RRHH." $condition_course "; $result = Database::fetch_array(Database::query($sql)); if (!empty($result)) { // The user has been registered in this course. return true; } if (!$in_a_session) { // The user has not been registered in this course. return false; } $tableSessionCourseUser = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER); $sql = "SELECT 1 FROM $tableSessionCourseUser WHERE user_id = $userId AND session_id = $session_id $condition_course"; if (Database::num_rows(Database::query($sql)) > 0) { return true; } $sql = "SELECT 1 FROM $tableSessionCourseUser WHERE user_id = $userId AND session_id = $session_id AND status = ".SessionEntity::COURSE_COACH." $condition_course"; if (Database::num_rows(Database::query($sql)) > 0) { return true; } $sql = "SELECT s.id FROM ".Database::get_main_table(TABLE_MAIN_SESSION)." s INNER JOIN ".Database::get_main_table(TABLE_MAIN_SESSION_USER)." sru ON (sru.session_id = s.id AND sru.relation_type = ".SessionEntity::GENERAL_COACH.") WHERE sru.user_id = $userId AND s.id = $session_id"; if (Database::num_rows(Database::query($sql)) > 0) { return true; } return false; } /** * Is the user a teacher in the given course? * * @param int $userId * @param int $courseId * * @return bool if the user is a teacher in the course, false otherwise */ public static function isCourseTeacher($userId, $courseId) { $userId = (int) $userId; $courseId = (int) $courseId; if (empty($courseId) || empty($userId)) { return false; } $sql = "SELECT status FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." WHERE c_id = $courseId AND user_id = $userId "; $result = Database::query($sql); if (Database::num_rows($result) > 0) { return 1 == Database::result($result, 0, 'status'); } return false; } /** * Get user info array of all users registered in a course, by course code. * Wrapper: This method calls getUserListFromCourseId() in the background. * @param string|null $courseCode Cours code is allowed to be null if we want all users * @param int $sessionId * @param string $limit * @param string $order_by the field to order the users by. * Valid values are 'lastname', 'firstname', 'username', 'email', * 'official_code' OR a part of a SQL statement that starts with ORDER BY ... * @param int|null $filter_by_status if using the session_id: 0 or 2 (student, coach), * if using session_id = 0 STUDENT or COURSEMANAGER * @param bool|null $return_count * @param bool $add_reports * @param bool $resumed_report * @param array $extra_field * @param array $courseCodeList * @param array $userIdList * @param bool $filterByActive * @param array $sessionIdList * @param string $searchByKeyword * * @return array|int * @throws Exception */ public static function get_user_list_from_course_code( $courseCode, $sessionId = 0, $limit = null, $order_by = null, $filter_by_status = null, $return_count = null, $add_reports = false, $resumed_report = false, $extra_field = [], $courseCodeList = [], $userIdList = [], $filterByActive = null, $sessionIdList = [], $searchByKeyword = '', $options = [] ) { $courseId = api_get_course_int_id($courseCode); return self::getUserListFromCourseId( $courseId, $sessionId, $limit, $order_by, $filter_by_status, $return_count, $add_reports, $resumed_report, $extra_field, $courseCodeList, $userIdList, $filterByActive, $sessionIdList, $searchByKeyword, $options ); } /** * Return user info array of all users registered in a course (by course ID and session ID). * This only returns the users that are registered in this actual course, not linked courses. * * @param ?int $courseCode Course ID is allowed to be null if we want all users * @param ?int $sessionId * @param ?string $limit * @param ?string $order_by the field to order the users by. * Valid values are 'lastname', 'firstname', 'username', 'email', * 'official_code' OR a part of a SQL statement that starts with ORDER BY ... * @param ?int $filter_by_status if using the session_id: 0 or 2 (student, coach), * if using session_id = 0 STUDENT or COURSEMANAGER * @param ?bool $return_count * @param ?bool $add_reports * @param ?bool $resumed_report * @param ?array $extra_field * @param ?array $courseCodeList * @param ?array $userIdList * @param ?bool $filterByActive * @param ?array $sessionIdList * @param ?string $searchByKeyword * @param ?array * * @return array|int * @throws Exception */ public static function getUserListFromCourseId( ?int $courseId = null, ?int $sessionId = 0, ?string $limit = null, ?string $order_by = null, ?int $filter_by_status = null, ?bool $return_count = null, ?bool $add_reports = false, ?bool $resumed_report = false, ?array $extra_field = [], ?array $courseIdsList = [], ?array $userIdList = [], ?bool $filterByActive = null, ?array $sessionIdList = [], ?string $searchByKeyword = '', ?array $options = [] ) { $course_table = Database::get_main_table(TABLE_MAIN_COURSE); $sessionTable = Database::get_main_table(TABLE_MAIN_SESSION); $sessionId = (int) $sessionId; $session = null; if (!empty($sessionId)) { $session = api_get_session_entity($sessionId); } $where = []; if (empty($order_by)) { $order_by = 'user.lastname, user.firstname'; if (api_is_western_name_order()) { $order_by = 'user.firstname, user.lastname'; } } // if the $order_by does not contain 'ORDER BY' // we have to check if it is a valid field that can be sorted on if (!strstr($order_by, 'ORDER BY')) { if (!empty($order_by)) { $order_by = "ORDER BY $order_by"; } else { $order_by = ''; } } $filter_by_status_condition = null; $whereExtraField = ''; $injectExtraFields = ' , '; $sqlInjectJoins = ''; if (!empty($options)) { $extraFieldModel = new ExtraField('user'); $conditions = $extraFieldModel->parseConditions($options, 'user'); if (!empty($conditions)) { $injectExtraFields = $conditions['inject_extra_fields']; if (!empty($injectExtraFields)) { $injectExtraFields = ', '.$injectExtraFields; } else { $injectExtraFields = ' , '; } $sqlInjectJoins = $conditions['inject_joins']; $whereExtraField = $conditions['where']; } } if (!empty($sessionId) || !empty($sessionIdList)) { $sql = 'SELECT DISTINCT user.id as user_id, user.email, session_course_user.status as status_session, session_id, user.*, course.*, course.id AS c_id '.$injectExtraFields.' session.title as session_name '; if ($return_count) { $sql = ' SELECT COUNT(user.id) as count'; } $sessionCondition = " session_course_user.session_id = $sessionId"; if (!empty($sessionIdList)) { $sessionIdListToString = implode("','", array_map('intval', $sessionIdList)); $sessionCondition = " session_course_user.session_id IN ('$sessionIdListToString') "; } $courseCondition = " course.id IS NOT NULL "; if (!empty($courseId)) { $courseCondition = " course.id = $courseId"; } if (!empty($courseCodeList)) { $courseCodeListForSession = array_map(['Database', 'escape_string'], $courseCodeList); $courseCodeListForSession = implode("','", $courseCodeListForSession); $courseCondition = " course.code IN ('$courseCodeListForSession') "; } $sql .= ' FROM '.Database::get_main_table(TABLE_MAIN_USER).' as user '; $sql .= " LEFT JOIN ".Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER)." as session_course_user ON user.id = session_course_user.user_id AND $sessionCondition INNER JOIN $course_table course ON session_course_user.c_id = course.id AND $courseCondition INNER JOIN $sessionTable session ON session_course_user.session_id = session.id $sqlInjectJoins "; $where[] = ' session_course_user.c_id IS NOT NULL '; // 2 = coach // 0 = student if (isset($filter_by_status)) { $filter_by_status_condition = " session_course_user.status = $filter_by_status AND "; } } else { if ($return_count) { $sql = " SELECT COUNT(*) as count"; } else { if (empty($courseCode)) { $sql = 'SELECT DISTINCT course.title, course.code, course.id AS c_id, course_rel_user.status as status_rel, user.id as user_id, user.email, course_rel_user.is_tutor '.$injectExtraFields.' user.* '; } else { $sql = 'SELECT DISTINCT course_rel_user.status as status_rel, user.id as user_id, user.email, course_rel_user.is_tutor '.$injectExtraFields.' user.* '; } } $sql .= " FROM ".Database::get_main_table(TABLE_MAIN_USER)." as user LEFT JOIN ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." as course_rel_user ON user.id = course_rel_user.user_id AND course_rel_user.relation_type <> ".COURSE_RELATION_TYPE_RRHH." INNER JOIN $course_table course ON (course_rel_user.c_id = course.id) $sqlInjectJoins "; if (!empty($courseId)) { $sql .= " AND course_rel_user.c_id = $courseId"; } $where[] = ' course_rel_user.c_id IS NOT NULL '; if (isset($filter_by_status)) { $filter_by_status_condition = " course_rel_user.status = $filter_by_status AND "; } } $multiple_access_url = api_get_multiple_access_url(); if ($multiple_access_url) { $sql .= ' LEFT JOIN '.Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_USER).' au ON (au.user_id = user.id) '; } $extraFieldWasAdded = false; if ($return_count && $resumed_report) { foreach ($extra_field as $extraField) { $extraFieldInfo = UserManager::get_extra_field_information_by_name($extraField); if (!empty($extraFieldInfo)) { $fieldValuesTable = Database::get_main_table(TABLE_EXTRA_FIELD_VALUES); $sql .= " LEFT JOIN $fieldValuesTable as ufv ON ( user.id = ufv.item_id AND (field_id = ".$extraFieldInfo['id']." OR field_id IS NULL) )"; $extraFieldWasAdded = true; } } } $sql .= " WHERE user.active <> ".USER_SOFT_DELETED." AND $filter_by_status_condition ".implode(' OR ', $where); if ($multiple_access_url) { $current_access_url_id = api_get_current_access_url_id(); $sql .= " AND (access_url_id = $current_access_url_id ) "; } if ($return_count && $resumed_report && $extraFieldWasAdded) { $sql .= ' AND field_id IS NOT NULL GROUP BY value '; } if (!empty($courseIdsList)) { $courseIdsList = array_map('intval', $courseIdsList); $courseIdsList = implode('","', $courseIdsList); if (empty($sessionIdList)) { $sql .= ' AND course.id IN ("'.$courseIdsList.'")'; } } if (!empty($userIdList)) { $userIdList = array_map('intval', $userIdList); $userIdList = implode('","', $userIdList); $sql .= ' AND user.id IN ("'.$userIdList.'")'; } if (isset($filterByActive)) { $filterByActive = (int) $filterByActive; $sql .= " AND user.active = $filterByActive"; } if (!empty($searchByKeyword)) { $searchByKeyword = Database::escape_string($searchByKeyword); $sql .= " AND ( user.firstname LIKE '$searchByKeyword' OR user.username LIKE '$searchByKeyword' OR user.lastname LIKE '$searchByKeyword' ) "; } $sql .= $whereExtraField; $sql .= " $order_by $limit"; $rs = Database::query($sql); $users = []; $extra_fields = UserManager::get_extra_fields( 0, 100, null, null, true, true ); $counter = 1; $count_rows = Database::num_rows($rs); if ($return_count && $resumed_report) { return $count_rows; } $table_user_field_value = Database::get_main_table(TABLE_EXTRA_FIELD_VALUES); $tableExtraField = Database::get_main_table(TABLE_EXTRA_FIELD); if ($count_rows) { while ($user = Database::fetch_array($rs)) { if ($return_count) { return $user['count']; } $report_info = []; $user_info = $user; $user_info['status'] = $user['status']; if (isset($user['is_tutor'])) { $user_info['is_tutor'] = $user['is_tutor']; } if (!empty($sessionId)) { $user_info['status_session'] = $user['status_session']; } $sessionId = $user['session_id'] ?? 0; $sessionName = isset($user['session_name']) ? ' ('.$user['session_name'].') ' : ''; if ($add_reports) { if ($resumed_report) { $extra = []; if (!empty($extra_fields)) { foreach ($extra_fields as $extra) { if (in_array($extra['1'], $extra_field)) { $user_data = UserManager::get_extra_user_data_by_field( $user['user_id'], $extra['1'] ); break; } } } $row_key = '-1'; $name = '-'; if (!empty($extra)) { if (!empty($user_data[$extra['1']])) { $row_key = $user_data[$extra['1']]; $name = $user_data[$extra['1']]; $users[$row_key]['extra_'.$extra['1']] = $name; } } if (empty($users[$row_key])) { $users[$row_key] = []; } if (!array_key_exists('training_hours', $users[$row_key])) { $users[$row_key]['training_hours'] = 0; } $users[$row_key]['training_hours'] += Tracking::get_time_spent_on_the_course( $user['user_id'], $user['c_id'], $sessionId ); if (!array_key_exists('count_users', $users[$row_key])) { $users[$row_key]['count_users'] = 0; } $users[$row_key]['count_users'] += $counter; $registered_users_with_extra_field = self::getCountRegisteredUsersWithCourseExtraField( $name, $tableExtraField, $table_user_field_value ); $users[$row_key]['count_users_registered'] = $registered_users_with_extra_field; $users[$row_key]['average_hours_per_user'] = $users[$row_key]['training_hours'] / $users[$row_key]['count_users']; $category = Category::load( null, null, $user['c_id'], null, null, $sessionId ); if (!isset($users[$row_key]['count_certificates'])) { $users[$row_key]['count_certificates'] = 0; } if (isset($category[0]) && $category[0]->is_certificate_available($user['user_id'])) { $users[$row_key]['count_certificates']++; } foreach ($extra_fields as $extra) { if ('ruc' === $extra['1']) { continue; } if (!isset($users[$row_key][$extra['1']])) { $user_data = UserManager::get_extra_user_data_by_field($user['user_id'], $extra['1']); if (!empty($user_data[$extra['1']])) { $users[$row_key][$extra['1']] = $user_data[$extra['1']]; } } } } else { $report_info['course'] = $user['title'].$sessionName; $report_info['user'] = api_get_person_name($user['firstname'], $user['lastname']); $report_info['email'] = $user['email']; $report_info['time'] = api_time_to_hms( Tracking::get_time_spent_on_the_course( $user['user_id'], $user['c_id'], $sessionId ) ); $category = Category:: load( null, null, $user['c_id'], null, null, $sessionId ); $report_info['certificate'] = Display::label(get_lang('No')); if (isset($category[0]) && $category[0]->is_certificate_available($user['user_id'])) { $report_info['certificate'] = Display::label(get_lang('Yes'), 'success'); } $course = api_get_course_entity($user['c_id']); $progress = (int) Tracking::get_avg_student_progress( $user['user_id'], $course, [], $session ); $report_info['progress_100'] = 100 == $progress ? Display::label(get_lang('Yes'), 'success') : Display::label(get_lang('No')); $report_info['progress'] = $progress."%"; foreach ($extra_fields as $extra) { $user_data = UserManager::get_extra_user_data_by_field($user['user_id'], $extra['1']); $report_info[$extra['1']] = $user_data[$extra['1']]; } $report_info['user_id'] = $user['user_id']; $users[] = $report_info; } } else { $users[$user['user_id']] = $user_info; } } } return $users; } /** * @param bool $resumed_report * @param array $extra_field * @param array $courseCodeList * @param array $userIdList * @param array $sessionIdList * @param array $options * * @return array|int */ public static function get_count_user_list_from_course_code( $resumed_report = false, $extra_field = [], $courseCodeList = [], $userIdList = [], $sessionIdList = [], $options = [] ) { return self::get_user_list_from_course_code( null, 0, null, null, null, true, false, $resumed_report, $extra_field, $courseCodeList, $userIdList, null, $sessionIdList, null, $options ); } /** * Gets subscribed users in a course or in a course/session. * * @param string $course_code * @param int $session_id * * @return int */ public static function get_users_count_in_course( $course_code, $session_id = 0, $status = null ) { // variable initialisation $session_id = (int) $session_id; $course_code = Database::escape_string($course_code); $tblUser = Database::get_main_table(TABLE_MAIN_USER); $tblSessionCourseUser = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER); $tblCourseUser = Database::get_main_table(TABLE_MAIN_COURSE_USER); $tblUrlUser = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_USER); $courseInfo = api_get_course_info($course_code); $courseId = $courseInfo['real_id']; $sql = " SELECT DISTINCT count(user.id) as count FROM $tblUser as user "; $where = []; if (!empty($session_id)) { $sql .= " LEFT JOIN $tblSessionCourseUser as session_course_user ON user.id = session_course_user.user_id AND session_course_user.c_id = $courseId AND session_course_user.session_id = $session_id "; $where[] = ' session_course_user.c_id IS NOT NULL '; } else { $sql .= " LEFT JOIN $tblCourseUser as course_rel_user ON user.id = course_rel_user.user_id AND course_rel_user.relation_type <> ".COURSE_RELATION_TYPE_RRHH." AND course_rel_user.c_id = $courseId "; $where[] = ' course_rel_user.c_id IS NOT NULL '; } $multiple_access_url = api_get_multiple_access_url(); if ($multiple_access_url) { $sql .= " LEFT JOIN $tblUrlUser au ON (au.user_id = user.id) "; } $sql .= ' WHERE user.active <> '.USER_SOFT_DELETED.' AND '.implode(' OR ', $where); if ($multiple_access_url) { $current_access_url_id = api_get_current_access_url_id(); $sql .= " AND (access_url_id = $current_access_url_id ) "; } $rs = Database::query($sql); $count = 0; if (Database::num_rows($rs)) { $user = Database::fetch_array($rs); $count = $user['count']; } return $count; } /** * Get a list of coaches of a course and a session. * * @param string $course_code * @param int $session_id * @param bool $addGeneralCoach * * @return array List of users */ public static function get_coach_list_from_course_code( $course_code, $session_id, $addGeneralCoach = true ) { if (empty($course_code) || empty($session_id)) { return []; } $course_code = Database::escape_string($course_code); $courseInfo = api_get_course_info($course_code); $courseId = $courseInfo['real_id']; $session_id = (int) $session_id; $users = []; // We get the coach for the given course in a given session. $sql = 'SELECT user_id FROM '.Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER). " WHERE session_id = $session_id AND c_id = $courseId AND status = ".SessionEntity::COURSE_COACH; $rs = Database::query($sql); while ($user = Database::fetch_array($rs)) { $userInfo = api_get_user_info($user['user_id']); if ($userInfo) { $users[$user['user_id']] = $userInfo; } } if ($addGeneralCoach) { $generalCoachesId = SessionManager::getGeneralCoachesIdForSession($session_id); foreach ($generalCoachesId as $session_id_coach) { $userInfo = api_get_user_info($session_id_coach); if ($userInfo) { $users[$session_id_coach] = $userInfo; } } } return $users; } /** * Return user info array of all users registered in a course * This only returns the users that are registered in this actual course, not linked courses. * * @param string $course_code * @param bool $with_session * @param int $sessionId * @param string $date_from * @param string $date_to * @param bool $includeInvitedUsers Whether include the invited users * @param int $groupId * @param bool $getCount * @param int $start * @param int $limit * * @return array with user id */ public static function get_student_list_from_course_code( $course_code, $with_session = false, $sessionId = 0, $date_from = null, $date_to = null, $includeInvitedUsers = true, $groupId = 0, $getCount = false, $start = 0, $limit = 0 ) { $userTable = Database::get_main_table(TABLE_MAIN_USER); $sessionId = (int) $sessionId; $courseInfo = api_get_course_info($course_code); if (empty($courseInfo)) { return []; } $courseId = $courseInfo['real_id']; $students = []; $limitCondition = ''; if (isset($start) && isset($limit) && !empty($limit)) { $start = (int) $start; $limit = (int) $limit; $limitCondition = " LIMIT $start, $limit"; } $select = '*'; if ($getCount) { $select = 'count(u.id) as count'; } if (empty($sessionId)) { if (empty($groupId)) { // students directly subscribed to the course $sql = "SELECT $select FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." cu INNER JOIN $userTable u ON cu.user_id = u.id WHERE u.active <> ".USER_SOFT_DELETED." AND c_id = $courseId AND cu.status = ".STUDENT; if (!$includeInvitedUsers) { $sql .= " AND u.status != ".INVITEE; } $sql .= $limitCondition; $rs = Database::query($sql); if ($getCount) { $row = Database::fetch_array($rs); return (int) $row['count']; } while ($student = Database::fetch_array($rs)) { $students[$student['user_id']] = $student; } } else { $students = GroupManager::get_users( $groupId, false, $start, $limit, $getCount, $courseInfo['real_id'] ); $students = array_flip($students); } } // students subscribed to the course through a session if ($with_session) { $joinSession = ''; //Session creation date if (!empty($date_from) && !empty($date_to)) { $joinSession = "INNER JOIN ".Database::get_main_table(TABLE_MAIN_SESSION)." s"; } $sql = "SELECT $select FROM ".Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER)." scu $joinSession INNER JOIN $userTable u ON scu.user_id = u.id WHERE u.active <> ".USER_SOFT_DELETED." AND scu.c_id = $courseId AND scu.status = ".SessionEntity::STUDENT; if (!empty($date_from) && !empty($date_to)) { $date_from = Database::escape_string($date_from); $date_to = Database::escape_string($date_to); $sql .= " AND s.access_start_date >= '$date_from' AND s.access_end_date <= '$date_to'"; } if (0 != $sessionId) { $sql .= " AND scu.session_id = $sessionId"; } if (!$includeInvitedUsers) { $sql .= " AND u.status != ".INVITEE; } $sql .= $limitCondition; $rs = Database::query($sql); if ($getCount) { $row = Database::fetch_array($rs); return (int) $row['count']; } while ($student = Database::fetch_array($rs)) { $students[$student['user_id']] = $student; } } return $students; } /** * Return user info array of all teacher-users registered in a course * This only returns the users that are registered in this actual course, not linked courses. * * @param string $course_code * * @return array with user id */ public static function get_teacher_list_from_course_code($course_code) { $courseInfo = api_get_course_info($course_code); $courseId = $courseInfo['real_id']; if (empty($courseId)) { return false; } $sql = "SELECT DISTINCT u.id as user_id, u.lastname, u.firstname, u.email, u.username, u.status FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." cu INNER JOIN ".Database::get_main_table(TABLE_MAIN_USER)." u ON (cu.user_id = u.id) WHERE cu.c_id = $courseId AND cu.status = 1 "; $rs = Database::query($sql); $teachers = []; while ($teacher = Database::fetch_array($rs)) { $teachers[$teacher['user_id']] = $teacher; } return $teachers; } /** * Return user info array of all teacher-users registered in a course * This only returns the users that are registered in this actual course, not linked courses. * * @param int $courseId * @param bool $loadAvatars * * @return array with user id */ public static function getTeachersFromCourse($courseId, $loadAvatars = true) { $courseId = (int) $courseId; if (empty($courseId)) { return false; } $sql = "SELECT DISTINCT u.id as user_id, u.lastname, u.firstname, u.email, u.username, u.status FROM ".Database::get_main_table(TABLE_MAIN_COURSE_USER)." cu INNER JOIN ".Database::get_main_table(TABLE_MAIN_USER)." u ON (cu.user_id = u.id) WHERE cu.c_id = $courseId AND cu.status = 1 "; $rs = Database::query($sql); $listTeachers = []; $teachers = []; $url = api_get_path(WEB_AJAX_PATH).'user_manager.ajax.php?a=get_user_popup&course_id='.$courseId; while ($teacher = Database::fetch_array($rs)) { $teachers['id'] = $teacher['user_id']; $teachers['lastname'] = $teacher['lastname']; $teachers['firstname'] = $teacher['firstname']; $teachers['email'] = $teacher['email']; $teachers['username'] = $teacher['username']; $teachers['status'] = $teacher['status']; $teachers['fullname'] = api_get_person_name($teacher['firstname'], $teacher['lastname']); $teachers['avatar'] = ''; /*if ($loadAvatars) { $userPicture = UserManager::getUserPicture($teacher['user_id'], USER_IMAGE_SIZE_SMALL); $teachers['avatar'] = $userPicture; }*/ $teachers['url'] = $url.'&user_id='.$teacher['user_id']; $listTeachers[] = $teachers; } return $listTeachers; } /** * Returns a string list of teachers assigned to the given course. * * @param string $course_code * @param string $separator between teachers names * @param bool $add_link_to_profile Whether to add a link to the teacher's profile * @param bool $orderList * * @return string List of teachers teaching the course */ public static function getTeacherListFromCourseCodeToString( $course_code, $separator = self::USER_SEPARATOR, $add_link_to_profile = false, $orderList = false ) { $teacher_list = self::get_teacher_list_from_course_code($course_code); $html = ''; $list = []; if (!empty($teacher_list)) { foreach ($teacher_list as $teacher) { $teacher_name = api_get_person_name( $teacher['firstname'], $teacher['lastname'] ); if ($add_link_to_profile) { $url = api_get_path(WEB_AJAX_PATH).'user_manager.ajax.php?a=get_user_popup&user_id='.$teacher['user_id']; $teacher_name = Display::url( $teacher_name, $url, [ 'class' => 'ajax', 'data-title' => $teacher_name, ] ); } $list[] = $teacher_name; } if (!empty($list)) { if (true === $orderList) { $html .= '
$wanted_code = 'curse' if there are in the DB codes like curse1 curse2 the function will return:
* course3
if the course code doest not exist in the DB the same course code will be returned
*
* @return string wanted unused code
*/
public static function generate_nice_next_course_code($wanted_code)
{
$course_code_ok = !self::course_code_exists($wanted_code);
if (!$course_code_ok) {
$wanted_code = self::generate_course_code($wanted_code);
$table = Database::get_main_table(TABLE_MAIN_COURSE);
$wanted_code = Database::escape_string($wanted_code);
$sql = "SELECT count(id) as count
FROM $table
WHERE code LIKE '$wanted_code%'";
$result = Database::query($sql);
if (Database::num_rows($result) > 0) {
$row = Database::fetch_array($result);
$count = $row['count'] + 1;
$wanted_code = $wanted_code.'_'.$count;
$result = api_get_course_info($wanted_code);
if (empty($result)) {
return $wanted_code;
}
}
return false;
}
return $wanted_code;
}
/**
* Gets the status of the users agreement in a course course-session.
*
* @param int $user_id
* @param string $course_code
* @param int $session_id
*
* @return bool
*/
public static function is_user_accepted_legal($user_id, $course_code, $session_id = 0)
{
$user_id = (int) $user_id;
$session_id = (int) $session_id;
$course_code = Database::escape_string($course_code);
$courseInfo = api_get_course_info($course_code);
$courseId = $courseInfo['real_id'];
// Course legal
$enabled = api_get_plugin_setting('courselegal', 'tool_enable');
if ('true' == $enabled) {
require_once api_get_path(SYS_PLUGIN_PATH).'courselegal/config.php';
$plugin = CourseLegalPlugin::create();
return $plugin->isUserAcceptedLegal($user_id, $course_code, $session_id);
}
if (empty($session_id)) {
$table = Database::get_main_table(TABLE_MAIN_COURSE_USER);
$sql = "SELECT legal_agreement FROM $table
WHERE user_id = $user_id AND c_id = $courseId ";
$result = Database::query($sql);
if (Database::num_rows($result) > 0) {
$result = Database::fetch_array($result);
if (1 == $result['legal_agreement']) {
return true;
}
}
return false;
} else {
$table = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
$sql = "SELECT legal_agreement FROM $table
WHERE user_id = $user_id AND c_id = $courseId AND session_id = $session_id";
$result = Database::query($sql);
if (Database::num_rows($result) > 0) {
$result = Database::fetch_array($result);
if (1 == $result['legal_agreement']) {
return true;
}
}
return false;
}
}
/**
* Saves the user-course legal agreement.
*
* @param int user id
* @param string course code
* @param int session id
*
* @return bool
*/
public static function save_user_legal($user_id, $courseInfo, $session_id = 0)
{
if (empty($courseInfo)) {
return false;
}
$course_code = $courseInfo['code'];
// Course plugin legal
$enabled = api_get_plugin_setting('courselegal', 'tool_enable');
if ('true' == $enabled) {
require_once api_get_path(SYS_PLUGIN_PATH).'courselegal/config.php';
$plugin = CourseLegalPlugin::create();
return $plugin->saveUserLegal($user_id, $course_code, $session_id);
}
$user_id = (int) $user_id;
$session_id = (int) $session_id;
$courseId = $courseInfo['real_id'];
if (empty($session_id)) {
$table = Database::get_main_table(TABLE_MAIN_COURSE_USER);
$sql = "UPDATE $table SET legal_agreement = '1'
WHERE user_id = $user_id AND c_id = $courseId ";
Database::query($sql);
} else {
$table = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
$sql = "UPDATE $table SET legal_agreement = '1'
WHERE user_id = $user_id AND c_id = $courseId AND session_id = $session_id";
Database::query($sql);
}
return true;
}
/**
* @param int $user_id
* @param int $course_id
* @param int $session_id
* @param int $url_id
*
* @return bool
*/
public static function get_user_course_vote($user_id, $course_id, $session_id = 0, $url_id = 0)
{
$table_user_course_vote = Database::get_main_table(TABLE_MAIN_USER_REL_COURSE_VOTE);
$session_id = !isset($session_id) ? api_get_session_id() : intval($session_id);
$url_id = empty($url_id) ? api_get_current_access_url_id() : intval($url_id);
$user_id = intval($user_id);
if (empty($user_id)) {
return false;
}
$params = [
'user_id' => $user_id,
'c_id' => $course_id,
'session_id' => $session_id,
'url_id' => $url_id,
];
$result = Database::select(
'vote',
$table_user_course_vote,
[
'where' => [
'user_id = ? AND c_id = ? AND session_id = ? AND url_id = ?' => $params,
],
],
'first'
);
if (!empty($result)) {
return $result['vote'];
}
return false;
}
/**
* @param int $course_id
* @param int $session_id
* @param int $url_id
*
* @return array
*/
public static function get_course_ranking(
$course_id,
$session_id = 0,
$url_id = 0
) {
$table_course_ranking = Database::get_main_table(TABLE_STATISTIC_TRACK_COURSE_RANKING);
$session_id = empty($session_id) ? api_get_session_id() : intval($session_id);
$url_id = empty($url_id) ? api_get_current_access_url_id() : intval($url_id);
$now = api_get_utc_datetime();
$params = [
'c_id' => $course_id,
'session_id' => $session_id,
'url_id' => $url_id,
'creation_date' => $now,
];
$result = Database::select(
'c_id, accesses, total_score, users',
$table_course_ranking,
['where' => ['c_id = ? AND session_id = ? AND url_id = ?' => $params]],
'first'
);
$point_average_in_percentage = 0;
$point_average_in_star = 0;
$users_who_voted = 0;
if (!empty($result['users'])) {
$users_who_voted = $result['users'];
$point_average_in_percentage = round($result['total_score'] / $result['users'] * 100 / 5, 2);
$point_average_in_star = round($result['total_score'] / $result['users'], 1);
}
$result['user_vote'] = false;
if (!api_is_anonymous()) {
$result['user_vote'] = self::get_user_course_vote(api_get_user_id(), $course_id, $session_id, $url_id);
}
$result['point_average'] = $point_average_in_percentage;
$result['point_average_star'] = $point_average_in_star;
$result['users_who_voted'] = $users_who_voted;
return $result;
}
/**
* Updates the course ranking.
*
* @param int course id
* @param int $session_id
* @param int url id
* @param $points_to_add
* @param bool $add_access
* @param bool $add_user
*
* @return array
*/
public static function update_course_ranking(
$course_id = 0,
$session_id = 0,
$url_id = 0,
$points_to_add = null,
$add_access = true,
$add_user = true
) {
// Course catalog stats modifications see #4191
$table_course_ranking = Database::get_main_table(TABLE_STATISTIC_TRACK_COURSE_RANKING);
$now = api_get_utc_datetime();
$course_id = empty($course_id) ? api_get_course_int_id() : intval($course_id);
$session_id = empty($session_id) ? api_get_session_id() : intval($session_id);
$url_id = empty($url_id) ? api_get_current_access_url_id() : intval($url_id);
$params = [
'c_id' => $course_id,
'session_id' => $session_id,
'url_id' => $url_id,
'creation_date' => $now,
'total_score' => 0,
'users' => 0,
];
$result = Database::select(
'id, accesses, total_score, users',
$table_course_ranking,
['where' => ['c_id = ? AND session_id = ? AND url_id = ?' => $params]],
'first'
);
// Problem here every time we load the courses/XXXX/index.php course home page we update the access
if (empty($result)) {
if ($add_access) {
$params['accesses'] = 1;
}
//The votes and users are empty
if (isset($points_to_add) && !empty($points_to_add)) {
$params['total_score'] = intval($points_to_add);
}
if ($add_user) {
$params['users'] = 1;
}
$result = Database::insert($table_course_ranking, $params);
} else {
$my_params = [];
if ($add_access) {
$my_params['accesses'] = intval($result['accesses']) + 1;
}
if (isset($points_to_add) && !empty($points_to_add)) {
$my_params['total_score'] = $result['total_score'] + $points_to_add;
}
if ($add_user) {
$my_params['users'] = $result['users'] + 1;
}
if (!empty($my_params)) {
$result = Database::update(
$table_course_ranking,
$my_params,
['c_id = ? AND session_id = ? AND url_id = ?' => $params]
);
}
}
return $result;
}
/**
* Add user vote to a course.
*
* @param int user id
* @param int vote [1..5]
* @param int course id
* @param int session id
* @param int url id (access_url_id)
*
* @return false|string 'added', 'updated' or 'nothing'
*/
public static function add_course_vote(
$user_id,
$vote,
$course_id,
$session_id = 0,
$url_id = 0
) {
$table_user_course_vote = Database::get_main_table(TABLE_MAIN_USER_REL_COURSE_VOTE);
$course_id = empty($course_id) ? api_get_course_int_id() : intval($course_id);
if (empty($course_id) || empty($user_id)) {
return false;
}
if (!in_array($vote, [1, 2, 3, 4, 5])) {
return false;
}
$session_id = empty($session_id) ? api_get_session_id() : intval($session_id);
$url_id = empty($url_id) ? api_get_current_access_url_id() : intval($url_id);
$vote = intval($vote);
$params = [
'user_id' => intval($user_id),
'c_id' => $course_id,
'session_id' => $session_id,
'url_id' => $url_id,
'vote' => $vote,
];
$action_done = 'nothing';
$result = Database::select(
'id, vote',
$table_user_course_vote,
['where' => ['user_id = ? AND c_id = ? AND session_id = ? AND url_id = ?' => $params]],
'first'
);
if (empty($result)) {
Database::insert($table_user_course_vote, $params);
$points_to_add = $vote;
$add_user = true;
$action_done = 'added';
} else {
$my_params = ['vote' => $vote];
$points_to_add = $vote - $result['vote'];
$add_user = false;
Database::update(
$table_user_course_vote,
$my_params,
['user_id = ? AND c_id = ? AND session_id = ? AND url_id = ?' => $params]
);
$action_done = 'updated';
}
// Current points
if (!empty($points_to_add)) {
self::update_course_ranking(
$course_id,
$session_id,
$url_id,
$points_to_add,
false,
$add_user
);
}
return $action_done;
}
/**
* Remove course ranking + user votes.
*
* @param int $course_id
* @param int $session_id
* @param int $url_id
*/
public static function remove_course_ranking($course_id, $session_id, $url_id = null)
{
$table_course_ranking = Database::get_main_table(TABLE_STATISTIC_TRACK_COURSE_RANKING);
$table_user_course_vote = Database::get_main_table(TABLE_MAIN_USER_REL_COURSE_VOTE);
if (!empty($course_id) && isset($session_id)) {
$url_id = empty($url_id) ? api_get_current_access_url_id() : intval($url_id);
$params = [
'c_id' => $course_id,
'session_id' => $session_id,
'url_id' => $url_id,
];
Database::delete($table_course_ranking, ['c_id = ? AND session_id = ? AND url_id = ?' => $params]);
Database::delete($table_user_course_vote, ['c_id = ? AND session_id = ? AND url_id = ?' => $params]);
}
}
/**
* Returns an array with the hottest courses.
*
* @param int $days number of days
* @param int $limit number of hottest courses
*
* @return array
*/
public static function return_hot_courses($days = 30, $limit = 6)
{
if (api_is_invitee()) {
return [];
}
$limit = (int) $limit;
$userId = api_get_user_id();
// Getting my courses
$my_course_list = self::get_courses_list_by_user_id($userId);
$codeList = [];
foreach ($my_course_list as $course) {
$codeList[$course['real_id']] = $course['real_id'];
}
if (api_is_drh()) {
$courses = self::get_courses_followed_by_drh($userId);
foreach ($courses as $course) {
$codeList[$course['real_id']] = $course['real_id'];
}
}
$table_course_access = Database::get_main_table(TABLE_STATISTIC_TRACK_E_COURSE_ACCESS);
$table_course = Database::get_main_table(TABLE_MAIN_COURSE);
$table_course_url = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_COURSE);
$urlId = api_get_current_access_url_id();
//$table_course_access table uses the now() and interval ...
$now = api_get_utc_datetime();
$sql = "SELECT COUNT(course_access_id) course_count, a.c_id, visibility
FROM $table_course c
INNER JOIN $table_course_access a
ON (c.id = a.c_id)
INNER JOIN $table_course_url u
ON u.c_id = c.id
WHERE
u.access_url_id = $urlId AND
login_course_date <= '$now' AND
login_course_date > DATE_SUB('$now', INTERVAL $days DAY) AND
visibility <> ".Course::CLOSED." AND
visibility <> ".Course::HIDDEN."
GROUP BY a.c_id
ORDER BY course_count DESC
LIMIT $limit
";
$result = Database::query($sql);
$courses = [];
if (Database::num_rows($result)) {
$courses = Database::store_result($result, 'ASSOC');
$courses = self::processHotCourseItem($courses, $codeList);
}
return $courses;
}
/**
* Returns an array with the "hand picked" popular courses.
* Courses only appear in this list if their extra field 'popular_courses'
* has been selected in the admin page of the course.
*
* @return array
*/
public static function returnPopularCoursesHandPicked()
{
if (api_is_invitee()) {
return [];
}
$userId = api_get_user_id();
// Getting my courses
$my_course_list = self::get_courses_list_by_user_id($userId);
$codeList = [];
foreach ($my_course_list as $course) {
$codeList[$course['real_id']] = $course['real_id'];
}
if (api_is_drh()) {
$courses = self::get_courses_followed_by_drh($userId);
foreach ($courses as $course) {
$codeList[$course['real_id']] = $course['real_id'];
}
}
$courseTable = Database::get_main_table(TABLE_MAIN_COURSE);
$tbl_course_field = Database::get_main_table(TABLE_EXTRA_FIELD);
$tbl_course_field_value = Database::get_main_table(TABLE_EXTRA_FIELD_VALUES);
//we filter the courses from the URL
$join_access_url = $where_access_url = '';
if (api_get_multiple_access_url()) {
$access_url_id = api_get_current_access_url_id();
if (-1 != $access_url_id) {
$tbl_url_course = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_COURSE);
$join_access_url = "LEFT JOIN $tbl_url_course url_rel_course
ON url_rel_course.c_id = tcfv.item_id ";
$where_access_url = " AND access_url_id = $access_url_id ";
}
}
$extraFieldType = EntityExtraField::COURSE_FIELD_TYPE;
// get course list auto-register
$sql = "SELECT DISTINCT(c.id) AS c_id
FROM $tbl_course_field_value tcfv
INNER JOIN $tbl_course_field tcf
ON tcfv.field_id = tcf.id $join_access_url
INNER JOIN $courseTable c
ON (c.id = tcfv.item_id)
WHERE
tcf.item_type = $extraFieldType AND
tcf.variable = 'popular_courses' AND
tcfv.field_value = 1 AND
visibility <> ".Course::CLOSED." AND
visibility <> ".Course::HIDDEN." $where_access_url";
$result = Database::query($sql);
$courses = [];
if (Database::num_rows($result)) {
$courses = Database::store_result($result, 'ASSOC');
$courses = self::processHotCourseItem($courses, $codeList);
}
return $courses;
}
/**
* @param array $courses
* @param array $codeList
*
* @return mixed
*/
public static function processHotCourseItem($courses, $codeList = [])
{
$hotCourses = [];
$ajax_url = api_get_path(WEB_AJAX_PATH).'course.ajax.php?a=add_course_vote';
$stok = Security::get_existing_token();
$user_id = api_get_user_id();
foreach ($courses as $courseId) {
$course_info = api_get_course_info_by_id($courseId['c_id']);
$courseCode = $course_info['code'];
$categoryCode = !empty($course_info['categoryCode']) ? $course_info['categoryCode'] : "";
$my_course = $course_info;
$my_course['go_to_course_button'] = '';
$my_course['register_button'] = '';
$access_link = self::get_access_link_by_user(
$user_id,
$course_info,
$codeList
);
$userRegisteredInCourse = self::is_user_subscribed_in_course($user_id, $course_info['code']);
$userRegisteredInCourseAsTeacher = self::isCourseTeacher($user_id, $courseId['c_id']);
$userRegistered = $userRegisteredInCourse && $userRegisteredInCourseAsTeacher;
$my_course['is_course_student'] = $userRegisteredInCourse;
$my_course['is_course_teacher'] = $userRegisteredInCourseAsTeacher;
$my_course['is_registered'] = $userRegistered;
$my_course['title_cut'] = cut($course_info['title'], 45);
// Course visibility
if ($access_link && in_array('register', $access_link)) {
$my_course['register_button'] = Display::url(
get_lang('Subscribe').' '.
Display::getMdiIcon('login'),
api_get_path(WEB_COURSE_PATH).$course_info['path'].
'/index.php?action=subscribe&sec_token='.$stok,
[
'class' => 'btn btn--success btn-sm',
'title' => get_lang('Subscribe'),
'aria-label' => get_lang('Subscribe'),
]
);
}
if ($access_link && in_array('enter', $access_link) ||
Course::OPEN_WORLD == $course_info['visibility']
) {
$my_course['go_to_course_button'] = Display::url(
get_lang('Go to the course').' '.
Display::getMdiIcon('share'),
api_get_path(WEB_COURSE_PATH).$course_info['path'].'/index.php',
[
'class' => 'btn btn--plain btn-sm',
'title' => get_lang('Go to the course'),
'aria-label' => get_lang('Go to the course'),
]
);
}
if ($access_link && in_array('unsubscribe', $access_link)) {
$my_course['unsubscribe_button'] = Display::url(
get_lang('Unsubscribe').' '.
Display::getMdiIcon('logout'),
api_get_path(WEB_CODE_PATH).'auth/courses.php?action=unsubscribe&unsubscribe='.$courseCode
.'&sec_token='.$stok.'&category_code='.$categoryCode,
[
'class' => 'btn btn--danger btn-sm',
'title' => get_lang('Unsubscribe'),
'aria-label' => get_lang('Unsubscribe'),
]
);
}
// start buycourse validation
// display the course price and buy button if the buycourses plugin is enabled and this course is configured
$plugin = BuyCoursesPlugin::create();
$isThisCourseInSale = $plugin->buyCoursesForGridCatalogValidator(
$course_info['real_id'],
BuyCoursesPlugin::PRODUCT_TYPE_COURSE
);
if ($isThisCourseInSale) {
// set the price label
$my_course['price'] = $isThisCourseInSale['html'];
// set the Buy button instead register.
if ($isThisCourseInSale['verificator'] && !empty($my_course['register_button'])) {
$my_course['register_button'] = $plugin->returnBuyCourseButton(
$course_info['real_id'],
BuyCoursesPlugin::PRODUCT_TYPE_COURSE
);
}
}
// end buycourse validation
// Description
$my_course['description_button'] = self::returnDescriptionButton($course_info);
$my_course['teachers'] = self::getTeachersFromCourse($course_info['real_id'], true);
$point_info = self::get_course_ranking($course_info['real_id'], 0);
$my_course['rating_html'] = '';
if (('false' === api_get_setting('course.hide_course_rating'))) {
$my_course['rating_html'] = Display::return_rating_system(
'star_'.$course_info['real_id'],
$ajax_url.'&course_id='.$course_info['real_id'],
$point_info
);
}
$hotCourses[] = $my_course;
}
return $hotCourses;
}
public function totalSubscribedUsersInCourses($urlId)
{
$table_course = Database::get_main_table(TABLE_MAIN_COURSE);
$table_course_rel_access_url = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_COURSE);
$courseUsers = Database::get_main_table(TABLE_MAIN_COURSE_USER);
$urlId = (int) $urlId;
$sql = "SELECT count(cu.user_id) count
FROM $courseUsers cu
INNER JOIN $table_course_rel_access_url u
ON cu.c_id = u.c_id
WHERE
relation_type <> ".COURSE_RELATION_TYPE_RRHH." AND
u.access_url_id = $urlId AND
visibility <> ".Course::CLOSED." AND
visibility <> ".Course::HIDDEN."
";
$res = Database::query($sql);
$row = Database::fetch_array($res);
return $row['count'];
}
/**
* Get courses count.
*
* @param int $access_url_id Access URL ID (optional)
* @param int $visibility
*
* @return int Number of courses
*/
public static function count_courses($access_url_id = null, $visibility = null)
{
$table_course = Database::get_main_table(TABLE_MAIN_COURSE);
$table_course_rel_access_url = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_COURSE);
$sql = "SELECT count(c.id) FROM $table_course c";
if (!empty($access_url_id) && $access_url_id == intval($access_url_id)) {
$sql .= ", $table_course_rel_access_url u
WHERE c.id = u.c_id AND u.access_url_id = $access_url_id";
if (!empty($visibility)) {
$visibility = intval($visibility);
$sql .= " AND visibility = $visibility ";
}
} else {
if (!empty($visibility)) {
$visibility = intval($visibility);
$sql .= " WHERE visibility = $visibility ";
}
}
$res = Database::query($sql);
$row = Database::fetch_row($res);
return $row[0];
}
/**
* Get active courses count.
* Active = all courses except the ones with hidden visibility.
*
* @param int $urlId Access URL ID (optional)
*
* @return int Number of courses
*/
public static function countActiveCourses($urlId = null)
{
$table_course = Database::get_main_table(TABLE_MAIN_COURSE);
$table_course_rel_access_url = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_COURSE);
$sql = "SELECT count(c.id) FROM $table_course c";
if (!empty($urlId)) {
$urlId = (int) $urlId;
$sql .= ", $table_course_rel_access_url u
WHERE
c.id = u.c_id AND
u.access_url_id = $urlId AND
visibility <> ".Course::HIDDEN;
} else {
$sql .= " WHERE visibility <> ".Course::HIDDEN;
}
$res = Database::query($sql);
$row = Database::fetch_row($res);
return $row[0];
}
/**
* Returns the SQL conditions to filter course only visible by the user in the catalogue.
*
* @param string $courseTableAlias Alias of the course table
* @param bool $hideClosed Whether to hide closed and hidden courses
* @param bool $checkHidePrivate
*
* @return string SQL conditions
*/
public static function getCourseVisibilitySQLCondition($courseTableAlias, $hideClosed = false, $checkHidePrivate = true)
{
$visibilityCondition = '';
if ($checkHidePrivate) {
$hidePrivateSetting = api_get_setting('course_catalog_hide_private');
if ('true' === $hidePrivateSetting) {
$visibilityCondition .= " AND $courseTableAlias.visibility <> ".Course::REGISTERED;
}
}
if ($hideClosed) {
$visibilityCondition .= " AND $courseTableAlias.visibility NOT IN (".Course::CLOSED.','.Course::HIDDEN.')';
}
// Check if course have users allowed to see it in the catalogue, then show only if current user is allowed to see it
$currentUserId = api_get_user_id();
$restrictedCourses = self::getCatalogCourseList(true);
$allowedCoursesToCurrentUser = self::getCatalogCourseList(true, $currentUserId);
if (!empty($restrictedCourses)) {
$visibilityCondition .= ' AND ('.$courseTableAlias.'.code NOT IN ("'.implode('","', $restrictedCourses).'")';
$visibilityCondition .= ' OR '.$courseTableAlias.'.code IN ("'.implode('","', $allowedCoursesToCurrentUser).'"))';
}
// Check if course have users denied to see it in the catalogue, then show only if current user is not denied to see it
$restrictedCourses = self::getCatalogCourseList(false);
$notAllowedCoursesToCurrentUser = self::getCatalogCourseList(false, $currentUserId);
if (!empty($restrictedCourses)) {
$visibilityCondition .= ' AND ('.$courseTableAlias.'.code NOT IN ("'.implode('","', $restrictedCourses).'")';
$visibilityCondition .= ' OR '.$courseTableAlias.'.code NOT IN ("'.implode('","', $notAllowedCoursesToCurrentUser).'"))';
}
return $visibilityCondition;
}
/**
* Return a link to go to the course, validating the visibility of the
* course and the user status.
*
* @param int $uid User ID
* @param array Course details array
* @param array List of courses to which the user is subscribed (if not provided, will be generated)
*
* @return mixed 'enter' for a link to go to the course or 'register' for a link to subscribe, or false if no access
*/
public static function get_access_link_by_user($uid, $course, $user_courses = [])
{
if (empty($uid) || empty($course)) {
return false;
}
if (empty($user_courses)) {
// get the array of courses to which the user is subscribed
$user_courses = self::get_courses_list_by_user_id($uid);
foreach ($user_courses as $k => $v) {
$user_courses[$k] = $v['real_id'];
}
}
if (!isset($course['real_id']) && empty($course['real_id'])) {
$course = api_get_course_info($course['code']);
}
if (Course::HIDDEN == $course['visibility']) {
return [];
}
$is_admin = api_is_platform_admin_by_id($uid);
$options = [];
// Register button
if (!api_is_anonymous($uid) &&
(
(Course::OPEN_WORLD == $course['visibility'] || Course::OPEN_PLATFORM == $course['visibility'])
//$course['visibility'] == Course::REGISTERED && $course['subscribe'] == SUBSCRIBE_ALLOWED
) &&
SUBSCRIBE_ALLOWED == $course['subscribe'] &&
(!in_array($course['real_id'], $user_courses) || empty($user_courses))
) {
$options[] = 'register';
}
$isLogin = !api_is_anonymous();
// Go To Course button (only if admin, if course public or if student already subscribed)
if ($is_admin ||
Course::OPEN_WORLD == $course['visibility'] && empty($course['registration_code']) ||
($isLogin && Course::OPEN_PLATFORM == $course['visibility'] && empty($course['registration_code'])) ||
(in_array($course['real_id'], $user_courses) && Course::CLOSED != $course['visibility'])
) {
$options[] = 'enter';
}
if ($is_admin ||
Course::OPEN_WORLD == $course['visibility'] && empty($course['registration_code']) ||
($isLogin && Course::OPEN_PLATFORM == $course['visibility'] && empty($course['registration_code'])) ||
(in_array($course['real_id'], $user_courses) && Course::CLOSED != $course['visibility'])
) {
$options[] = 'enter';
}
if (Course::HIDDEN != $course['visibility'] &&
empty($course['registration_code']) &&
UNSUBSCRIBE_ALLOWED == $course['unsubscribe'] &&
$isLogin &&
in_array($course['real_id'], $user_courses)
) {
$options[] = 'unsubscribe';
}
return $options;
}
/**
* @param array $courseInfo
* @param array $teachers
* @param bool $deleteTeachersNotInList
* @param bool $editTeacherInSessions
* @param bool $deleteSessionTeacherNotInList
* @param array $teacherBackup
* @param Monolog\Logger $logger
*
* @return false|null
*/
public static function updateTeachers(
$courseInfo,
$teachers,
$deleteTeachersNotInList = true,
$editTeacherInSessions = false,
$deleteSessionTeacherNotInList = false,
$teacherBackup = [],
$logger = null
) {
if (!is_array($teachers)) {
$teachers = [$teachers];
}
if (empty($courseInfo) || !isset($courseInfo['real_id'])) {
return false;
}
$teachers = array_filter($teachers);
$courseId = $courseInfo['real_id'];
$course_code = $courseInfo['code'];
$course_user_table = Database::get_main_table(TABLE_MAIN_COURSE_USER);
$alreadyAddedTeachers = self::get_teacher_list_from_course_code($course_code);
if ($deleteTeachersNotInList) {
// Delete only teacher relations that doesn't match the selected teachers
$cond = null;
if (count($teachers) > 0) {
foreach ($teachers as $key) {
$key = Database::escape_string($key);
$cond .= " AND user_id <> '".$key."'";
}
}
// Recover user categories
$sql = "SELECT * FROM $course_user_table
WHERE c_id = $courseId AND status = 1 AND relation_type = 0 ".$cond;
$result = Database::query($sql);
if (Database::num_rows($result)) {
$teachersToDelete = Database::store_result($result, 'ASSOC');
foreach ($teachersToDelete as $data) {
$userId = $data['user_id'];
$teacherBackup[$userId][$course_code] = $data;
}
}
$sql = "DELETE FROM $course_user_table
WHERE c_id = $courseId AND status = 1 AND relation_type = 0 ".$cond;
Database::query($sql);
}
if (count($teachers) > 0) {
foreach ($teachers as $userId) {
$userId = intval($userId);
// We check if the teacher is already subscribed in this course
$sql = "SELECT 1 FROM $course_user_table
WHERE user_id = $userId AND c_id = $courseId";
$result = Database::query($sql);
if (Database::num_rows($result)) {
$sql = "UPDATE $course_user_table
SET status = 1
WHERE c_id = $courseId AND user_id = $userId ";
} else {
$userCourseCategory = '0';
if (isset($teacherBackup[$userId]) &&
isset($teacherBackup[$userId][$course_code])
) {
$courseUserData = $teacherBackup[$userId][$course_code];
$userCourseCategory = $courseUserData['user_course_cat'];
if ($logger) {
$logger->debug("Recovering user_course_cat: $userCourseCategory");
}
}
$sql = "INSERT INTO $course_user_table SET
c_id = $courseId,
user_id = $userId,
status = 1,
is_tutor = 0,
sort = 0,
relation_type = 0,
user_course_cat = $userCourseCategory,
progress = 0
";
}
Database::query($sql);
}
}
if ($editTeacherInSessions) {
$sessions = SessionManager::get_session_by_course($courseId);
if (!empty($sessions)) {
if ($logger) {
$logger->debug("Edit teachers in sessions");
}
foreach ($sessions as $session) {
$sessionId = $session['id'];
// Remove old and add new
if ($deleteSessionTeacherNotInList) {
foreach ($teachers as $userId) {
if ($logger) {
$logger->debug("Set coach #$userId in session #$sessionId of course #$courseId ");
}
SessionManager::set_coach_to_course_session(
$userId,
$sessionId,
$courseId
);
}
$teachersToDelete = [];
if (!empty($alreadyAddedTeachers)) {
$teachersToDelete = array_diff(array_keys($alreadyAddedTeachers), $teachers);
}
if (!empty($teachersToDelete)) {
foreach ($teachersToDelete as $userId) {
if ($logger) {
$logger->debug("Delete coach #$userId in session #$sessionId of course #$courseId ");
}
SessionManager::set_coach_to_course_session(
$userId,
$sessionId,
$courseId,
true
);
}
}
} else {
// Add new teachers only
foreach ($teachers as $userId) {
if ($logger) {
$logger->debug("Add coach #$userId in session #$sessionId of course #$courseId ");
}
SessionManager::set_coach_to_course_session(
$userId,
$sessionId,
$courseId
);
}
}
}
}
}
}
/**
* Course available settings variables see c_course_setting table.
*
* @return array
*/
public static function getCourseSettingVariables(AppPlugin $appPlugin = null)
{
$pluginCourseSettings = [];
if ($appPlugin) {
$pluginCourseSettings = $appPlugin->getAllPluginCourseSettings();
}
$courseSettings = [
// Get allow_learning_path_theme from table
'allow_learning_path_theme',
// Get allow_open_chat_window from table
'allow_open_chat_window',
'allow_public_certificates',
// Get allow_user_edit_agenda from table
'allow_user_edit_agenda',
// Get allow_user_edit_announcement from table
'allow_user_edit_announcement',
// Get allow_user_image_forum from table
'allow_user_image_forum',
//Get allow show user list
'allow_user_view_user_list',
// Get course_theme from table
'course_theme',
//Get allow show user list
'display_info_advance_inside_homecourse',
'documents_default_visibility',
// Get send_mail_setting (work)from table
'email_alert_manager_on_new_doc',
// Get send_mail_setting (work)from table
'email_alert_manager_on_new_quiz',
// Get send_mail_setting (dropbox) from table
'email_alert_on_new_doc_dropbox',
'email_alert_students_on_new_homework',
// Get send_mail_setting (auth)from table
'email_alert_to_teacher_on_new_user_in_course',
'enable_lp_auto_launch',
'enable_exercise_auto_launch',
'enable_document_auto_launch',
'pdf_export_watermark_text',
'show_system_folders',
'exercise_invisible_in_session',
'enable_forum_auto_launch',
'show_course_in_user_language',
'email_to_teachers_on_new_work_feedback',
'student_delete_own_publication',
'hide_forum_notifications',
'quiz_question_limit_per_day',
'subscribe_users_to_forum_notifications',
];
$courseModels = ExerciseLib::getScoreModels();
if (!empty($courseModels)) {
$courseSettings[] = 'score_model_id';
}
$allowLPReturnLink = api_get_setting('allow_lp_return_link');
if ('true' === $allowLPReturnLink) {
$courseSettings[] = 'lp_return_link';
}
if (!empty($pluginCourseSettings)) {
$courseSettings = array_merge(
$courseSettings,
$pluginCourseSettings
);
}
return $courseSettings;
}
/**
* @param string $variable
* @param string|array $value
* @param int $courseId
*
* @return bool
*/
public static function saveCourseConfigurationSetting($variable, $value, $courseId, AppPlugin $appPlugin = null)
{
$settingList = self::getCourseSettingVariables($appPlugin);
if (!in_array($variable, $settingList)) {
return false;
}
$courseSettingTable = Database::get_course_table(TABLE_COURSE_SETTING);
if (is_array($value)) {
$value = implode(',', $value);
}
$settingFromDatabase = self::getCourseSetting($variable, $courseId);
if (!empty($settingFromDatabase)) {
// Update
Database::update(
$courseSettingTable,
['value' => $value],
['variable = ? AND c_id = ?' => [$variable, $courseId]]
);
/*if ($settingFromDatabase['value'] != $value) {
Event::addEvent(
LOG_COURSE_SETTINGS_CHANGED,
$variable,
$settingFromDatabase['value']." -> $value"
);
}*/
} else {
// Create
Database::insert(
$courseSettingTable,
[
'title' => $variable,
'value' => $value,
'c_id' => $courseId,
'variable' => $variable,
]
);
/*Event::addEvent(
LOG_COURSE_SETTINGS_CHANGED,
$variable,
$value
);*/
}
return true;
}
/**
* Get course setting.
*
* @param string $variable
* @param int $courseId
*
* @return array
*/
public static function getCourseSetting($variable, $courseId)
{
$courseSetting = Database::get_course_table(TABLE_COURSE_SETTING);
$courseId = (int) $courseId;
$variable = Database::escape_string($variable);
$sql = "SELECT variable, value FROM $courseSetting
WHERE c_id = $courseId AND variable = '$variable'";
$result = Database::query($sql);
return Database::fetch_array($result);
}
public static function saveSettingChanges($courseInfo, $params)
{
if (empty($courseInfo) || empty($params)) {
return false;
}
$userId = api_get_user_id();
$now = api_get_utc_datetime();
foreach ($params as $name => $value) {
$emptyValue = ' - ';
if (isset($courseInfo[$name]) && $courseInfo[$name] != $value) {
if ('' !== $courseInfo[$name]) {
$emptyValue = $courseInfo[$name];
}
$changedTo = $emptyValue.' -> '.$value;
Event::addEvent(
LOG_COURSE_SETTINGS_CHANGED,
$name,
$changedTo,
$now,
$userId,
$courseInfo['real_id']
);
}
}
return true;
}
/**
* Get information from the track_e_course_access table.
*
* @param int $courseId
* @param int $sessionId
* @param string $startDate
* @param string $endDate
*
* @return array
*/
public static function getCourseAccessPerCourseAndSession(
$courseId,
$sessionId,
$startDate,
$endDate
) {
$table = Database::get_main_table(TABLE_STATISTIC_TRACK_E_COURSE_ACCESS);
$courseId = (int) $courseId;
$sessionId = (int) $sessionId;
$startDate = Database::escape_string($startDate);
$endDate = Database::escape_string($endDate);
$sql = "SELECT * FROM $table
WHERE
c_id = $courseId AND
session_id = $sessionId AND
login_course_date BETWEEN '$startDate' AND '$endDate'
";
$result = Database::query($sql);
return Database::store_result($result);
}
/**
* Get login information from the track_e_course_access table, for any
* course in the given session.
*
* @param int $sessionId
* @param int $userId
*
* @return array
*/
public static function getFirstCourseAccessPerSessionAndUser($sessionId, $userId)
{
$sessionId = (int) $sessionId;
$userId = (int) $userId;
$table = Database::get_main_table(TABLE_STATISTIC_TRACK_E_COURSE_ACCESS);
$sql = "SELECT * FROM $table
WHERE session_id = $sessionId AND user_id = $userId
ORDER BY login_course_date ASC
LIMIT 1";
$result = Database::query($sql);
$courseAccess = [];
if (Database::num_rows($result)) {
$courseAccess = Database::fetch_assoc($result);
}
return $courseAccess;
}
/**
* @param int $courseId
* @param int $sessionId
* @param bool $getAllSessions
*
* @return mixed
*/
public static function getCountForum(
$courseId,
$sessionId = 0,
$getAllSessions = false
) {
$forum = Database::get_course_table(TABLE_FORUM);
if ($getAllSessions) {
$sql = "SELECT count(*) as count
FROM $forum f
WHERE f.c_id = %s";
} else {
$sql = "SELECT count(*) as count
FROM $forum f
WHERE f.c_id = %s and f.session_id = %s";
}
$sql = sprintf($sql, intval($courseId), intval($sessionId));
$result = Database::query($sql);
$row = Database::fetch_array($result);
return $row['count'];
}
/**
* @param int $userId
* @param int $courseId
* @param int $sessionId
*
* @return mixed
*/
public static function getCountPostInForumPerUser(
$userId,
$courseId,
$sessionId = 0
) {
$forum = Database::get_course_table(TABLE_FORUM);
$forum_post = Database::get_course_table(TABLE_FORUM_POST);
$sql = "SELECT count(distinct post_id) as count
FROM $forum_post p
INNER JOIN $forum f
ON f.forum_id = p.forum_id AND f.c_id = p.c_id
WHERE p.poster_id = %s and f.session_id = %s and p.c_id = %s";
$sql = sprintf(
$sql,
intval($userId),
intval($sessionId),
intval($courseId)
);
$result = Database::query($sql);
$row = Database::fetch_array($result);
return $row['count'];
}
/**
* @param int $userId
* @param int $courseId
* @param int $sessionId
*
* @return mixed
*/
public static function getCountForumPerUser(
$userId,
$courseId,
$sessionId = 0
) {
$forum = Database::get_course_table(TABLE_FORUM);
$forum_post = Database::get_course_table(TABLE_FORUM_POST);
$sql = "SELECT count(distinct f.forum_id) as count
FROM $forum_post p
INNER JOIN $forum f
ON f.forum_id = p.forum_id AND f.c_id = p.c_id
WHERE p.poster_id = %s and f.session_id = %s and p.c_id = %s";
$sql = sprintf(
$sql,
intval($userId),
intval($sessionId),
intval($courseId)
);
$result = Database::query($sql);
$row = Database::fetch_array($result);
return $row['count'];
}
/**
* Returns the course name from a given code.
*
* @param string $code
*
* @return string
*/
public static function getCourseNameFromCode($code)
{
$tbl_main_categories = Database::get_main_table(TABLE_MAIN_COURSE);
$code = Database::escape_string($code);
$sql = "SELECT title
FROM $tbl_main_categories
WHERE code = '$code'";
$result = Database::query($sql);
if ($col = Database::fetch_array($result)) {
return $col['title'];
}
}
/**
* Generates a course code from a course title.
*
* @todo Such a function might be useful in other places too. It might be moved in the CourseManager class.
* @todo the function might be upgraded for avoiding code duplications (currently,
* it might suggest a code that is already in use)
*
* @param string $title A course title
*
* @return string A proposed course code
* +
* @assert (null,null) === false
* @assert ('ABC_DEF', null) === 'ABCDEF'
* @assert ('ABC09*^[%A', null) === 'ABC09A'
*/
public static function generate_course_code($title)
{
return substr(
preg_replace('/[^A-Z0-9]/', '', strtoupper(api_replace_dangerous_char($title))),
0,
self::MAX_COURSE_LENGTH_CODE
);
}
/**
* this function gets all the users of the course,
* including users from linked courses.
*
* @param $filterByActive
*
* @return array
*/
public static function getCourseUsers($filterByActive = null)
{
// This would return only the users from real courses:
return self::get_user_list_from_course_code(
api_get_course_id(),
api_get_session_id(),
null,
null,
null,
null,
false,
false,
[],
[],
[],
$filterByActive
);
}
/**
* this function gets all the groups of the course,
* not including linked courses.
*
* @return CGroup[]
*/
public static function getCourseGroups()
{
$sessionId = api_get_session_id();
$courseCode = api_get_course_id();
if (0 != $sessionId) {
$groupList = self::get_group_list_of_course(
$courseCode,
$sessionId,
1
);
} else {
$groupList = self::get_group_list_of_course(
$courseCode,
0,
1
);
}
return $groupList;
}
/**
* @param FormValidator $form
* @param array $alreadySelected
*
* @return HTML_QuickForm_element
*/
public static function addUserGroupMultiSelect(&$form, $alreadySelected, $addShortCut = false)
{
$userList = self::getCourseUsers(true);
$groupList = self::getCourseGroups();
$array = self::buildSelectOptions(
$groupList,
$userList,
$alreadySelected
);
$result = [];
foreach ($array as $content) {
$result[$content['value']] = $content['content'];
}
$multiple = $form->addMultiSelect(
'users',
get_lang('Users'),
$result,
['select_all_checkbox' => true, 'id' => 'users']
);
$sessionId = api_get_session_id();
if ($addShortCut && empty($sessionId)) {
$addStudents = [];
foreach ($userList as $user) {
if (STUDENT == $user['status_rel']) {
$addStudents[] = $user['user_id'];
}
}
if (!empty($addStudents)) {
$form->addHtml(
''
);
$form->addLabel(
'',
Display::url(get_lang('Add learners'), '#', ['id' => 'add_students', 'class' => 'btn btn--primary'])
);
}
}
return $multiple;
}
/**
* This function separates the users from the groups
* users have a value USER:XXX (with XXX the groups id have a value
* GROUP:YYY (with YYY the group id).
*
* @param array $to Array of strings that define the type and id of each destination
*
* @return array Array of groups and users (each an array of IDs)
*/
public static function separateUsersGroups($to)
{
$groupList = [];
$userList = [];
foreach ($to as $to_item) {
if (!empty($to_item)) {
$parts = explode(':', $to_item);
$type = isset($parts[0]) ? $parts[0] : '';
$id = isset($parts[1]) ? $parts[1] : '';
switch ($type) {
case 'GROUP':
$groupList[] = (int) $id;
break;
case 'USER':
$userList[] = (int) $id;
break;
}
}
}
$send_to['groups'] = $groupList;
$send_to['users'] = $userList;
return $send_to;
}
/**
* Shows the form for sending a message to a specific group or user.
*
* @return HTML_QuickForm_element
*/
public static function addGroupMultiSelect(FormValidator $form, CGroup $group, $to = [])
{
$groupUsers = GroupManager::get_subscribed_users($group);
$array = self::buildSelectOptions([$group], $groupUsers, $to);
$result = [];
foreach ($array as $content) {
$result[$content['value']] = $content['content'];
}
return $form->addMultiSelect('users', get_lang('Users'), $result);
}
/**
* this function shows the form for sending a message to a specific group or user.
*
* @param CGroup[] $groupList
* @param array $userList
* @param array $alreadySelected
*
* @return array
*/
public static function buildSelectOptions($groupList = [], $userList = [], $alreadySelected = [])
{
if (empty($alreadySelected)) {
$alreadySelected = [];
}
$result = [];
// adding the groups to the select form
if ($groupList) {
foreach ($groupList as $thisGroup) {
$groupId = $thisGroup->getIid();
if (is_array($alreadySelected)) {
if (!in_array(
"GROUP:".$groupId,
$alreadySelected
)
) {
$userCount = $thisGroup->getMembers()->count();
// $alreadySelected is the array containing the groups (and users) that are already selected
$userLabel = ($userCount > 0) ? get_lang('Users') : get_lang('user');
$userDisabled = ($userCount > 0) ? "" : "disabled=disabled";
$result[] = [
'disabled' => $userDisabled,
'value' => "GROUP:".$groupId,
// The space before "G" is needed in order to advmultiselect.php js puts groups first
'content' => " G: ".$thisGroup->getTitle()." - ".$userCount." ".$userLabel,
];
}
}
}
}
// adding the individual users to the select form
if ($userList) {
foreach ($userList as $user) {
if (is_array($alreadySelected)) {
if (!in_array(
"USER:".$user['user_id'],
$alreadySelected
)
) {
// $alreadySelected is the array containing the users (and groups) that are already selected
$result[] = [
'value' => "USER:".$user['user_id'],
'content' => api_get_person_name($user['firstname'], $user['lastname']),
];
}
}
}
}
return $result;
}
/**
* @return array a list (array) of all courses
*/
public static function get_course_list()
{
$table = Database::get_main_table(TABLE_MAIN_COURSE);
return Database::store_result(Database::query("SELECT *, id as real_id FROM $table"));
}
/**
* Returns course code from a given gradebook category's id.
*
* @param int $category_id Category ID
*
* @return ?int Course ID
* @throws Exception
*/
public static function get_course_by_category(int $category_id): ?int
{
$category_id = (int) $category_id;
$sql = 'SELECT c_id FROM '.Database::get_main_table(TABLE_MAIN_GRADEBOOK_CATEGORY).'
WHERE id='.$category_id;
$info = Database::fetch_array(Database::query($sql));
return $info ? $info['c_id'] : null;
}
/**
* This function gets all the courses that are not in a session.
*
* @param date Start date
* @param date End date
* @param bool $includeClosed Whether to include closed and hidden courses
*
* @return array Not-in-session courses
*/
public static function getCoursesWithoutSession(
$startDate = null,
$endDate = null,
$includeClosed = false
) {
$dateConditional = ($startDate && $endDate) ?
" WHERE session_id IN (SELECT id FROM ".Database::get_main_table(TABLE_MAIN_SESSION).
" WHERE access_start_date = '$startDate' AND access_end_date = '$endDate')" : null;
$visibility = ($includeClosed ? '' : 'visibility NOT IN (0, 4) AND ');
$sql = "SELECT id, code, title
FROM ".Database::get_main_table(TABLE_MAIN_COURSE)."
WHERE $visibility code NOT IN (
SELECT DISTINCT course_code
FROM ".Database::get_main_table(TABLE_MAIN_SESSION_COURSE).$dateConditional."
)
ORDER BY id";
$result = Database::query($sql);
$courses = [];
while ($row = Database::fetch_array($result)) {
$courses[] = $row;
}
return $courses;
}
/**
* Get list of courses based on users of a group for a group admin.
*
* @param int $userId The user id
*
* @return array
*/
public static function getCoursesFollowedByGroupAdmin($userId)
{
$coursesList = [];
$courseTable = Database::get_main_table(TABLE_MAIN_COURSE);
$courseUserTable = Database::get_main_table(TABLE_MAIN_COURSE_USER);
$userGroup = new UserGroupModel();
$userIdList = $userGroup->getGroupUsersByUser($userId);
if (empty($userIdList)) {
return [];
}
$sql = "SELECT DISTINCT(c.id), c.title
FROM $courseTable c
INNER JOIN $courseUserTable cru ON c.id = cru.c_id
WHERE (
cru.user_id IN (".implode(', ', $userIdList).")
AND cru.relation_type = 0
)";
if (api_is_multiple_url_enabled()) {
$courseAccessUrlTable = Database::get_main_table(TABLE_MAIN_ACCESS_URL_REL_COURSE);
$accessUrlId = api_get_current_access_url_id();
if (-1 != $accessUrlId) {
$sql = "SELECT DISTINCT(c.id), c.title
FROM $courseTable c
INNER JOIN $courseUserTable cru ON c.id = cru.c_id
INNER JOIN $courseAccessUrlTable crau ON c.id = crau.c_id
WHERE crau.access_url_id = $accessUrlId
AND (
cru.id_user IN (".implode(', ', $userIdList).") AND
cru.relation_type = 0
)";
}
}
$result = Database::query($sql);
while ($row = Database::fetch_assoc($result)) {
$coursesList[] = $row;
}
return $coursesList;
}
/**
* Direct course link see #5299.
*
* You can send to your students an URL like this
* http://chamilodev.beeznest.com/main/auth/inscription.php?c=ABC&e=3
* Where "c" is the course code and "e" is the exercise Id, after a successful
* registration the user will be sent to the course or exercise
*
* @param array $form_data
*
* @return array
*/
public static function redirectToCourse($form_data)
{
$course_code_redirect = Session::read('course_redirect');
$_user = api_get_user_info();
$userId = api_get_user_id();
if (!empty($course_code_redirect)) {
$course_info = api_get_course_info($course_code_redirect);
if (!empty($course_info)) {
if (in_array(
$course_info['visibility'],
[Course::OPEN_PLATFORM, Course::OPEN_WORLD]
)
) {
if (self::is_user_subscribed_in_course($userId, $course_info['code'])) {
$form_data['action'] = $course_info['course_public_url'];
$form_data['message'] = sprintf(get_lang('You have been registered to course %s'), $course_info['title']);
$form_data['button'] = Display::button(
'next',
get_lang('Go to the course', null, $_user['language']),
['class' => 'btn btn--primary btn-large']
);
$exercise_redirect = (int) Session::read('exercise_redirect');
// Specify the course id as the current context does not
// hold a global $_course array
$objExercise = new Exercise($course_info['real_id']);
$result = $objExercise->read($exercise_redirect);
if (!empty($exercise_redirect) && !empty($result)) {
$form_data['action'] = api_get_path(WEB_CODE_PATH).
'exercise/overview.php?exerciseId='.$exercise_redirect.'&cid='.$course_info['real_id'];
$form_data['message'] .= '