/** * Fetch the answer data and clean it up based on the type of question * @param Array $potentialAnswers The potential answers that need checking. * @return Array A list of the results. */ function check_quizzes_canWeContinue_extractAnswerData($potentialAnswers) { $resultsList = array('answer_list' => array(), 'wrong_answer_list' => array(), 'error_answer_list' => array()); // #### 1 - Extract a list of actual answers from the potential answers. There will // be some noise in that data. Check the raw data to see what questions we have. foreach ($potentialAnswers as $key => $value) { // Only considering answers to questions. Format of answer field is: // question_16_truefalse_48 (first ID is quiz, 2nd ID is question, middle string // is the question type. if (preg_match('/^question_(\\d+)_([a-z]+)_(\\d+)$/', $key, $matches)) { $quizID = $matches[1]; $questionID = $matches[3]; $questionType = $matches[2]; // Again, check that answer matches quiz we're expecting. // Probably a little paranoid, but it's worth checking // to ensure there's nothing naughty going on. if ($quizID != $this->unitQuizDetails->quiz_id) { continue; } // Clean up the submitted data based on the type of quiz using the static checks in each // of the questions (to save loading whole class). If the data is valid, add the valid // answer to the list of fully validate danswers. switch ($questionType) { case 'multi': $resultsList['answer_list'][$questionID] = WPCW_quiz_MultipleChoice::sanitizeAnswerData($value); break; case 'truefalse': $resultsList['answer_list'][$questionID] = WPCW_quiz_TrueFalse::sanitizeAnswerData($value); break; case 'open': $resultsList['answer_list'][$questionID] = WPCW_quiz_OpenEntry::sanitizeAnswerData($value); break; // Ignore uploads as a $_POST field, simply because the files should be stored in $_FILES // not in $_POST. So if we have a file in $_FILES, that's clearly an issue. // Ignore uploads as a $_POST field, simply because the files should be stored in $_FILES // not in $_POST. So if we have a file in $_FILES, that's clearly an issue. case 'upload': break; } } // end of question check } // end of potential answers loop // ### 2 - Check for file uploads if the quiz requires them. Only check for uploads // if the quiz details say there should be some uploads. if ($this->unitQuizDetails->want_uploads) { $uploadResultList = WPCW_quiz_FileUpload::validateFiles($_FILES, $this->unitQuizDetails); // Merge the valid results. // Basically if a file has been uploaded correctly, that answer is marked as being set. if (count($uploadResultList['upload_valid']) > 0) { $resultsList['answer_list'] = $resultsList['answer_list'] + $uploadResultList['upload_valid']; } // Merge the error results if (count($uploadResultList['upload_errors']) > 0) { $resultsList['error_answer_list'] = $resultsList['error_answer_list'] + $uploadResultList['upload_errors']; } } return $resultsList; }
/** * Having entered some details into the quiz, may the user progress to the next unit? If * there are any problems with the quiz, then they are dealt with via AJAX. * * @param Object $quizDetails The potential quiz details. * @param Array $potentialAnswers The potential answers that need checking. * @param Integer $userID The ID of the user that we're saving progress for. * * @return Boolean True if the user may progress, false otherwise. */ function WPCW_quizzes_handleQuizRendering_canUserContinueAfterQuiz($quizDetails, $potentialAnswers, $userID) { $resultsList = array('answer_list' => array(), 'wrong_answer_list' => array(), 'error_answer_list' => array()); $resultDetails = array('correct' => array(), 'wrong' => array()); // #### 1A Extract a list of actual answers from the potential answers. There will // be some noise in that data. foreach ($potentialAnswers as $key => $value) { // Only considering answers to questions. Format of answer field is: // question_16_truefalse_48 (first ID is quiz, 2nd ID is question, middle string // is the question type. if (preg_match('/^question_(\\d+)_([a-z]+)_(\\d+)$/', $key, $matches)) { $quizID = $matches[1]; $questionID = $matches[3]; $questionType = $matches[2]; // Again, check that answer matches quiz we're expecting. // Probably a little paranoid, but it's worth checking // to ensure there's nothing naughty going on. if ($quizID != $quizDetails->quiz_id) { continue; } // Clean up the submitted data based on the type of quiz using the static checks in each // of the questions (to save loading whole class). If the data is valid, add the valid // answer to the list of fully validate danswers. switch ($questionType) { case 'multi': $resultsList['answer_list'][$questionID] = WPCW_quiz_MultipleChoice::sanitizeAnswerData($value); break; case 'truefalse': $resultsList['answer_list'][$questionID] = WPCW_quiz_TrueFalse::sanitizeAnswerData($value); break; case 'open': $resultsList['answer_list'][$questionID] = WPCW_quiz_OpenEntry::sanitizeAnswerData($value); break; // Ignore uploads as a $_POST field, simply because the files should be stored in $_FILES // not in $_POST. So if we have a file in $_FILES, that's clearly an issue. // Ignore uploads as a $_POST field, simply because the files should be stored in $_FILES // not in $_POST. So if we have a file in $_FILES, that's clearly an issue. case 'upload': break; } } // end of question check } // end of potential answers loop // ### 1B Check for file uploads if the quiz requires them. Only check for uploads // if the quiz details say there should be some uploads. if ($quizDetails->want_uploads) { $uploadResultList = WPCW_quiz_FileUpload::validateFiles($_FILES, $quizDetails); // Merge the valid results. // Basically if a file has been uploaded correctly, that answer is marked as being set. if (count($uploadResultList['upload_valid']) > 0) { $resultsList['answer_list'] = $resultsList['answer_list'] + $uploadResultList['upload_valid']; } // Merge the error results if (count($uploadResultList['upload_errors']) > 0) { $resultsList['error_answer_list'] = $resultsList['error_answer_list'] + $uploadResultList['upload_errors']; } } // ### 2 - Check that we have enough answers given how many questions there are. // If there are not enough answers, then re-render the form with the answered questions // marked, and highlight the fields that have errors. if ($quizDetails->questions && count($resultsList['answer_list']) < count($quizDetails->questions)) { // Error - not all questions are answered echo WPCW_units_createErrorMessage(__('Please provide an answer for all of the questions.', 'wp_courseware')); // Show the form with the questions that have been completed already. echo WPCW_quizzes_handleQuizRendering($quizDetails->parent_unit_id, $quizDetails, $resultsList); // User may not continue - as quiz is not complete. return false; } // Flag to indicate if grading is needed before the user continues. $gradingNeeded = false; $gradingNeededBeforeContinue = false; // ### 3 - Do we need to check for correct answers? if ('survey' == $quizDetails->quiz_type) { // Never try to show answers. There aren't any. $quizDetails->quiz_show_answers = 'hide_answers'; // No answers to check. Say thanks echo WPCW_units_createSuccessMessage(__('Thank you for your responses. This unit is now complete.', 'wp_courseware')); } else { $resultDetails = WPCW_quizzes_checkForCorrectAnswers($quizDetails, $resultsList['answer_list']); // #### Step A - have open-ended questions that need marking. if (!empty($resultDetails['needs_marking'])) { $gradingNeeded = true; $courseDetails = WPCW_courses_getCourseDetails($quizDetails->parent_course_id); // Non-blocking quiz - so allowed to continue, but will be graded later. if ('quiz_noblock' == $quizDetails->quiz_type) { echo WPCW_units_createSuccessMessage($courseDetails->course_message_quiz_open_grading_non_blocking); } else { echo WPCW_units_createSuccessMessage($courseDetails->course_message_quiz_open_grading_blocking); // Grading is needed before they continue, but don't want them to re-take the quiz. $gradingNeededBeforeContinue = true; } } else { // Copy over the wrong answers. $resultsList['wrong_answer_list'] = $resultDetails['wrong']; // Some statistics $correctCount = count($resultDetails['correct']); $totalQuestions = count($quizDetails->questions); $correctPercentage = number_format($correctCount / $totalQuestions * 100, 1); // Non-blocking quiz. if ('quiz_noblock' == $quizDetails->quiz_type) { // Store user quiz results echo WPCW_units_createSuccessMessage(sprintf(__('You got <b>%d out of %d (%d%%)</b> questions correct! This unit is now complete.', 'wp_courseware'), $correctCount, $totalQuestions, $correctPercentage)); // Notify the user of their grade. do_action('wpcw_quiz_graded', $userID, $quizDetails, $correctPercentage, false); } else { $minPassQuestions = $totalQuestions * ($quizDetails->quiz_pass_mark / 100); // They've passed. Report how many they got right. if ($correctPercentage >= $quizDetails->quiz_pass_mark) { echo WPCW_units_createSuccessMessage(sprintf(__('You got <b>%d out of %d (%d%%)</b> questions correct! This unit is now complete.', 'wp_courseware'), $correctCount, $totalQuestions, $correctPercentage)); // Notify the user of their grade. do_action('wpcw_quiz_graded', $userID, $quizDetails, $correctPercentage, false); } else { echo WPCW_units_createErrorMessage(sprintf(__('Unfortunately, you only got <b>%d out of %d (%d%%)</b> questions correct. You need to correctly answer <b>at least %d questions (%d%%)</b>.', 'wp_courseware'), $correctCount, $totalQuestions, $correctPercentage, $minPassQuestions, $quizDetails->quiz_pass_mark)); // Show form with error answers. echo WPCW_quizzes_handleQuizRendering($quizDetails->parent_unit_id, $quizDetails, $resultsList); // Errors, so the user cannot progress yet. return false; } } // end of blocking quiz check } } // end of survey check // ### 4 - Show the correct answers to the user? if ('show_answers' == $quizDetails->quiz_show_answers) { echo WPCW_quizzes_showAllCorrectAnswers($quizDetails); } // ### 5 - Save the user progress WPCW_quizzes_saveUserProgress($userID, $quizDetails, $resultDetails, $resultsList['answer_list']); // Questions need grading, notify the admin if ($gradingNeeded) { // Notify the admin that questions need answering. do_action('wpcw_quiz_needs_grading', $userID, $quizDetails); } // Questions need grading, so don't allow user to continue if ($gradingNeededBeforeContinue) { return false; } // If we get this far, the user may progress to next unit return true; }