1<?php
2// This file is part of Moodle - http://moodle.org/
3//
4// Moodle is free software: you can redistribute it and/or modify
5// it under the terms of the GNU General Public License as published by
6// the Free Software Foundation, either version 3 of the License, or
7// (at your option) any later version.
8//
9// Moodle is distributed in the hope that it will be useful,
10// but WITHOUT ANY WARRANTY; without even the implied warranty of
11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12// GNU General Public License for more details.
13//
14// You should have received a copy of the GNU General Public License
15// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
16
17/**
18 * This page prints a summary of a quiz attempt before it is submitted.
19 *
20 * @package   mod_quiz
21 * @copyright 2009 The Open University
22 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23 */
24
25
26require_once(__DIR__ . '/../../config.php');
27require_once($CFG->dirroot . '/mod/quiz/locallib.php');
28
29$attemptid = required_param('attempt', PARAM_INT); // The attempt to summarise.
30$cmid = optional_param('cmid', null, PARAM_INT);
31
32$PAGE->set_url('/mod/quiz/summary.php', array('attempt' => $attemptid));
33// During quiz attempts, the browser back/forwards buttons should force a reload.
34$PAGE->set_cacheable(false);
35
36$attemptobj = quiz_create_attempt_handling_errors($attemptid, $cmid);
37
38// Check login.
39require_login($attemptobj->get_course(), false, $attemptobj->get_cm());
40
41// Check that this attempt belongs to this user.
42if ($attemptobj->get_userid() != $USER->id) {
43    if ($attemptobj->has_capability('mod/quiz:viewreports')) {
44        redirect($attemptobj->review_url(null));
45    } else {
46        throw new moodle_quiz_exception($attemptobj->get_quizobj(), 'notyourattempt');
47    }
48}
49
50// Check capabilites.
51if (!$attemptobj->is_preview_user()) {
52    $attemptobj->require_capability('mod/quiz:attempt');
53}
54
55if ($attemptobj->is_preview_user()) {
56    navigation_node::override_active_url($attemptobj->start_attempt_url());
57}
58
59// Check access.
60$accessmanager = $attemptobj->get_access_manager(time());
61$accessmanager->setup_attempt_page($PAGE);
62$output = $PAGE->get_renderer('mod_quiz');
63$messages = $accessmanager->prevent_access();
64if (!$attemptobj->is_preview_user() && $messages) {
65    print_error('attempterror', 'quiz', $attemptobj->view_url(),
66            $output->access_messages($messages));
67}
68if ($accessmanager->is_preflight_check_required($attemptobj->get_attemptid())) {
69    redirect($attemptobj->start_attempt_url(null));
70}
71
72$displayoptions = $attemptobj->get_display_options(false);
73
74// If the attempt is now overdue, or abandoned, deal with that.
75$attemptobj->handle_if_time_expired(time(), true);
76
77// If the attempt is already closed, redirect them to the review page.
78if ($attemptobj->is_finished()) {
79    redirect($attemptobj->review_url());
80}
81
82\core\session\manager::keepalive(); // Try to prevent sessions expiring during quiz attempts.
83
84// Arrange for the navigation to be displayed.
85if (empty($attemptobj->get_quiz()->showblocks)) {
86    $PAGE->blocks->show_only_fake_blocks();
87}
88
89$navbc = $attemptobj->get_navigation_panel($output, 'quiz_attempt_nav_panel', -1);
90$regions = $PAGE->blocks->get_regions();
91$PAGE->blocks->add_fake_block($navbc, reset($regions));
92
93$PAGE->navbar->add(get_string('summaryofattempt', 'quiz'));
94$PAGE->set_title($attemptobj->summary_page_title());
95$PAGE->set_heading($attemptobj->get_course()->fullname);
96
97// Display the page.
98echo $output->summary_page($attemptobj, $displayoptions);
99
100// Log this page view.
101$attemptobj->fire_attempt_summary_viewed_event();
102