includeAllUsers = $includeAllUsers; } /** * @param bool $value */ public function setOnlyBestAttempts($value) { $this->onlyBestAttempts = $value; } /** * Gets the results of all students (or just one student if access is limited). * * @param string $document_path The document path (for HotPotatoes retrieval) * @param int $user_id User ID. Optional. If no user ID is provided, we take all the results. Defauts to null * @param int $filter * @param int $exercise_id * * @return bool */ public function getExercisesReporting( $document_path, $user_id = null, $filter = 0, $exercise_id = 0 ) { $return = []; $TBL_EXERCISES = Database::get_course_table(TABLE_QUIZ_TEST); $TBL_TABLE_LP_MAIN = Database::get_course_table(TABLE_LP_MAIN); $TBL_USER = Database::get_main_table(TABLE_MAIN_USER); $TBL_TRACK_EXERCISES = Database::get_main_table(TABLE_STATISTIC_TRACK_E_EXERCISES); $TBL_TRACK_ATTEMPT_RECORDING = Database::get_main_table(TABLE_STATISTIC_TRACK_E_ATTEMPT_RECORDING); $cid = api_get_course_id(); $course_id = api_get_course_int_id(); $user_id = intval($user_id); $sessionId = api_get_session_id(); $session_id_and = ' AND te.session_id = '.$sessionId.' '; $exercise_id = intval($exercise_id); if (!empty($exercise_id)) { $session_id_and .= " AND exe_exo_id = $exercise_id "; } if (empty($user_id)) { $user_id_and = null; $sql = "SELECT ".(api_is_western_name_order() ? "firstname as userpart1, lastname userpart2" : "lastname as userpart1, firstname as userpart2").", official_code, ce.title as extitle, te.score as exresult , te.max_score as exweight, te.exe_date as exdate, te.exe_id as exid, email as exemail, te.start_date as exstart, steps_counter as exstep, exe_user_id as excruid, te.exe_duration as duration, te.orig_lp_id as orig_lp_id, tlm.name as lp_name, user.username FROM $TBL_EXERCISES AS ce INNER JOIN $TBL_TRACK_EXERCISES AS te ON (te.exe_exo_id = ce.id) INNER JOIN $TBL_USER AS user ON (user.user_id = exe_user_id) LEFT JOIN $TBL_TABLE_LP_MAIN AS tlm ON (tlm.id = te.orig_lp_id AND tlm.c_id = ce.c_id) WHERE ce.c_id = $course_id AND te.status != 'incomplete' AND te.c_id = ce.c_id $user_id_and $session_id_and AND ce.active <>-1"; } else { $user_id_and = ' AND te.exe_user_id = '.api_get_user_id().' '; // get only this user's results $sql = "SELECT ".(api_is_western_name_order() ? "firstname as userpart1, lastname userpart2" : "lastname as userpart1, firstname as userpart2").", official_code, ce.title as extitle, te.score as exresult, te.max_score as exweight, te.exe_date as exdate, te.exe_id as exid, email as exemail, te.start_date as exstart, steps_counter as exstep, exe_user_id as excruid, te.exe_duration as duration, ce.results_disabled as exdisabled, te.orig_lp_id as orig_lp_id, tlm.name as lp_name, user.username FROM $TBL_EXERCISES AS ce INNER JOIN $TBL_TRACK_EXERCISES AS te ON (te.exe_exo_id = ce.id) INNER JOIN $TBL_USER AS user ON (user.user_id = exe_user_id) LEFT JOIN $TBL_TABLE_LP_MAIN AS tlm ON (tlm.id = te.orig_lp_id AND tlm.c_id = ce.c_id) WHERE ce.c_id = $course_id AND te.status != 'incomplete' AND te.c_id = ce.c_id $user_id_and $session_id_and AND ce.active <>-1 AND ORDER BY userpart2, te.c_id ASC, ce.title ASC, te.exe_date DESC"; } $results = []; $resx = Database::query($sql); $bestAttemptPerUser = []; while ($rowx = Database::fetch_array($resx, 'ASSOC')) { if ($this->onlyBestAttempts) { if (!isset($bestAttemptPerUser[$rowx['excruid']])) { $bestAttemptPerUser[$rowx['excruid']] = $rowx; } else { if ($rowx['exresult'] > $bestAttemptPerUser[$rowx['excruid']]['exresult']) { $bestAttemptPerUser[$rowx['excruid']] = $rowx; } } } else { $results[] = $rowx; } } if ($this->onlyBestAttempts) { // Remove userId indexes to avoid issues in output foreach ($bestAttemptPerUser as $attempt) { $results[] = $attempt; } } $filter_by_not_revised = false; $filter_by_revised = false; if ($filter) { switch ($filter) { case 1: $filter_by_not_revised = true; break; case 2: $filter_by_revised = true; break; default: null; } } if (empty($sessionId)) { $students = CourseManager::get_user_list_from_course_code($cid); } else { $students = CourseManager::get_user_list_from_course_code($cid, $sessionId); } $studentsUserIdList = array_keys($students); // Print the results of tests $userWithResults = []; if (is_array($results)) { $i = 0; foreach ($results as $result) { $revised = false; //revised or not $sql_exe = "SELECT exe_id FROM $TBL_TRACK_ATTEMPT_RECORDING WHERE author != '' AND exe_id = ".Database::escape_string($result['exid'])." LIMIT 1"; $query = Database::query($sql_exe); if (Database:: num_rows($query) > 0) { $revised = true; } if ($filter_by_not_revised && $revised) { continue; } if ($filter_by_revised && !$revised) { continue; } $return[$i] = []; if (empty($user_id)) { $return[$i]['official_code'] = $result['official_code']; if (api_is_western_name_order()) { $return[$i]['first_name'] = $results[$i]['userpart1']; $return[$i]['last_name'] = $results[$i]['userpart2']; } else { $return[$i]['first_name'] = $results[$i]['userpart2']; $return[$i]['last_name'] = $results[$i]['userpart1']; } $return[$i]['user_id'] = $results[$i]['excruid']; $return[$i]['email'] = $results[$i]['exemail']; $return[$i]['username'] = $results[$i]['username']; } $return[$i]['title'] = $result['extitle']; $return[$i]['start_date'] = api_get_local_time($result['exstart']); $return[$i]['end_date'] = api_get_local_time($result['exdate']); $return[$i]['duration'] = $result['duration']; $return[$i]['result'] = $result['exresult']; $return[$i]['max'] = $result['exweight']; $return[$i]['status'] = $revised ? get_lang('Validated') : get_lang('Not validated'); $return[$i]['lp_id'] = $result['orig_lp_id']; $return[$i]['lp_name'] = $result['lp_name']; if (in_array($result['excruid'], $studentsUserIdList)) { $return[$i]['is_user_subscribed'] = get_lang('Yes'); } else { $return[$i]['is_user_subscribed'] = get_lang('No'); } $userWithResults[$result['excruid']] = 1; $i++; } } if ($this->includeAllUsers) { $latestId = count($return); $userWithResults = array_keys($userWithResults); if (!empty($students)) { foreach ($students as $student) { if (!in_array($student['user_id'], $userWithResults)) { $i = $latestId; $isWestern = api_is_western_name_order(); if (empty($user_id)) { $return[$i]['official_code'] = $student['official_code']; if ($isWestern) { $return[$i]['first_name'] = $student['firstname']; $return[$i]['last_name'] = $student['lastname']; } else { $return[$i]['first_name'] = $student['lastname']; $return[$i]['last_name'] = $student['firstname']; } $return[$i]['user_id'] = $student['user_id']; $return[$i]['email'] = $student['email']; $return[$i]['username'] = $student[$i]['username']; } $return[$i]['title'] = null; $return[$i]['start_date'] = null; $return[$i]['end_date'] = null; $return[$i]['duration'] = null; $return[$i]['result'] = null; $return[$i]['max'] = null; $return[$i]['status'] = get_lang('Not attempted'); $return[$i]['lp_id'] = null; $return[$i]['lp_name'] = null; $return[$i]['is_user_subscribed'] = get_lang('Yes'); $latestId++; } } } } $this->results = $return; return true; } /** * Exports the complete report as a CSV file. * * @param string $document_path Document path inside the document tool * @param int $user_id Optional user ID * @param bool $export_user_fields Whether to include user fields or not * @param int $export_filter * @param int $exercise_id * * @return bool False on error */ public function exportCompleteReportCSV( $document_path = '', $user_id = null, $export_user_fields = false, $export_filter = 0, $exercise_id = 0 ) { global $charset; $this->getExercisesReporting( $document_path, $user_id, $export_filter, $exercise_id ); $now = api_get_local_time(); $filename = 'exercise_results_'.$now.'.csv'; if (!empty($user_id)) { $filename = 'exercise_results_user_'.$user_id.'_'.$now.'.csv'; } $filename = api_replace_dangerous_char($filename); $data = ''; if (api_is_western_name_order()) { if (!empty($this->results[0]['first_name'])) { $data .= get_lang('First name').';'; } if (!empty($this->results[0]['last_name'])) { $data .= get_lang('Last name').';'; } } else { if (!empty($this->results[0]['last_name'])) { $data .= get_lang('Last name').';'; } if (!empty($this->results[0]['first_name'])) { $data .= get_lang('First name').';'; } } $officialCodeInList = api_get_setting('show_official_code_exercise_result_list'); if ($officialCodeInList === 'true') { $data .= get_lang('Code').';'; } $data .= get_lang('Login').';'; $data .= get_lang('e-mail').';'; $data .= get_lang('Groups').';'; if ($export_user_fields) { //show user fields section with a big th colspan that spans over all fields $extra_user_fields = UserManager::get_extra_fields( 0, 1000, 5, 'ASC', false, 1 ); if (!empty($extra_user_fields)) { foreach ($extra_user_fields as $field) { $data .= '"'.str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($field[3]), ENT_QUOTES, $charset)).'";'; } } } $data .= get_lang('Title').';'; $data .= get_lang('Start Date').';'; $data .= get_lang('End Date').';'; $data .= get_lang('Duration').' ('.get_lang('minutes').') ;'; $data .= get_lang('Score').';'; $data .= get_lang('Total').';'; $data .= get_lang('Status').';'; $data .= get_lang('Learning path').';'; $data .= get_lang('The user is currently subscribed').';'; $data .= "\n"; //results foreach ($this->results as $row) { if (api_is_western_name_order()) { $data .= str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($row['first_name']), ENT_QUOTES, $charset)).';'; $data .= str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($row['last_name']), ENT_QUOTES, $charset)).';'; } else { $data .= str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($row['last_name']), ENT_QUOTES, $charset)).';'; $data .= str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($row['first_name']), ENT_QUOTES, $charset)).';'; } // Official code if ($officialCodeInList === 'true') { $data .= $row['official_code'].';'; } // e-mail $data .= str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($row['username']), ENT_QUOTES, $charset)).';'; $data .= str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($row['email']), ENT_QUOTES, $charset)).';'; $data .= str_replace("\r\n", ' ', implode(", ", GroupManager::get_user_group_name($row['user_id']))).';'; if ($export_user_fields) { //show user fields data, if any, for this user $user_fields_values = UserManager::get_extra_user_data( $row['user_id'], false, false, false, true ); if (!empty($user_fields_values)) { foreach ($user_fields_values as $value) { $data .= '"'.str_replace('"', '""', api_html_entity_decode(strip_tags($value), ENT_QUOTES, $charset)).'";'; } } } $duration = !empty($row['duration']) ? round($row['duration'] / 60) : 0; $data .= str_replace("\r\n", ' ', api_html_entity_decode(strip_tags($row['title']), ENT_QUOTES, $charset)).';'; $data .= str_replace("\r\n", ' ', $row['start_date']).';'; $data .= str_replace("\r\n", ' ', $row['end_date']).';'; $data .= str_replace("\r\n", ' ', $duration).';'; $data .= str_replace("\r\n", ' ', $row['result']).';'; $data .= str_replace("\r\n", ' ', $row['max']).';'; $data .= str_replace("\r\n", ' ', $row['status']).';'; $data .= str_replace("\r\n", ' ', $row['lp_name']).';'; $data .= str_replace("\r\n", ' ', $row['is_user_subscribed']).';'; $data .= "\n"; } // output the results $len = strlen($data); header('Content-type: application/octet-stream'); header('Content-Type: application/force-download'); header('Content-length: '.$len); if (preg_match("/MSIE 5.5/", $_SERVER['HTTP_USER_AGENT'])) { header('Content-Disposition: filename= '.$filename); } else { header('Content-Disposition: attachment; filename= '.$filename); } if (strpos($_SERVER['HTTP_USER_AGENT'], 'MSIE')) { header('Pragma: '); header('Cache-Control: '); header('Cache-Control: public'); // IE cannot download from sessions without a cache } header('Content-Description: '.$filename); header('Content-transfer-encoding: binary'); echo $data; return true; } /** * Exports the complete report as an XLS file. * * @param string $document_path * @param null $user_id * @param bool $export_user_fields * @param int $export_filter * @param int $exercise_id * @param null $hotpotato_name * * @return bool */ public function exportCompleteReportXLS( $document_path = '', $user_id = null, $export_user_fields = false, $export_filter = 0, $exercise_id = 0, $hotpotato_name = null ) { global $charset; $this->getExercisesReporting( $document_path, $user_id, $export_filter, $exercise_id, $hotpotato_name ); $now = api_get_local_time(); $filename = 'exercise_results_'.$now; if (!empty($user_id)) { $filename = 'exercise_results_user_'.$user_id.'_'.$now; } // check if exists column 'user' $withColumnUser = false; foreach ($this->results as $result) { if (!empty($result['last_name']) && !empty($result['first_name'])) { $withColumnUser = true; break; } } $officialCodeInList = api_get_setting('show_official_code_exercise_result_list'); $list = []; if ($withColumnUser) { if (api_is_western_name_order()) { $list[0][] = get_lang('First name'); $list[0][] = get_lang('Last name'); } else { $list[0][] = get_lang('Last name'); $list[0][] = get_lang('First name'); } if ($officialCodeInList === 'true') { $list[0][] = get_lang('Code'); } $list[0][] = get_lang('Login'); $list[0][] = get_lang('e-mail'); } $list[0][] = get_lang('Groups'); if ($export_user_fields) { //show user fields section with a big th colspan that spans over all fields $extra_user_fields = UserManager::get_extra_fields( 0, 1000, 5, 'ASC', false, 1 ); //show the fields names for user fields foreach ($extra_user_fields as $field) { $list[0][] = api_html_entity_decode( strip_tags($field[3]), ENT_QUOTES, $charset ); } } $list[0][] = get_lang('Title'); $list[0][] = get_lang('Start Date'); $list[0][] = get_lang('End Date'); $list[0][] = get_lang('Duration').' ('.get_lang('minutes').')'; $list[0][] = get_lang('Score'); $list[0][] = get_lang('Total'); $list[0][] = get_lang('Status'); $list[0][] = get_lang('Learning path'); $list[0][] = get_lang('The user is currently subscribed'); $column = 1; foreach ($this->results as $row) { if ($withColumnUser) { if (api_is_western_name_order()) { $list[$column][] = api_html_entity_decode( strip_tags($row['first_name']), ENT_QUOTES, $charset ); $list[$column][] = api_html_entity_decode( strip_tags($row['last_name']), ENT_QUOTES, $charset ); } else { $list[$column][] = api_html_entity_decode( strip_tags($row['last_name']), ENT_QUOTES, $charset ); $list[$column][] = api_html_entity_decode( strip_tags($row['first_name']), ENT_QUOTES, $charset ); } if ($officialCodeInList === 'true') { $list[$column][] = api_html_entity_decode( strip_tags($row['official_code']), ENT_QUOTES, $charset ); } $list[$column][] = api_html_entity_decode( strip_tags($row['username']), ENT_QUOTES, $charset ); $list[$column][] = api_html_entity_decode( strip_tags($row['email']), ENT_QUOTES, $charset ); } $list[$column][] = api_html_entity_decode( strip_tags( implode( ', ', GroupManager:: get_user_group_name($row['user_id']) ) ), ENT_QUOTES, $charset ); if ($export_user_fields) { // show user fields data, if any, for this user $values = UserManager::get_extra_user_data( $row['user_id'], false, false, false, true ); foreach ($values as $value) { $list[$column][] = api_html_entity_decode( strip_tags($value), ENT_QUOTES, $charset ); } } $list[$column][] = api_html_entity_decode( strip_tags($row['title']), ENT_QUOTES, $charset ); $list[$column][] = $row['start_date']; $list[$column][] = $row['end_date']; $duration = !empty($row['duration']) ? round($row['duration'] / 60) : 0; $list[$column][] = $duration; $list[$column][] = $row['result']; $list[$column][] = $row['max']; $list[$column][] = $row['status']; $list[$column][] = $row['lp_name']; $list[$column][] = $row['is_user_subscribed']; $column++; } Export::arrayToXls($list, $filename); return true; } }