See Release Notes
Long Term Support Release
<?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/>. /** * Rest endpoint for ajax editing of quiz structure. * * @package mod_quiz * @copyright 1999 Martin Dougiamas http://dougiamas.com * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */> use mod_quiz\quiz_settings; if (!defined('AJAX_SCRIPT')) { >define('AJAX_SCRIPT', true); } require_once(__DIR__ . '/../../config.php'); require_once($CFG->dirroot . '/mod/quiz/locallib.php'); // Initialise ALL the incoming parameters here, up front. $quizid = required_param('quizid', PARAM_INT); $class = required_param('class', PARAM_ALPHA); $field = optional_param('field', '', PARAM_ALPHA); $instanceid = optional_param('instanceId', 0, PARAM_INT); $sectionid = optional_param('sectionId', 0, PARAM_INT); $previousid = optional_param('previousid', 0, PARAM_INT); $value = optional_param('value', 0, PARAM_INT); $column = optional_param('column', 0, PARAM_ALPHA); $id = optional_param('id', 0, PARAM_INT); $summary = optional_param('summary', '', PARAM_RAW); $sequence = optional_param('sequence', '', PARAM_SEQUENCE); $visible = optional_param('visible', 0, PARAM_INT); $pageaction = optional_param('action', '', PARAM_ALPHA); // Used to simulate a DELETE command. $maxmark = optional_param('maxmark', '', PARAM_FLOAT); $newheading = optional_param('newheading', '', PARAM_TEXT); $shuffle = optional_param('newshuffle', 0, PARAM_INT); $page = optional_param('page', '', PARAM_INT); $ids = optional_param('ids', '', PARAM_SEQUENCE); $PAGE->set_url('/mod/quiz/edit-rest.php',< array('quizid' => $quizid, 'class' => $class));> ['quizid' => $quizid, 'class' => $class]);require_sesskey();< $quiz = $DB->get_record('quiz', array('id' => $quizid), '*', MUST_EXIST); < $cm = get_coursemodule_from_instance('quiz', $quiz->id, $quiz->course); < $course = $DB->get_record('course', array('id' => $quiz->course), '*', MUST_EXIST);> $quizobj = quiz_settings::create($quizid); > $quiz = $quizobj->get_quiz(); > $cm = $quizobj->get_cm(); > $course = $quizobj->get_course();require_login($course, false, $cm);< $quizobj = new quiz($quiz, $cm, $course);$structure = $quizobj->get_structure();< $modcontext = context_module::instance($cm->id);> $gradecalculator = $quizobj->get_grade_calculator(); > $modcontext = $quizobj->get_context();echo $OUTPUT->header(); // Send headers. // All these AJAX actions should be logically atomic. $transaction = $DB->start_delegated_transaction(); // OK, now let's process the parameters and do stuff // MDL-10221 the DELETE method is not allowed on some web servers, // so we simulate it with the action URL param. $requestmethod = $_SERVER['REQUEST_METHOD']; if ($pageaction == 'DELETE') { $requestmethod = 'DELETE'; } $result = null; switch($requestmethod) { case 'POST': case 'GET': // For debugging. switch ($class) { case 'section': $table = 'quiz_sections'; $section = $structure->get_section_by_id($id); switch ($field) { case 'getsectiontitle': require_capability('mod/quiz:manage', $modcontext);< $result = array('instancesection' => $section->heading);> $result = ['instancesection' => $section->heading];break; case 'updatesectiontitle': require_capability('mod/quiz:manage', $modcontext); $structure->set_section_heading($id, $newheading);< $result = array('instancesection' => format_string($newheading));> $result = ['instancesection' => format_string($newheading)];break; case 'updateshufflequestions': require_capability('mod/quiz:manage', $modcontext); $structure->set_section_shuffle($id, $shuffle);< $result = array('instanceshuffle' => $section->shufflequestions);> $result = ['instanceshuffle' => $section->shufflequestions];break; } break; case 'resource': switch ($field) { case 'move': require_capability('mod/quiz:manage', $modcontext); if (!$previousid) { $section = $structure->get_section_by_id($sectionid); if ($section->firstslot > 1) { $previousid = $structure->get_slot_id_for_slot($section->firstslot - 1); $page = $structure->get_page_number_for_slot($section->firstslot); } } $structure->move_slot($id, $previousid, $page); quiz_delete_previews($quiz);< $result = array('visible' => true);> $result = ['visible' => true];break; case 'getmaxmark': require_capability('mod/quiz:manage', $modcontext);< $slot = $DB->get_record('quiz_slots', array('id' => $id), '*', MUST_EXIST); < $result = array('instancemaxmark' => quiz_format_question_grade($quiz, $slot->maxmark));> $slot = $DB->get_record('quiz_slots', ['id' => $id], '*', MUST_EXIST); > $result = ['instancemaxmark' => quiz_format_question_grade($quiz, $slot->maxmark)];break; case 'updatemaxmark': require_capability('mod/quiz:manage', $modcontext); $slot = $structure->get_slot_by_id($id); if ($structure->update_slot_maxmark($slot, $maxmark)) { // Grade has really changed. quiz_delete_previews($quiz);< quiz_update_sumgrades($quiz); < quiz_update_all_attempt_sumgrades($quiz); < quiz_update_all_final_grades($quiz);> $gradecalculator->recompute_quiz_sumgrades(); > $gradecalculator->recompute_all_attempt_sumgrades(); > $gradecalculator->recompute_all_final_grades();quiz_update_grades($quiz, 0, true); }< $result = array('instancemaxmark' => quiz_format_question_grade($quiz, $maxmark), < 'newsummarks' => quiz_format_grade($quiz, $quiz->sumgrades));> $result = ['instancemaxmark' => quiz_format_question_grade($quiz, $maxmark), > 'newsummarks' => quiz_format_grade($quiz, $quiz->sumgrades)];break; case 'updatepagebreak': require_capability('mod/quiz:manage', $modcontext); $slots = $structure->update_page_break($id, $value);< $json = array();> $json = [];foreach ($slots as $slot) {< $json[$slot->slot] = array('id' => $slot->id, 'slot' => $slot->slot, < 'page' => $slot->page);> $json[$slot->slot] = ['id' => $slot->id, 'slot' => $slot->slot, > 'page' => $slot->page];}< $result = array('slots' => $json);> $result = ['slots' => $json];break; case 'deletemultiple': require_capability('mod/quiz:manage', $modcontext); $ids = explode(',', $ids); foreach ($ids as $id) {< $slot = $DB->get_record('quiz_slots', array('quizid' => $quiz->id, 'id' => $id),> $slot = $DB->get_record('quiz_slots', ['quizid' => $quiz->id, 'id' => $id],'*', MUST_EXIST); if ($structure->has_use_capability($slot->slot)) { $structure->remove_slot($slot->slot); } } quiz_delete_previews($quiz);< quiz_update_sumgrades($quiz);> $gradecalculator->recompute_quiz_sumgrades();< $result = array('newsummarks' => quiz_format_grade($quiz, $quiz->sumgrades), < 'deleted' => true, 'newnumquestions' => $structure->get_question_count());> $result = ['newsummarks' => quiz_format_grade($quiz, $quiz->sumgrades), > 'deleted' => true, 'newnumquestions' => $structure->get_question_count()];break; case 'updatedependency': require_capability('mod/quiz:manage', $modcontext); $slot = $structure->get_slot_by_id($id); $value = (bool) $value; $structure->update_question_dependency($slot->id, $value);< $result = array('requireprevious' => $value);> $result = ['requireprevious' => $value];break; } break; } break; case 'DELETE': switch ($class) { case 'section': require_capability('mod/quiz:manage', $modcontext); $structure->remove_section_heading($id);< $result = array('deleted' => true);> $result = ['deleted' => true];break; case 'resource': require_capability('mod/quiz:manage', $modcontext);< if (!$slot = $DB->get_record('quiz_slots', array('quizid' => $quiz->id, 'id' => $id))) {> if (!$slot = $DB->get_record('quiz_slots', ['quizid' => $quiz->id, 'id' => $id])) {throw new moodle_exception('AJAX commands.php: Bad slot ID '.$id); } if (!$structure->has_use_capability($slot->slot)) { $slotdetail = $structure->get_slot_by_id($slot->id); $context = context::instance_by_id($slotdetail->contextid); throw new required_capability_exception($context, 'moodle/question:useall', 'nopermissions', ''); } $structure->remove_slot($slot->slot); quiz_delete_previews($quiz);< quiz_update_sumgrades($quiz); < $result = array('newsummarks' => quiz_format_grade($quiz, $quiz->sumgrades), < 'deleted' => true, 'newnumquestions' => $structure->get_question_count());> $gradecalculator->recompute_quiz_sumgrades(); > $result = ['newsummarks' => quiz_format_grade($quiz, $quiz->sumgrades), > 'deleted' => true, 'newnumquestions' => $structure->get_question_count()];break; } break; } $transaction->allow_commit(); echo json_encode($result);