<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
/**
* This page is the entry page into the quiz UI. Displays information about the
* quiz to students and teachers, and lets students see their previous attempts.
*
* @package mod_quiz
* @copyright 1999 onwards Martin Dougiamas {@link http://moodle.com}
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
> use mod_quiz\access_manager;
> use mod_quiz\output\renderer;
require_once(__DIR__ . '/../../config.php');
> use mod_quiz\output\view_page;
require_once($CFG->libdir.'/gradelib.php');
> use mod_quiz\quiz_attempt;
require_once($CFG->dirroot.'/mod/quiz/locallib.php');
> use mod_quiz\quiz_settings;
require_once($CFG->libdir . '/completionlib.php');
require_once($CFG->dirroot . '/course/format/lib.php');
$id = optional_param('id', 0, PARAM_INT); // Course Module ID, or ...
$q = optional_param('q', 0, PARAM_INT); // Quiz ID.
if ($id) {
< if (!$cm = get_coursemodule_from_id('quiz', $id)) {
< throw new \moodle_exception('invalidcoursemodule');
< }
< if (!$course = $DB->get_record('course', array('id' => $cm->course))) {
< throw new \moodle_exception('coursemisconf');
< }
> $quizobj = quiz_settings::create_for_cmid($id, $USER->id);
} else {
< if (!$quiz = $DB->get_record('quiz', array('id' => $q))) {
< throw new \moodle_exception('invalidquizid', 'quiz');
< }
< if (!$course = $DB->get_record('course', array('id' => $quiz->course))) {
< throw new \moodle_exception('invalidcourseid');
< }
< if (!$cm = get_coursemodule_from_instance("quiz", $quiz->id, $course->id)) {
< throw new \moodle_exception('invalidcoursemodule');
< }
> $quizobj = quiz_settings::create($q, $USER->id);
}
> $quiz = $quizobj->get_quiz();
> $cm = $quizobj->get_cm();
// Check login and get context.
> $course = $quizobj->get_course();
require_login($course, false, $cm);
< $context = context_module::instance($cm->id);
> $context = $quizobj->get_context();
require_capability('mod/quiz:view', $context);
// Cache some other capabilities we use several times.
$canattempt = has_capability('mod/quiz:attempt', $context);
$canreviewmine = has_capability('mod/quiz:reviewmyattempts', $context);
$canpreview = has_capability('mod/quiz:preview', $context);
// Create an object to manage all the other (non-roles) access rules.
$timenow = time();
< $quizobj = quiz::create($cm->instance, $USER->id);
< $accessmanager = new quiz_access_manager($quizobj, $timenow,
> $accessmanager = new access_manager($quizobj, $timenow,
has_capability('mod/quiz:ignoretimelimits', $context, null, false));
< $quiz = $quizobj->get_quiz();
// Trigger course_module_viewed event and completion.
quiz_view($quiz, $course, $cm, $context);
// Initialize $PAGE, compute blocks.
< $PAGE->set_url('/mod/quiz/view.php', array('id' => $cm->id));
> $PAGE->set_url('/mod/quiz/view.php', ['id' => $cm->id]);
// Create view object which collects all the information the renderer will need.
< $viewobj = new mod_quiz_view_object();
> $viewobj = new view_page();
$viewobj->accessmanager = $accessmanager;
$viewobj->canreviewmine = $canreviewmine || $canpreview;
// Get this user's attempts.
$attempts = quiz_get_user_attempts($quiz->id, $USER->id, 'finished', true);
$lastfinishedattempt = end($attempts);
$unfinished = false;
$unfinishedattemptid = null;
if ($unfinishedattempt = quiz_get_user_attempt_unfinished($quiz->id, $USER->id)) {
$attempts[] = $unfinishedattempt;
// If the attempt is now overdue, deal with that - and pass isonline = false.
// We want the student notified in this case.
$quizobj->create_attempt_object($unfinishedattempt)->handle_if_time_expired(time(), false);
$unfinished = $unfinishedattempt->state == quiz_attempt::IN_PROGRESS ||
$unfinishedattempt->state == quiz_attempt::OVERDUE;
if (!$unfinished) {
$lastfinishedattempt = $unfinishedattempt;
}
$unfinishedattemptid = $unfinishedattempt->id;
$unfinishedattempt = null; // To make it clear we do not use this again.
}
$numattempts = count($attempts);
$viewobj->attempts = $attempts;
< $viewobj->attemptobjs = array();
> $viewobj->attemptobjs = [];
foreach ($attempts as $attempt) {
$viewobj->attemptobjs[] = new quiz_attempt($attempt, $quiz, $cm, $course, false);
}
// Work out the final grade, checking whether it was overridden in the gradebook.
if (!$canpreview) {
$mygrade = quiz_get_best_grade($quiz, $USER->id);
} else if ($lastfinishedattempt) {
// Users who can preview the quiz don't get a proper grade, so work out a
// plausible value to display instead, so the page looks right.
$mygrade = quiz_rescale_grade($lastfinishedattempt->sumgrades, $quiz, false);
} else {
$mygrade = null;
}
$mygradeoverridden = false;
$gradebookfeedback = '';
$item = null;
< $grading_info = grade_get_grades($course->id, 'mod', 'quiz', $quiz->id, $USER->id);
< if (!empty($grading_info->items)) {
< $item = $grading_info->items[0];
> $gradinginfo = grade_get_grades($course->id, 'mod', 'quiz', $quiz->id, $USER->id);
> if (!empty($gradinginfo->items)) {
> $item = $gradinginfo->items[0];
if (isset($item->grades[$USER->id])) {
$grade = $item->grades[$USER->id];
if ($grade->overridden) {
$mygrade = $grade->grade + 0; // Convert to number.
$mygradeoverridden = true;
}
if (!empty($grade->str_feedback)) {
$gradebookfeedback = $grade->str_feedback;
}
}
}
$title = $course->shortname . ': ' . format_string($quiz->name);
$PAGE->set_title($title);
$PAGE->set_heading($course->fullname);
if (html_is_blank($quiz->intro)) {
$PAGE->activityheader->set_description('');
}
$PAGE->add_body_class('limitedwidth');
< /** @var mod_quiz_renderer $output */
> /** @var renderer $output */
$output = $PAGE->get_renderer('mod_quiz');
// Print table with existing attempts.
if ($attempts) {
// Work out which columns we need, taking account what data is available in each attempt.
list($someoptions, $alloptions) = quiz_get_combined_reviewoptions($quiz, $attempts);
$viewobj->attemptcolumn = $quiz->attempts != 1;
$viewobj->gradecolumn = $someoptions->marks >= question_display_options::MARK_AND_MAX &&
quiz_has_grades($quiz);
$viewobj->markcolumn = $viewobj->gradecolumn && ($quiz->grade != $quiz->sumgrades);
$viewobj->overallstats = $lastfinishedattempt && $alloptions->marks >= question_display_options::MARK_AND_MAX;
$viewobj->feedbackcolumn = quiz_has_feedback($quiz) && $alloptions->overallfeedback;
}
$viewobj->timenow = $timenow;
$viewobj->numattempts = $numattempts;
$viewobj->mygrade = $mygrade;
$viewobj->moreattempts = $unfinished ||
!$accessmanager->is_finished($numattempts, $lastfinishedattempt);
$viewobj->mygradeoverridden = $mygradeoverridden;
$viewobj->gradebookfeedback = $gradebookfeedback;
$viewobj->lastfinishedattempt = $lastfinishedattempt;
$viewobj->canedit = has_capability('mod/quiz:manage', $context);
< $viewobj->editurl = new moodle_url('/mod/quiz/edit.php', array('cmid' => $cm->id));
< $viewobj->backtocourseurl = new moodle_url('/course/view.php', array('id' => $course->id));
> $viewobj->editurl = new moodle_url('/mod/quiz/edit.php', ['cmid' => $cm->id]);
> $viewobj->backtocourseurl = new moodle_url('/course/view.php', ['id' => $course->id]);
$viewobj->startattempturl = $quizobj->start_attempt_url();
if ($accessmanager->is_preflight_check_required($unfinishedattemptid)) {
$viewobj->preflightcheckform = $accessmanager->get_preflight_check_form(
$viewobj->startattempturl, $unfinishedattemptid);
}
$viewobj->popuprequired = $accessmanager->attempt_must_be_in_popup();
$viewobj->popupoptions = $accessmanager->get_popup_options();
// Display information about this quiz.
$viewobj->infomessages = $viewobj->accessmanager->describe_rules();
if ($quiz->attempts != 1) {
$viewobj->infomessages[] = get_string('gradingmethod', 'quiz',
quiz_get_grading_option_name($quiz->grademethod));
}
// Inform user of the grade to pass if non-zero.
if ($item && grade_floats_different($item->gradepass, 0)) {
$a = new stdClass();
$a->grade = quiz_format_grade($quiz, $item->gradepass);
$a->maxgrade = quiz_format_grade($quiz, $quiz->grade);
$viewobj->infomessages[] = get_string('gradetopassoutof', 'quiz', $a);
}
< // Determine wheter a start attempt button should be displayed.
> // Determine whether a start attempt button should be displayed.
$viewobj->quizhasquestions = $quizobj->has_questions();
< $viewobj->preventmessages = array();
> $viewobj->preventmessages = [];
if (!$viewobj->quizhasquestions) {
$viewobj->buttontext = '';
} else {
if ($unfinished) {
if ($canpreview) {
$viewobj->buttontext = get_string('continuepreview', 'quiz');
} else if ($canattempt) {
$viewobj->buttontext = get_string('continueattemptquiz', 'quiz');
}
} else {
if ($canpreview) {
$viewobj->buttontext = get_string('previewquizstart', 'quiz');
} else if ($canattempt) {
$viewobj->preventmessages = $viewobj->accessmanager->prevent_new_attempt(
$viewobj->numattempts, $viewobj->lastfinishedattempt);
if ($viewobj->preventmessages) {
$viewobj->buttontext = '';
} else if ($viewobj->numattempts == 0) {
$viewobj->buttontext = get_string('attemptquiz', 'quiz');
} else {
$viewobj->buttontext = get_string('reattemptquiz', 'quiz');
}
}
}
// Users who can preview the quiz should be able to see all messages for not being able to access the quiz.
if ($canpreview) {
$viewobj->preventmessages = $viewobj->accessmanager->prevent_access();
} else if ($viewobj->buttontext) {
// If, so far, we think a button should be printed, so check if they will be allowed to access it.
if (!$viewobj->moreattempts) {
$viewobj->buttontext = '';
} else if ($canattempt) {
$viewobj->preventmessages = $viewobj->accessmanager->prevent_access();
if ($viewobj->preventmessages) {
$viewobj->buttontext = '';
}
}
}
}
$viewobj->showbacktocourse = ($viewobj->buttontext === '' &&
course_get_format($course)->has_view_page());
echo $OUTPUT->header();
>
> if (!empty($gradinginfo->errors)) {
if (isguestuser()) {
> foreach ($gradinginfo->errors as $error) {
// Guests can't do a quiz, so offer them a choice of logging in or going back.
> $errortext = new \core\output\notification($error, \core\output\notification::NOTIFY_ERROR);
echo $output->view_page_guest($course, $quiz, $cm, $context, $viewobj->infomessages, $viewobj);
> echo $OUTPUT->render($errortext);
} else if (!isguestuser() && !($canattempt || $canpreview
> }
|| $viewobj->canreviewmine)) {
> }
// If they are not enrolled in this course in a good enough role, tell them to enrol.
echo $output->view_page_notenrolled($course, $quiz, $cm, $context, $viewobj->infomessages, $viewobj);
} else {
echo $output->view_page($course, $quiz, $cm, $context, $viewobj);
}
echo $OUTPUT->footer();