gradebook_functions_users.inc.php 4.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133
  1. <?php
  2. /* For licensing terms, see /license.txt */
  3. /**
  4. * Various user related functions
  5. * @package dokeos.gradebook
  6. */
  7. /**
  8. * returns users within a course given by param
  9. * @param $course_id
  10. */
  11. function get_users_in_course($course_id) {
  12. $tbl_course_user = Database :: get_main_table(TABLE_MAIN_COURSE_USER);
  13. $tbl_session_course_user = Database :: get_main_table(TABLE_MAIN_SESSION_COURSE_USER);
  14. $tbl_user = Database :: get_main_table(TABLE_MAIN_USER);
  15. $order_clause = api_sort_by_first_name() ? ' ORDER BY firstname, lastname ASC' : ' ORDER BY lastname, firstname ASC';
  16. $current_session = api_get_session_id();
  17. if (!empty($current_session)) {
  18. $sql = "SELECT user.user_id,lastname,firstname
  19. FROM $tbl_session_course_user as scru, $tbl_user as user
  20. WHERE scru.id_user=user.user_id
  21. AND scru.status=0
  22. AND scru.course_code='$course_id' AND id_session ='$current_session' $order_clause ";
  23. } else {
  24. $sql = 'SELECT user.user_id,lastname,firstname'
  25. .' FROM '.$tbl_course_user.' as course_rel_user, '.$tbl_user.' as user'
  26. .' WHERE course_rel_user.user_id=user.user_id'
  27. .' AND course_rel_user.status='.STUDENT
  28. ." AND course_rel_user.course_code='".$course_id."'"
  29. .$order_clause;
  30. }
  31. $result = Database::query($sql);
  32. return get_user_array_from_sql_result($result);
  33. }
  34. function get_user_array_from_sql_result($result) {
  35. $a_students = array();
  36. while ($user = Database::fetch_array($result)) {
  37. if (!array_key_exists($user['user_id'],$a_students)) {
  38. $a_current_student = array ();
  39. $a_current_student[] = $user['user_id'];
  40. $a_current_student[] = $user['lastname'];
  41. $a_current_student[] = $user['firstname'];
  42. $a_students['STUD'.$user['user_id']] = $a_current_student;
  43. }
  44. }
  45. return $a_students;
  46. }
  47. function get_all_users ($evals = array(), $links = array()) {
  48. $coursecodes = array();
  49. $users = array();
  50. foreach ($evals as $eval) {
  51. $coursecode = $eval->get_course_code();
  52. // evaluation in course
  53. if (isset($coursecode) && !empty($coursecode)) {
  54. if (!array_key_exists($coursecode,$coursecodes)) {
  55. $coursecodes[$coursecode] = '1';
  56. $users = array_merge($users, get_users_in_course($coursecode));
  57. }
  58. } else {// course independent evaluation
  59. $tbl_user = Database :: get_main_table(TABLE_MAIN_USER);
  60. $tbl_res = Database :: get_main_table(TABLE_MAIN_GRADEBOOK_RESULT);
  61. $sql = 'SELECT user.user_id,lastname,firstname'
  62. .' FROM '.$tbl_res.' as res, '.$tbl_user.' as user'
  63. .' WHERE res.evaluation_id = '.$eval->get_id()
  64. .' AND res.user_id = user.user_id';
  65. $result = Database::query($sql);
  66. $users = array_merge($users,get_user_array_from_sql_result($result));
  67. }
  68. }
  69. foreach ($links as $link) {
  70. // links are always in a course
  71. $coursecode = $link->get_course_code();
  72. if (!array_key_exists($coursecode,$coursecodes)) {
  73. $coursecodes[$coursecode] = '1';
  74. $users = array_merge($users, get_users_in_course($coursecode));
  75. }
  76. }
  77. unset ($coursecodes);
  78. return $users;
  79. }
  80. /**
  81. * Search students matching a given last name and/or first name
  82. * @author Bert Stepp�
  83. */
  84. function find_students($mask= '') {
  85. // students shouldn't be here // don't search if mask empty
  86. if (!api_is_allowed_to_create_course() || empty ($mask)) {
  87. return null;
  88. }
  89. $tbl_user= Database :: get_main_table(TABLE_MAIN_USER);
  90. $tbl_cru= Database :: get_main_table(TABLE_MAIN_COURSE_USER);
  91. $sql= 'SELECT DISTINCT user.user_id, user.lastname, user.firstname, user.email' . ' FROM ' . $tbl_user . ' user';
  92. if (!api_is_platform_admin()) {
  93. $sql .= ', ' . $tbl_cru . ' cru';
  94. }
  95. $sql .= ' WHERE user.status = ' . STUDENT;
  96. $sql .= ' AND (user.lastname LIKE '."'%" . $mask . "%'";
  97. $sql .= ' OR user.firstname LIKE '."'%" . $mask . "%')";
  98. if (!api_is_platform_admin()) {
  99. $sql .= ' AND user.user_id = cru.user_id AND cru.relation_type<>'.COURSE_RELATION_TYPE_RRHH.' ' . ' AND cru.course_code in' . ' (SELECT course_code' . ' FROM ' . $tbl_cru . ' WHERE user_id = ' . api_get_user_id() . ' AND status = ' . COURSEMANAGER . ')';
  100. }
  101. $sql .= ' ORDER BY lastname';
  102. $result= Database::query($sql);
  103. $db_users= Database::store_result($result);
  104. return $db_users;
  105. }
  106. /**
  107. * Get user information from a given id
  108. * @param int $userid The userid
  109. * @return array All user information as an associative array
  110. */
  111. function get_user_info_from_id($userid) {
  112. $user_table= Database :: get_main_table(TABLE_MAIN_USER);
  113. $sql= 'SELECT * FROM ' . $user_table . ' WHERE user_id=' . $userid;
  114. $res= Database::query($sql);
  115. $user= Database::fetch_array($res,ASSOC);
  116. return $user;
  117. }