123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577 |
- <?php
- /*
- ==============================================================================
- Dokeos - elearning and course management software
- Copyright (c) 2004 Dokeos S.A.
- Copyright (c) 2003 Ghent University (UGent)
- Copyright (c) 2001 Universite catholique de Louvain (UCL)
- Copyright (c) various contributors
- For a full list of contributors, see "credits.txt".
- The full license can be read in "license.txt".
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License
- as published by the Free Software Foundation; either version 2
- of the License, or (at your option) any later version.
- See the GNU General Public License for more details.
- Contact: Dokeos, 181 rue Royale, B-1000 Brussels, Belgium, info@dokeos.com
- ==============================================================================
- */
- /**
- ==============================================================================
- * This script displays a list of the users of the current course.
- * Course admins can change user perimssions, subscribe and unsubscribe users...
- *
- * EXPERIMENTAL: support for virtual courses
- * - show users registered in virtual and real courses;
- * - only show the users of a virtual course if the current user;
- * is registered in that virtual course.
- *
- * Exceptions: platform admin and the course admin will see all virtual courses.
- * This is a new feature, there may be bugs.
- *
- * @todo possibility to edit user-course rights and view statistics for users in virtual courses
- * @todo convert normal table display to display function (refactor virtual course display function)
- * @todo display table functions need support for align and valign (e.g. to center text in cells) (this is now possible)
- * @author Roan Embrechts, refactoring + virtual courses support
- * @package dokeos.user
- ==============================================================================
- */
- /*
- ==============================================================================
- INIT SECTION
- ==============================================================================
- */
- $langFile = array('registration','admin');
- require_once ("../inc/global.inc.php");
- $this_section = SECTION_COURSES;
- /*
- -----------------------------------------------------------
- Libraries
- -----------------------------------------------------------
- */
- require_once (api_get_path(LIBRARY_PATH)."debug.lib.inc.php");
- require_once (api_get_path(LIBRARY_PATH)."events.lib.inc.php");
- require_once (api_get_path(LIBRARY_PATH)."export.lib.inc.php");
- require_once (api_get_path(LIBRARY_PATH)."course.lib.php");
- require_once (api_get_path(LIBRARY_PATH).'sortabletable.class.php');
- require_once (api_get_path(LIBRARY_PATH).'formvalidator/FormValidator.class.php');
- //CHECK KEYS
- if( !isset ($_cid))
- {
- header("location: ".$rootWeb);
- }
- /*
- -----------------------------------------------------------
- Constants and variables
- -----------------------------------------------------------
- */
- $currentCourseID = $_course['sysCode'];
- /*
- ==============================================================================
- FUNCTIONS
- ==============================================================================
- */
- function display_user_search_form()
- {
- echo '<form method="get" action="user.php">';
- echo get_lang("SearchForUser") . " ";
- echo '<input type="text" name="keyword" value="'.$_GET['keyword'].'"/>';
- echo '<input type="submit" value="'.get_lang('SearchButton').'"/>';
- echo '</form>';
- }
- /**
- * This function displays a list if users for each virtual course linked to the current
- * real course.
- *
- * defines globals
- *
- * @version 1.0
- * @author Roan Embrechts
- * @todo users from virtual courses always show "-" for the group related output. Edit and statistics columns are disabled * for these users, for now.
- */
- function show_users_in_virtual_courses()
- {
- global $_course, $_uid;
- $real_course_code = $_course['sysCode'];
- $real_course_info = Database::get_course_info($real_course_code);
- $user_subscribed_virtual_course_list = CourseManager::get_list_of_virtual_courses_for_specific_user_and_real_course($_uid, $real_course_code);
- $number_of_virtual_courses = count($user_subscribed_virtual_course_list);
- $row = 0;
- $column_header[$row ++] = "ID";
- $column_header[$row ++] = get_lang("FullUserName");
- $column_header[$row ++] = get_lang("Role");
- $column_header[$row ++] = get_lang("Group");
- if( api_is_allowed_to_edit())
- {
- $column_header[$row ++] = get_lang("Tutor");
- }
- if( api_is_allowed_to_edit())
- {
- $column_header[$row ++] = get_lang("CourseManager");
- }
- //$column_header[$row++] = get_lang("Edit");
- //$column_header[$row++] = get_lang("Unreg");
- //$column_header[$row++] = get_lang("Tracking");
- if( !is_array($user_subscribed_virtual_course_list))
- return;
- foreach ($user_subscribed_virtual_course_list as $virtual_course)
- {
- $virtual_course_code = $virtual_course["code"];
- $virtual_course_user_list = CourseManager::get_user_list_from_course_code($virtual_course_code);
- $message = get_lang("RegisteredInVirtualCourse")." ".$virtual_course["title"]." (".$virtual_course["code"].")";
- echo "<br/>";
- echo "<h4>".$message."</h4>";
- $properties["width"] = "100%";
- $properties["cellspacing"] = "1";
- Display::display_complex_table_header($properties, $column_header);
- foreach ($virtual_course_user_list as $this_user)
- {
- $user_id = $this_user["user_id"];
- $loginname = $this_user["username"];
- $lastname = $this_user["lastname"];
- $firstname = $this_user["firstname"];
- $status = $this_user["status"];
- $role = $this_user["role"];
- if( $status == "1")
- $status = get_lang("CourseManager");
- else
- $status = " - ";
- //if(xxx['tutor'] == '0') $tutor = " - ";
- //else $tutor = get_lang("Tutor");
- $full_name = $lastname.", ".$firstname;
- if( $lastname == "" || $firstname == '')
- $full_name = $loginname;
- $user_info_hyperlink = "<a href=\"userInfo.php?".api_get_cidreq()."&origin=".$origin."&uInfo=".$user_id."&virtual_course=".$virtual_course["code"]."\">".$full_name."</a>";
- $row = 0;
- $table_row[$row ++] = $user_id;
- $table_row[$row ++] = $user_info_hyperlink; //Full name
- $table_row[$row ++] = $role; //Description
- $table_row[$row ++] = " - "; //Group, for the moment groups don't work for students in virtual courses
- if( api_is_allowed_to_edit())
- $table_row[$row ++] = " - "; //Tutor column
- if( api_is_allowed_to_edit())
- $table_row[$row ++] = $status; //Course Manager column
- Display::display_table_row($bgcolor, $table_row, true);
- }
- Display::display_table_footer();
- }
- }
- /*
- ==============================================================================
- MAIN CODE
- ==============================================================================
- */
- if(!$is_allowed_in_course)
- api_not_allowed();
- //statistics
- event_access_tool(TOOL_USER);
- /*
- --------------------------------------
- Setting the permissions for this page
- --------------------------------------
- */
- $is_allowed_to_track = $is_courseAdmin && $is_trackingEnabled;
- /*
- --------------------------------------
- Unregistering a user section
- --------------------------------------
- */
- if(api_is_allowed_to_edit())
- {
- if(isset($_POST['action']))
- {
- switch($_POST['action'])
- {
- case 'unsubscribe' :
- // Make sure we don't unsubscribe current user from the course
- $user_ids = array_diff($_POST['user'],array($_uid));
- if(count($user_ids) > 0)
- {
- CourseManager::unsubscribe_user($user_ids, $_SESSION['_course']['sysCode']);
- $message = get_lang('UsersUnsubscribed');
- }
- break;
- }
- }
- }
- if(api_is_allowed_to_edit())
- {
- if( isset ($_GET['action']))
- {
- switch ($_GET['action'])
- {
- case 'export' :
- if(api_get_setting('use_session_mode')!="true"){
- $table_user = Database::get_main_table(MAIN_USER_TABLE);
- $table_course_user = Database::get_main_table(MAIN_COURSE_USER_TABLE);
- $course = api_get_course_info();
- $sql = "SELECT official_code,firstname,lastname,email FROM $table_user u, $table_course_user cu WHERE cu.user_id = u.user_id AND cu.course_code = '".$course['sysCode']."' ORDER BY lastname ASC";
- }
- else {
- $sql = "SELECT `user`.`user_id`, `user`.`lastname`, `user`.`firstname`,
- `user`.`email`, `user`.`official_code`, session.name
- FROM ".Database::get_main_table(MAIN_USER_TABLE)." `user`, ".Database::get_main_table(MAIN_SESSION_COURSE_USER_TABLE)." cu, ".Database::get_main_table(MAIN_SESSION_TABLE)." session
- WHERE `user`.`user_id`= cu.`id_user`
- AND cu.`course_code`='".$currentCourseID."'
- AND session.id=cu.id_session
- AND session.id='".$_SESSION['id_session']."'";
- }
- $users = api_sql_query($sql, __FILE__, __LINE__);
- while ($user = mysql_fetch_array($users, MYSQL_ASSOC))
- {
- $data[] = $user;
- }
- switch ($_GET['type'])
- {
- case 'csv' :
- Export::export_table_csv($data);
- case 'xls' :
- Export::export_table_xls($data);
- }
- }
- }
- } // end if allowed to edit
- if(api_is_allowed_to_edit())
- {
- // Unregister user from course
- if($_GET['unregister'])
- {
- if(isset($_GET['user_id']) && is_numeric($_GET['user_id']) && $_GET['user_id'] != $_uid)
- {
- CourseManager::unsubscribe_user($_GET['user_id'],$_SESSION['_course']['sysCode']);
- $message = get_lang('UserUnsubscribed');
- }
- }
- } // end if allowed to edit
- /*
- -----------------------------------------------------------
- Header
- -----------------------------------------------------------
- */
- if( $origin != 'learnpath')
- {
- //so we are not in learnpath tool
- $nameTools = get_lang("Users");
- Display::display_header($nameTools, "User");
- }
- else
- {
- ?> <link rel="stylesheet" type="text/css" href="<?php echo api_get_path(WEB_CODE_PATH); ?>css/default.css" /> <?php
- }
- if( isset($message))
- {
- Display::display_normal_message($message);
- }
- /*
- -----------------------------------------------------------
- Introduction section
- (editable by course admins)
- -----------------------------------------------------------
- */
- Display::display_introduction_section(TOOL_USER, $is_allowed);
- if( api_is_allowed_to_edit())
- {
- echo "<div align=\"right\">";
- echo '<a href="user.php?action=export&type=csv">'.get_lang('ExportAsCSV').'</a> | ';
- echo '<a href="user.php?action=export&type=xls">'.get_lang('ExportAsXLS').'</a> | ';
- echo "<a href=\"subscribe_user.php\">".get_lang("SubscribeUserToCourse")."</a> | ";
- echo "<a href=\"../group/group.php?".api_get_cidreq()."\">".get_lang("GroupUserManagement")."</a>";
- if(api_get_setting('use_session_mode')=='false')
- {
- echo ' | <a href="class.php">'.get_lang('Classes').'</a>';
- }
- echo "</div>";
- }
- /*
- --------------------------------------
- DISPLAY USERS LIST
- --------------------------------------
- Also shows a "next page" button if there are
- more than 50 users.
- There's a bug in here somewhere - some users count as more than one if they are in more than one group
- --> code for > 50 users should take this into account
- (Roan, Feb 2004)
- */
- if( CourseManager::has_virtual_courses_from_code($course_id, $user_id))
- {
- $real_course_code = $_course['sysCode'];
- $real_course_info = Database::get_course_info($real_course_code);
- $message = get_lang("RegisteredInRealCourse")." ".$real_course_info["title"]." (".$real_course_info["official_code"].")";
- echo "<h4>".$message."</h4>";
- }
- /*
- ==============================================================================
- DISPLAY LIST OF USERS
- ==============================================================================
- */
- /**
- * * Get the users to display on the current page.
- */
- function get_number_of_users()
- {
- $user_table = Database::get_main_table(MAIN_USER_TABLE);
- $course_user_table = Database::get_main_table(MAIN_COURSE_USER_TABLE);
- if(api_get_setting('use_session_mode')!="true"){
- $sql = "SELECT COUNT(u.user_id) AS number_of_users FROM $user_table u,$course_user_table cu WHERE u.user_id = cu.user_id and course_code='".$_SESSION['_course']['id']."'";
- }
- else{
- $sql = "SELECT COUNT(id_user)+1 AS number_of_users
- FROM ".Database::get_main_table(MAIN_SESSION_COURSE_USER_TABLE)."
- WHERE course_code= '".$_SESSION['_course']['id']."'
- AND id_session='".$_SESSION['id_session']."'";
- }
- if( isset ($_GET['keyword']))
- {
- $keyword = mysql_real_escape_string($_GET['keyword']);
- $sql .= " AND (firstname LIKE '%".$keyword."%' OR lastname LIKE '%".$keyword."%' OR username LIKE '%".$keyword."%' OR official_code LIKE '%".$keyword."%')";
- }
- $res = api_sql_query($sql, __FILE__, __LINE__);
- $result = mysql_fetch_object($res);
- return $result->number_of_users;
- }
- /**
- * Get the users to display on the current page.
- */
- function get_user_data($from, $number_of_items, $column, $direction)
- {
- global $is_allowed_to_track;
- if(api_get_setting('use_session_mode')!='true')
- {
- $user_table = Database::get_main_table(MAIN_USER_TABLE);
- $course_user_table = Database::get_main_table(MAIN_COURSE_USER_TABLE);
- if(api_is_allowed_to_edit())
- $columns[] = 'u.user_id';
- $columns[] = 'u.official_code';
- $columns[] = 'u.lastname';
- $columns[] = 'u.firstname';
- $columns[] = 'cu.role';
- $columns[] = "''"; //placeholder for group-data
- if(api_is_allowed_to_edit())
- {
- $columns[] = "IF(cu.tutor_id = 1,'".get_lang('Tutor')."','')";
- $columns[] = "IF(cu.status = 1,'".get_lang('CourseManager')."','')";
- }
- $columns[] = 'u.user_id';
- $sql = "SELECT ";
- foreach( $columns as $index => $sqlcolumn)
- $columns[$index] = ' '.$sqlcolumn.' AS col'.$index.' ';
- $sql .= implode(" , ", $columns);
- $sql .= "FROM $user_table u,$course_user_table cu WHERE u.user_id = cu.user_id and course_code='".$_SESSION['_course']['id']."'";
- if( isset ($_GET['keyword']))
- {
- $keyword = mysql_real_escape_string($_GET['keyword']);
- $sql .= " AND (firstname LIKE '%".$keyword."%' OR lastname LIKE '%".$keyword."%' OR username LIKE '%".$keyword."%' OR official_code LIKE '%".$keyword."%')";
- }
- $sql .= " ORDER BY col$column $direction ";
- $sql .= " LIMIT $from, $number_of_items";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- $users = array();
- $user_ids = array();
- while($user = mysql_fetch_row($res))
- {
- $users[''.$user[0]] = $user;
- $user_ids[] = $user[0];
- }
- $sql = "
- SELECT
- ug.user_id,
- ug.group_id group_id,
- sg.name
- FROM " . Database::get_course_table(GROUP_USER_TABLE) . " ug
- LEFT JOIN " . Database::get_course_table(GROUP_TABLE) . " sg ON ug.group_id = sg.id
- WHERE ug.user_id IN ('".implode("','", $user_ids)."')";
- $res = api_sql_query($sql,__FILE__,__LINE__);
- while($group = mysql_fetch_object($res))
- $users[''.$group->user_id][5] .= $group->name.'<br />';
- }
- else {
- $columns = array();
- if(api_is_allowed_to_edit())
- {
- $columns[] = 'u.user_id';
- }
- $columns[] = 'u.official_code';
- $columns[] = 'u.lastname';
- $columns[] = 'u.firstname';
- $columns[] = '"Professor"';
- $columns[] = "''"; //placeholder for group-data
- if(api_is_allowed_to_edit())
- {
- $columns[] = "'".get_lang('Tutor')."'";
- $columns[] = "'".get_lang('CourseManager')."'";
- }
- $columns[] = 'u.user_id';
- $sql = "SELECT ".implode(',',$columns)."
- FROM ".Database::get_main_table(MAIN_USER_TABLE)." `u`, ".Database::get_main_table(MAIN_SESSION_COURSE_TABLE)." c
- WHERE `u`.`user_id`= c.`id_coach`
- AND c.`course_code`='".$_SESSION['_course']['id']."'
- AND c.id_session='".$_SESSION['id_session']."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- $users = array ();
- while ($user = mysql_fetch_row($res))
- {
- $users[''.$user[0]] = $user;
- $user_ids[] = $user[0];
- }
- $columns = array();
- if(api_is_allowed_to_edit())
- {
- $columns[] = 'u.user_id';
- }
- $columns[] = 'u.official_code';
- $columns[] = 'u.lastname';
- $columns[] = 'u.firstname';
- $columns[] = '"Professor"';
- $columns[] = "''"; //placeholder for group-data
- if(api_is_allowed_to_edit())
- {
- $columns[] = "''";
- $columns[] = "''";
- }
- $columns[] = 'u.user_id';
- $sql = "SELECT ".implode(',',$columns)."
- FROM ".Database::get_main_table(MAIN_USER_TABLE)." `u`, ".Database::get_main_table(MAIN_SESSION_COURSE_USER_TABLE)." c
- WHERE `u`.`user_id`= c.`id_user`
- AND c.`course_code`='".$_SESSION['_course']['id']."'
- AND c.id_session='".$_SESSION['id_session']."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- while ($user = mysql_fetch_row($res))
- {
- $users[''.$user[0]] = $user;
- $user_ids[] = $user[0];
- }
- $sql = "SELECT ug.user_id, ug.group_id group_id, sg.name
- FROM ".Database::get_course_table(GROUP_USER_TABLE)." ug
- LEFT JOIN ".Database::get_course_table(GROUP_TABLE)." sg
- ON ug.group_id = sg.id
- WHERE ug.user_id IN ('".implode("','", $user_ids)."')";
- $res = api_sql_query($sql,__FILE__,__LINE__);
- while($group = mysql_fetch_object($res))
- {
- $users[''.$group->user_id][5] .= $group->name.'<br />';
- }
- }
- return $users;
- }
- /**
- * Build the modify-column of the table
- * @param int $user_id The user id
- * @return string Some HTML-code
- */
- function modify_filter($user_id)
- {
- global $origin,$_uid,$is_allowed_to_track;
- // info
- $result = '<a href="userInfo.php?origin='.$origin.'&uInfo='.$user_id.'"><img border="0" alt="'.get_lang('Info').'" src="../img/info_small.gif" /></a>';
- if(api_is_allowed_to_edit())
- {
- if($is_allowed_to_track)
- {
- $result .= '<a href="../tracking/userLog.php?'.api_get_cidreq().'&origin='.$origin.'&uInfo='.$user_id.'"><img border="0" alt="'.get_lang('Tracking').'" src="../img/statistics.gif" /></a>';
- }
- // edit
- $result .= '<a href="userInfo.php?origin='.$origin.'&editMainUserInfo='.$user_id.'"><img border="0" alt="'.get_lang('Edit').'" src="../img/edit.gif" /></a>';
- // unregister
- if( $user_id != $_uid)
- {
- $result .= '<a href="'.$_SERVER['PHP_SELF'].'?unregister=yes&user_id='.$user_id.'&'.$sort_params.'" onclick="javascript:if(!confirm(\''.addslashes(htmlentities(get_lang('ConfirmYourChoice'))).'\')) return false;"><img border="0" alt="'.get_lang("Unreg").'" src="../img/delete.gif"/></a>';
- }
- }
- return $result;
- }
- $default_column = api_is_allowed_to_edit() ? 2 : 1;
- $table = new SortableTable('users', 'get_number_of_users', 'get_user_data',$default_column);
- $parameters['keyword'] = $_GET['keyword'];
- $table->set_additional_parameters($parameters);
- $header_nr = 0;
- if( api_is_allowed_to_edit())
- {
- $table->set_header($header_nr++, '', false);
- }
- $table->set_header($header_nr++, get_lang('OfficialCode'));
- $table->set_header($header_nr++, get_lang('Lastname'));
- $table->set_header($header_nr++, get_lang('Firstname'));
- $table->set_header($header_nr++, get_lang('Role'));
- $table->set_header($header_nr++, get_lang('Group'),false);
- if( api_is_allowed_to_edit())
- {
- $table->set_header($header_nr++, get_lang('Tutor'));
- $table->set_header($header_nr++, get_lang('CourseManager'));
- }
- //actions column
- $table->set_header($header_nr++, '', false);
- $table->set_column_filter($header_nr-1,'modify_filter');
- if( api_is_allowed_to_edit())
- {
- $table->set_form_actions(array ('unsubscribe' => get_lang('Unreg')), 'user');
- }
- // Build search-form
- $form = new FormValidator('search_user', 'get','','',null,false);
- $renderer = & $form->defaultRenderer();
- $renderer->setElementTemplate('<span>{element}</span> ');
- $form->add_textfield('keyword', '', false);
- $form->addElement('submit', 'submit', get_lang('SearchButton'));
- $form->display();
- echo '<br />';
- $table->display();
- if( get_setting('allow_user_headings') == 'true' && $is_courseAdmin && api_is_allowed_to_edit() && $origin != 'learnpath') // only course administrators see this line
- {
- echo "<div align=\"right\">", "<form method=\"post\" action=\"userInfo.php\">", get_lang("CourseAdministratorOnly"), " : ", "<input type=\"submit\" name=\"viewDefList\" value=\"".get_lang("DefineHeadings")."\" />", "</form>", "</div>\n";
- }
- //User list of the virtual courses linked to this course.
- //show_users_in_virtual_courses($is_allowed_to_track);
- /*
- ==============================================================================
- FOOTER
- ==============================================================================
- */
- if( $origin != 'learnpath')
- {
- Display::display_footer();
- }
- ?>
|