MDL-73337 Quiz: Editing quizzes should be logged in detail

mod/quiz/backup/moodle2/restore_quiz_stepslib.php

@@ -388,8 +388,10 @@ protected function process_quiz_section($data) {
 
         $data = (object) $data;
         $data->quizid = $this->get_new_parentid('quiz');
+        $oldid = $data->id;
         $newitemid = $DB->insert_record('quiz_sections', $data);
         $this->sectioncreated = true;
+        $this->set_mapping('quiz_section', $oldid, $newitemid, true);
     }
 
     protected function process_quiz_feedback($data) {

mod/quiz/classes/event/page_break_created.php

@@ -0,0 +1,94 @@
+<?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/>.
+
+/**
+ * The mod_quiz page break created event.
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace mod_quiz\event;
+
+/**
+ * The mod_quiz page break created event class.
+ *
+ * @property-read array $other {
+ *      Extra information about event.
+ *
+ *      - int quizid: the id of the quiz.
+ *      - int slotnumber: the slot number which we will add the page break before.
+ * }
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class page_break_created extends \core\event\base {
+    protected function init() {
+        $this->data['objecttable'] = 'quiz_slots';
+        $this->data['crud'] = 'u';
+        $this->data['edulevel'] = self::LEVEL_PARTICIPATING;
+    }
+
+    public static function get_name() {
+        return get_string('eventpagebreakcreated', 'mod_quiz');
+    }
+
+    public function get_description() {
+        return "The user with id '$this->userid' created the page break before the slot with id '{$this->objectid}' " .
+            "and slot number '{$this->other['slotnumber']}' " .
+            "belonging to the quiz with course module id '$this->contextinstanceid'.";
+    }
+
+    public function get_url() {
+        return new \moodle_url('/mod/quiz/edit.php', [
+            'cmid' => $this->contextinstanceid
+        ]);
+    }
+
+    protected function validate_data() {
+        parent::validate_data();
+
+        if (!isset($this->objectid)) {
+            throw new \coding_exception('The \'objectid\' value must be set.');
+        }
+
+        if (!isset($this->contextinstanceid)) {
+            throw new \coding_exception('The \'contextinstanceid\' value must be set.');
+        }
+
+        if (!isset($this->other['quizid'])) {
+            throw new \coding_exception('The \'quizid\' value must be set in other.');
+        }
+
+        if (!isset($this->other['slotnumber'])) {
+            throw new \coding_exception('The \'slotnumber\' value must be set in other.');
+        }
+    }
+
+    public static function get_objectid_mapping() {
+        return ['db' => 'quiz_slots', 'restore' => 'quiz_question_instance'];
+    }
+
+    public static function get_other_mapping() {
+        $othermapped = [];
+        $othermapped['quizid'] = ['db' => 'quiz', 'restore' => 'quiz'];
+
+        return $othermapped;
+    }
+}

mod/quiz/classes/event/page_break_deleted.php

@@ -0,0 +1,94 @@
+<?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/>.
+
+/**
+ * The mod_quiz page break deleted event.
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace mod_quiz\event;
+
+/**
+ * The mod_quiz page break deleted event class.
+ *
+ * @property-read array $other {
+ *      Extra information about event.
+ *
+ *      - int quizid: the id of the quiz.
+ *      - int slotnumber: the slot number which we will remove the page break before.
+ * }
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class page_break_deleted extends \core\event\base {
+    protected function init() {
+        $this->data['objecttable'] = 'quiz_slots';
+        $this->data['crud'] = 'u';
+        $this->data['edulevel'] = self::LEVEL_PARTICIPATING;
+    }
+
+    public static function get_name() {
+        return get_string('eventpagebreakdeleted', 'mod_quiz');
+    }
+
+    public function get_description() {
+        return "The user with id '$this->userid' deleted the page break before the slot with id '{$this->objectid}' " .
+            "and slot number '{$this->other['slotnumber']}' " .
+            "belonging to the quiz with course module id '$this->contextinstanceid'.";
+    }
+
+    public function get_url() {
+        return new \moodle_url('/mod/quiz/edit.php', [
+            'cmid' => $this->contextinstanceid
+        ]);
+    }
+
+    protected function validate_data() {
+        parent::validate_data();
+
+        if (!isset($this->objectid)) {
+            throw new \coding_exception('The \'objectid\' value must be set.');
+        }
+
+        if (!isset($this->contextinstanceid)) {
+            throw new \coding_exception('The \'contextinstanceid\' value must be set.');
+        }
+
+        if (!isset($this->other['quizid'])) {
+            throw new \coding_exception('The \'quizid\' value must be set in other.');
+        }
+
+        if (!isset($this->other['slotnumber'])) {
+            throw new \coding_exception('The \'slotnumber\' value must be set in other.');
+        }
+    }
+
+    public static function get_objectid_mapping() {
+        return ['db' => 'quiz_slots', 'restore' => 'quiz_question_instance'];
+    }
+
+    public static function get_other_mapping() {
+        $othermapped = [];
+        $othermapped['quizid'] = ['db' => 'quiz', 'restore' => 'quiz'];
+
+        return $othermapped;
+    }
+}

mod/quiz/classes/event/quiz_grade_updated.php

@@ -0,0 +1,91 @@
+<?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/>.
+
+/**
+ * The mod_quiz quiz grade updated event.
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace mod_quiz\event;
+
+/**
+ * The mod_quiz quiz grade updated event class.
+ *
+ * @property-read array $other {
+ *      Extra information about event.
+ *
+ *      - int newgrade: the new maximum grade value.
+ *      - int oldgrade: the old maximum grade value.
+ * }
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class quiz_grade_updated extends \core\event\base {
+    protected function init() {
+        $this->data['objecttable'] = 'quiz';
+        $this->data['crud'] = 'u';
+        $this->data['edulevel'] = self::LEVEL_PARTICIPATING;
+    }
+
+    public static function get_name() {
+        return get_string('eventquizgradeupdated', 'mod_quiz');
+    }
+
+    public function get_description() {
+        return "The user with id '$this->userid' updated the maximum grade for the quiz with " .
+            "course module id '$this->contextinstanceid'. " .
+            "The maximum grade was changed from '{$this->other['oldgrade']}' to '{$this->other['newgrade']}'.";
+    }
+
+    public function get_url() {
+        return new \moodle_url('/mod/quiz/edit.php', [
+            'cmid' => $this->contextinstanceid
+        ]);
+    }
+
+    protected function validate_data() {
+        parent::validate_data();
+
+        if (!isset($this->objectid)) {
+            throw new \coding_exception('The \'objectid\' value must be set.');
+        }
+
+        if (!isset($this->contextinstanceid)) {
+            throw new \coding_exception('The \'contextinstanceid\' value must be set.');
+        }
+
+        if (!isset($this->other['oldgrade'])) {
+            throw new \coding_exception('The \'oldgrade\' value must be set in other.');
+        }
+
+        if (!isset($this->other['newgrade'])) {
+            throw new \coding_exception('The \'newgrade\' value must be set in other.');
+        }
+    }
+
+    public static function get_objectid_mapping() {
+        return ['db' => 'quiz', 'restore' => 'quiz'];
+    }
+
+    public static function get_other_mapping() {
+        return [];
+    }
+}

mod/quiz/classes/event/quiz_repaginated.php

@@ -0,0 +1,85 @@
+<?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/>.
+
+/**
+ * The mod_quiz quiz re-paginated event.
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+namespace mod_quiz\event;
+
+/**
+ * The mod_quiz quiz re-paginated event class.
+ *
+ * @property-read array $other {
+ *      Extra information about event.
+ *
+ *      - int slotsperpage: the slot number per page option.
+ * }
+ *
+ * @package    mod_quiz
+ * @copyright  2021 The Open University
+ * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class quiz_repaginated extends \core\event\base {
+    protected function init() {
+        $this->data['objecttable'] = 'quiz';
+        $this->data['crud'] = 'u';
+        $this->data['edulevel'] = self::LEVEL_PARTICIPATING;
+    }
+
+    public static function get_name() {
+        return get_string('eventquizrepaginated', 'mod_quiz');
+    }
+
+    public function get_description() {
+        return "The user with id '$this->userid' re-paginated the quiz with course module id '$this->contextinstanceid' " .
+            " with the new option '{$this->other['slotsperpage']}' slot(s) per page.";
+    }
+
+    public function get_url() {
+        return new \moodle_url('/mod/quiz/edit.php', [
+            'cmid' => $this->contextinstanceid
+        ]);
+    }
+
+    protected function validate_data() {
+        parent::validate_data();
+
+        if (!isset($this->objectid)) {
+            throw new \coding_exception('The \'objectid\' value must be set.');
+        }
+
+        if (!isset($this->contextinstanceid)) {
+            throw new \coding_exception('The \'contextinstanceid\' value must be set.');
+        }
+
+        if (!isset($this->other['slotsperpage'])) {
+            throw new \coding_exception('The \'slotsperpage\' value must be set in other.');
+        }
+    }
+
+    public static function get_objectid_mapping() {
+        return ['db' => 'quiz', 'restore' => 'quiz'];
+    }
+
+    public static function get_other_mapping() {
+        return [];
+    }
+}