Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 4.3.x will end 7 October 2024 (12 months).
  • Bug fixes for security issues in 4.3.x will end 21 April 2025 (18 months).
  • PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.2.x is supported too.
<?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/>.

/**
 * Provides support for the conversion of moodle1 backup to the moodle2 format
 * Based off of a template @ http://docs.moodle.org/dev/Backup_1.9_conversion_for_developers
 *
 * @package    mod_quiz
 * @copyright  2011 Aparup Banerjee <aparup@moodle.com>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

/**
 * Quiz conversion handler
 */
class moodle1_mod_quiz_handler extends moodle1_mod_handler {

    /** @var moodle1_file_manager */
    protected $fileman = null;

    /** @var int cmid */
    protected $moduleid = null;

    /**
     * Declare the paths in moodle.xml we are able to convert
     *
     * The method returns list of {@link convert_path} instances.
     * For each path returned, the corresponding conversion method must be
     * defined.
     *
     * Note that the path /MOODLE_BACKUP/COURSE/MODULES/MOD/QUIZ does not
     * actually exist in the file. The last element with the module name was
     * appended by the moodle1_converter class.
     *
     * @return array of {@link convert_path} instances
     */
    public function get_paths() {
< return array(
> return [
new convert_path( 'quiz', '/MOODLE_BACKUP/COURSE/MODULES/MOD/QUIZ',
< array( < 'newfields' => array(
> [ > 'newfields' => [
'showuserpicture' => 0, 'questiondecimalpoints' => -1, 'introformat' => 0, 'showblocks' => 0,
< ), < )
> ], > ]
), new convert_path('quiz_question_instances', '/MOODLE_BACKUP/COURSE/MODULES/MOD/QUIZ/QUESTION_INSTANCES'), new convert_path('quiz_question_instance', '/MOODLE_BACKUP/COURSE/MODULES/MOD/QUIZ/QUESTION_INSTANCES/QUESTION_INSTANCE',
< array( < 'renamefields' => array(
> [ > 'renamefields' => [
'question' => 'questionid', 'grade' => 'maxmark',
< ), < )
> ], > ]
), new convert_path('quiz_feedbacks', '/MOODLE_BACKUP/COURSE/MODULES/MOD/QUIZ/FEEDBACKS'), new convert_path('quiz_feedback', '/MOODLE_BACKUP/COURSE/MODULES/MOD/QUIZ/FEEDBACKS/FEEDBACK',
< array( < 'newfields' => array(
> [ > 'newfields' => [
'feedbacktextformat' => FORMAT_HTML,
> ] ) > ]
< ) < ) < );
> ];
} /** * This is executed every time we have one /MOODLE_BACKUP/COURSE/MODULES/MOD/QUIZ * data available */ public function process_quiz($data) { global $CFG; // Replay the upgrade step 2008081501. if (is_null($data['sumgrades'])) { $data['sumgrades'] = 0; // TODO for user data: quiz_attempts SET sumgrades=0 WHERE sumgrades IS NULL. // TODO for user data: quiz_grades.grade should be not be null , convert to default 0. } // Replay the upgrade step 2009042000. if ($CFG->texteditors !== 'textarea') { $data['intro'] = text_to_html($data['intro'], false, false, true); $data['introformat'] = FORMAT_HTML; } // Replay the upgrade step 2009031001. $data['timelimit'] *= 60; // Get the course module id and context id. $instanceid = $data['id']; $cminfo = $this->get_cminfo($instanceid); $this->moduleid = $cminfo['id']; $contextid = $this->converter->get_contextid(CONTEXT_MODULE, $this->moduleid); // Get a fresh new file manager for this instance. $this->fileman = $this->converter->get_file_manager($contextid, 'mod_quiz'); // Convert course files embedded into the intro. $this->fileman->filearea = 'intro'; $this->fileman->itemid = 0; $data['intro'] = moodle1_converter::migrate_referenced_files( $data['intro'], $this->fileman); // Start writing quiz.xml. $this->open_xml_writer("activities/quiz_{$this->moduleid}/quiz.xml");
< $this->xmlwriter->begin_tag('activity', array('id' => $instanceid,
> $this->xmlwriter->begin_tag('activity', ['id' => $instanceid,
'moduleid' => $this->moduleid, 'modulename' => 'quiz',
< 'contextid' => $contextid)); < $this->xmlwriter->begin_tag('quiz', array('id' => $instanceid));
> 'contextid' => $contextid]); > $this->xmlwriter->begin_tag('quiz', ['id' => $instanceid]);
foreach ($data as $field => $value) { if ($field <> 'id') { $this->xmlwriter->full_tag($field, $value); } } return $data; } public function on_quiz_question_instances_start() { $this->xmlwriter->begin_tag('question_instances'); } public function on_quiz_question_instances_end() { $this->xmlwriter->end_tag('question_instances'); } public function process_quiz_question_instance($data) {
< $this->write_xml('question_instance', $data, array('/question_instance/id'));
> $this->write_xml('question_instance', $data, ['/question_instance/id']);
} public function on_quiz_feedbacks_start() { $this->xmlwriter->begin_tag('feedbacks'); } public function on_quiz_feedbacks_end() { $this->xmlwriter->end_tag('feedbacks'); } public function process_quiz_feedback($data) { // Replay the upgrade step 2010122302. if (is_null($data['mingrade'])) { $data['mingrade'] = 0; } if (is_null($data['maxgrade'])) { $data['maxgrade'] = 0; }
< $this->write_xml('feedback', $data, array('/feedback/id'));
> $this->write_xml('feedback', $data, ['/feedback/id']);
} /** * This is executed when we reach the closing </MOD> tag of our 'quiz' path */ public function on_quiz_end() { // Append empty <overrides> subpath element.
< $this->write_xml('overrides', array());
> $this->write_xml('overrides', []);
// Finish writing quiz.xml. $this->xmlwriter->end_tag('quiz'); $this->xmlwriter->end_tag('activity'); $this->close_xml_writer(); // Write inforef.xml. $this->open_xml_writer("activities/quiz_{$this->moduleid}/inforef.xml"); $this->xmlwriter->begin_tag('inforef'); $this->xmlwriter->begin_tag('fileref'); foreach ($this->fileman->get_fileids() as $fileid) {
< $this->write_xml('file', array('id' => $fileid));
> $this->write_xml('file', ['id' => $fileid]);
} $this->xmlwriter->end_tag('fileref'); $this->xmlwriter->end_tag('inforef'); $this->close_xml_writer(); } }