/**
  * 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;
 }
Beispiel #2
0
/**
 * 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;
}