/**
* 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;
}