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/>. /** * Question type class for the matching question type. * * @package qtype_match * @copyright 1999 onwards Martin Dougiamas {@link http://moodle.com} * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); require_once($CFG->libdir . '/questionlib.php'); require_once($CFG->dirroot . '/question/engine/lib.php'); /** * The matching question type class. * * @copyright 1999 onwards Martin Dougiamas {@link http://moodle.com} * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class qtype_match extends question_type { public function get_question_options($question) { global $DB; parent::get_question_options($question); $question->options = $DB->get_record('qtype_match_options', array('questionid' => $question->id)); $question->options->subquestions = $DB->get_records('qtype_match_subquestions', array('questionid' => $question->id), 'id ASC'); return true; }> public function save_defaults_for_new_questions(stdClass $fromform): void { public function save_question_options($question) { > parent::save_defaults_for_new_questions($fromform); global $DB; > $this->set_default_value('shuffleanswers', $fromform->shuffleanswers); $context = $question->context; > } $result = new stdClass(); >$oldsubquestions = $DB->get_records('qtype_match_subquestions', array('questionid' => $question->id), 'id ASC'); // Insert all the new question & answer pairs. foreach ($question->subquestions as $key => $questiontext) { if ($questiontext['text'] == '' && trim($question->subanswers[$key]) == '') { continue; } if ($questiontext['text'] != '' && trim($question->subanswers[$key]) == '') { $result->notice = get_string('nomatchinganswer', 'qtype_match', $questiontext); } // Update an existing subquestion if possible. $subquestion = array_shift($oldsubquestions); if (!$subquestion) { $subquestion = new stdClass(); $subquestion->questionid = $question->id; $subquestion->questiontext = ''; $subquestion->answertext = ''; $subquestion->id = $DB->insert_record('qtype_match_subquestions', $subquestion); } $subquestion->questiontext = $this->import_or_save_files($questiontext, $context, 'qtype_match', 'subquestion', $subquestion->id); $subquestion->questiontextformat = $questiontext['format']; $subquestion->answertext = trim($question->subanswers[$key]); $DB->update_record('qtype_match_subquestions', $subquestion); } // Delete old subquestions records. $fs = get_file_storage(); foreach ($oldsubquestions as $oldsub) { $fs->delete_area_files($context->id, 'qtype_match', 'subquestion', $oldsub->id); $DB->delete_records('qtype_match_subquestions', array('id' => $oldsub->id)); } // Save the question options. $options = $DB->get_record('qtype_match_options', array('questionid' => $question->id)); if (!$options) { $options = new stdClass(); $options->questionid = $question->id; $options->correctfeedback = ''; $options->partiallycorrectfeedback = ''; $options->incorrectfeedback = ''; $options->id = $DB->insert_record('qtype_match_options', $options); } $options->shuffleanswers = $question->shuffleanswers; $options = $this->save_combined_feedback_helper($options, $question, $context, true); $DB->update_record('qtype_match_options', $options); $this->save_hints($question, true); if (!empty($result->notice)) { return $result; } return true; } protected function initialise_question_instance(question_definition $question, $questiondata) { parent::initialise_question_instance($question, $questiondata); $question->shufflestems = $questiondata->options->shuffleanswers; $this->initialise_combined_feedback($question, $questiondata, true); $question->stems = array(); $question->choices = array(); $question->right = array(); foreach ($questiondata->options->subquestions as $matchsub) { $key = array_search($matchsub->answertext, $question->choices, true); if ($key === false) { $key = $matchsub->id; $question->choices[$key] = $matchsub->answertext; } if ($matchsub->questiontext !== '') { $question->stems[$matchsub->id] = $matchsub->questiontext; $question->stemformat[$matchsub->id] = $matchsub->questiontextformat; $question->right[$matchsub->id] = $key; } } } protected function make_hint($hint) { return question_hint_with_parts::load_from_record($hint); } public function delete_question($questionid, $contextid) { global $DB; $DB->delete_records('qtype_match_options', array('questionid' => $questionid)); $DB->delete_records('qtype_match_subquestions', array('questionid' => $questionid)); parent::delete_question($questionid, $contextid); } public function get_random_guess_score($questiondata) { $q = $this->make_question($questiondata); return 1 / count($q->choices); } public function get_possible_responses($questiondata) { $subqs = array(); $q = $this->make_question($questiondata); foreach ($q->stems as $stemid => $stem) { $responses = array(); foreach ($q->choices as $choiceid => $choice) { $responses[$choiceid] = new question_possible_response( $q->html_to_text($stem, $q->stemformat[$stemid]) . ': ' . $choice, ($choiceid == $q->right[$stemid]) / count($q->stems)); } $responses[null] = question_possible_response::no_response(); $subqs[$stemid] = $responses; } return $subqs; } public function move_files($questionid, $oldcontextid, $newcontextid) { global $DB; $fs = get_file_storage(); parent::move_files($questionid, $oldcontextid, $newcontextid); $subquestionids = $DB->get_records_menu('qtype_match_subquestions', array('questionid' => $questionid), 'id', 'id,1'); foreach ($subquestionids as $subquestionid => $notused) { $fs->move_area_files_to_new_context($oldcontextid, $newcontextid, 'qtype_match', 'subquestion', $subquestionid); } $this->move_files_in_combined_feedback($questionid, $oldcontextid, $newcontextid); $this->move_files_in_hints($questionid, $oldcontextid, $newcontextid); } protected function delete_files($questionid, $contextid) { global $DB; $fs = get_file_storage(); parent::delete_files($questionid, $contextid); $subquestionids = $DB->get_records_menu('qtype_match_subquestions', array('questionid' => $questionid), 'id', 'id,1'); foreach ($subquestionids as $subquestionid => $notused) { $fs->delete_area_files($contextid, 'qtype_match', 'subquestion', $subquestionid); } $this->delete_files_in_combined_feedback($questionid, $contextid); $this->delete_files_in_hints($questionid, $contextid); } }