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 review of a particular quiz attempt
19 *
20 * It is used either by the student whose attempts this is, after the attempt,
21 * or by a teacher reviewing another's attempt during or afterwards.
22 *
23 * @package   mod_quiz
24 * @copyright 1999 onwards Martin Dougiamas  {@link http://moodle.com}
25 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
26 */
27
28
29require_once(__DIR__ . '/../../config.php');
30require_once($CFG->dirroot . '/mod/quiz/locallib.php');
31require_once($CFG->dirroot . '/mod/quiz/report/reportlib.php');
32
33$attemptid = required_param('attempt', PARAM_INT);
34$page      = optional_param('page', 0, PARAM_INT);
35$showall   = optional_param('showall', null, PARAM_BOOL);
36$cmid      = optional_param('cmid', null, PARAM_INT);
37
38$url = new moodle_url('/mod/quiz/review.php', array('attempt'=>$attemptid));
39if ($page !== 0) {
40    $url->param('page', $page);
41} else if ($showall) {
42    $url->param('showall', $showall);
43}
44$PAGE->set_url($url);
45
46$attemptobj = quiz_create_attempt_handling_errors($attemptid, $cmid);
47$attemptobj->preload_all_attempt_step_users();
48$page = $attemptobj->force_page_number_into_range($page);
49
50// Now we can validate the params better, re-genrate the page URL.
51if ($showall === null) {
52    $showall = $page == 0 && $attemptobj->get_default_show_all('review');
53}
54$PAGE->set_url($attemptobj->review_url(null, $page, $showall));
55
56// Check login.
57require_login($attemptobj->get_course(), false, $attemptobj->get_cm());
58$attemptobj->check_review_capability();
59
60// Create an object to manage all the other (non-roles) access rules.
61$accessmanager = $attemptobj->get_access_manager(time());
62$accessmanager->setup_attempt_page($PAGE);
63
64$options = $attemptobj->get_display_options(true);
65
66// Check permissions - warning there is similar code in reviewquestion.php and
67// quiz_attempt::check_file_access. If you change on, change them all.
68if ($attemptobj->is_own_attempt()) {
69    if (!$attemptobj->is_finished()) {
70        redirect($attemptobj->attempt_url(null, $page));
71
72    } else if (!$options->attempt) {
73        $accessmanager->back_to_view_page($PAGE->get_renderer('mod_quiz'),
74                $attemptobj->cannot_review_message());
75    }
76
77} else if (!$attemptobj->is_review_allowed()) {
78    throw new moodle_quiz_exception($attemptobj->get_quizobj(), 'noreviewattempt');
79}
80
81// Load the questions and states needed by this page.
82if ($showall) {
83    $questionids = $attemptobj->get_slots();
84} else {
85    $questionids = $attemptobj->get_slots($page);
86}
87
88// Save the flag states, if they are being changed.
89if ($options->flags == question_display_options::EDITABLE && optional_param('savingflags', false,
90        PARAM_BOOL)) {
91    require_sesskey();
92    $attemptobj->save_question_flags();
93    redirect($attemptobj->review_url(null, $page, $showall));
94}
95
96// Work out appropriate title and whether blocks should be shown.
97if ($attemptobj->is_own_preview()) {
98    navigation_node::override_active_url($attemptobj->start_attempt_url());
99
100} else {
101    if (empty($attemptobj->get_quiz()->showblocks) && !$attemptobj->is_preview_user()) {
102        $PAGE->blocks->show_only_fake_blocks();
103    }
104}
105
106// Set up the page header.
107$headtags = $attemptobj->get_html_head_contributions($page, $showall);
108$PAGE->set_title($attemptobj->review_page_title($page, $showall));
109$PAGE->set_heading($attemptobj->get_course()->fullname);
110
111// Summary table start. ============================================================================
112
113// Work out some time-related things.
114$attempt = $attemptobj->get_attempt();
115$quiz = $attemptobj->get_quiz();
116$overtime = 0;
117
118if ($attempt->state == quiz_attempt::FINISHED) {
119    if ($timetaken = ($attempt->timefinish - $attempt->timestart)) {
120        if ($quiz->timelimit && $timetaken > ($quiz->timelimit + 60)) {
121            $overtime = $timetaken - $quiz->timelimit;
122            $overtime = format_time($overtime);
123        }
124        $timetaken = format_time($timetaken);
125    } else {
126        $timetaken = "-";
127    }
128} else {
129    $timetaken = get_string('unfinished', 'quiz');
130}
131
132// Prepare summary informat about the whole attempt.
133$summarydata = array();
134if (!$attemptobj->get_quiz()->showuserpicture && $attemptobj->get_userid() != $USER->id) {
135    // If showuserpicture is true, the picture is shown elsewhere, so don't repeat it.
136    $student = $DB->get_record('user', array('id' => $attemptobj->get_userid()));
137    $userpicture = new user_picture($student);
138    $userpicture->courseid = $attemptobj->get_courseid();
139    $summarydata['user'] = array(
140        'title'   => $userpicture,
141        'content' => new action_link(new moodle_url('/user/view.php', array(
142                                'id' => $student->id, 'course' => $attemptobj->get_courseid())),
143                          fullname($student, true)),
144    );
145}
146
147if ($attemptobj->has_capability('mod/quiz:viewreports')) {
148    $attemptlist = $attemptobj->links_to_other_attempts($attemptobj->review_url(null, $page,
149            $showall));
150    if ($attemptlist) {
151        $summarydata['attemptlist'] = array(
152            'title'   => get_string('attempts', 'quiz'),
153            'content' => $attemptlist,
154        );
155    }
156}
157
158// Timing information.
159$summarydata['startedon'] = array(
160    'title'   => get_string('startedon', 'quiz'),
161    'content' => userdate($attempt->timestart),
162);
163
164$summarydata['state'] = array(
165    'title'   => get_string('attemptstate', 'quiz'),
166    'content' => quiz_attempt::state_name($attempt->state),
167);
168
169if ($attempt->state == quiz_attempt::FINISHED) {
170    $summarydata['completedon'] = array(
171        'title'   => get_string('completedon', 'quiz'),
172        'content' => userdate($attempt->timefinish),
173    );
174    $summarydata['timetaken'] = array(
175        'title'   => get_string('timetaken', 'quiz'),
176        'content' => $timetaken,
177    );
178}
179
180if (!empty($overtime)) {
181    $summarydata['overdue'] = array(
182        'title'   => get_string('overdue', 'quiz'),
183        'content' => $overtime,
184    );
185}
186
187// Show marks (if the user is allowed to see marks at the moment).
188$grade = quiz_rescale_grade($attempt->sumgrades, $quiz, false);
189if ($options->marks >= question_display_options::MARK_AND_MAX && quiz_has_grades($quiz)) {
190
191    if ($attempt->state != quiz_attempt::FINISHED) {
192        // Cannot display grade.
193
194    } else if (is_null($grade)) {
195        $summarydata['grade'] = array(
196            'title'   => get_string('grade', 'quiz'),
197            'content' => quiz_format_grade($quiz, $grade),
198        );
199
200    } else {
201        // Show raw marks only if they are different from the grade (like on the view page).
202        if ($quiz->grade != $quiz->sumgrades) {
203            $a = new stdClass();
204            $a->grade = quiz_format_grade($quiz, $attempt->sumgrades);
205            $a->maxgrade = quiz_format_grade($quiz, $quiz->sumgrades);
206            $summarydata['marks'] = array(
207                'title'   => get_string('marks', 'quiz'),
208                'content' => get_string('outofshort', 'quiz', $a),
209            );
210        }
211
212        // Now the scaled grade.
213        $a = new stdClass();
214        $a->grade = html_writer::tag('b', quiz_format_grade($quiz, $grade));
215        $a->maxgrade = quiz_format_grade($quiz, $quiz->grade);
216        if ($quiz->grade != 100) {
217            $a->percent = html_writer::tag('b', format_float(
218                    $attempt->sumgrades * 100 / $quiz->sumgrades, 0));
219            $formattedgrade = get_string('outofpercent', 'quiz', $a);
220        } else {
221            $formattedgrade = get_string('outof', 'quiz', $a);
222        }
223        $summarydata['grade'] = array(
224            'title'   => get_string('grade', 'quiz'),
225            'content' => $formattedgrade,
226        );
227    }
228}
229
230// Any additional summary data from the behaviour.
231$summarydata = array_merge($summarydata, $attemptobj->get_additional_summary_data($options));
232
233// Feedback if there is any, and the user is allowed to see it now.
234$feedback = $attemptobj->get_overall_feedback($grade);
235if ($options->overallfeedback && $feedback) {
236    $summarydata['feedback'] = array(
237        'title'   => get_string('feedback', 'quiz'),
238        'content' => $feedback,
239    );
240}
241
242// Summary table end. ==============================================================================
243
244if ($showall) {
245    $slots = $attemptobj->get_slots();
246    $lastpage = true;
247} else {
248    $slots = $attemptobj->get_slots($page);
249    $lastpage = $attemptobj->is_last_page($page);
250}
251
252$output = $PAGE->get_renderer('mod_quiz');
253
254// Arrange for the navigation to be displayed.
255$navbc = $attemptobj->get_navigation_panel($output, 'quiz_review_nav_panel', $page, $showall);
256$regions = $PAGE->blocks->get_regions();
257$PAGE->blocks->add_fake_block($navbc, reset($regions));
258
259echo $output->review_page($attemptobj, $slots, $page, $showall, $lastpage, $options, $summarydata);
260
261// Trigger an event for this review.
262$attemptobj->fire_attempt_reviewed_event();
263