Revert "MDL-34257 quiz 'secure' mode: PAGE initialisation order issues."
[moodle.git] / mod / quiz / review.php
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/>.
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  */
29 require_once(dirname(__FILE__) . '/../../config.php');
30 require_once($CFG->dirroot . '/mod/quiz/locallib.php');
31 require_once($CFG->dirroot . '/mod/quiz/report/reportlib.php');
33 $attemptid = required_param('attempt', PARAM_INT);
34 $page      = optional_param('page', 0, PARAM_INT);
35 $showall   = optional_param('showall', 0, PARAM_BOOL);
37 $url = new moodle_url('/mod/quiz/review.php', array('attempt'=>$attemptid));
38 if ($page !== 0) {
39     $url->param('page', $page);
40 }
41 if ($showall !== 0) {
42     $url->param('showall', $showall);
43 }
44 $PAGE->set_url($url);
46 $attemptobj = quiz_attempt::create($attemptid);
47 $page = $attemptobj->force_page_number_into_range($page);
49 // Check login.
50 require_login($attemptobj->get_course(), false, $attemptobj->get_cm());
51 $attemptobj->check_review_capability();
53 // Create an object to manage all the other (non-roles) access rules.
54 $accessmanager = $attemptobj->get_access_manager(time());
55 $options = $attemptobj->get_display_options(true);
57 // Check permissions.
58 if ($attemptobj->is_own_attempt()) {
59     if (!$attemptobj->is_finished()) {
60         redirect($attemptobj->attempt_url(null, $page));
62     } else if (!$options->attempt) {
63         $accessmanager->back_to_view_page($PAGE->get_renderer('mod_quiz'),
64                 $attemptobj->cannot_review_message());
65     }
67 } else if (!$attemptobj->is_review_allowed()) {
68     throw new moodle_quiz_exception($attemptobj->get_quizobj(), 'noreviewattempt');
69 }
71 // Load the questions and states needed by this page.
72 if ($showall) {
73     $questionids = $attemptobj->get_slots();
74 } else {
75     $questionids = $attemptobj->get_slots($page);
76 }
78 // Save the flag states, if they are being changed.
79 if ($options->flags == question_display_options::EDITABLE && optional_param('savingflags', false,
80         PARAM_BOOL)) {
81     require_sesskey();
82     $attemptobj->save_question_flags();
83     redirect($attemptobj->review_url(null, $page, $showall));
84 }
86 // Log this review.
87 add_to_log($attemptobj->get_courseid(), 'quiz', 'review', 'review.php?attempt=' .
88         $attemptobj->get_attemptid(), $attemptobj->get_quizid(), $attemptobj->get_cmid());
90 // Work out appropriate title and whether blocks should be shown.
91 if ($attemptobj->is_preview_user() && $attemptobj->is_own_attempt()) {
92     $strreviewtitle = get_string('reviewofpreview', 'quiz');
93     navigation_node::override_active_url($attemptobj->start_attempt_url());
95 } else {
96     $strreviewtitle = get_string('reviewofattempt', 'quiz', $attemptobj->get_attempt_number());
97     if (empty($attemptobj->get_quiz()->showblocks) && !$attemptobj->is_preview_user()) {
98         $PAGE->blocks->show_only_fake_blocks();
99     }
102 // Set up the page header.
103 $headtags = $attemptobj->get_html_head_contributions($page, $showall);
104 $PAGE->set_title(format_string($attemptobj->get_quiz_name()));
105 $PAGE->set_heading($attemptobj->get_course()->fullname);
106 $accessmanager->setup_attempt_page($PAGE);
108 // Summary table start. ============================================================================
110 // Work out some time-related things.
111 $attempt = $attemptobj->get_attempt();
112 $quiz = $attemptobj->get_quiz();
113 $overtime = 0;
115 if ($attempt->state == quiz_attempt::FINISHED) {
116     if ($timetaken = ($attempt->timefinish - $attempt->timestart)) {
117         if ($quiz->timelimit && $timetaken > ($quiz->timelimit + 60)) {
118             $overtime = $timetaken - $quiz->timelimit;
119             $overtime = format_time($overtime);
120         }
121         $timetaken = format_time($timetaken);
122     } else {
123         $timetaken = "-";
124     }
125 } else {
126     $timetaken = get_string('unfinished', 'quiz');
129 // Prepare summary informat about the whole attempt.
130 $summarydata = array();
131 if (!$attemptobj->get_quiz()->showuserpicture && $attemptobj->get_userid() != $USER->id) {
132     // If showuserpicture is true, the picture is shown elsewhere, so don't repeat it.
133     $student = $DB->get_record('user', array('id' => $attemptobj->get_userid()));
134     $usrepicture = new user_picture($student);
135     $usrepicture->courseid = $attemptobj->get_courseid();
136     $summarydata['user'] = array(
137         'title'   => $usrepicture,
138         'content' => new action_link(new moodle_url('/user/view.php', array(
139                                 'id' => $student->id, 'course' => $attemptobj->get_courseid())),
140                           fullname($student, true)),
141     );
144 if ($attemptobj->has_capability('mod/quiz:viewreports')) {
145     $attemptlist = $attemptobj->links_to_other_attempts($attemptobj->review_url(null, $page,
146             $showall));
147     if ($attemptlist) {
148         $summarydata['attemptlist'] = array(
149             'title'   => get_string('attempts', 'quiz'),
150             'content' => $attemptlist,
151         );
152     }
155 // Timing information.
156 $summarydata['startedon'] = array(
157     'title'   => get_string('startedon', 'quiz'),
158     'content' => userdate($attempt->timestart),
159 );
161 $summarydata['state'] = array(
162     'title'   => get_string('attemptstate', 'quiz'),
163     'content' => quiz_attempt::state_name($attempt->state),
164 );
166 if ($attempt->state == quiz_attempt::FINISHED) {
167     $summarydata['completedon'] = array(
168         'title'   => get_string('completedon', 'quiz'),
169         'content' => userdate($attempt->timefinish),
170     );
171     $summarydata['timetaken'] = array(
172         'title'   => get_string('timetaken', 'quiz'),
173         'content' => $timetaken,
174     );
177 if (!empty($overtime)) {
178     $summarydata['overdue'] = array(
179         'title'   => get_string('overdue', 'quiz'),
180         'content' => $overtime,
181     );
184 // Show marks (if the user is allowed to see marks at the moment).
185 $grade = quiz_rescale_grade($attempt->sumgrades, $quiz, false);
186 if ($options->marks >= question_display_options::MARK_AND_MAX && quiz_has_grades($quiz)) {
188     if ($attempt->state != quiz_attempt::FINISHED) {
189         $summarydata['grade'] = array(
190             'title'   => get_string('grade', 'quiz'),
191             'content' => get_string('attemptstillinprogress', 'quiz'),
192         );
194     } else if (is_null($grade)) {
195         $summarydata['grade'] = array(
196             'title'   => get_string('grade', 'quiz'),
197             'content' => quiz_format_grade($quiz, $grade),
198         );
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         }
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     }
230 // Feedback if there is any, and the user is allowed to see it now.
231 $feedback = $attemptobj->get_overall_feedback($grade);
232 if ($options->overallfeedback && $feedback) {
233     $summarydata['feedback'] = array(
234         'title'   => get_string('feedback', 'quiz'),
235         'content' => $feedback,
236     );
239 // Summary table end. ==============================================================================
241 if ($showall) {
242     $slots = $attemptobj->get_slots();
243     $lastpage = true;
244 } else {
245     $slots = $attemptobj->get_slots($page);
246     $lastpage = $attemptobj->is_last_page($page);
249 $output = $PAGE->get_renderer('mod_quiz');
251 // Arrange for the navigation to be displayed.
252 $navbc = $attemptobj->get_navigation_panel($output, 'quiz_review_nav_panel', $page, $showall);
253 $regions = $PAGE->blocks->get_regions();
254 $PAGE->blocks->add_fake_block($navbc, reset($regions));
256 echo $output->review_page($attemptobj, $slots, $page, $showall, $lastpage, $options, $summarydata);