, Ghent University * * @version January 2007 */ public static function remove_answer($user, $survey_id, $question_id, $course_id) { $course_id = intval($course_id); // table definition $table = Database::get_course_table(TABLE_SURVEY_ANSWER); $sql = "DELETE FROM $table WHERE c_id = $course_id AND user = '".Database::escape_string($user)."' AND survey_id = '".intval($survey_id)."' AND question_id = '".intval($question_id)."'"; Database::query($sql); } /** * This function stores an answer of a user on a question of a survey. * * @param mixed The user id or email of the person who fills the survey * @param int Survey id * @param int Question id * @param int Option id * @param string Option value * @param array $survey_data Survey data settings * * @return bool False if insufficient data, true otherwise * * @author Patrick Cool , Ghent University * * @version January 2007 */ public static function store_answer( $user, $survey_id, $question_id, $option_id, $option_value, $survey_data ) { // If the question_id is empty, don't store an answer if (empty($question_id)) { return false; } // Table definition $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); // Make the survey anonymous if ($survey_data['anonymous'] == 1) { $surveyUser = Session::read('surveyuser'); if (empty($surveyUser)) { $user = md5($user.time()); Session::write('surveyuser', $user); } else { $user = Session::read('surveyuser'); } } $answer = new CSurveyAnswer(); $answer ->setCId($survey_data['c_id']) ->setUser($user) ->setSurveyId($survey_id) ->setQuestionId($question_id) ->setOptionId($option_id) ->setValue($option_value) ; $em = Database::getManager(); $em->persist($answer); $em->flush(); $insertId = $answer->getIid(); if ($insertId) { $sql = "UPDATE $table_survey_answer SET answer_id = $insertId WHERE iid = $insertId"; Database::query($sql); } return true; } /** * This function checks the parameters that are used in this page. * * @return string $people_filled The header, an error and the footer if any parameter fails, else it returns true * * @author Patrick Cool , Ghent University * * @version February 2007 */ public static function check_parameters($people_filled) { $error = false; // Getting the survey data $survey_data = SurveyManager::get_survey($_GET['survey_id']); // $_GET['survey_id'] has to be numeric if (!is_numeric($_GET['survey_id'])) { $error = get_lang('Unknown survey id'); } // $_GET['action'] $allowed_actions = [ 'overview', 'questionreport', 'userreport', 'comparativereport', 'completereport', 'deleteuserreport', ]; if (isset($_GET['action']) && !in_array($_GET['action'], $allowed_actions)) { $error = get_lang('Action not allowed'); } // User report if (isset($_GET['action']) && $_GET['action'] == 'userreport') { if ($survey_data['anonymous'] == 0) { foreach ($people_filled as $key => &$value) { $people_filled_userids[] = $value['invited_user']; } } else { $people_filled_userids = $people_filled; } if (isset($_GET['user']) && !in_array($_GET['user'], $people_filled_userids)) { $error = get_lang('Unknow user'); } } // Question report if (isset($_GET['action']) && $_GET['action'] == 'questionreport') { if (isset($_GET['question']) && !is_numeric($_GET['question'])) { $error = get_lang('Unknown question'); } } if ($error) { $tool_name = get_lang('Reporting'); Display::addFlash( Display::return_message( get_lang('Error').': '.$error, 'error', false ) ); Display::display_header($tool_name); Display::display_footer(); exit; } else { return true; } } /** * This function deals with the action handling. * * @param array $survey_data * @param array $people_filled * * @author Patrick Cool , Ghent University * * @version February 2007 */ public static function handle_reporting_actions($survey_data, $people_filled) { $action = isset($_GET['action']) ? $_GET['action'] : ''; // Getting the number of question $temp_questions_data = SurveyManager::get_questions($_GET['survey_id']); // Sorting like they should be displayed and removing the non-answer question types (comment and pagebreak) $my_temp_questions_data = $temp_questions_data == null ? [] : $temp_questions_data; $questions_data = []; foreach ($my_temp_questions_data as $key => &$value) { if ($value['type'] != 'pagebreak') { $questions_data[$value['sort']] = $value; } } // Counting the number of questions that are relevant for the reporting $survey_data['number_of_questions'] = count($questions_data); switch ($action) { case 'questionreport': self::display_question_report($survey_data); break; case 'userreport': self::displayUserReport($survey_data, $people_filled); break; case 'comparativereport': self::display_comparative_report(); break; case 'completereport': echo self::displayCompleteReport($survey_data); break; case 'deleteuserreport': self::delete_user_report($_GET['survey_id'], $_GET['user']); break; } } /** * This function deletes the report of an user who wants to retake the survey. * * @param int $survey_id * @param int $user_id * * @author Christian Fasanando Flores * * @version November 2008 */ public static function delete_user_report($survey_id, $user_id) { $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION); $table_survey = Database::get_course_table(TABLE_SURVEY); $course_id = api_get_course_int_id(); $survey_id = (int) $survey_id; $user_id = Database::escape_string($user_id); if (!empty($survey_id) && !empty($user_id)) { // delete data from survey_answer by user_id and survey_id $sql = "DELETE FROM $table_survey_answer WHERE c_id = $course_id AND survey_id = '".$survey_id."' AND user = '".$user_id."'"; Database::query($sql); // update field answered from survey_invitation by user_id and survey_id $sql = "UPDATE $table_survey_invitation SET answered = '0' WHERE c_id = $course_id AND survey_code = ( SELECT code FROM $table_survey WHERE c_id = $course_id AND survey_id = '".$survey_id."' ) AND user = '".$user_id."'"; $result = Database::query($sql); } if ($result !== false) { $message = get_lang('The user\'s answers to the survey have been succesfully removed.').'
'. get_lang('Go back').''; echo Display::return_message($message, 'confirmation', false); } } /** * @param array $survey_data * @param array $people_filled * * @return string */ public static function displayUserReportForm($survey_data, $people_filled) { $surveyId = $survey_data['survey_id']; if (empty($survey_data)) { return ''; } // Step 1: selection of the user echo ""; echo get_lang('Select user who filled the survey').'
'; echo ''; } /** * @param int $userId * @param array $survey_data * @param bool $addMessage */ public static function displayUserReportAnswers($userId, $survey_data, $addMessage = true) { // Database table definitions $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION); $table_survey_question_option = Database::get_course_table(TABLE_SURVEY_QUESTION_OPTION); $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); $course_id = (int) $survey_data['c_id']; $surveyId = (int) $survey_data['survey_id']; $userId = Database::escape_string($userId); $content = ''; // Step 2: displaying the survey and the answer of the selected users if (!empty($userId)) { if ($addMessage) { $content .= Display::return_message( get_lang('This screen displays an exact copy of the form as it was filled by the user'), 'normal', false ); } // Getting all the questions and options $sql = "SELECT survey_question.question_id, survey_question.survey_id, survey_question.survey_question, survey_question.display, survey_question.max_value, survey_question.sort, survey_question.type, survey_question_option.question_option_id, survey_question_option.option_text, survey_question_option.sort as option_sort FROM $table_survey_question survey_question LEFT JOIN $table_survey_question_option survey_question_option ON survey_question.question_id = survey_question_option.question_id AND survey_question_option.c_id = $course_id WHERE survey_question NOT LIKE '%{{%' AND survey_question.survey_id = '".$surveyId."' AND survey_question.c_id = $course_id ORDER BY survey_question.sort, survey_question_option.sort ASC"; $result = Database::query($sql); while ($row = Database::fetch_array($result, 'ASSOC')) { if ($row['type'] != 'pagebreak') { $questions[$row['sort']]['question_id'] = $row['question_id']; $questions[$row['sort']]['survey_id'] = $row['survey_id']; $questions[$row['sort']]['survey_question'] = $row['survey_question']; $questions[$row['sort']]['display'] = $row['display']; $questions[$row['sort']]['type'] = $row['type']; $questions[$row['sort']]['maximum_score'] = $row['max_value']; $questions[$row['sort']]['options'][$row['question_option_id']] = $row['option_text']; } } // Getting all the answers of the user $sql = "SELECT * FROM $table_survey_answer WHERE c_id = $course_id AND survey_id = '".$surveyId."' AND user = '".$userId."'"; $result = Database::query($sql); while ($row = Database::fetch_array($result, 'ASSOC')) { $answers[$row['question_id']][] = $row['option_id']; $all_answers[$row['question_id']][] = $row; } // Displaying all the questions foreach ($questions as &$question) { // If the question type is a scoring then we have to format the answers differently switch ($question['type']) { case 'score': $finalAnswer = []; if (is_array($question) && is_array($all_answers)) { foreach ($all_answers[$question['question_id']] as $key => &$answer_array) { $finalAnswer[$answer_array['option_id']] = $answer_array['value']; } } break; case 'multipleresponse': $finalAnswer = isset($answers[$question['question_id']]) ? $answers[$question['question_id']] : ''; break; default: $finalAnswer = ''; if (isset($all_answers[$question['question_id']])) { $finalAnswer = $all_answers[$question['question_id']][0]['option_id']; } break; } $display = survey_question::createQuestion($question['type']); $url = api_get_self(); $form = new FormValidator('question', 'post', $url); $form->addHtml('
'); $form->addHtml($question['survey_question']); $display->render($form, $question, $finalAnswer); $form->addHtml('
'); $content .= $form->returnForm(); } } return $content; } /** * This function displays the user report which is basically nothing more * than a one-page display of all the questions * of the survey that is filled with the answers of the person who filled the survey. * * @return string html code of the one-page survey with the answers of the selected user * * @author Patrick Cool , Ghent University * * @version February 2007 - Updated March 2008 */ public static function displayUserReport($survey_data, $people_filled, $addActionBar = true) { if (empty($survey_data)) { return ''; } $surveyId = $survey_data['survey_id']; $reportingUrl = api_get_path(WEB_CODE_PATH).'survey/reporting.php?survey_id='.$surveyId.'&'.api_get_cidreq(); // Actions bar if ($addActionBar) { echo ''; } echo self::displayUserReportForm($survey_data, $people_filled); if (isset($_GET['user'])) { echo self::displayUserReportAnswers($_GET['user'], $survey_data); } } /** * This function displays the report by question. * * It displays a table with all the options of the question and the number of users who have answered positively on * the option. The number of users who answered positive on a given option is expressed in an absolute number, in a * percentage of the total and graphically using bars By clicking on the absolute number you get a list with the * persons who have answered this. You can then click on the name of the person and you will then go to the report * by user where you see all the answers of that user. * * @param array All the survey data * * @return string html code that displays the report by question * * @todo allow switching between horizontal and vertical. * @todo multiple response: percentage are probably not OK * @todo the question and option text have to be shortened and should expand when the user clicks on it. * @todo the pagebreak and comment question types should not be shown => removed from $survey_data before * * @author Patrick Cool , Ghent University * * @version February 2007 - Updated March 2008 */ public static function display_question_report($survey_data) { $singlePage = isset($_GET['single_page']) ? (int) $_GET['single_page'] : 0; // Determining the offset of the sql statement (the n-th question of the survey) $offset = !isset($_GET['question']) ? 0 : (int) $_GET['question']; $currentQuestion = isset($_GET['question']) ? (int) $_GET['question'] : 0; $surveyId = (int) $_GET['survey_id']; $action = Security::remove_XSS($_GET['action']); $course_id = api_get_course_int_id(); // Database table definitions $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION); $table_survey_question_option = Database::get_course_table(TABLE_SURVEY_QUESTION_OPTION); $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); $questions = []; echo ''; if ($survey_data['number_of_questions'] > 0) { $limitStatement = null; if (!$singlePage) { echo ''; $limitStatement = " LIMIT $offset, 1"; } // Getting the question information $sql = "SELECT * FROM $table_survey_question WHERE c_id = $course_id AND survey_id='".$surveyId."' AND survey_question NOT LIKE '%{{%' AND type <>'pagebreak' ORDER BY sort ASC $limitStatement"; $result = Database::query($sql); while ($row = Database::fetch_array($result)) { $questions[$row['question_id']] = $row; } } foreach ($questions as $question) { $chartData = []; $options = []; $questionId = (int) $question['question_id']; echo '
'; echo strip_tags(isset($question['survey_question']) ? $question['survey_question'] : null); echo '
'; if ($question['type'] == 'score') { /** @todo This function should return the options as this is needed further in the code */ $options = self::display_question_report_score($survey_data, $question, $offset); } elseif ($question['type'] == 'open' || $question['type'] == 'comment') { /** @todo Also get the user who has answered this */ $sql = "SELECT * FROM $table_survey_answer WHERE c_id = $course_id AND survey_id='".$surveyId."' AND question_id = '".$questionId."'"; $result = Database::query($sql); while ($row = Database::fetch_array($result, 'ASSOC')) { echo $row['option_id'].'
'; } } else { // Getting the options ORDER BY sort ASC $sql = "SELECT * FROM $table_survey_question_option WHERE c_id = $course_id AND survey_id='".$surveyId."' AND question_id = '".$questionId."' ORDER BY sort ASC"; $result = Database::query($sql); while ($row = Database::fetch_array($result, 'ASSOC')) { $options[$row['question_option_id']] = $row; } // Getting the answers $sql = "SELECT *, count(answer_id) as total FROM $table_survey_answer WHERE c_id = $course_id AND survey_id='".$surveyId."' AND question_id = '".$questionId."' GROUP BY option_id, value"; $result = Database::query($sql); $number_of_answers = []; $data = []; while ($row = Database::fetch_array($result, 'ASSOC')) { if (!isset($number_of_answers[$row['question_id']])) { $number_of_answers[$row['question_id']] = 0; } $number_of_answers[$row['question_id']] += $row['total']; $data[$row['option_id']] = $row; } foreach ($options as $option) { $optionText = strip_tags($option['option_text']); $optionText = html_entity_decode($optionText); $votes = isset($data[$option['question_option_id']]['total']) ? $data[$option['question_option_id']]['total'] : '0'; array_push($chartData, ['option' => $optionText, 'votes' => $votes]); } $chartContainerId = 'chartContainer'.$question['question_id']; echo '
'; echo self::drawChart($chartData, false, $chartContainerId); // displaying the table: headers echo ''; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; // Displaying the table: the content if (is_array($options)) { foreach ($options as $key => &$value) { $absolute_number = null; if (isset($data[$value['question_option_id']])) { $absolute_number = $data[$value['question_option_id']]['total']; } if ($question['type'] == 'percentage' && empty($absolute_number)) { continue; } $number_of_answers[$option['question_id']] = isset($number_of_answers[$option['question_id']]) ? $number_of_answers[$option['question_id']] : 0; if ($number_of_answers[$option['question_id']] == 0) { $answers_number = 0; } else { $answers_number = $absolute_number / $number_of_answers[$option['question_id']] * 100; } echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; } } $optionResult = ''; if (isset($option['question_id']) && isset($number_of_answers[$option['question_id']])) { if ($number_of_answers[$option['question_id']] == 0) { $optionResult = '0'; } else { $optionResult = $number_of_answers[$option['question_id']]; } } // displaying the table: footer (totals) echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo '
 '.get_lang('Absolute total').''.get_lang('Percentage').''.get_lang('Graphic').'
'.$value['option_text'].''; if ($absolute_number != 0) { echo ''.$absolute_number.''; } else { echo '0'; } echo ' '.round($answers_number, 2).' %'; $size = $answers_number * 2; if ($size > 0) { echo '
 
'; } else { echo '
'.get_lang("No data available").'
'; } echo '
'.get_lang('Total').''.$optionResult.'  
'; echo '
'; } } if (isset($_GET['viewoption'])) { echo '
'; echo '

'.get_lang('People who have chosen this answer').': ' .strip_tags($options[Security::remove_XSS($_GET['viewoption'])]['option_text']).'

'; if (is_numeric($_GET['value'])) { $sql_restriction = "AND value='".Database::escape_string($_GET['value'])."'"; } $sql = "SELECT user FROM $table_survey_answer WHERE c_id = $course_id AND option_id = '".Database::escape_string($_GET['viewoption'])."' $sql_restriction"; $result = Database::query($sql); echo ''; echo '
'; } } /** * Display score data about a survey question. * * @param array Question info * @param int The offset of results shown */ public static function display_question_report_score($survey_data, $question, $offset) { // Database table definitions $action = isset($_GET['action']) ? Security::remove_XSS($_GET['action']) : ''; $table_survey_question_option = Database::get_course_table(TABLE_SURVEY_QUESTION_OPTION); $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); $course_id = api_get_course_int_id(); // Getting the options $sql = "SELECT * FROM $table_survey_question_option WHERE c_id = $course_id AND survey_id='".intval($_GET['survey_id'])."' AND question_id = '".intval($question['question_id'])."' ORDER BY sort ASC"; $result = Database::query($sql); while ($row = Database::fetch_array($result)) { $options[$row['question_option_id']] = $row; } // Getting the answers $sql = "SELECT *, count(answer_id) as total FROM $table_survey_answer WHERE c_id = $course_id AND survey_id='".intval($_GET['survey_id'])."' AND question_id = '".Database::escape_string($question['question_id'])."' GROUP BY option_id, value"; $result = Database::query($sql); $number_of_answers = 0; while ($row = Database::fetch_array($result)) { $number_of_answers += $row['total']; $data[$row['option_id']][$row['value']] = $row; } $chartData = []; foreach ($options as $option) { $optionText = strip_tags($option['option_text']); $optionText = html_entity_decode($optionText); for ($i = 1; $i <= $question['max_value']; $i++) { $votes = $data[$option['question_option_id']][$i]['total']; if (empty($votes)) { $votes = '0'; } array_push( $chartData, [ 'serie' => $optionText, 'option' => $i, 'votes' => $votes, ] ); } } echo '
'; echo self::drawChart($chartData, true); echo '
'; // Displaying the table: headers echo ''; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; // Displaying the table: the content foreach ($options as $key => &$value) { for ($i = 1; $i <= $question['max_value']; $i++) { $absolute_number = $data[$value['question_option_id']][$i]['total']; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; } } // Displaying the table: footer (totals) echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo ' '; echo '
 '.get_lang('Score').''.get_lang('Absolute total').''.get_lang('Percentage').''.get_lang('Graphic').'
'.$value['option_text'].''.$i.''.$absolute_number.''.round($absolute_number / $number_of_answers * 100, 2).' %'; $size = ($absolute_number / $number_of_answers * 100 * 2); if ($size > 0) { echo '
 
'; } echo '
'.get_lang('Total').' '.$number_of_answers.'  
'; } /** * This functions displays the complete reporting. * * @param array $survey_data * @param int $userId * @param bool $addActionBar * @param bool $addFilters * @param bool $addExtraFields * * @return string */ public static function displayCompleteReport( $survey_data, $userId = 0, $addActionBar = true, $addFilters = true, $addExtraFields = true ) { // Database table definitions $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION); $table_survey_question_option = Database::get_course_table(TABLE_SURVEY_QUESTION_OPTION); $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); $surveyId = (int) $survey_data['survey_id']; $course_id = (int) $survey_data['c_id']; if (empty($surveyId) || empty($course_id)) { return ''; } $action = isset($_GET['action']) ? Security::remove_XSS($_GET['action']) : ''; $content = ''; if ($addActionBar) { $content .= ''; // The form $content .= ''; $content .= ''; $content .= ''; $content .= ''; $content .= '
'; $content .= ''; $content .= ''; $content .= '
'; } $content .= '
'; // The table $content .= '
'; // Getting the number of options per question $content .= ' '; $content .= ' '; } $display_extra_user_fields = false; if ($addExtraFields) { if (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter'] || isset($_POST['export_report']) && $_POST['export_report']) || !empty($_POST['fields_filter']) ) { // Show user fields section with a big th colspan that spans over all fields $extra_user_fields = UserManager::get_extra_fields( 0, 0, 5, 'ASC', false, true ); $num = count($extra_user_fields); if ($num > 0) { $content .= ''; $display_extra_user_fields = true; } } } $sql = "SELECT q.question_id, q.type, q.survey_question, count(o.question_option_id) as number_of_options FROM $table_survey_question q LEFT JOIN $table_survey_question_option o ON q.question_id = o.question_id AND q.c_id = o.c_id WHERE survey_question NOT LIKE '%{{%' AND q.survey_id = '".$surveyId."' AND q.c_id = $course_id GROUP BY q.question_id ORDER BY q.sort ASC"; $result = Database::query($sql); $questions = []; while ($row = Database::fetch_array($result)) { // We show the questions if // 1. there is no question filter and the export button has not been clicked // 2. there is a quesiton filter but the question is selected for display if (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter']) || (is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])) ) { // We do not show comment and pagebreak question types if ($row['type'] != 'pagebreak') { $content .= ' 0 && $row['type'] != 'percentage') { $content .= ' colspan="'.$row['number_of_options'].'"'; } $content .= '>'; $content .= ''; $content .= ''; } // No column at all if it's not a question } $questions[$row['question_id']] = $row; } $content .= ' '; // Getting all the questions and options $content .= ' '; $content .= ' '; // the user column if (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter'] || isset($_POST['export_report']) && $_POST['export_report']) || !empty($_POST['fields_filter']) ) { if ($addExtraFields) { // show the fields names for user fields foreach ($extra_user_fields as &$field) { $content .= ''; } } } // cells with option (none for open question) $sql = "SELECT sq.question_id, sq.survey_id, sq.survey_question, sq.display, sq.sort, sq.type, sqo.question_option_id, sqo.option_text, sqo.sort as option_sort FROM $table_survey_question sq LEFT JOIN $table_survey_question_option sqo ON sq.question_id = sqo.question_id AND sq.c_id = sqo.c_id WHERE survey_question NOT LIKE '%{{%' AND sq.survey_id = '".$surveyId."' AND sq.c_id = $course_id ORDER BY sq.sort ASC, sqo.sort ASC"; $result = Database::query($sql); $display_percentage_header = 1; $possible_answers = []; // in order to display only once the cell option (and not 100 times) while ($row = Database::fetch_array($result)) { // We show the options if // 1. there is no question filter and the export button has not been clicked // 2. there is a question filter but the question is selected for display if (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter']) || (is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])) ) { // we do not show comment and pagebreak question types if ($row['type'] == 'open' || $row['type'] == 'comment') { $content .= ''; $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id']; $display_percentage_header = 1; } elseif ($row['type'] == 'percentage' && $display_percentage_header) { $content .= ''; $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id']; $display_percentage_header = 0; } elseif ($row['type'] == 'percentage') { $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id']; } elseif ($row['type'] != 'pagebreak' && $row['type'] != 'percentage') { $content .= ''; $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id']; $display_percentage_header = 1; } } } $content .= ' '; $userCondition = ''; if (!empty($userId)) { $userId = (int) $userId; $userCondition = " AND user = $userId "; } // Getting all the answers of the users $old_user = ''; $answers_of_user = []; $sql = "SELECT * FROM $table_survey_answer WHERE c_id = $course_id AND survey_id = $surveyId $userCondition ORDER BY answer_id, user ASC"; $result = Database::query($sql); $i = 1; while ($row = Database::fetch_array($result)) { if ($old_user != $row['user'] && $old_user != '') { $userParam = $old_user; if ($survey_data['anonymous'] != 0) { $userParam = $i; $i++; } $content .= self::display_complete_report_row( $survey_data, $possible_answers, $answers_of_user, $userParam, $questions, $display_extra_user_fields ); $answers_of_user = []; } if (isset($questions[$row['question_id']]) && $questions[$row['question_id']]['type'] != 'open' && $questions[$row['question_id']]['type'] != 'comment' ) { $answers_of_user[$row['question_id']][$row['option_id']] = $row; } else { $answers_of_user[$row['question_id']][0] = $row; } $old_user = $row['user']; } $userParam = $old_user; if ($survey_data['anonymous'] != 0) { $userParam = $i; $i++; } $content .= self::display_complete_report_row( $survey_data, $possible_answers, $answers_of_user, $userParam, $questions, $display_extra_user_fields ); // This is to display the last user $content .= '
'; if ($addFilters) { if ((isset($_POST['submit_question_filter']) && $_POST['submit_question_filter']) || (isset($_POST['export_report']) && $_POST['export_report']) ) { $content .= ''; } $content .= ''; $content .= ' 0 ? ' colspan="'.$num.'"' : '').'>'; $content .= ''; $content .= '
 '.$field[3].' -  % '; $content .= $row['option_text']; $content .= '
'; $content .= '
'; return $content; } /** * Return user answers in a row. * * @param $survey_data * @param $possible_options * @param $answers_of_user * @param $user * @param $questions * @param bool $display_extra_user_fields * * @return string */ public static function display_complete_report_row( $survey_data, $possible_options, $answers_of_user, $user, $questions, $display_extra_user_fields = false ) { $user = Security::remove_XSS($user); $surveyId = (int) $survey_data['survey_id']; if (empty($surveyId)) { return ''; } $content = ''; $url = api_get_path(WEB_CODE_PATH).'survey/reporting.php?survey_id='.$surveyId.'&'.api_get_cidreq(); if ($survey_data['anonymous'] == 0) { if (intval($user) !== 0) { $userInfo = api_get_user_info($user); $user_displayed = '-'; if (!empty($userInfo)) { $user_displayed = $userInfo['complete_name_with_username']; } $content .= ' ' .$user_displayed.' '; // the user column } else { $content .= ''.$user.''; // the user column } } else { $content .= ''.get_lang('Anonymous').' '.$user.''; } if ($display_extra_user_fields) { // Show user fields data, if any, for this user $user_fields_values = UserManager::get_extra_user_data( $user, false, false, false, true ); foreach ($user_fields_values as &$value) { $content .= ''.$value.''; } } if (is_array($possible_options)) { foreach ($possible_options as $question_id => &$possible_option) { if ($questions[$question_id]['type'] == 'open' || $questions[$question_id]['type'] == 'comment') { $content .= ''; if (isset($answers_of_user[$question_id]) && isset($answers_of_user[$question_id]['0'])) { $content .= $answers_of_user[$question_id]['0']['option_id']; } $content .= ''; } else { foreach ($possible_option as $option_id => &$value) { if ($questions[$question_id]['type'] == 'percentage') { if (!empty($answers_of_user[$question_id][$option_id])) { $content .= ""; $content .= $answers_of_user[$question_id][$option_id]['value']; $content .= ""; } } else { $content .= ''; if (!empty($answers_of_user[$question_id][$option_id])) { if ($answers_of_user[$question_id][$option_id]['value'] != 0) { $content .= $answers_of_user[$question_id][$option_id]['value']; } else { $content .= 'v'; } } } } } } } $content .= ''; return $content; } /** * Quite similar to display_complete_report(), returns an HTML string * that can be used in a csv file. * * @todo consider merging this function with display_complete_report * * @return string The contents of a csv file * * @author Patrick Cool , Ghent University * * @version February 2007 */ public static function export_complete_report($survey_data, $user_id = 0) { $surveyId = isset($_GET['survey_id']) ? (int) $_GET['survey_id'] : 0; if (empty($surveyId)) { return false; } $course_id = api_get_course_int_id(); $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION); $table_survey_question_option = Database::get_course_table(TABLE_SURVEY_QUESTION_OPTION); $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); // The first column $return = ';'; // Show extra fields blank space (enough for extra fields on next line) $extra_user_fields = UserManager::get_extra_fields( 0, 0, 5, 'ASC', false, true ); $num = count($extra_user_fields); $return .= str_repeat(';', $num); $sql = "SELECT questions.question_id, questions.type, questions.survey_question, count(options.question_option_id) as number_of_options FROM $table_survey_question questions LEFT JOIN $table_survey_question_option options ON questions.question_id = options.question_id AND options.c_id = questions.c_id WHERE survey_question NOT LIKE '%{{%' AND questions.type <> 'pagebreak' AND questions.survey_id = $surveyId AND questions.c_id = $course_id GROUP BY questions.question_id ORDER BY questions.sort ASC"; $result = Database::query($sql); while ($row = Database::fetch_array($result)) { // We show the questions if // 1. there is no question filter and the export button has not been clicked // 2. there is a quesiton filter but the question is selected for display if (!(isset($_POST['submit_question_filter'])) || (isset($_POST['submit_question_filter']) && is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])) ) { if ($row['number_of_options'] == 0) { $return .= str_replace( "\r\n", ' ', api_html_entity_decode(strip_tags($row['survey_question']), ENT_QUOTES) ) .';'; } else { for ($ii = 0; $ii < $row['number_of_options']; $ii++) { $return .= str_replace( "\r\n", ' ', api_html_entity_decode(strip_tags($row['survey_question']), ENT_QUOTES) ) .';'; } } } } $return .= "\n"; // Getting all the questions and options $return .= ';'; // Show the fields names for user fields if (!empty($extra_user_fields)) { foreach ($extra_user_fields as &$field) { $return .= '"' .str_replace( "\r\n", ' ', api_html_entity_decode(strip_tags($field[3]), ENT_QUOTES) ) .'";'; } } $sql = "SELECT DISTINCT survey_question.question_id, survey_question.survey_id, survey_question.survey_question, survey_question.display, survey_question.sort, survey_question.type, survey_question_option.question_option_id, survey_question_option.option_text, survey_question_option.sort as option_sort FROM $table_survey_question survey_question LEFT JOIN $table_survey_question_option survey_question_option ON survey_question.question_id = survey_question_option.question_id AND survey_question_option.c_id = survey_question.c_id WHERE survey_question NOT LIKE '%{{%' AND survey_question.type <> 'pagebreak' AND survey_question.survey_id = $surveyId AND survey_question.c_id = $course_id ORDER BY survey_question.sort ASC, survey_question_option.sort ASC"; $result = Database::query($sql); $possible_answers = []; $possible_answers_type = []; while ($row = Database::fetch_array($result)) { // We show the options if // 1. there is no question filter and the export button has not been clicked // 2. there is a question filter but the question is selected for display if (!(isset($_POST['submit_question_filter'])) || ( is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter']) ) ) { $row['option_text'] = str_replace(["\r", "\n"], ['', ''], $row['option_text']); $return .= api_html_entity_decode(strip_tags($row['option_text']), ENT_QUOTES).';'; $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id']; $possible_answers_type[$row['question_id']] = $row['type']; } } $return .= "\n"; // Getting all the answers of the users $old_user = ''; $answers_of_user = []; $sql = "SELECT * FROM $table_survey_answer WHERE c_id = $course_id AND survey_id='".$surveyId."' "; if ($user_id != 0) { $sql .= "AND user='".Database::escape_string($user_id)."' "; } $sql .= ' ORDER BY user ASC '; $questionIdList = array_keys($possible_answers_type); $open_question_iterator = 1; $result = Database::query($sql); while ($row = Database::fetch_array($result, 'ASSOC')) { if (!in_array($row['question_id'], $questionIdList)) { continue; } if ($old_user != $row['user'] && $old_user != '') { $return .= self::export_complete_report_row( $survey_data, $possible_answers, $answers_of_user, $old_user, true ); $answers_of_user = []; } if ($possible_answers_type[$row['question_id']] == 'open' || $possible_answers_type[$row['question_id']] == 'comment' ) { $temp_id = 'open'.$open_question_iterator; $answers_of_user[$row['question_id']][$temp_id] = $row; $open_question_iterator++; } else { $answers_of_user[$row['question_id']][$row['option_id']] = $row; } $old_user = $row['user']; } // This is to display the last user $return .= self::export_complete_report_row( $survey_data, $possible_answers, $answers_of_user, $old_user, true ); return $return; } /** * Add a line to the csv file. * * @param array Possible answers * @param array User's answers * @param mixed User ID or user details as string - Used as a string in the result string * @param bool Whether to display user fields or not * * @return string One line of the csv file * * @author Patrick Cool , Ghent University * * @version February 2007 */ public static function export_complete_report_row( $survey_data, $possible_options, $answers_of_user, $user, $display_extra_user_fields = false ) { $return = ''; if ($survey_data['anonymous'] == 0) { if (intval($user) !== 0) { $userInfo = api_get_user_info($user); if (!empty($userInfo)) { $user_displayed = $userInfo['complete_name_with_username']; } else { $user_displayed = '-'; } $return .= $user_displayed.';'; } else { $return .= $user.';'; } } else { $return .= '-;'; // The user column } if ($display_extra_user_fields) { // Show user fields data, if any, for this user $user_fields_values = UserManager::get_extra_user_data( $user, false, false, false, true ); foreach ($user_fields_values as &$value) { $return .= '"'.str_replace('"', '""', api_html_entity_decode(strip_tags($value), ENT_QUOTES)).'";'; } } if (is_array($possible_options)) { foreach ($possible_options as $question_id => $possible_option) { if (is_array($possible_option) && count($possible_option) > 0) { foreach ($possible_option as $option_id => &$value) { $my_answer_of_user = !isset($answers_of_user[$question_id]) || isset($answers_of_user[$question_id]) && $answers_of_user[$question_id] == null ? [] : $answers_of_user[$question_id]; $key = array_keys($my_answer_of_user); if (isset($key[0]) && substr($key[0], 0, 4) == 'open') { $return .= '"'. str_replace( '"', '""', api_html_entity_decode( strip_tags( $answers_of_user[$question_id][$key[0]]['option_id'] ), ENT_QUOTES ) ). '"'; } elseif (!empty($answers_of_user[$question_id][$option_id])) { //$return .= 'v'; if ($answers_of_user[$question_id][$option_id]['value'] != 0) { $return .= $answers_of_user[$question_id][$option_id]['value']; } else { $return .= 'v'; } } $return .= ';'; } } } } $return .= "\n"; return $return; } /** * Quite similar to display_complete_report(), returns an HTML string * that can be used in a csv file. * * @todo consider merging this function with display_complete_report * * @return string The contents of a csv file * * @author Patrick Cool , Ghent University * * @version February 2007 */ public static function export_complete_report_xls($survey_data, $filename, $user_id = 0) { $course_id = api_get_course_int_id(); $user_id = (int) $user_id; $surveyId = isset($_GET['survey_id']) ? (int) $_GET['survey_id'] : 0; if (empty($course_id) || empty($surveyId)) { return false; } // Show extra fields blank space (enough for extra fields on next line) // Show user fields section with a big th colspan that spans over all fields $extra_user_fields = UserManager::get_extra_fields( 0, 0, 5, 'ASC', false, true ); $list = []; $num = count($extra_user_fields); for ($i = 0; $i < $num; $i++) { $list[0][] = ''; } $display_extra_user_fields = true; // Database table definitions $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION); $table_survey_question_option = Database::get_course_table(TABLE_SURVEY_QUESTION_OPTION); $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); // First line (questions) $sql = "SELECT questions.question_id, questions.type, questions.survey_question, count(options.question_option_id) as number_of_options FROM $table_survey_question questions LEFT JOIN $table_survey_question_option options ON questions.question_id = options.question_id AND options.c_id = questions.c_id WHERE survey_question NOT LIKE '%{{%' AND questions.type <> 'pagebreak' AND questions.survey_id = $surveyId AND questions.c_id = $course_id GROUP BY questions.question_id ORDER BY questions.sort ASC"; $result = Database::query($sql); $line = 1; $column = 1; while ($row = Database::fetch_array($result)) { // We show the questions if // 1. there is no question filter and the export button has not been clicked // 2. there is a quesiton filter but the question is selected for display if (!(isset($_POST['submit_question_filter'])) || (isset($_POST['submit_question_filter']) && is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])) ) { // We do not show comment and pagebreak question types if ($row['type'] != 'pagebreak') { if ($row['number_of_options'] == 0 && ($row['type'] == 'open' || $row['type'] == 'comment')) { $list[$line][$column] = api_html_entity_decode( strip_tags($row['survey_question']), ENT_QUOTES ); $column++; } else { for ($ii = 0; $ii < $row['number_of_options']; $ii++) { $list[$line][$column] = api_html_entity_decode( strip_tags($row['survey_question']), ENT_QUOTES ); $column++; } } } } } $line++; $column = 1; // Show extra field values if ($display_extra_user_fields) { // Show the fields names for user fields foreach ($extra_user_fields as &$field) { $list[$line][$column] = api_html_entity_decode(strip_tags($field[3]), ENT_QUOTES); $column++; } } // Getting all the questions and options (second line) $sql = "SELECT survey_question.question_id, survey_question.survey_id, survey_question.survey_question, survey_question.display, survey_question.sort, survey_question.type, survey_question_option.question_option_id, survey_question_option.option_text, survey_question_option.sort as option_sort FROM $table_survey_question survey_question LEFT JOIN $table_survey_question_option survey_question_option ON survey_question.question_id = survey_question_option.question_id AND survey_question_option.c_id = survey_question.c_id WHERE survey_question NOT LIKE '%{{%' AND survey_question.type <> 'pagebreak' AND survey_question.survey_id = $surveyId AND survey_question.c_id = $course_id ORDER BY survey_question.sort ASC, survey_question_option.sort ASC"; $result = Database::query($sql); $possible_answers = []; $possible_answers_type = []; while ($row = Database::fetch_array($result)) { // We show the options if // 1. there is no question filter and the export button has not been clicked // 2. there is a quesiton filter but the question is selected for display if (!isset($_POST['submit_question_filter']) || (isset($_POST['questions_filter']) && is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])) ) { // We do not show comment and pagebreak question types if ($row['type'] != 'pagebreak') { $list[$line][$column] = api_html_entity_decode( strip_tags($row['option_text']), ENT_QUOTES ); $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id']; $possible_answers_type[$row['question_id']] = $row['type']; $column++; } } } // Getting all the answers of the users $line++; $column = 0; $old_user = ''; $answers_of_user = []; $sql = "SELECT * FROM $table_survey_answer WHERE c_id = $course_id AND survey_id = $surveyId"; if ($user_id != 0) { $sql .= " AND user='".$user_id."' "; } $sql .= ' ORDER BY user ASC'; $open_question_iterator = 1; $result = Database::query($sql); while ($row = Database::fetch_array($result)) { if ($old_user != $row['user'] && $old_user != '') { $return = self::export_complete_report_row_xls( $survey_data, $possible_answers, $answers_of_user, $old_user, true ); foreach ($return as $elem) { $list[$line][$column] = $elem; $column++; } $answers_of_user = []; $line++; $column = 0; } if ($possible_answers_type[$row['question_id']] == 'open' || $possible_answers_type[$row['question_id']] == 'comment') { $temp_id = 'open'.$open_question_iterator; $answers_of_user[$row['question_id']][$temp_id] = $row; $open_question_iterator++; } else { $answers_of_user[$row['question_id']][$row['option_id']] = $row; } $old_user = $row['user']; } $return = self::export_complete_report_row_xls( $survey_data, $possible_answers, $answers_of_user, $old_user, true ); // this is to display the last user foreach ($return as $elem) { $list[$line][$column] = $elem; $column++; } Export::arrayToXls($list, $filename); return null; } /** * Add a line to the csv file. * * @param array Possible answers * @param array User's answers * @param mixed User ID or user details as string - Used as a string in the result string * @param bool Whether to display user fields or not * * @return string One line of the csv file */ public static function export_complete_report_row_xls( $survey_data, $possible_options, $answers_of_user, $user, $display_extra_user_fields = false ) { $return = []; if ($survey_data['anonymous'] == 0) { if (intval($user) !== 0) { $userInfo = api_get_user_info($user); if ($userInfo) { $user_displayed = $userInfo['complete_name_with_username']; } else { $user_displayed = '-'; } $return[] = $user_displayed; } else { $return[] = $user; } } else { $return[] = '-'; // The user column } if ($display_extra_user_fields) { //show user fields data, if any, for this user $user_fields_values = UserManager::get_extra_user_data( $user, false, false, false, true ); foreach ($user_fields_values as $value) { $return[] = api_html_entity_decode(strip_tags($value), ENT_QUOTES); } } if (is_array($possible_options)) { foreach ($possible_options as $question_id => &$possible_option) { if (is_array($possible_option) && count($possible_option) > 0) { foreach ($possible_option as $option_id => &$value) { $my_answers_of_user = isset($answers_of_user[$question_id]) ? $answers_of_user[$question_id] : []; $key = array_keys($my_answers_of_user); if (isset($key[0]) && substr($key[0], 0, 4) == 'open') { $return[] = api_html_entity_decode( strip_tags($answers_of_user[$question_id][$key[0]]['option_id']), ENT_QUOTES ); } elseif (!empty($answers_of_user[$question_id][$option_id])) { if ($answers_of_user[$question_id][$option_id]['value'] != 0) { $return[] = $answers_of_user[$question_id][$option_id]['value']; } else { $return[] = 'v'; } } else { $return[] = ''; } } } } } return $return; } /** * This function displays the comparative report which * allows you to compare two questions * A comparative report creates a table where one question * is on the x axis and a second question is on the y axis. * In the intersection is the number of people who have * answered positive on both options. * * @return string HTML code * * @author Patrick Cool , Ghent University * * @version February 2007 */ public static function display_comparative_report() { // Allowed question types for comparative report $allowed_question_types = [ 'yesno', 'multiplechoice', 'multipleresponse', 'dropdown', 'percentage', 'score', ]; $surveyId = isset($_GET['survey_id']) ? (int) $_GET['survey_id'] : 0; // Getting all the questions $questions = SurveyManager::get_questions($surveyId); // Actions bar echo ''; // Displaying an information message that only the questions with predefined answers can be used in a comparative report echo Display::return_message(get_lang('Only questions with predefined answers can be used'), 'normal', false); $xAxis = isset($_GET['xaxis']) ? Security::remove_XSS($_GET['xaxis']) : ''; $yAxis = isset($_GET['yaxis']) ? Security::remove_XSS($_GET['yaxis']) : ''; $url = api_get_self().'?'.api_get_cidreq().'&action='.Security::remove_XSS($_GET['action']) .'&survey_id='.$surveyId.'&xaxis='.$xAxis.'&y='.$yAxis; $form = new FormValidator('compare', 'get', $url); $form->addHidden('action', Security::remove_XSS($_GET['action'])); $form->addHidden('survey_id', $surveyId); $optionsX = ['----']; $optionsY = ['----']; $defaults = []; foreach ($questions as $key => &$question) { // Ignored tagged questions if ($question) { if (strpos($question['question'], '{{') !== false) { $question = null; continue; } } if (is_array($allowed_question_types)) { if (in_array($question['type'], $allowed_question_types)) { if (isset($_GET['xaxis']) && $_GET['xaxis'] == $question['question_id']) { $defaults['xaxis'] = $question['question_id']; } if (isset($_GET['yaxis']) && $_GET['yaxis'] == $question['question_id']) { $defaults['yaxis'] = $question['question_id']; } $optionsX[$question['question_id']] = api_substr(strip_tags($question['question']), 0, 90); $optionsY[$question['question_id']] = api_substr(strip_tags($question['question']), 0, 90); } } } $form->addSelect('xaxis', get_lang('Select the question on the X axis'), $optionsX); $form->addSelect('yaxis', get_lang('Select the question on the Y axis'), $optionsY); $form->addButtonSearch(get_lang('Compare questions')); $form->setDefaults($defaults); $form->display(); // Getting all the information of the x axis if (is_numeric($xAxis)) { $question_x = SurveyManager::get_question($xAxis); } // Getting all the information of the y axis if (is_numeric($yAxis)) { $question_y = SurveyManager::get_question($yAxis); } if (is_numeric($xAxis) && is_numeric($yAxis)) { // Getting the answers of the two questions $answers_x = self::get_answers_of_question_by_user($surveyId, $xAxis); $answers_y = self::get_answers_of_question_by_user($surveyId, $yAxis); // Displaying the table $tableHtml = ''; $xOptions = []; // The header $tableHtml .= ''; for ($ii = 0; $ii <= count($question_x['answers']); $ii++) { if ($ii == 0) { $tableHtml .= ''; } else { if ($question_x['type'] == 'score') { for ($x = 1; $x <= $question_x['maximum_score']; $x++) { $tableHtml .= ''; } $x = ''; } else { $tableHtml .= ''; } $optionText = strip_tags($question_x['answers'][$ii - 1]); $optionText = html_entity_decode($optionText); array_push($xOptions, trim($optionText)); } } $tableHtml .= ''; $chartData = []; // The main part for ($ij = 0; $ij < count($question_y['answers']); $ij++) { $currentYQuestion = strip_tags($question_y['answers'][$ij]); $currentYQuestion = html_entity_decode($currentYQuestion); // The Y axis is a scoring question type so we have more rows than the options (actually options * maximum score) if ($question_y['type'] == 'score') { for ($y = 1; $y <= $question_y['maximum_score']; $y++) { $tableHtml .= ''; for ($ii = 0; $ii <= count($question_x['answers']); $ii++) { if ($question_x['type'] == 'score') { for ($x = 1; $x <= $question_x['maximum_score']; $x++) { if ($ii == 0) { $tableHtml .= ''; break; } else { $tableHtml .= ''; } } } else { if ($ii == 0) { $tableHtml .= ''; } else { $tableHtml .= ''; } } } $tableHtml .= ''; } } else { // The Y axis is NOT a score question type so the number of rows = the number of options $tableHtml .= ''; for ($ii = 0; $ii <= count($question_x['answers']); $ii++) { if ($question_x['type'] == 'score') { for ($x = 1; $x <= $question_x['maximum_score']; $x++) { if ($ii == 0) { $tableHtml .= ''; break; } else { $tableHtml .= ''; } } } else { if ($ii == 0) { $tableHtml .= ''; } else { $tableHtml .= ''; } } } $tableHtml .= ''; } } $tableHtml .= '
 '.$question_x['answers'][($ii - 1)].'
'.$x.'
'.$question_x['answers'][($ii - 1)].'
'.$question_y['answers'][($ij)].' '.$y.''; $votes = self::comparative_check( $answers_x, $answers_y, $question_x['answersid'][($ii - 1)], $question_y['answersid'][($ij)], $x, $y ); $tableHtml .= $votes; array_push( $chartData, [ 'serie' => [$currentYQuestion, $xOptions[$ii - 1]], 'option' => $x, 'votes' => $votes, ] ); $tableHtml .= ''.$question_y['answers'][$ij].' '.$y.''; $votes = self::comparative_check( $answers_x, $answers_y, $question_x['answersid'][($ii - 1)], $question_y['answersid'][($ij)], 0, $y ); $tableHtml .= $votes; array_push( $chartData, [ 'serie' => [$currentYQuestion, $xOptions[$ii - 1]], 'option' => $y, 'votes' => $votes, ] ); $tableHtml .= '
'.$question_y['answers'][$ij].''; $votes = self::comparative_check( $answers_x, $answers_y, $question_x['answersid'][($ii - 1)], $question_y['answersid'][($ij)], $x, 0 ); $tableHtml .= $votes; array_push( $chartData, [ 'serie' => [$currentYQuestion, $xOptions[$ii - 1]], 'option' => $x, 'votes' => $votes, ] ); $tableHtml .= ''.$question_y['answers'][($ij)].''; $votes = self::comparative_check( $answers_x, $answers_y, $question_x['answersid'][($ii - 1)], $question_y['answersid'][($ij)] ); $tableHtml .= $votes; array_push( $chartData, [ 'serie' => $xOptions[$ii - 1], 'option' => $currentYQuestion, 'votes' => $votes, ] ); $tableHtml .= '
'; echo '
'; echo self::drawChart($chartData, true); echo '
'; echo $tableHtml; } } /** * Get all the answers of a question grouped by user. * * @param int $survey_id Survey ID * @param int $question_id Question ID * * @return array Array containing all answers of all users, grouped by user * * @author Patrick Cool , Ghent University * * @version February 2007 - Updated March 2008 */ public static function get_answers_of_question_by_user($survey_id, $question_id) { $course_id = api_get_course_int_id(); $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER); $sql = "SELECT * FROM $table_survey_answer WHERE c_id = $course_id AND survey_id='".intval($survey_id)."' AND question_id='".intval($question_id)."' ORDER BY USER ASC"; $result = Database::query($sql); $return = []; while ($row = Database::fetch_array($result)) { if ($row['value'] == 0) { $return[$row['user']][] = $row['option_id']; } else { $return[$row['user']][] = $row['option_id'].'*'.$row['value']; } } return $return; } /** * Count the number of users who answer positively on both options. * * @param array All answers of the x axis * @param array All answers of the y axis * @param int x axis value (= the option_id of the first question) * @param int y axis value (= the option_id of the second question) * * @return int Number of users who have answered positively to both options * * @author Patrick Cool , Ghent University * * @version February 2007 */ public static function comparative_check( $answers_x, $answers_y, $option_x, $option_y, $value_x = 0, $value_y = 0 ) { if ($value_x == 0) { $check_x = $option_x; } else { $check_x = $option_x.'*'.$value_x; } if ($value_y == 0) { $check_y = $option_y; } else { $check_y = $option_y.'*'.$value_y; } $counter = 0; if (is_array($answers_x)) { foreach ($answers_x as $user => &$answers) { // Check if the user has given $option_x as answer if (in_array($check_x, $answers)) { // Check if the user has given $option_y as an answer if (!is_null($answers_y[$user]) && in_array($check_y, $answers_y[$user]) ) { $counter++; } } } } return $counter; } /** * Save the invitation mail. * * @param string Text of the e-mail * @param int Whether the mail contents are for invite mail (0, default) or reminder mail (1) * * @author Patrick Cool , Ghent University * * @version January 2007 */ public static function save_invite_mail($mailtext, $mail_subject, $reminder = 0) { $course_id = api_get_course_int_id(); // Database table definition $table_survey = Database::get_course_table(TABLE_SURVEY); // Reminder or not if ($reminder == 0) { $mail_field = 'invite_mail'; } else { $mail_field = 'reminder_mail'; } $sql = "UPDATE $table_survey SET mail_subject='".Database::escape_string($mail_subject)."', $mail_field = '".Database::escape_string($mailtext)."' WHERE c_id = $course_id AND survey_id = '".intval($_GET['survey_id'])."'"; Database::query($sql); } /** * This function saves all the invitations of course users * and additional users in the database * and sends the invitations by email. * * @param $users_array Users $array array can be both a list of course uids AND a list of additional emailaddresses * @param $invitation_title Title $string of the invitation, used as the title of the mail * @param $invitation_text Text $string of the invitation, used as the text of the mail. * The text has to contain a **link** string or this will automatically be added to the end * @param int $reminder * @param bool $sendmail * @param int $remindUnAnswered * @param bool $isAdditionalEmail * @param bool $hideLink * * @author Patrick Cool , Ghent University * @author Julio Montoya - Adding auto-generated link support * * @version January 2007 */ public static function saveInvitations( $users_array, $invitation_title, $invitation_text, $reminder = 0, $sendmail = false, $remindUnAnswered = 0, $isAdditionalEmail = false, $hideLink = false ) { if (!is_array($users_array)) { // Should not happen return 0; } // Getting the survey information $survey_data = SurveyManager::get_survey($_GET['survey_id']); $survey_invitations = self::get_invitations($survey_data['survey_code']); $already_invited = self::get_invited_users($survey_data['code']); // Remind unanswered is a special version of remind all reminder $exclude_users = []; if ($remindUnAnswered == 1) { // Remind only unanswered users $reminder = 1; $exclude_users = SurveyManager::get_people_who_filled_survey($_GET['survey_id']); } $counter = 0; // Nr of invitations "sent" (if sendmail option) $course_id = api_get_course_int_id(); $session_id = api_get_session_id(); if ($isAdditionalEmail == false) { $result = CourseManager::separateUsersGroups($users_array); $groupList = $result['groups']; $users_array = $result['users']; foreach ($groupList as $groupId) { $userGroupList = GroupManager::getStudents($groupId, true); $userGroupIdList = array_column($userGroupList, 'user_id'); $users_array = array_merge($users_array, $userGroupIdList); $params = [ 'c_id' => $course_id, 'session_id' => $session_id, 'group_id' => $groupId, 'survey_code' => $survey_data['code'], ]; $invitationExists = self::invitationExists( $course_id, $session_id, $groupId, $survey_data['code'] ); if (empty($invitationExists)) { self::save_invitation($params); } } } $users_array = array_unique($users_array); foreach ($users_array as $key => $value) { if (!isset($value) || $value == '') { continue; } // Skip user if reminding only unanswered people if (in_array($value, $exclude_users)) { continue; } // Get the unique invitation code if we already have it if ($reminder == 1 && array_key_exists($value, $survey_invitations)) { $invitation_code = $survey_invitations[$value]['invitation_code']; } else { $invitation_code = md5($value.microtime()); } $new_user = false; // User not already invited // Store the invitation if user_id not in $already_invited['course_users'] OR email is not in $already_invited['additional_users'] $addit_users_array = isset($already_invited['additional_users']) && !empty($already_invited['additional_users']) ? explode(';', $already_invited['additional_users']) : []; $my_alredy_invited = $already_invited['course_users'] == null ? [] : $already_invited['course_users']; if ((is_numeric($value) && !in_array($value, $my_alredy_invited)) || (!is_numeric($value) && !in_array($value, $addit_users_array)) ) { $new_user = true; if (!array_key_exists($value, $survey_invitations)) { $params = [ 'c_id' => $course_id, 'session_id' => $session_id, 'user' => $value, 'survey_code' => $survey_data['code'], 'invitation_code' => $invitation_code, 'invitation_date' => api_get_utc_datetime(), ]; self::save_invitation($params); } } // Send the email if checkboxed if (($new_user || $reminder == 1) && $sendmail) { // Make a change for absolute url if (isset($invitation_text)) { $invitation_text = api_html_entity_decode($invitation_text, ENT_QUOTES); $invitation_text = str_replace('src="../../', 'src="'.api_get_path(WEB_PATH), $invitation_text); $invitation_text = trim(stripslashes($invitation_text)); } self::send_invitation_mail( $value, $invitation_code, $invitation_title, $invitation_text, $hideLink ); $counter++; } } return $counter; // Number of invitations sent } /** * @param $params * * @return bool|int */ public static function save_invitation($params) { // Database table to store the invitations data $table = Database::get_course_table(TABLE_SURVEY_INVITATION); if (!empty($params['c_id']) && (!empty($params['user']) || !empty($params['group_id'])) && !empty($params['survey_code']) ) { if (!isset($params['survey_invitation_id'])) { $params['survey_invitation_id'] = 0; } if (!isset($params['answered'])) { $params['answered'] = 0; } if (!isset($params['group_id'])) { $params['group_id'] = 0; } $insertId = Database::insert($table, $params); if ($insertId) { $sql = "UPDATE $table SET survey_invitation_id = $insertId WHERE iid = $insertId"; Database::query($sql); } return $insertId; } return false; } /** * @param int $courseId * @param int $sessionId * @param int $groupId * @param string $surveyCode * * @return int */ public static function invitationExists($courseId, $sessionId, $groupId, $surveyCode) { $table = Database::get_course_table(TABLE_SURVEY_INVITATION); $courseId = (int) $courseId; $sessionId = (int) $sessionId; $groupId = (int) $groupId; $surveyCode = Database::escape_string($surveyCode); $sql = "SELECT survey_invitation_id FROM $table WHERE c_id = $courseId AND session_id = $sessionId AND group_id = $groupId AND survey_code = '$surveyCode' "; $result = Database::query($sql); return Database::num_rows($result); } /** * Send the invitation by mail. * * @param int invitedUser - the userId (course user) or emailaddress of additional user * $param string $invitation_code - the unique invitation code for the URL */ public static function send_invitation_mail( $invitedUser, $invitation_code, $invitation_title, $invitation_text, $hideLink = false ) { $_user = api_get_user_info(); $_course = api_get_course_info(); $sessionId = api_get_session_id(); // Replacing the **link** part with a valid link for the user $link = self::generateFillSurveyLink($invitation_code, $_course, $sessionId); if ($hideLink) { $full_invitation_text = str_replace('**link**', '', $invitation_text); } else { $text_link = ''.get_lang('Click here to answer the survey')."
\r\n
\r\n" .get_lang('or copy paste the following url :')."
\r\n
\r\n ".$link; $replace_count = 0; $full_invitation_text = api_str_ireplace('**link**', $text_link, $invitation_text, $replace_count); if ($replace_count < 1) { $full_invitation_text = $full_invitation_text."
\r\n
\r\n".$text_link; } } // Sending the mail $sender_name = api_get_person_name($_user['firstName'], $_user['lastName'], null, PERSON_NAME_EMAIL_ADDRESS); $sender_email = $_user['mail']; $sender_user_id = api_get_user_id(); $replyto = []; if (api_get_setting('survey_email_sender_noreply') == 'noreply') { $noreply = api_get_setting('noreply_email_address'); if (!empty($noreply)) { $replyto['Reply-to'] = $noreply; $sender_name = $noreply; $sender_email = $noreply; $sender_user_id = null; } } // Optionally: finding the e-mail of the course user if (is_numeric($invitedUser)) { MessageManager::send_message( $invitedUser, $invitation_title, $full_invitation_text, [], [], null, null, null, null, $sender_user_id, true ); } else { @api_mail_html( '', $invitedUser, $invitation_title, $full_invitation_text, $sender_name, $sender_email, $replyto ); } } /** * This function recalculates the number of users who have been invited and updates the survey table with this * value. * * @param string Survey code * @param int $courseId * @param int $sessionId * * @return int * * @author Patrick Cool , Ghent University * * @version January 2007 */ public static function update_count_invited($survey_code, $courseId = 0, $sessionId = 0) { $survey_code = Database::escape_string($survey_code); $courseId = (int) $courseId; $sessionId = (int) $sessionId; $courseId = $courseId ?: api_get_course_int_id(); $sessionId = $sessionId ?: api_get_session_id(); $sessionCondition = api_get_session_condition($sessionId); // Database table definition $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION); $table_survey = Database::get_course_table(TABLE_SURVEY); // Counting the number of people that are invited $sql = "SELECT count(user) as total FROM $table_survey_invitation WHERE c_id = $courseId AND survey_code = '".$survey_code."' AND user <> '' $sessionCondition "; $result = Database::query($sql); $row = Database::fetch_array($result); $total_invited = $row['total']; // Updating the field in the survey table $sql = "UPDATE $table_survey SET invited = '".Database::escape_string($total_invited)."' WHERE c_id = $courseId AND code = '".$survey_code."' $sessionCondition "; Database::query($sql); return $total_invited; } /** * This function gets all the invited users for a given survey code. * * @param string Survey code * @param string optional - course database * * @return array Array containing the course users and additional users (non course users) * * @todo consider making $defaults['additional_users'] also an array * * @author Patrick Cool , Ghent University * @author Julio Montoya, adding c_id fixes - Dec 2012 * * @version January 2007 */ public static function get_invited_users($survey_code, $course_code = '', $session_id = 0) { $session_id = (int) $session_id; $survey_code = Database::escape_string($survey_code); $course_code = Database::escape_string($course_code); $course_id = api_get_course_int_id(); if (!empty($course_code)) { $course_info = api_get_course_info($course_code); if ($course_info) { $course_id = $course_info['real_id']; } } if (empty($session_id)) { $session_id = api_get_session_id(); } $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION); $table_user = Database::get_main_table(TABLE_MAIN_USER); // Selecting all the invitations of this survey AND the additional emailaddresses (the left join) $order_clause = api_sort_by_first_name() ? ' ORDER BY firstname, lastname' : ' ORDER BY lastname, firstname'; $sql = "SELECT user, group_id FROM $table_survey_invitation as table_invitation WHERE table_invitation.c_id = $course_id AND survey_code='".$survey_code."' AND session_id = $session_id "; $defaults = []; $defaults['course_users'] = []; $defaults['additional_users'] = []; // Textarea $defaults['users'] = []; // user and groups $result = Database::query($sql); while ($row = Database::fetch_array($result)) { if (is_numeric($row['user'])) { $defaults['course_users'][] = $row['user']; $defaults['users'][] = 'USER:'.$row['user']; } else { if (!empty($row['user'])) { $defaults['additional_users'][] = $row['user']; } } if (isset($row['group_id']) && !empty($row['group_id'])) { $defaults['users'][] = 'GROUP:'.$row['group_id']; } } if (!empty($defaults['course_users'])) { $user_ids = implode("','", $defaults['course_users']); $sql = "SELECT user_id FROM $table_user WHERE user_id IN ('$user_ids') $order_clause"; $result = Database::query($sql); $fixed_users = []; while ($row = Database::fetch_array($result)) { $fixed_users[] = $row['user_id']; } $defaults['course_users'] = $fixed_users; } if (!empty($defaults['additional_users'])) { $defaults['additional_users'] = implode(';', $defaults['additional_users']); } return $defaults; } /** * Get all the invitations. * * @param string Survey code * * @return array Database rows matching the survey code * * @author Patrick Cool , Ghent University * * @version September 2007 */ public static function get_invitations($survey_code) { $course_id = api_get_course_int_id(); $sessionId = api_get_session_id(); // Database table definition $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION); $sql = "SELECT * FROM $table_survey_invitation WHERE c_id = $course_id AND session_id = $sessionId AND survey_code = '".Database::escape_string($survey_code)."'"; $result = Database::query($sql); $return = []; while ($row = Database::fetch_array($result)) { $return[$row['user']] = $row; } return $return; } /** * This function displays the form for searching a survey. * * @author Patrick Cool , Ghent University * * @version January 2007 * * @todo consider moving this to surveymanager.inc.lib.php */ public static function display_survey_search_form() { $url = api_get_path(WEB_CODE_PATH).'survey/survey_list.php?search=advanced&'.api_get_cidreq(); $form = new FormValidator('search', 'get', $url); $form->addHeader(get_lang('Search a survey')); $form->addText('keyword_title', get_lang('Title')); $form->addText('keyword_code', get_lang('Course code')); $form->addSelectLanguage('keyword_language', get_lang('Language')); $form->addHidden('cidReq', api_get_course_id()); $form->addButtonSearch(get_lang('Search'), 'do_search'); $form->display(); } /** * Show table only visible by DRH users. */ public static function displaySurveyListForDrh() { $parameters = []; $parameters['cidReq'] = api_get_course_id(); // Create a sortable table with survey-data $table = new SortableTable( 'surveys', 'get_number_of_surveys', 'get_survey_data_drh', 2 ); $table->set_additional_parameters($parameters); $table->set_header(0, '', false); $table->set_header(1, get_lang('Survey name')); $table->set_header(2, get_lang('SurveyCourse code')); $table->set_header(3, get_lang('Questions')); $table->set_header(4, get_lang('Author')); $table->set_header(5, get_lang('Available from')); $table->set_header(6, get_lang('Until')); $table->set_header(7, get_lang('Invite')); $table->set_header(8, get_lang('Anonymous')); if (api_get_configuration_value('allow_mandatory_survey')) { $table->set_header(9, get_lang('Mandatory?')); $table->set_header(10, get_lang('Edit'), false, 'width="150"'); $table->set_column_filter(9, 'anonymous_filter'); $table->set_column_filter(10, 'modify_filter_drh'); } else { $table->set_header(9, get_lang('Edit'), false, 'width="150"'); $table->set_column_filter(9, 'modify_filter_drh'); } $table->set_column_filter(8, 'anonymous_filter'); $table->display(); } /** * This function displays the sortable table with all the surveys. * * * @author Patrick Cool , Ghent University * * @version January 2007 */ public static function display_survey_list() { $parameters = []; $parameters['cidReq'] = api_get_course_id(); if (isset($_GET['do_search']) && $_GET['do_search']) { $message = get_lang('Display search results').'
'; $message .= ''.get_lang('Display all').''; echo Display::return_message($message, 'normal', false); } // Create a sortable table with survey-data $table = new SortableTable( 'surveys', 'get_number_of_surveys', 'get_survey_data', 2 ); $table->set_additional_parameters($parameters); $table->set_header(0, '', false); $table->set_header(1, get_lang('Survey name')); $table->set_header(2, get_lang('SurveyCourse code')); $table->set_header(3, get_lang('Questions')); $table->set_header(4, get_lang('Author')); //$table->set_header(5, get_lang('Language')); //$table->set_header(6, get_lang('Shared')); $table->set_header(5, get_lang('Available from')); $table->set_header(6, get_lang('Until')); $table->set_header(7, get_lang('Invite')); $table->set_header(8, get_lang('Anonymous')); if (api_get_configuration_value('allow_mandatory_survey')) { $table->set_header(9, get_lang('Mandatory?')); $table->set_header(10, get_lang('Edit'), false, 'width="150"'); $table->set_column_filter(8, 'anonymous_filter'); $table->set_column_filter(10, 'modify_filter'); } else { $table->set_header(9, get_lang('Edit'), false, 'width="150"'); $table->set_column_filter(9, 'modify_filter'); } $table->set_column_filter(8, 'anonymous_filter'); $table->set_form_actions(['delete' => get_lang('Delete survey')]); $table->display(); } /** * Survey list for coach. */ public static function display_survey_list_for_coach() { $parameters = []; $parameters['cidReq'] = api_get_course_id(); if (isset($_GET['do_search'])) { $message = get_lang('Display search results').'
'; $message .= ''.get_lang('Display all').''; echo Display::return_message($message, 'normal', false); } // Create a sortable table with survey-data $table = new SortableTable( 'surveys_coach', 'get_number_of_surveys_for_coach', 'get_survey_data_for_coach', 2 ); $table->set_additional_parameters($parameters); $table->set_header(0, '', false); $table->set_header(1, get_lang('Survey name')); $table->set_header(2, get_lang('SurveyCourse code')); $table->set_header(3, get_lang('Questions')); $table->set_header(4, get_lang('Author')); $table->set_header(5, get_lang('Available from')); $table->set_header(6, get_lang('Until')); $table->set_header(7, get_lang('Invite')); $table->set_header(8, get_lang('Anonymous')); if (api_get_configuration_value('allow_mandatory_survey')) { $table->set_header(9, get_lang('Edit'), false, 'width="130"'); $table->set_header(10, get_lang('Edit'), false, 'width="130"'); $table->set_column_filter(8, 'anonymous_filter'); $table->set_column_filter(10, 'modify_filter_for_coach'); } else { $table->set_header(9, get_lang('Edit'), false, 'width="130"'); $table->set_column_filter(9, 'modify_filter_for_coach'); } $table->set_column_filter(8, 'anonymous_filter'); $table->display(); } /** * Check if the hide_survey_edition configurations setting is enabled. * * @param string $surveyCode * * @return bool */ public static function checkHideEditionToolsByCode($surveyCode) { $hideSurveyEdition = api_get_configuration_value('hide_survey_edition'); if (false === $hideSurveyEdition) { return false; } if ('*' === $hideSurveyEdition['codes']) { return true; } if (in_array($surveyCode, $hideSurveyEdition['codes'])) { return true; } return false; } /** * This function changes the modify column of the sortable table. * * @param int $survey_id the id of the survey * @param bool $drh * * @throws \Doctrine\ORM\ORMException * @throws \Doctrine\ORM\OptimisticLockException * @throws \Doctrine\ORM\TransactionRequiredException * * @author Patrick Cool , Ghent University * * @return string html code that are the actions that can be performed on any survey * * @version January 2007 */ public static function modify_filter($survey_id, $drh = false) { /** @var CSurvey $survey */ $survey = Database::getManager()->find('ChamiloCourseBundle:CSurvey', $survey_id); $hideSurveyEdition = self::checkHideEditionToolsByCode($survey->getCode()); if ($hideSurveyEdition) { return ''; } if (empty($survey)) { return ''; } $survey_id = $survey->getSurveyId(); $actions = []; $hideReportingButton = api_get_configuration_value('hide_survey_reporting_button'); $codePath = api_get_path(WEB_CODE_PATH); $params = []; parse_str(api_get_cidreq(), $params); $reportingLink = Display::url( Display::return_icon('statistics.png', get_lang('Reporting')), $codePath.'survey/reporting.php?'.http_build_query($params + ['survey_id' => $survey_id]) ); if ($drh) { return $hideReportingButton ? '-' : $reportingLink; } $type = $survey->getSurveyType(); // Coach can see that only if the survey is in his session if (api_is_allowed_to_edit() || api_is_element_in_the_session(TOOL_SURVEY, $survey_id) ) { $editUrl = $codePath.'survey/create_new_survey.php?'. http_build_query($params + ['action' => 'edit', 'survey_id' => $survey_id]); if ($survey->getSurveyType() == 3) { $editUrl = $codePath.'survey/edit_meeting.php?'. http_build_query($params + ['action' => 'edit', 'survey_id' => $survey_id]); } $actions[] = Display::url( Display::return_icon('edit.png', get_lang('Edit')), $editUrl ); if (SurveyManager::survey_generation_hash_available()) { $actions[] = Display::url( Display::return_icon('new_link.png', get_lang('Generate survey access link')), $codePath.'survey/generate_link.php?'.http_build_query($params + ['survey_id' => $survey_id]) ); } if ($type != 3) { $actions[] = Display::url( Display::return_icon('backup.png', get_lang('Copy survey')), $codePath.'survey/copy_survey.php?'.http_build_query($params + ['survey_id' => $survey_id]) ); $actions[] = Display::url( Display::return_icon('copy.png', get_lang('Duplicate survey')), $codePath.'survey/survey_list.php?' .http_build_query($params + ['action' => 'copy_survey', 'survey_id' => $survey_id]) ); $actions[] = Display::url( Display::return_icon('multiplicate_survey.png', get_lang('Multiplicate questions')), $codePath.'survey/survey_list.php?' .http_build_query($params + ['action' => 'multiplicate', 'survey_id' => $survey_id]) ); $actions[] = Display::url( Display::return_icon('multiplicate_survey_na.png', get_lang('RemoveMultiplicate questions')), $codePath.'survey/survey_list.php?' .http_build_query($params + ['action' => 'remove_multiplicate', 'survey_id' => $survey_id]) ); $warning = addslashes(api_htmlentities(get_lang('Empty survey').'?', ENT_QUOTES)); $actions[] = Display::url( Display::return_icon('clean.png', get_lang('Empty survey')), $codePath.'survey/survey_list.php?' .http_build_query($params + ['action' => 'empty', 'survey_id' => $survey_id]), [ 'onclick' => "javascript: if (!confirm('".$warning."')) return false;", ] ); } } if ($type != 3) { $actions[] = Display::url( Display::return_icon('preview_view.png', get_lang('Preview')), $codePath.'survey/preview.php?'.http_build_query($params + ['survey_id' => $survey_id]) ); } $actions[] = Display::url( Display::return_icon('mail_send.png', get_lang('Publish')), $codePath.'survey/survey_invite.php?'.http_build_query($params + ['survey_id' => $survey_id]) ); if ($type != 3) { $actions[] = $hideReportingButton ? null : $reportingLink; } if (api_is_allowed_to_edit() || api_is_element_in_the_session(TOOL_SURVEY, $survey_id) ) { $actions[] = self::getAdditionalTeacherActions($survey_id); $warning = addslashes(api_htmlentities(get_lang('Delete survey').'?', ENT_QUOTES)); $actions[] = Display::url( Display::return_icon('delete.png', get_lang('Delete')), $codePath.'survey/survey_list.php?' .http_build_query($params + ['action' => 'delete', 'survey_id' => $survey_id]), [ 'onclick' => "javascript: if (!confirm('".$warning."')) return false;", ] ); } return implode(PHP_EOL, $actions); } /** * Get the additional actions added in survey_additional_teacher_modify_actions configuration. * * @param int $surveyId * @param int $iconSize * * @return string */ public static function getAdditionalTeacherActions($surveyId, $iconSize = ICON_SIZE_SMALL) { $additionalActions = api_get_configuration_value('survey_additional_teacher_modify_actions') ?: []; if (empty($additionalActions)) { return ''; } $actions = []; foreach ($additionalActions as $additionalAction) { $actions[] = call_user_func( $additionalAction, ['survey_id' => $surveyId, 'icon_size' => $iconSize] ); } return implode(PHP_EOL, $actions); } /** * @param int $survey_id * * @return string */ public static function modify_filter_for_coach($survey_id) { $survey_id = (int) $survey_id; $actions = []; $codePath = api_get_path(WEB_CODE_PATH); $params = []; parse_str(api_get_cidreq(), $params); $actions[] = Display::url( Display::return_icon('preview_view.png', get_lang('Preview')), $codePath.'survey/preview.php?'.http_build_query($params + ['survey_id' => $survey_id]) ); $actions[] = Display::url( Display::return_icon('mail_send.png', get_lang('Publish')), $codePath.'survey/survey_invite.php?'.http_build_query($params + ['survey_id' => $survey_id]) ); $warning = addslashes(api_htmlentities(get_lang('Empty survey').'?', ENT_QUOTES)); $actions[] = Display::url( Display::return_icon('clean.png', get_lang('Empty survey')), $codePath.'survey/survey_list.php?' .http_build_query($params + ['action' => 'empty', 'survey_id' => $survey_id]), [ 'onclick' => "javascript: if(!confirm('".$warning."')) return false;", ] ); return implode(PHP_EOL, $actions); } /** * Returns "yes" when given parameter is one, "no" for any other value. * * @param int Whether anonymous or not * * @return string "Yes" or "No" in the current language */ public static function anonymous_filter($anonymous) { if ($anonymous == 1) { return get_lang('Yes'); } else { return get_lang('No'); } } /** * This function handles the search restriction for the SQL statements. * * @return string Part of a SQL statement or false on error * * @author Patrick Cool , Ghent University * * @version January 2007 */ public static function survey_search_restriction() { if (isset($_GET['do_search'])) { if ($_GET['keyword_title'] != '') { $search_term[] = 'title like "%" \''.Database::escape_string($_GET['keyword_title']).'\' "%"'; } if ($_GET['keyword_code'] != '') { $search_term[] = 'code =\''.Database::escape_string($_GET['keyword_code']).'\''; } if ($_GET['keyword_language'] != '%') { $search_term[] = 'lang =\''.Database::escape_string($_GET['keyword_language']).'\''; } $my_search_term = ($search_term == null) ? [] : $search_term; $search_restriction = implode(' AND ', $my_search_term); return $search_restriction; } else { return false; } } /** * This function calculates the total number of surveys. * * @return int Total number of surveys * * @author Patrick Cool , Ghent University * * @version January 2007 */ public static function get_number_of_surveys() { $table_survey = Database::get_course_table(TABLE_SURVEY); $course_id = api_get_course_int_id(); $search_restriction = self::survey_search_restriction(); if ($search_restriction) { $search_restriction = 'WHERE c_id = '.$course_id.' AND '.$search_restriction; } else { $search_restriction = "WHERE c_id = $course_id"; } $sql = "SELECT count(survey_id) AS total_number_of_items FROM $table_survey $search_restriction"; $res = Database::query($sql); $obj = Database::fetch_object($res); return $obj->total_number_of_items; } /** * @return int */ public static function get_number_of_surveys_for_coach() { $survey_tree = new SurveyTree(); return count($survey_tree->surveylist); } /** * This function gets all the survey data that is to be displayed in the sortable table. * * @param int $from * @param int $number_of_items * @param int $column * @param string $direction * @param bool $isDrh * * @return array * * @author Patrick Cool , Ghent University * @author Julio Montoya , Beeznest - Adding intvals * * @version January 2007 */ public static function get_survey_data( $from, $number_of_items, $column, $direction, $isDrh = false ) { $table_survey = Database::get_course_table(TABLE_SURVEY); $table_user = Database::get_main_table(TABLE_MAIN_USER); $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION); $mandatoryAllowed = api_get_configuration_value('allow_mandatory_survey'); $_user = api_get_user_info(); $allowSurveyAvailabilityDatetime = api_get_configuration_value('allow_survey_availability_datetime'); // Searching $search_restriction = self::survey_search_restriction(); if ($search_restriction) { $search_restriction = ' AND '.$search_restriction; } $from = (int) $from; $number_of_items = (int) $number_of_items; $column = (int) $column; if (!in_array(strtolower($direction), ['asc', 'desc'])) { $direction = 'asc'; } // Condition for the session $session_id = api_get_session_id(); $condition_session = api_get_session_condition($session_id); $course_id = api_get_course_int_id(); $sql = " SELECT survey.survey_id AS col0, survey.title AS col1, survey.code AS col2, count(survey_question.question_id) AS col3, " .(api_is_western_name_order() ? "CONCAT(user.firstname, ' ', user.lastname)" : "CONCAT(user.lastname, ' ', user.firstname)") ." AS col4, survey.avail_from AS col5, survey.avail_till AS col6, survey.invited AS col7, survey.anonymous AS col8, survey.iid AS col9, survey.session_id AS session_id, survey.answered, survey.invited, survey.survey_type FROM $table_survey survey LEFT JOIN $table_survey_question survey_question ON (survey.survey_id = survey_question.survey_id AND survey_question.c_id = $course_id) LEFT JOIN $table_user user ON (survey.author = user.user_id) WHERE survey.c_id = $course_id $search_restriction $condition_session GROUP BY survey.survey_id ORDER BY col$column $direction LIMIT $from,$number_of_items "; $res = Database::query($sql); $surveys = []; $array = []; $efv = new ExtraFieldValue('survey'); while ($survey = Database::fetch_array($res)) { $array[0] = $survey[0]; if (self::checkHideEditionToolsByCode($survey['col2'])) { $array[1] = $survey[1]; } else { // Doodle if ($survey['survey_type'] == 3) { $array[1] = Display::url( $survey[1], api_get_path(WEB_CODE_PATH).'survey/meeting.php?survey_id='.$survey[0].'&'.api_get_cidreq() ); } else { $array[1] = Display::url( $survey[1], api_get_path(WEB_CODE_PATH).'survey/survey.php?survey_id='.$survey[0].'&'.api_get_cidreq() ); } } // Validation when belonging to a session $session_img = api_get_session_image($survey['session_id'], $_user['status']); $array[2] = $survey[2].$session_img; $array[3] = $survey[3]; $array[4] = $survey[4]; // Dates $array[5] = ''; if (!empty($survey[5]) && $survey[5] !== '0000-00-00' && $survey[5] !== '0000-00-00 00:00:00') { $array[5] = api_convert_and_format_date( $survey[5], $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG ); } $array[6] = ''; if (!empty($survey[6]) && $survey[6] !== '0000-00-00' && $survey[6] !== '0000-00-00 00:00:00') { $array[6] = api_convert_and_format_date( $survey[6], $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG ); } $array[7] = Display::url( $survey['answered'], api_get_path(WEB_CODE_PATH).'survey/survey_invitation.php?view=answered&survey_id='.$survey[0].'&' .api_get_cidreq() ).' / '. Display::url( $survey['invited'], api_get_path(WEB_CODE_PATH).'survey/survey_invitation.php?view=invited&survey_id='.$survey[0].'&' .api_get_cidreq() ); // Anon $array[8] = $survey['col8']; if ($mandatoryAllowed) { $efvMandatory = $efv->get_values_by_handler_and_field_variable( $survey[9], 'is_mandatory' ); $array[9] = $efvMandatory ? $efvMandatory['value'] : 0; // Survey id $array[10] = $survey['col9']; } else { // Survey id $array[9] = $survey['col9']; } if ($isDrh) { $array[1] = $survey[1]; $array[7] = strip_tags($array[7]); } $surveys[] = $array; } return $surveys; } /** * @param $from * @param $number_of_items * @param $column * @param $direction * * @return array */ public static function get_survey_data_for_coach($from, $number_of_items, $column, $direction) { $mandatoryAllowed = api_get_configuration_value('allow_mandatory_survey'); $allowSurveyAvailabilityDatetime = api_get_configuration_value('allow_survey_availability_datetime'); $survey_tree = new SurveyTree(); $last_version_surveys = $survey_tree->surveylist; $list = []; foreach ($last_version_surveys as &$survey) { $list[] = $survey['id']; } if (count($list) > 0) { $list_condition = " AND survey.survey_id IN (".implode(',', $list).") "; } else { $list_condition = ''; } $from = (int) $from; $number_of_items = (int) $number_of_items; $column = (int) $column; if (!in_array(strtolower($direction), ['asc', 'desc'])) { $direction = 'asc'; } $table_survey = Database::get_course_table(TABLE_SURVEY); $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION); $table_user = Database::get_main_table(TABLE_MAIN_USER); $course_id = api_get_course_int_id(); $efv = new ExtraFieldValue('survey'); $sql = " SELECT survey.survey_id AS col0, survey.title AS col1, survey.code AS col2, count(survey_question.question_id) AS col3, " .(api_is_western_name_order() ? "CONCAT(user.firstname, ' ', user.lastname)" : "CONCAT(user.lastname, ' ', user.firstname)") ." AS col4, survey.avail_from AS col5, survey.avail_till AS col6, CONCAT('',survey.answered,' / ',survey.invited, '') AS col7, survey.anonymous AS col8, survey.survey_id AS col9 FROM $table_survey survey LEFT JOIN $table_survey_question survey_question ON (survey.survey_id = survey_question.survey_id AND survey.c_id = survey_question.c_id), $table_user user WHERE survey.author = user.user_id AND survey.c_id = $course_id $list_condition "; $sql .= ' GROUP BY survey.survey_id'; $sql .= " ORDER BY col$column $direction "; $sql .= " LIMIT $from,$number_of_items"; $res = Database::query($sql); $surveys = []; while ($survey = Database::fetch_array($res)) { $survey['col5'] = api_convert_and_format_date( $survey['col5'], $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG ); $survey['col6'] = api_convert_and_format_date( $survey['col6'], $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG ); if ($mandatoryAllowed) { $survey['col10'] = $survey['col9']; $efvMandatory = $efv->get_values_by_handler_and_field_variable( $survey['col9'], 'is_mandatory' ); $survey['col9'] = $efvMandatory['value']; } $surveys[] = $survey; } return $surveys; } /** * Display all the active surveys for the given course user. * * @param int $user_id * * @author Patrick Cool , Ghent University * * @version April 2007 */ public static function getSurveyList($user_id) { $_course = api_get_course_info(); $course_id = $_course['real_id']; $user_id = (int) $user_id; $sessionId = api_get_session_id(); $mandatoryAllowed = api_get_configuration_value('allow_mandatory_survey'); $allowSurveyAvailabilityDatetime = api_get_configuration_value('allow_survey_availability_datetime'); // Database table definitions $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION); $table_survey = Database::get_course_table(TABLE_SURVEY); echo ''; echo ''; echo ''; echo ' '; echo ' '; if ($mandatoryAllowed) { echo ''; } echo ''; echo ''; echo ''; /** @var \DateTime $now */ $now = api_get_utc_datetime(null, false, true); $filterDate = $allowSurveyAvailabilityDatetime ? $now->format('Y-m-d H:i') : $now->format('Y-m-d'); $sql = "SELECT survey_invitation.answered, survey_invitation.invitation_code, survey_invitation.session_id, survey.title, survey.visible_results, survey.survey_id, survey.anonymous FROM $table_survey survey INNER JOIN $table_survey_invitation survey_invitation ON ( survey.code = survey_invitation.survey_code AND survey.c_id = survey_invitation.c_id AND survey.session_id = survey_invitation.session_id ) WHERE survey_invitation.user = $user_id AND survey.avail_from <= '$filterDate' AND survey.avail_till >= '$filterDate' AND survey.c_id = $course_id AND survey.session_id = $sessionId AND survey_invitation.c_id = $course_id "; $result = Database::query($sql); $efv = new ExtraFieldValue('survey'); $surveyIds = []; while ($row = Database::fetch_array($result, 'ASSOC')) { if (in_array($row['survey_id'], $surveyIds)) { continue; } echo ''; if ($row['answered'] == 0) { echo ''; } else { $isDrhOfCourse = CourseManager::isUserSubscribedInCourseAsDrh( $user_id, $_course ); $icon = Display::return_icon( 'statistics_na.png', get_lang('Survey'), [], ICON_SIZE_TINY ); $showLink = (!api_is_allowed_to_edit(false, true) || $isDrhOfCourse) && $row['visible_results'] != SURVEY_VISIBLE_TUTOR; echo ''; } echo ''; if ($mandatoryAllowed) { $efvMandatory = $efv->get_values_by_handler_and_field_variable( $row['survey_id'], 'is_mandatory' ); echo ''; } echo ''; $surveyIds[] = $row['survey_id']; } echo ''; echo '
'.get_lang('Survey name').''.get_lang('Anonymous').''.get_lang('Mandatory?').'
'; echo Display::return_icon( 'statistics.png', get_lang('Create survey'), [], ICON_SIZE_TINY ); $url = self::generateFillSurveyLink($row['invitation_code'], $_course, $row['session_id']); echo ' '.$row['title'] .''; echo $showLink ? Display::url( $icon.PHP_EOL.$row['title'], api_get_path(WEB_CODE_PATH).'survey/reporting.php?'.api_get_cidreq().'&'.http_build_query([ 'action' => 'questionreport', 'survey_id' => $row['survey_id'], ]) ) : $icon.PHP_EOL.$row['title']; echo ''; echo ($row['anonymous'] == 1) ? get_lang('Yes') : get_lang('No'); echo ''.($efvMandatory['value'] ? get_lang('Yes') : get_lang('No')).'
'; } /** * Creates a multi array with the user fields that we can show. * We look the visibility with the api_get_setting function * The username is always NOT able to change it. * * @author Julio Montoya Armas , Chamilo: Personality Test modification * * @return array array[value_name][name], array[value_name][visibilty] */ public static function make_field_list() { // LAST NAME and FIRST NAME $field_list_array = []; $field_list_array['lastname']['name'] = get_lang('Last name'); $field_list_array['firstname']['name'] = get_lang('First name'); if (api_get_setting('profile', 'name') != 'true') { $field_list_array['firstname']['visibility'] = 0; $field_list_array['lastname']['visibility'] = 0; } else { $field_list_array['firstname']['visibility'] = 1; $field_list_array['lastname']['visibility'] = 1; } $field_list_array['username']['name'] = get_lang('Username'); $field_list_array['username']['visibility'] = 0; // OFFICIAL CODE $field_list_array['official_code']['name'] = get_lang('OfficialCourse code'); if (api_get_setting('profile', 'officialcode') != 'true') { $field_list_array['official_code']['visibility'] = 1; } else { $field_list_array['official_code']['visibility'] = 0; } // EMAIL $field_list_array['email']['name'] = get_lang('e-mail'); if (api_get_setting('profile', 'email') != 'true') { $field_list_array['email']['visibility'] = 1; } else { $field_list_array['email']['visibility'] = 0; } // PHONE $field_list_array['phone']['name'] = get_lang('Phone'); if (api_get_setting('profile', 'phone') != 'true') { $field_list_array['phone']['visibility'] = 0; } else { $field_list_array['phone']['visibility'] = 1; } // LANGUAGE $field_list_array['language']['name'] = get_lang('Language'); if (api_get_setting('profile', 'language') != 'true') { $field_list_array['language']['visibility'] = 0; } else { $field_list_array['language']['visibility'] = 1; } // EXTRA FIELDS $extra = UserManager::get_extra_fields(0, 50, 5, 'ASC'); foreach ($extra as $id => $field_details) { if ($field_details[6] == 0) { continue; } switch ($field_details[2]) { case UserManager::USER_FIELD_TYPE_TEXT: $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_TEXTAREA: $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_RADIO: $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_SELECT: $get_lang_variables = false; if (in_array( $field_details[1], ['mail_notify_message', 'mail_notify_invitation', 'mail_notify_group_message'] ) ) { $get_lang_variables = true; } if ($get_lang_variables) { $field_list_array['extra_'.$field_details[1]]['name'] = get_lang($field_details[3]); } else { $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; } if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_SELECT_MULTIPLE: $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_DATE: $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_DATETIME: $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_DOUBLE_SELECT: $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3]; if ($field_details[7] == 0) { $field_list_array['extra_'.$field_details[1]]['visibility'] = 0; } else { $field_list_array['extra_'.$field_details[1]]['visibility'] = 1; } break; case UserManager::USER_FIELD_TYPE_DIVIDER: //$form->addElement('static',$field_details[1], '
'.$field_details[3].''); break; } } return $field_list_array; } /** * Display survey question chart. * * @param array $chartData * @param bool $hasSerie Tells if the chart has a serie. False by default * @param string $chartContainerId * * @return string (direct output) */ public static function drawChart( $chartData, $hasSerie = false, $chartContainerId = 'chartContainer' ) { $htmlChart = ''; if (api_browser_support('svg')) { $htmlChart .= api_get_js('d3/d3.v3.5.4.min.js'); $htmlChart .= api_get_js('dimple.v2.1.2.min.js').' '; } return $htmlChart; } /** * Set a flag to the current survey as answered by the current user. * * @param string $surveyCode The survey code * @param int $courseId The course ID */ public static function flagSurveyAsAnswered($surveyCode, $courseId) { $currentUserId = api_get_user_id(); $flag = sprintf('%s-%s-%d', $courseId, $surveyCode, $currentUserId); if (!isset($_SESSION['filled_surveys'])) { $_SESSION['filled_surveys'] = []; } $_SESSION['filled_surveys'][] = $flag; } /** * Check whether a survey was answered by the current user. * * @param string $surveyCode The survey code * @param int $courseId The course ID * * @return bool */ public static function isSurveyAnsweredFlagged($surveyCode, $courseId) { $currentUserId = api_get_user_id(); $flagToCheck = sprintf('%s-%s-%d', $courseId, $surveyCode, $currentUserId); if (!isset($_SESSION['filled_surveys'])) { return false; } if (!is_array($_SESSION['filled_surveys'])) { return false; } foreach ($_SESSION['filled_surveys'] as $flag) { if ($flagToCheck != $flag) { continue; } return true; } return false; } /** * Check if the current survey has answers. * * @param int $surveyId * * @return bool return true if the survey has answers, false otherwise */ public static function checkIfSurveyHasAnswers($surveyId) { $tableSurveyAnswer = Database::get_course_table(TABLE_SURVEY_ANSWER); $courseId = api_get_course_int_id(); $surveyId = (int) $surveyId; if (empty($courseId) || empty($surveyId)) { return false; } $sql = "SELECT * FROM $tableSurveyAnswer WHERE c_id = $courseId AND survey_id = '".$surveyId."' ORDER BY answer_id, user ASC"; $result = Database::query($sql); $response = Database::affected_rows($result); return $response > 0; } /** * Get the pending surveys for a user. * * @param int $userId * * @return array */ public static function getUserPendingInvitations($userId) { $now = api_get_utc_datetime(null, false, true); $dql = " SELECT s, si FROM ChamiloCourseBundle:CSurvey s INNER JOIN ChamiloCourseBundle:CSurveyInvitation si WITH (s.code = si.surveyCode AND s.cId = si.cId AND s.sessionId = si.sessionId ) WHERE si.user = :user_id AND s.availFrom <= :now AND s.availTill >= :now AND si.answered = 0 ORDER BY s.availTill ASC "; $pendingSurveys = Database::getManager() ->createQuery($dql) ->setParameters(['user_id' => $userId, 'now' => $now->format('Y-m-d')]) ->getResult(); return $pendingSurveys; } /** * @param string $surveyCode * @param int $courseId * @param int $sessionId * * @return array */ public static function getSentInvitations($surveyCode, $courseId, $sessionId = 0) { $tblUser = Database::get_main_table(TABLE_MAIN_USER); $tblSurveyInvitation = Database::get_course_table(TABLE_SURVEY_INVITATION); $sessionCondition = api_get_session_condition($sessionId); $surveyCode = Database::escape_string($surveyCode); $courseId = (int) $courseId; $sql = "SELECT survey_invitation.*, user.firstname, user.lastname, user.email FROM $tblSurveyInvitation survey_invitation LEFT JOIN $tblUser user ON (survey_invitation.user = user.id AND survey_invitation.c_id = $courseId) WHERE survey_invitation.survey_code = '$surveyCode' AND survey_invitation.c_id = $courseId $sessionCondition"; $query = Database::query($sql); return Database::store_result($query); } /** * @param string $code invitation code * @param array $courseInfo * @param int $sessionId * @param string $surveyCode * * @return string */ public static function generateFillSurveyLink($code, $courseInfo, $sessionId, $surveyCode = '') { $code = Security::remove_XSS($code); $sessionId = (int) $sessionId; if (empty($courseInfo)) { return ''; } $params = [ 'invitationcode' => $code, 'cidReq' => $courseInfo['code'], 'course' => $courseInfo['code'], 'id_session' => $sessionId, ]; if (!empty($surveyCode)) { $params['scode'] = Security::remove_XSS($surveyCode); } return api_get_path(WEB_CODE_PATH).'survey/fillsurvey.php?'.http_build_query($params); } }