. /** * 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', ['quizid' => $quizid, 'class' => $class]); require_sesskey(); $quizobj = quiz_settings::create($quizid); $quiz = $quizobj->get_quiz(); $cm = $quizobj->get_cm(); $course = $quizobj->get_course(); require_login($course, false, $cm); $structure = $quizobj->get_structure(); $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 = ['instancesection' => $section->heading]; break; case 'updatesectiontitle': require_capability('mod/quiz:manage', $modcontext); $structure->set_section_heading($id, $newheading); $result = ['instancesection' => format_string($newheading)]; break; case 'updateshufflequestions': require_capability('mod/quiz:manage', $modcontext); $structure->set_section_shuffle($id, $shuffle); $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 = ['visible' => true]; break; case 'getmaxmark': require_capability('mod/quiz:manage', $modcontext); $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); $gradecalculator->recompute_quiz_sumgrades(); $gradecalculator->recompute_all_attempt_sumgrades(); $gradecalculator->recompute_all_final_grades(); quiz_update_grades($quiz, 0, true); } $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 = []; foreach ($slots as $slot) { $json[$slot->slot] = ['id' => $slot->id, 'slot' => $slot->slot, 'page' => $slot->page]; } $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', ['quizid' => $quiz->id, 'id' => $id], '*', MUST_EXIST); if ($structure->has_use_capability($slot->slot)) { $structure->remove_slot($slot->slot); } } quiz_delete_previews($quiz); $gradecalculator->recompute_quiz_sumgrades(); $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 = ['requireprevious' => $value]; break; } break; } break; case 'DELETE': switch ($class) { case 'section': require_capability('mod/quiz:manage', $modcontext); $structure->remove_section_heading($id); $result = ['deleted' => true]; break; case 'resource': require_capability('mod/quiz:manage', $modcontext); 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); $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);