123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938 |
- <?php //$id: $
- /* For licensing terms, see /dokeos_license.txt */
- /**
- ==============================================================================
- * This class provides methods for sessions management.
- * Include/require it in your code to use its features.
- *
- * @package dokeos.library
- ==============================================================================
- */
- require_once('display.lib.php');
- class SessionManager {
- private function __construct() {
- }
- /**
- * Fetches a session from the database
- * @param int Session ID
- * @return array Session details (id, id_coach, name, nbr_courses, nbr_users, nbr_classes, date_start, date_end, nb_days_access_before_beginning,nb_days_access_after_end, session_admin_id)
- */
- public static function fetch($id) {
- $t = Database::get_main_table(TABLE_MAIN_SESSION);
- if ($id != strval(intval($id))) { return array(); }
- $s = "SELECT * FROM $t WHERE id = $id";
- $r = Database::query($s,__FILE__,__LINE__);
- if (Database::num_rows($r) != 1) { return array(); }
- return Database::fetch_array($r,'ASSOC');
- }
- /**
- * Create a session
- * @author Carlos Vargas <carlos.vargas@dokeos.com>,from existing code
- * @param string name
- * @param integer year_start
- * @param integer month_start
- * @param integer day_start
- * @param integer year_end
- * @param integer month_end
- * @param integer day_end
- * @param integer nb_days_acess_before
- * @param integer nb_days_acess_after
- * @param integer nolimit
- * @param string coach_username
- * @param integer id_session_category
- * @return $id_session;
- **/
- public static function create_session ($sname,$syear_start,$smonth_start,$sday_start,$syear_end,$smonth_end,$sday_end,$snb_days_acess_before,$snb_days_acess_after,$nolimit,$coach_username, $id_session_category,$id_visibility) {
- global $_user;
- $name= trim($sname);
- $year_start= intval($syear_start);
- $month_start=intval($smonth_start);
- $day_start=intval($sday_start);
- $year_end=intval($syear_end);
- $month_end=intval($smonth_end);
- $day_end=intval($sday_end);
- $nb_days_acess_before = intval($snb_days_acess_before);
- $nb_days_acess_after = intval($snb_days_acess_after);
- $id_session_category = intval($id_session_category);
- $id_visibility = intval($id_visibility);
- $tbl_user = Database::get_main_table(TABLE_MAIN_USER);
- $tbl_session = Database::get_main_table(TABLE_MAIN_SESSION);
- $sql = 'SELECT user_id FROM '.$tbl_user.' WHERE username="'.Database::escape_string($coach_username).'"';
- $rs = Database::query($sql, __FILE__, __LINE__);
- $id_coach = Database::result($rs,0,'user_id');
- if (empty($nolimit)) {
- $date_start="$year_start-".(($month_start < 10)?"0$month_start":$month_start)."-".(($day_start < 10)?"0$day_start":$day_start);
- $date_end="$year_end-".(($month_end < 10)?"0$month_end":$month_end)."-".(($day_end < 10)?"0$day_end":$day_end);
- } else {
- $id_visibility = 1; // by default is read only
- $date_start="000-00-00";
- $date_end="000-00-00";
- }
- if (empty($name)) {
- $msg=get_lang('SessionNameIsRequired');
- return $msg;
- } elseif (empty($coach_username)) {
- $msg=get_lang('CoachIsRequired');
- return $msg;
- } elseif (empty($nolimit) && (!$month_start || !$day_start || !$year_start || !checkdate($month_start,$day_start,$year_start))) {
- $msg=get_lang('InvalidStartDate');
- return $msg;
- } elseif (empty($nolimit) && (!$month_end || !$day_end || !$year_end || !checkdate($month_end,$day_end,$year_end))) {
- $msg=get_lang('InvalidEndDate');
- return $msg;
- } elseif(empty($nolimit) && $date_start >= $date_end) {
- $msg=get_lang('StartDateShouldBeBeforeEndDate');
- return $msg;
- } else {
- $rs = Database::query("SELECT 1 FROM $tbl_session WHERE name='".addslashes($name)."'");
- if(Database::num_rows($rs)) {
- $msg=get_lang('SessionNameAlreadyExists');
- return $msg;
- } else {
- $sql_insert = "INSERT INTO $tbl_session(name,date_start,date_end,id_coach,session_admin_id, nb_days_access_before_beginning, nb_days_access_after_end, session_category_id,visibility)
- VALUES('".Database::escape_string($name)."','$date_start','$date_end','$id_coach',".intval($_user['user_id']).",".$nb_days_acess_before.", ".$nb_days_acess_after.", ".$id_session_category.", ".$id_visibility.")";
- Database::query($sql_insert ,__FILE__,__LINE__);
- $id_session=Database::insert_id();
- // add event to system log
- $time = time();
- $user_id = api_get_user_id();
- event_system(LOG_SESSION_CREATE, LOG_SESSION_ID, $id_session, $time, $user_id);
- return $id_session;
- }
- }
- }
- /**
- * Edit a session
- * @author Carlos Vargas <carlos.vargas@dokeos.com>,from existing code
- * @param integer id
- * @param string name
- * @param integer year_start
- * @param integer month_start
- * @param integer day_start
- * @param integer year_end
- * @param integer month_end
- * @param integer day_end
- * @param integer nb_days_acess_before
- * @param integer nb_days_acess_after
- * @param integer nolimit
- * @param integer id_coach
- * @param integer id_session_category
- * @return $id;
- * The parameter id is a primary key
- **/
- public static function edit_session ($id,$name,$year_start,$month_start,$day_start,$year_end,$month_end,$day_end,$nb_days_acess_before,$nb_days_acess_after,$nolimit,$id_coach, $id_session_category, $id_visibility) {
- global $_user;
- $name=trim(stripslashes($name));
- $year_start=intval($year_start);
- $month_start=intval($month_start);
- $day_start=intval($day_start);
- $year_end=intval($year_end);
- $month_end=intval($month_end);
- $day_end=intval($day_end);
- $id_coach= intval($id_coach);
- $nb_days_acess_before= intval($nb_days_acess_before);
- $nb_days_acess_after = intval($nb_days_acess_after);
- $id_session_category = intval($id_session_category);
- $id_visibility = intval($id_visibility);
- $tbl_user = Database::get_main_table(TABLE_MAIN_USER);
- $tbl_session = Database::get_main_table(TABLE_MAIN_SESSION);
- $tbl_session_rel_course = Database::get_main_table(TABLE_MAIN_SESSION_COURSE);
- if (empty($nolimit)) {
- $date_start="$year_start-".(($month_start < 10)?"0$month_start":$month_start)."-".(($day_start < 10)?"0$day_start":$day_start);
- $date_end="$year_end-".(($month_end < 10)?"0$month_end":$month_end)."-".(($day_end < 10)?"0$day_end":$day_end);
- } else {
- $date_start="000-00-00";
- $date_end="000-00-00";
- $id_visibility = 1;//force read only
- }
- if (empty($name)) {
- $msg=get_lang('SessionNameIsRequired');
- return $msg;
- } elseif (empty($id_coach)) {
- $msg=get_lang('CoachIsRequired');
- return $msg;
- } elseif (empty($nolimit) && (!$month_start || !$day_start || !$year_start || !checkdate($month_start,$day_start,$year_start))) {
- $msg=get_lang('InvalidStartDate');
- return $msg;
- } elseif (empty($nolimit) && (!$month_end || !$day_end || !$year_end || !checkdate($month_end,$day_end,$year_end))) {
- $msg=get_lang('InvalidEndDate');
- return $msg;
- } elseif (empty($nolimit) && $date_start >= $date_end) {
- $msg=get_lang('StartDateShouldBeBeforeEndDate');
- return $msg;
- } else {
- $rs = Database::query("SELECT id FROM $tbl_session WHERE name='".Database::escape_string($name)."'");
- $exists = false;
- while ($row = Database::fetch_array($rs)) {
- if($row['id']!=$id)
- $exists = true;
- }
- if ($exists) {
- $msg=get_lang('SessionNameAlreadyExists');
- return $msg;
- } else {
- $sql="UPDATE $tbl_session " .
- "SET name='".Database::escape_string($name)."',
- date_start='".$date_start."',
- date_end='".$date_end."',
- id_coach='".$id_coach."',
- nb_days_access_before_beginning = ".$nb_days_acess_before.",
- nb_days_access_after_end = ".$nb_days_acess_after.",
- session_category_id = ".$id_session_category." ,
- visibility= ".$id_visibility."
- WHERE id='$id'";
- Database::query($sql,__FILE__,__LINE__);
- /*$sqlu = "UPDATE $tbl_session_rel_course " .
- " SET id_coach='$id_coach'" .
- " WHERE id_session='$id'";
- Database::query($sqlu,__FILE__,__LINE__);*/
- return $id;
- }
- }
- }
- /**
- * Delete session
- * @author Carlos Vargas <carlos.vargas@dokeos.com>, from existing code
- * @param array id_checked
- * @param boolean optional, true if the function is called by a webservice, false otherwise.
- * @return void Nothing, or false on error
- * The parameters is a array to delete sessions
- **/
- public static function delete_session ($id_checked,$from_ws = false) {
- $tbl_session= Database::get_main_table(TABLE_MAIN_SESSION);
- $tbl_session_rel_course= Database::get_main_table(TABLE_MAIN_SESSION_COURSE);
- $tbl_session_rel_course_rel_user= Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
- $tbl_session_rel_user= Database::get_main_table(TABLE_MAIN_SESSION_USER);
- $tbl_user = Database::get_main_table(TABLE_MAIN_USER);
- global $_user;
- if(is_array($id_checked)) {
- $id_checked=Database::escape_string(implode(',',$id_checked));
- } else {
- $id_checked=intval($id_checked);
- }
- if (!api_is_platform_admin() && !$from_ws) {
- $sql = 'SELECT session_admin_id FROM '.Database :: get_main_table(TABLE_MAIN_SESSION).' WHERE id='.$id_checked;
- $rs = Database::query($sql,__FILE__,__LINE__);
- if (Database::result($rs,0,0)!=$_user['user_id']) {
- api_not_allowed(true);
- }
- }
- Database::query("DELETE FROM $tbl_session WHERE id IN($id_checked)",__FILE__,__LINE__);
- Database::query("DELETE FROM $tbl_session_rel_course WHERE id_session IN($id_checked)",__FILE__,__LINE__);
- Database::query("DELETE FROM $tbl_session_rel_course_rel_user WHERE id_session IN($id_checked)",__FILE__,__LINE__);
- Database::query("DELETE FROM $tbl_session_rel_user WHERE id_session IN($id_checked)",__FILE__,__LINE__);
- // delete extra session fields
- $t_sf = Database::get_main_table(TABLE_MAIN_SESSION_FIELD);
- $t_sfv = Database::get_main_table(TABLE_MAIN_SESSION_FIELD_VALUES);
- // Delete extra fields from session where field variable is "SECCION"
- $sql = "SELECT t_sfv.field_id FROM $t_sfv t_sfv, $t_sf t_sf WHERE t_sfv.session_id = '$id_checked' AND t_sf.field_variable = 'SECCION' ";
- $rs_field = Database::query($sql,__FILE__,__LINE__);
- $field_id = 0;
- if (Database::num_rows($rs_field) == 1) {
- $row_field = Database::fetch_row($rs_field);
- $field_id = $row_field[0];
- $sql_delete_sfv = "DELETE FROM $t_sfv WHERE session_id = '$id_checked' AND field_id = '$field_id'";
- $rs_delete_sfv = Database::query($sql_delete_sfv,__FILE__,__LINE__);
- }
- $sql = "SELECT * FROM $t_sfv WHERE field_id = '$field_id' ";
- $rs_field_id = Database::query($sql,__FILE__,__LINE__);
- if (Database::num_rows($rs_field_id) == 0) {
- $sql_delete_sf = "DELETE FROM $t_sf WHERE id = '$field_id'";
- $rs_delete_sf = Database::query($sql_delete_sf,__FILE__,__LINE__);
- }
- /*
- $sql = "SELECT distinct field_id FROM $t_sfv WHERE session_id = '$id_checked'";
- $res_field_ids = @Database::query($sql,__FILE__,__LINE__);
- if (Database::num_rows($res_field_ids) > 0) {
- while($row_field_id = Database::fetch_row($res_field_ids)){
- $field_ids[] = $row_field_id[0];
- }
- }
- //delete from table_session_field_value from a given session id
- $sql_session_field_value = "DELETE FROM $t_sfv WHERE session_id = '$id_checked'";
- @Database::query($sql_session_field_value,__FILE__,__LINE__);
- $sql = "SELECT distinct field_id FROM $t_sfv";
- $res_field_all_ids = @Database::query($sql,__FILE__,__LINE__);
- if (Database::num_rows($res_field_all_ids) > 0) {
- while($row_field_all_id = Database::fetch_row($res_field_all_ids)){
- $field_all_ids[] = $row_field_all_id[0];
- }
- }
- if (count($field_ids) > 0 && count($field_all_ids) > 0) {
- foreach($field_ids as $field_id) {
- // check if field id is used into table field value
- if (in_array($field_id,$field_all_ids)) {
- continue;
- } else {
- $sql_session_field = "DELETE FROM $t_sf WHERE id = '$field_id'";
- Database::query($sql_session_field,__FILE__,__LINE__);
- }
- }
- }
- */
- // add event to system log
- $time = time();
- $user_id = api_get_user_id();
- event_system(LOG_SESSION_DELETE, LOG_SESSION_ID, $id_checked, $time, $user_id);
- }
- /**
- * Subscribes users to the given session and optionally (default) unsubscribes previous users
- * @author Carlos Vargas <carlos.vargas@dokeos.com>,from existing code
- * @param integer Session ID
- * @param array List of user IDs
- * @param bool Whether to unsubscribe existing users (true, default) or not (false)
- * @return void Nothing, or false on error
- **/
- public static function suscribe_users_to_session ($id_session,$user_list, $visibility=SESSION_VISIBLE_READ_ONLY, $empty_users=true) {
- if ($id_session!= strval(intval($id_session))) return false;
- foreach($user_list as $intUser){
- if ($intUser!= strval(intval($intUser))) return false;
- }
- $tbl_session_rel_course = Database::get_main_table(TABLE_MAIN_SESSION_COURSE);
- $tbl_session_rel_course_rel_user = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
- $tbl_session_rel_user = Database::get_main_table(TABLE_MAIN_SESSION_USER);
- $tbl_session = Database::get_main_table(TABLE_MAIN_SESSION);
- if (empty($visibility)) {
- $sql = "SELECT visibility FROM $tbl_session WHERE id_session='$id_session'";
- $result = Database::query($sql,__FILE__,__LINE__);
- $row = Database::fetch_array($result);
- $visibility = $row['visibility'];
- if (empty($visibility))
- $visibility = SESSION_VISIBLE_READ_ONLY; // by default readonly 1
- }
- $sql = "SELECT id_user FROM $tbl_session_rel_user WHERE id_session='$id_session'";
- $result = Database::query($sql,__FILE__,__LINE__);
- $existingUsers = array();
- while($row = Database::fetch_array($result)){
- $existingUsers[] = $row['id_user'];
- }
- $sql = "SELECT course_code FROM $tbl_session_rel_course WHERE id_session='$id_session'";
- $result=Database::query($sql,__FILE__,__LINE__);
- $course_list=array();
- while($row=Database::fetch_array($result)) {
- $course_list[]=$row['course_code'];
- }
- foreach ($course_list as $enreg_course) {
- // for each course in the session
- $nbr_users=0;
- $enreg_course = Database::escape_string($enreg_course);
- // delete existing users
- if ($empty_users!==false) {
- foreach ($existingUsers as $existing_user) {
- if(!in_array($existing_user, $user_list)) {
- $sql = "DELETE FROM $tbl_session_rel_course_rel_user WHERE id_session='$id_session' AND course_code='$enreg_course' AND id_user='$existing_user'";
- Database::query($sql,__FILE__,__LINE__);
- if(Database::affected_rows()) {
- $nbr_users--;
- }
- }
- }
- }
- // insert new users into session_rel_course_rel_user and ignore if they already exist
- foreach ($user_list as $enreg_user) {
- if(!in_array($enreg_user, $existingUsers)) {
- $enreg_user = Database::escape_string($enreg_user);
- $insert_sql = "INSERT IGNORE INTO $tbl_session_rel_course_rel_user(id_session,course_code,id_user,visibility) VALUES('$id_session','$enreg_course','$enreg_user','$visibility')";
- Database::query($insert_sql,__FILE__,__LINE__);
- if(Database::affected_rows()) {
- $nbr_users++;
- }
- }
- }
- // count users in this session-course relation
- $sql = "SELECT COUNT(id_user) as nbUsers FROM $tbl_session_rel_course_rel_user WHERE id_session='$id_session' AND course_code='$enreg_course'";
- $rs = Database::query($sql, __FILE__, __LINE__);
- list($nbr_users) = Database::fetch_array($rs);
- // update the session-course relation to add the users total
- $update_sql = "UPDATE $tbl_session_rel_course SET nbr_users=$nbr_users WHERE id_session='$id_session' AND course_code='$enreg_course'";
- Database::query($update_sql,__FILE__,__LINE__);
- }
- // delete users from the session
- if ($empty_users===true){
- Database::query("DELETE FROM $tbl_session_rel_user WHERE id_session = $id_session",__FILE__,__LINE__);
- }
- // insert missing users into session
- $nbr_users = 0;
- foreach ($user_list as $enreg_user) {
- $enreg_user = Database::escape_string($enreg_user);
- $nbr_users++;
- $insert_sql = "INSERT IGNORE INTO $tbl_session_rel_user(id_session, id_user) VALUES('$id_session','$enreg_user')";
- Database::query($insert_sql,__FILE__,__LINE__);
- }
- // update number of users in the session
- $nbr_users = count($user_list);
- $update_sql = "UPDATE $tbl_session SET nbr_users= $nbr_users WHERE id='$id_session' ";
- Database::query($update_sql,__FILE__,__LINE__);
- }
- /** Subscribes courses to the given session and optionally (default) unsubscribes previous users
- * @author Carlos Vargas <carlos.vargas@dokeos.com>,from existing code
- * @param int Session ID
- * @param array List of courses IDs
- * @param bool Whether to unsubscribe existing users (true, default) or not (false)
- * @return void Nothing, or false on error
- **/
- public static function add_courses_to_session ($id_session, $course_list, $empty_courses=true) {
- // security checks
- if ($id_session!= strval(intval($id_session))) { return false; }
- foreach($course_list as $intCourse){
- if ($intCourse!= strval(intval($intCourse))) { return false; }
- }
- // initialisation
- $tbl_session_rel_course_rel_user = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
- $tbl_session = Database::get_main_table(TABLE_MAIN_SESSION);
- $tbl_session_rel_user = Database::get_main_table(TABLE_MAIN_SESSION_USER);
- $tbl_session_rel_course = Database::get_main_table(TABLE_MAIN_SESSION_COURSE);
- $tbl_course = Database::get_main_table(TABLE_MAIN_COURSE);
- // get general coach ID
- $id_coach = Database::query("SELECT id_coach FROM $tbl_session WHERE id=$id_session");
- $id_coach = Database::fetch_array($id_coach);
- $id_coach = $id_coach[0];
- // get list of courses subscribed to this session
- $rs = Database::query("SELECT course_code FROM $tbl_session_rel_course WHERE id_session=$id_session");
- $existingCourses = Database::store_result($rs);
- $nbr_courses=count($existingCourses);
- // get list of users subscribed to this session
- $sql="SELECT id_user
- FROM $tbl_session_rel_user
- WHERE id_session = $id_session";
- $result=Database::query($sql,__FILE__,__LINE__);
- $user_list=Database::store_result($result);
- // remove existing courses from the session
- if ($empty_courses===true) {
- foreach ($existingCourses as $existingCourse) {
- if (!in_array($existingCourse['course_code'], $course_list)){
- Database::query("DELETE FROM $tbl_session_rel_course WHERE course_code='".$existingCourse['course_code']."' AND id_session=$id_session");
- Database::query("DELETE FROM $tbl_session_rel_course_rel_user WHERE course_code='".$existingCourse['course_code']."' AND id_session=$id_session");
- }
- }
- $nbr_courses=0;
- }
- // Pass through the courses list we want to add to the session
- foreach ($course_list as $enreg_course) {
- $enreg_course = Database::escape_string($enreg_course);
- $exists = false;
- // check if the course we want to add is already subscribed
- foreach ($existingCourses as $existingCourse) {
- if ($enreg_course == $existingCourse['course_code']) {
- $exists=true;
- }
- }
- if (!$exists) {
- //if the course isn't subscribed yet
- $sql_insert_rel_course= "INSERT INTO $tbl_session_rel_course (id_session,course_code, id_coach) VALUES ('$id_session','$enreg_course','$id_coach')";
- Database::query($sql_insert_rel_course ,__FILE__,__LINE__);
- //We add the current course in the existing courses array, to avoid adding another time the current course
- $existingCourses[]=array('course_code'=>$enreg_course);
- $nbr_courses++;
- // subscribe all the users from the session to this course inside the session
- $nbr_users=0;
- foreach ($user_list as $enreg_user) {
- $enreg_user_id = Database::escape_string($enreg_user['id_user']);
- $sql_insert = "INSERT IGNORE INTO $tbl_session_rel_course_rel_user (id_session,course_code,id_user) VALUES ('$id_session','$enreg_course','$enreg_user_id')";
- Database::query($sql_insert,__FILE__,__LINE__);
- if (Database::affected_rows()) {
- $nbr_users++;
- }
- }
- Database::query("UPDATE $tbl_session_rel_course SET nbr_users=$nbr_users WHERE id_session='$id_session' AND course_code='$enreg_course'",__FILE__,__LINE__);
- }
- }
- Database::query("UPDATE $tbl_session SET nbr_courses=$nbr_courses WHERE id='$id_session'",__FILE__,__LINE__);
- }
- /**
- * Creates a new extra field for a given session
- * @param string Field's internal variable name
- * @param int Field's type
- * @param string Field's language var name
- * @return int new extra field id
- */
- public static function create_session_extra_field ($fieldvarname, $fieldtype, $fieldtitle) {
- // database table definition
- $t_sf = Database::get_main_table(TABLE_MAIN_SESSION_FIELD);
- $fieldvarname = Database::escape_string($fieldvarname);
- $fieldtitle = Database::escape_string($fieldtitle);
- $fieldtype = (int)$fieldtype;
- $time = time();
- $sql_field = "SELECT id FROM $t_sf WHERE field_variable = '$fieldvarname'";
- $res_field = Database::query($sql_field,__FILE__,__LINE__);
- $r_field = Database::fetch_row($res_field);
- if (Database::num_rows($res_field)>0) {
- $field_id = $r_field[0];
- } else {
- // save new fieldlabel into course_field table
- $sql = "SELECT MAX(field_order) FROM $t_sf";
- $res = Database::query($sql,__FILE__,__LINE__);
- $order = 0;
- if (Database::num_rows($res)>0) {
- $row = Database::fetch_row($res);
- $order = $row[0]+1;
- }
- $sql = "INSERT INTO $t_sf
- SET field_type = '$fieldtype',
- field_variable = '$fieldvarname',
- field_display_text = '$fieldtitle',
- field_order = '$order',
- tms = FROM_UNIXTIME($time)";
- $result = Database::query($sql,__FILE__,__LINE__);
- $field_id=Database::insert_id();
- }
- return $field_id;
- }
- /**
- * Update an extra field value for a given session
- * @param integer Course ID
- * @param string Field variable name
- * @param string Field value
- * @return boolean true if field updated, false otherwise
- */
- public static function update_session_extra_field_value ($session_id,$fname,$fvalue='') {
- $t_sf = Database::get_main_table(TABLE_MAIN_SESSION_FIELD);
- $t_sfv = Database::get_main_table(TABLE_MAIN_SESSION_FIELD_VALUES);
- $fname = Database::escape_string($fname);
- $session_id = (int)$session_id;
- $fvalues = '';
- if(is_array($fvalue))
- {
- foreach($fvalue as $val)
- {
- $fvalues .= Database::escape_string($val).';';
- }
- if(!empty($fvalues))
- {
- $fvalues = substr($fvalues,0,-1);
- }
- }
- else
- {
- $fvalues = Database::escape_string($fvalue);
- }
- $sqlsf = "SELECT * FROM $t_sf WHERE field_variable='$fname'";
- $ressf = Database::query($sqlsf,__FILE__,__LINE__);
- if(Database::num_rows($ressf)==1)
- { //ok, the field exists
- // Check if enumerated field, if the option is available
- $rowsf = Database::fetch_array($ressf);
- $tms = time();
- $sqlsfv = "SELECT * FROM $t_sfv WHERE session_id = '$session_id' AND field_id = '".$rowsf['id']."' ORDER BY id";
- $ressfv = Database::query($sqlsfv,__FILE__,__LINE__);
- $n = Database::num_rows($ressfv);
- if ($n>1) {
- //problem, we already have to values for this field and user combination - keep last one
- while($rowsfv = Database::fetch_array($ressfv))
- {
- if($n > 1)
- {
- $sqld = "DELETE FROM $t_sfv WHERE id = ".$rowsfv['id'];
- $resd = Database::query($sqld,__FILE__,__LINE__);
- $n--;
- }
- $rowsfv = Database::fetch_array($ressfv);
- if($rowsfv['field_value'] != $fvalues)
- {
- $sqlu = "UPDATE $t_sfv SET field_value = '$fvalues', tms = FROM_UNIXTIME($tms) WHERE id = ".$rowsfv['id'];
- $resu = Database::query($sqlu,__FILE__,__LINE__);
- return($resu?true:false);
- }
- return true;
- }
- } else if ($n==1) {
- //we need to update the current record
- $rowsfv = Database::fetch_array($ressfv);
- if($rowsfv['field_value'] != $fvalues)
- {
- $sqlu = "UPDATE $t_sfv SET field_value = '$fvalues', tms = FROM_UNIXTIME($tms) WHERE id = ".$rowsfv['id'];
- //error_log('UM::update_extra_field_value: '.$sqlu);
- $resu = Database::query($sqlu,__FILE__,__LINE__);
- return($resu?true:false);
- }
- return true;
- } else {
- $sqli = "INSERT INTO $t_sfv (session_id,field_id,field_value,tms) " .
- "VALUES ('$session_id',".$rowsf['id'].",'$fvalues',FROM_UNIXTIME($tms))";
- //error_log('UM::update_extra_field_value: '.$sqli);
- $resi = Database::query($sqli,__FILE__,__LINE__);
- return($resi?true:false);
- }
- } else {
- return false; //field not found
- }
- }
- /**
- * Checks the relationship between a session and a course.
- * @param int $session_id
- * @param int $course_id
- * @return bool Returns TRUE if the session and the course are related, FALSE otherwise.
- * */
- public static function relation_session_course_exist ($session_id, $course_id) {
- $tbl_session_course = Database::get_main_table(TABLE_MAIN_SESSION_COURSE);
- $return_value = false;
- $sql= "SELECT course_code FROM $tbl_session_course WHERE id_session = ".Database::escape_string($session_id)." AND course_code = '".Database::escape_string($course_id)."'";
- $result = Database::query($sql, __FILE__, __LINE__);
- $num = Database::num_rows($result);
- if ($num>0) {
- $return_value = true;
- }
- return $return_value;
- }
- /**
- * Get the session information by name
- * @param string session name
- * @return mixed false if the session does not exist, array if the session exist
- * */
- public static function get_session_by_name ($session_name) {
- $tbl_session = Database::get_main_table(TABLE_MAIN_SESSION);
- $sql = 'SELECT id, id_coach, date_start, date_end FROM '.$tbl_session.' WHERE name="'.Database::escape_string($session_name).'"';
- $result = Database::query($sql, __FILE__, __LINE__);
- $num = Database::num_rows($result);
- if ($num>0){
- return Database::fetch_array($result);
- } else {
- return false;
- }
- }
- /**
- * Create a session category
- * @author Jhon Hinojosa <jhon.hinojosa@dokeos.com>, from existing code
- * @param string name
- * @param integer year_start
- * @param integer month_start
- * @param integer day_start
- * @param integer year_end
- * @param integer month_end
- * @param integer day_end
- * @return $id_session;
- **/
- public static function create_category_session($sname,$syear_start,$smonth_start,$sday_start,$syear_end,$smonth_end, $sday_end){
- $tbl_session_category = Database::get_main_table(TABLE_MAIN_SESSION_CATEGORY);
- $name= trim($sname);
- $year_start= intval($syear_start);
- $month_start=intval($smonth_start);
- $day_start=intval($sday_start);
- $year_end=intval($syear_end);
- $month_end=intval($smonth_end);
- $day_end=intval($sday_end);
- $date_start = "$year_start-".(($month_start < 10)?"0$month_start":$month_start)."-".(($day_start < 10)?"0$day_start":$day_start);
- $date_end = "$year_end-".(($month_end < 10)?"0$month_end":$month_end)."-".(($day_end < 10)?"0$day_end":$day_end);
- if (empty($name)) {
- $msg=get_lang('SessionCategoryNameIsRequired');
- return $msg;
- } elseif (!$month_start || !$day_start || !$year_start || !checkdate($month_start,$day_start,$year_start)) {
- $msg=get_lang('InvalidStartDate');
- return $msg;
- } elseif (!$month_end || !$day_end || !$year_end || !checkdate($month_end,$day_end,$year_end)) {
- $msg=get_lang('InvalidEndDate');
- return $msg;
- } elseif($date_start >= $date_end) {
- $msg=get_lang('StartDateShouldBeBeforeEndDate');
- return $msg;
- } else {
- $sql = "INSERT INTO $tbl_session_category(name, date_start, date_end) VALUES('".Database::escape_string($name)."','$date_start','$date_end')";
- Database::query($sql ,__FILE__,__LINE__);
- $id_session=Database::insert_id();
- // add event to system log
- $time = time();
- $user_id = api_get_user_id();
- event_system(LOG_SESSION_CATEGORY_CREATE, LOG_SESSION_CATEGORY_ID, $id_session, $time, $user_id);
- return $id_session;
- }
- }
- /**
- * Edit a sessions categories
- * @author Jhon Hinojosa <jhon.hinojosa@dokeos.com>,from existing code
- * @param integer id
- * @param string name
- * @param integer year_start
- * @param integer month_start
- * @param integer day_start
- * @param integer year_end
- * @param integer month_end
- * @param integer day_end
- * @return $id;
- * The parameter id is a primary key
- **/
- public static function edit_category_session($id, $sname,$syear_start,$smonth_start,$sday_start,$syear_end,$smonth_end, $sday_end){
- $tbl_session_category = Database::get_main_table(TABLE_MAIN_SESSION_CATEGORY);
- $name= trim($sname);
- $year_start= intval($syear_start);
- $month_start=intval($smonth_start);
- $day_start=intval($sday_start);
- $year_end=intval($syear_end);
- $month_end=intval($smonth_end);
- $day_end=intval($sday_end);
- $id=intval($id);
- $date_start = "$year_start-".(($month_start < 10)?"0$month_start":$month_start)."-".(($day_start < 10)?"0$day_start":$day_start);
- $date_end = "$year_end-".(($month_end < 10)?"0$month_end":$month_end)."-".(($day_end < 10)?"0$day_end":$day_end);
- if (empty($name)) {
- $msg=get_lang('SessionCategoryNameIsRequired');
- return $msg;
- } elseif (!$month_start || !$day_start || !$year_start || !checkdate($month_start,$day_start,$year_start)) {
- $msg=get_lang('InvalidStartDate');
- return $msg;
- } elseif (!$month_end || !$day_end || !$year_end || !checkdate($month_end,$day_end,$year_end)) {
- $msg=get_lang('InvalidEndDate');
- return $msg;
- } elseif($date_start >= $date_end) {
- $msg=get_lang('StartDateShouldBeBeforeEndDate');
- return $msg;
- } else {
- $sql = "UPDATE $tbl_session_category SET name = '".Database::escape_string($name)."', date_start = '$date_start', date_end = '$date_end'
- WHERE id= '".$id."' ";
- $result = Database::query($sql, __FILE__,__LINE__);
- return ($result? true:false);
- }
- }
- /**
- * Delete sessions categories
- * @author Jhon Hinojosa <jhon.hinojosa@dokeos.com>, from existing code
- * @param array id_checked
- * @param bool include delete session
- * @param bool optional, true if the function is called by a webservice, false otherwise.
- * @return void Nothing, or false on error
- * The parameters is a array to delete sessions
- **/
- public static function delete_session_category($id_checked, $delete_session = false,$from_ws = false){
- $tbl_session_category = Database::get_main_table(TABLE_MAIN_SESSION_CATEGORY);
- $tbl_session = Database::get_main_table(TABLE_MAIN_SESSION);
- if(is_array($id_checked)) {
- $id_checked=Database::escape_string(implode(',',$id_checked));
- } else {
- $id_checked=intval($id_checked);
- }
- $sql = "SELECT id FROM $tbl_session WHERE session_category_id IN (".$id_checked.")";
- $result = @Database::query($sql,__FILE__,__LINE__);
- while ($rows = Database::fetch_array($result)) {
- $session_id = $rows['id'];
- if($delete_session == true){
- if ($from_ws) {
- SessionManager::delete_session($session_id,true);
- } else {
- SessionManager::delete_session($session_id);
- }
- }
- }
- $sql = "DELETE FROM $tbl_session_category WHERE id IN (".$id_checked.")";
- $rs = @Database::query($sql,__FILE__,__LINE__);
- $result = Database::affected_rows();
- // add event to system log
- $time = time();
- $user_id = api_get_user_id();
- event_system(LOG_SESSION_CATEGORY_DELETE, LOG_SESSION_CATEGORY_ID, $id_checked, $time, $user_id);
- // delete extra session fields where field variable is "PERIODO"
- $t_sf = Database::get_main_table(TABLE_MAIN_SESSION_FIELD);
- $t_sfv = Database::get_main_table(TABLE_MAIN_SESSION_FIELD_VALUES);
- $sql = "SELECT t_sfv.field_id FROM $t_sfv t_sfv, $t_sf t_sf WHERE t_sfv.session_id = '$id_checked' AND t_sf.field_variable = 'PERIODO' ";
- $rs_field = Database::query($sql,__FILE__,__LINE__);
- $field_id = 0;
- if (Database::num_rows($rs_field) > 0) {
- $row_field = Database::fetch_row($rs_field);
- $field_id = $row_field[0];
- $sql_delete_sfv = "DELETE FROM $t_sfv WHERE session_id = '$id_checked' AND field_id = '$field_id'";
- $rs_delete_sfv = Database::query($sql_delete_sfv,__FILE__,__LINE__);
- }
- $sql = "SELECT * FROM $t_sfv WHERE field_id = '$field_id' ";
- $rs_field_id = Database::query($sql,__FILE__,__LINE__);
- if (Database::num_rows($rs_field_id) == 0) {
- $sql_delete_sf = "DELETE FROM $t_sf WHERE id = '$field_id'";
- $rs_delete_sf = Database::query($sql_delete_sf,__FILE__,__LINE__);
- }
- return true;
- }
- /**
- * Get a list of sessions of which the given conditions match with an = 'cond'
- * @param array $conditions a list of condition (exemple : status=>STUDENT)
- * @param array $order_by a list of fields on which sort
- * @return array An array with all sessions of the platform.
- * @todo optional course code parameter, optional sorting parameters...
- */
- public static function get_sessions_list ($conditions = array(), $order_by = array()) {
- $session_table =Database::get_main_table(TABLE_MAIN_SESSION);
- $session_category_table = Database::get_main_table(TABLE_MAIN_SESSION_CATEGORY);
- $user_table = Database::get_main_table(TABLE_MAIN_USER);
- $return_array = array();
- $sql_query = " SELECT s.id, s.name, s.nbr_courses, s.date_start, s.date_end, u.firstname, u.lastname , sc.name as category_name
- FROM $session_table s
- INNER JOIN $user_table u ON s.id_coach = u.user_id
- LEFT JOIN $session_category_table sc ON s.session_category_id = sc.id ";
- if (count($conditions)>0) {
- $sql_query .= ' WHERE ';
- foreach ($conditions as $field=>$value) {
- $field = Database::escape_string($field);
- $value = Database::escape_string($value);
- $sql_query .= $field.' = '.$value;
- }
- }
- if (count($order_by)>0) {
- $sql_query .= ' ORDER BY '.Database::escape_string(implode(',',$order_by));
- }
- $sql_result = Database::query($sql_query,__FILE__,__LINE__);
- while ($result = Database::fetch_array($sql_result)) {
- $return_array[] = $result;
- }
- return $return_array;
- }
- /**
- * Get the session category information by id
- * @param string session category ID
- * @return mixed false if the session category does not exist, array if the session category exists
- */
- public static function get_session_category ($id) {
- $id = intval($id);
- $tbl_session_category = Database::get_main_table(TABLE_MAIN_SESSION_CATEGORY);
- $sql = 'SELECT id, name, date_start, date_end FROM '.$tbl_session_category.' WHERE id="'.$id.'"';
- $result = Database::query($sql, __FILE__, __LINE__);
- $num = Database::num_rows($result);
- if ($num>0){
- return Database::fetch_array($result);
- } else {
- return false;
- }
- }
- /**
- * Assign a coach to course in session with status = 2
- * @param int - user id
- * @param int - session id
- * @param string - course code
- * @param bool - optional, if is true the user don't be a coach now, otherwise it'll assign a coach
- * @return bool true if there are affected rows, otherwise false
- */
- function set_coach_to_course_session($user_id, $session_id = 0, $course_code = '',$nocoach = false) {
- // Definition of variables
- $user_id = intval($user_id);
- if (!empty($session_id)) {
- $session_id = intval($session_id);
- } else {
- $session_id = api_get_session_id();
- }
- if (!empty($course_code)) {
- $course_code = Database::escape_string($course_code);
- } else {
- $course_code = api_get_course_id();
- }
- // definitios of tables
- $tbl_session_rel_course_rel_user = Database::get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
- $tbl_session_rel_user = Database::get_main_table(TABLE_MAIN_SESSION_USER);
- $tbl_user = Database::get_main_table(TABLE_MAIN_USER);
- // check if user is a teacher
- $sql= "SELECT * FROM $tbl_user WHERE status='1' AND user_id = '$user_id'";
- $rs_check_user = Database::query($sql,__FILE__,__LINE__);
- if (Database::num_rows($rs_check_user) > 0) {
- if ($nocoach) {
- // check if user_id exits int session_rel_user
- $sql = "SELECT id_user FROM $tbl_session_rel_user WHERE id_session = '$session_id' AND id_user = '$user_id'";
- $res = Database::query($sql,__FILE__,__LINE__);
- if (Database::num_rows($res) > 0) {
- // The user don't be a coach now
- $sql = "UPDATE $tbl_session_rel_course_rel_user SET status = 0 WHERE id_session = '$session_id' AND course_code = '$course_code' AND id_user = '$user_id' ";
- $rs_update = Database::query($sql,__FILE__,__LINE__);
- if (Database::affected_rows() > 0) return true;
- else return false;
- } else {
- // The user don't be a coach now
- $sql = "DELETE FROM $tbl_session_rel_course_rel_user WHERE id_session = '$session_id' AND course_code = '$course_code' AND id_user = '$user_id' ";
- $rs_delete = Database::query($sql,__FILE__,__LINE__);
- if (Database::affected_rows() > 0) return true;
- else return false;
- }
- } else {
- // Assign user like a coach to course
- // First check if the user is registered in the course
- $sql = "SELECT id_user FROM $tbl_session_rel_course_rel_user WHERE id_session = '$session_id' AND course_code = '$course_code' AND id_user = '$user_id'";
- $rs_check = Database::query($sql,__FILE__,__LINE__);
- //Then update or insert
- if (Database::num_rows($rs_check) > 0) {
- $sql = "UPDATE $tbl_session_rel_course_rel_user SET status = 2 WHERE id_session = '$session_id' AND course_code = '$course_code' AND id_user = '$user_id' ";
- $rs_update = Database::query($sql,__FILE__,__LINE__);
- if (Database::affected_rows() > 0) return true;
- else return false;
- } else {
- $sql = " INSERT INTO $tbl_session_rel_course_rel_user(id_session, course_code, id_user, status) VALUES('$session_id', '$course_code', '$user_id', 2)";
- $rs_insert = Database::query($sql,__FILE__,__LINE__);
- if (Database::affected_rows() > 0) return true;
- else return false;
- }
- }
- } else {
- return false;
- }
- }
- }
|