/**
* Grade quiz automatically
*
* This function grades each question automatically if there all questions are auto gradable. If not
* the quiz will not be auto gradable.
*
* @since 1.7.4
*
* @param integer $quiz_id ID of quiz
* @param array $submitted questions id ans answers {
* @type int $question_id
* @type mixed $answer
* }
* @param integer $total_questions Total questions in quiz (not used)
* @param string $quiz_grade_type Optional defaults to auto
*
* @return int $quiz_grade total sum of all question grades
*/
public static function grade_quiz_auto($quiz_id = 0, $submitted = array(), $total_questions = 0, $quiz_grade_type = 'auto')
{
if (!(intval($quiz_id) > 0) || !$submitted || $quiz_grade_type != 'auto') {
return false;
// exit early
}
global $woothemes_sensei;
$user_id = get_current_user_id();
$lesson_id = $woothemes_sensei->quiz->get_lesson_id($quiz_id);
$quiz_autogradable = true;
/**
* Filter the types of question types that can be automatically graded.
*
* This filter fires inside the auto grade quiz function and provides you with the default list.
*
* @param array {
* 'multiple-choice',
* 'boolean',
* 'gap-fill'.
* }
*/
$autogradable_question_types = apply_filters('sensei_autogradable_question_types', array('multiple-choice', 'boolean', 'gap-fill'));
$grade_total = 0;
$all_question_grades = array();
foreach ($submitted as $question_id => $answer) {
// check if the question is autogradable, either by type, or because the grade is 0
$question_type = $woothemes_sensei->question->get_question_type($question_id);
$achievable_grade = $woothemes_sensei->question->get_question_grade($question_id);
// Question has a zero grade, so skip grading
if (0 == $achievable_grade) {
$all_question_grades[$question_id] = $achievable_grade;
} elseif (in_array($question_type, $autogradable_question_types)) {
// Get user question grade
$question_grade = WooThemes_Sensei_Utils::sensei_grade_question_auto($question_id, $question_type, $answer, $user_id);
$all_question_grades[$question_id] = $question_grade;
$grade_total += $question_grade;
} else {
// There is a question that cannot be autograded
$quiz_autogradable = false;
}
// end if in_array( $question_type...
}
// end for each question
// Only if the whole quiz was autogradable do we set a grade
if ($quiz_autogradable) {
$quiz_total = WooThemes_Sensei_Utils::sensei_get_quiz_total($quiz_id);
// Check for zero total from grades
if (0 < $quiz_total) {
$grade = abs(round(doubleval($grade_total) * 100 / $quiz_total, 2));
} else {
$grade = 0;
}
WooThemes_Sensei_Utils::sensei_grade_quiz($quiz_id, $grade, $user_id, $quiz_grade_type);
} else {
$grade = new WP_Error('autograde', __('This quiz is not able to be automatically graded.', 'woothemes-sensei'));
}
// store the auto gradable grades. If the quiz is not auto gradable the grades can be use as the default
// when doing manual grading.
$woothemes_sensei->quiz->set_user_grades($all_question_grades, $lesson_id, $user_id);
return $grade;
}
/**
* Grade quiz automatically
* @param integer $quiz_id ID of quiz
* @param integer $lesson_id ID of lesson
* @param boolean $submitted Submitted answers
* @param integer $total_questions Total questions in quiz (not used)
* @return boolean Whether quiz was successfully graded or not
*/
public static function sensei_grade_quiz_auto($quiz_id = 0, $submitted = false, $total_questions = 0, $quiz_grade_type = 'auto')
{
if (intval($user_id) == 0) {
$user_id = get_current_user_id();
}
$grade = 0;
$correct_answers = 0;
$quiz_graded = false;
$quiz_autogradable = true;
if (intval($quiz_id) > 0 && $submitted) {
if ($quiz_grade_type == 'auto') {
// Can only autograde these question types
$autogradable_question_types = apply_filters('sensei_autogradable_question_types', array('multiple-choice', 'boolean', 'gap-fill'));
$grade_total = 0;
foreach ($submitted as $question_id => $answer) {
// check if the question is autogradable
$question_type = get_the_terms($question_id, 'question-type');
// Set default question type if one does not exist - prevents errors when grading
if (!$question_type || is_wp_error($question_type) || !is_array($question_type)) {
$question_type = 'multiple-choice';
} else {
$question_type = array_shift($question_type)->slug;
}
if (in_array($question_type, $autogradable_question_types)) {
// Get user question grade
$question_grade = WooThemes_Sensei_Utils::sensei_grade_question_auto($question_id, $question_type, $answer, $user_id);
$grade_total += $question_grade;
} else {
// There is a question that cannot be autograded
$quiz_autogradable = false;
}
}
// Only if the whole quiz was autogradable do we set a grade
if ($quiz_autogradable) {
$quiz_total = WooThemes_Sensei_Utils::sensei_get_quiz_total($quiz_id);
$grade = abs(round(doubleval($grade_total) * 100 / $quiz_total, 2));
$activity_logged = WooThemes_Sensei_Utils::sensei_grade_quiz($quiz_id, $grade, $user_id, $quiz_grade_type);
} else {
$grade = new WP_Error('autograde', __('This quiz is not able to be automatically graded.', 'woothemes-sensei'));
}
}
}
return $grade;
}
