mod/quiz/edit.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/>.
  16
  17
  18 /**
  19  * Page to edit quizzes
  20  *
  21  * This page generally has two columns:
  22  * The right column lists all available questions in a chosen category and
  23  * allows them to be edited or more to be added. This column is only there if
  24  * the quiz does not already have student attempts
  25  * The left column lists all questions that have been added to the current quiz.
  26  * The lecturer can add questions from the right hand list to the quiz or remove them
  27  *
  28  * The script also processes a number of actions:
  29  * Actions affecting a quiz:
  30  * up and down  Changes the order of questions and page breaks
  31  * addquestion  Adds a single question to the quiz
  32  * add          Adds several selected questions to the quiz
  33  * addrandom    Adds a certain number of random questions to the quiz
  34  * repaginate   Re-paginates the quiz
  35  * delete       Removes a question from the quiz
  36  * savechanges  Saves the order and grades for questions in the quiz
  37  *
  38  * @package    mod_quiz
  39  * @copyright  1999 onwards Martin Dougiamas and others {@link http://moodle.com}
  40  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  41  */
  42
  43
  44 require_once(__DIR__ . '/../../config.php');
  45 require_once($CFG->dirroot . '/mod/quiz/locallib.php');
  46 require_once($CFG->dirroot . '/mod/quiz/addrandomform.php');
  47 require_once($CFG->dirroot . '/question/editlib.php');
  48 require_once($CFG->dirroot . '/question/category_class.php');
  49
  50 // These params are only passed from page request to request while we stay on
  51 // this page otherwise they would go in question_edit_setup.
  52 $scrollpos = optional_param('scrollpos', '', PARAM_INT);
  53
  54 list($thispageurl, $contexts, $cmid, $cm, $quiz, $pagevars) =
  55         question_edit_setup('editq', '/mod/quiz/edit.php', true);
  56
  57 $defaultcategoryobj = question_make_default_categories($contexts->all());
  58 $defaultcategory = $defaultcategoryobj->id . ',' . $defaultcategoryobj->contextid;
  59
  60 $quizhasattempts = quiz_has_attempts($quiz->id);
  61
  62 $PAGE->set_url($thispageurl);
  63
  64 // Get the course object and related bits.
  65 $course = $DB->get_record('course', array('id' => $quiz->course), '*', MUST_EXIST);
  66 $quizobj = new quiz($quiz, $cm, $course);
  67 $structure = $quizobj->get_structure();
  68
  69 // You need mod/quiz:manage in addition to question capabilities to access this page.
  70 require_capability('mod/quiz:manage', $contexts->lowest());
  71
  72 // Log this visit.
  73 $params = array(
  74     'courseid' => $course->id,
  75     'context' => $contexts->lowest(),
  76     'other' => array(
  77         'quizid' => $quiz->id
  78     )
  79 );
  80 $event = \mod_quiz\event\edit_page_viewed::create($params);
  81 $event->trigger();
  82
  83 // Process commands ============================================================.
  84
  85 // Get the list of question ids had their check-boxes ticked.
  86 $selectedslots = array();
  87 $params = (array) data_submitted();
  88 foreach ($params as $key => $value) {
  89     if (preg_match('!^s([0-9]+)$!', $key, $matches)) {
  90         $selectedslots[] = $matches[1];
  91     }
  92 }
  93
  94 $afteractionurl = new moodle_url($thispageurl);
  95 if ($scrollpos) {
  96     $afteractionurl->param('scrollpos', $scrollpos);
  97 }
  98
  99 if (optional_param('repaginate', false, PARAM_BOOL) && confirm_sesskey()) {
 100     // Re-paginate the quiz.
 101     $structure->check_can_be_edited();
 102     $questionsperpage = optional_param('questionsperpage', $quiz->questionsperpage, PARAM_INT);
 103     quiz_repaginate_questions($quiz->id, $questionsperpage );
 104     quiz_delete_previews($quiz);
 105     redirect($afteractionurl);
 106 }
 107
 108 if (($addquestion = optional_param('addquestion', 0, PARAM_INT)) && confirm_sesskey()) {
 109     // Add a single question to the current quiz.
 110     $structure->check_can_be_edited();
 111     quiz_require_question_use($addquestion);
 112     $addonpage = optional_param('addonpage', 0, PARAM_INT);
 113     quiz_add_quiz_question($addquestion, $quiz, $addonpage);
 114     quiz_delete_previews($quiz);
 115     quiz_update_sumgrades($quiz);
 116     $thispageurl->param('lastchanged', $addquestion);
 117     redirect($afteractionurl);
 118 }
 119
 120 if (optional_param('add', false, PARAM_BOOL) && confirm_sesskey()) {
 121     $structure->check_can_be_edited();
 122     $addonpage = optional_param('addonpage', 0, PARAM_INT);
 123     // Add selected questions to the current quiz.
 124     $rawdata = (array) data_submitted();
 125     foreach ($rawdata as $key => $value) { // Parse input for question ids.
 126         if (preg_match('!^q([0-9]+)$!', $key, $matches)) {
 127             $key = $matches[1];
 128             quiz_require_question_use($key);
 129             quiz_add_quiz_question($key, $quiz, $addonpage);
 130         }
 131     }
 132     quiz_delete_previews($quiz);
 133     quiz_update_sumgrades($quiz);
 134     redirect($afteractionurl);
 135 }
 136
 137 if (optional_param('addsection', false, PARAM_BOOL)) {
 138     $structure->check_can_be_edited();
 139
 140     // Add a section to the quiz.
 141     if ($addonpage = optional_param('addonpage', 0, PARAM_INT)) {
 142         $structure->add_section_heading($addonpage);
 143     }
 144     quiz_delete_previews($quiz);
 145     redirect($afteractionurl);
 146 }
 147
 148 if ((optional_param('addrandom', false, PARAM_BOOL)) && confirm_sesskey()) {
 149     // Add random questions to the quiz.
 150     $structure->check_can_be_edited();
 151     $recurse = optional_param('recurse', 0, PARAM_BOOL);
 152     $addonpage = optional_param('addonpage', 0, PARAM_INT);
 153     $categoryid = required_param('categoryid', PARAM_INT);
 154     $randomcount = required_param('randomcount', PARAM_INT);
 155     quiz_add_random_questions($quiz, $addonpage, $categoryid, $randomcount, $recurse);
 156
 157     quiz_delete_previews($quiz);
 158     quiz_update_sumgrades($quiz);
 159     redirect($afteractionurl);
 160 }
 161
 162 if (optional_param('savechanges', false, PARAM_BOOL) && confirm_sesskey()) {
 163
 164     // If rescaling is required save the new maximum.
 165     $maxgrade = unformat_float(optional_param('maxgrade', -1, PARAM_RAW));
 166     if ($maxgrade >= 0) {
 167         quiz_set_grade($maxgrade, $quiz);
 168         quiz_update_all_final_grades($quiz);
 169         quiz_update_grades($quiz, 0, true);
 170     }
 171
 172     redirect($afteractionurl);
 173 }
 174
 175 // Get the question bank view.
 176 $questionbank = new mod_quiz\question\bank\custom_view($contexts, $thispageurl, $course, $cm, $quiz);
 177 $questionbank->set_quiz_has_attempts($quizhasattempts);
 178 $questionbank->process_actions($thispageurl, $cm);
 179
 180 // End of process commands =====================================================.
 181
 182 $PAGE->set_pagelayout('incourse');
 183 $PAGE->set_pagetype('mod-quiz-edit');
 184
 185 $output = $PAGE->get_renderer('mod_quiz', 'edit');
 186
 187 $PAGE->set_title(get_string('editingquizx', 'quiz', format_string($quiz->name)));
 188 $PAGE->set_heading($course->fullname);
 189 $node = $PAGE->settingsnav->find('mod_quiz_edit', navigation_node::TYPE_SETTING);
 190 if ($node) {
 191     $node->make_active();
 192 }
 193 echo $OUTPUT->header();
 194
 195 // Initialise the JavaScript.
 196 $quizeditconfig = new stdClass();
 197 $quizeditconfig->url = $thispageurl->out(true, array('qbanktool' => '0'));
 198 $quizeditconfig->dialoglisteners = array();
 199 $numberoflisteners = $DB->get_field_sql("
 200     SELECT COALESCE(MAX(page), 1)
 201       FROM {quiz_slots}
 202      WHERE quizid = ?", array($quiz->id));
 203
 204 for ($pageiter = 1; $pageiter <= $numberoflisteners; $pageiter++) {
 205     $quizeditconfig->dialoglisteners[] = 'addrandomdialoglaunch_' . $pageiter;
 206 }
 207
 208 $PAGE->requires->data_for_js('quiz_edit_config', $quizeditconfig);
 209 $PAGE->requires->js('/question/qengine.js');
 210
 211 // Questions wrapper start.
 212 echo html_writer::start_tag('div', array('class' => 'mod-quiz-edit-content'));
 213
 214 echo $output->edit_page($quizobj, $structure, $contexts, $thispageurl, $pagevars);
 215
 216 // Questions wrapper end.
 217 echo html_writer::end_tag('div');
 218
 219 echo $OUTPUT->footer();