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/>. /** * Test helpers for the essay question type. * * @package qtype_essay * @copyright 2013 The Open University * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); /** * Test helper class for the essay question type. * * @copyright 2013 The Open University * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ class qtype_essay_test_helper extends question_test_helper { public function get_test_questions() { return array('editor', 'editorfilepicker', 'plain', 'monospaced', 'responsetemplate', 'noinline'); } /** * Helper method to reduce duplication. * @return qtype_essay_question */ protected function initialise_essay_question() { question_bank::load_question_definition_classes('essay'); $q = new qtype_essay_question(); test_question_maker::initialise_a_question($q); $q->name = 'Essay question (HTML editor)'; $q->questiontext = 'Please write a story about a frog.'; $q->generalfeedback = 'I hope your story had a beginning, a middle and an end.'; $q->responseformat = 'editor'; $q->responserequired = 1; $q->responsefieldlines = 10;> $q->minwordlimit = null; $q->attachments = 0; > $q->maxwordlimit = null;$q->attachmentsrequired = 0;> $q->maxbytes = 0;$q->filetypeslist = null; $q->graderinfo = ''; $q->graderinfoformat = FORMAT_HTML; $q->qtype = question_bank::get_qtype('essay'); return $q; } /** * Makes an essay question using the HTML editor as input. * @return qtype_essay_question */ public function make_essay_question_editor() { return $this->initialise_essay_question(); } /** * Make the data what would be received from the editing form for an essay * question using the HTML editor allowing embedded files as input, and up * to three attachments. * * @return stdClass the data that would be returned by $form->get_gata(); */ public function get_essay_question_form_data_editor() { $fromform = new stdClass(); $fromform->name = 'Essay question (HTML editor)'; $fromform->questiontext = array('text' => 'Please write a story about a frog.', 'format' => FORMAT_HTML); $fromform->defaultmark = 1.0; $fromform->generalfeedback = array('text' => 'I hope your story had a beginning, a middle and an end.', 'format' => FORMAT_HTML); $fromform->responseformat = 'editor'; $fromform->responserequired = 1; $fromform->responsefieldlines = 10; $fromform->attachments = 0; $fromform->attachmentsrequired = 0;< $fromform->filetypeslist = '';> $fromform->maxbytes = 0; > $fromform->filetypeslist = ''; // Although once saved in the DB, this becomes null, the form returns '' here.$fromform->graderinfo = array('text' => '', 'format' => FORMAT_HTML); $fromform->responsetemplate = array('text' => '', 'format' => FORMAT_HTML);> $fromform->status = \core_question\local\bank\question_version_status::QUESTION_STATUS_READY;return $fromform; } /** * Makes an essay question using the HTML editor allowing embedded files as * input, and up to three attachments. * @return qtype_essay_question */ public function make_essay_question_editorfilepicker() { $q = $this->initialise_essay_question(); $q->responseformat = 'editorfilepicker'; $q->attachments = 3; return $q; } /** * Makes an essay question using the HTML editor allowing embedded files as * input, and up to two attachments, two needed. * @return qtype_essay_question */ public function make_essay_question_editorfilepickertworequired() { $q = $this->initialise_essay_question(); $q->responseformat = 'editorfilepicker'; $q->attachments = 2; $q->attachmentsrequired = 2; return $q; } /** * Make the data what would be received from the editing form for an essay * question using the HTML editor allowing embedded files as input, and up * to three attachments. * * @return stdClass the data that would be returned by $form->get_gata(); */ public function get_essay_question_form_data_editorfilepicker() { $fromform = new stdClass(); $fromform->name = 'Essay question with filepicker and attachments'; $fromform->questiontext = array('text' => 'Please write a story about a frog.', 'format' => FORMAT_HTML); $fromform->defaultmark = 1.0; $fromform->generalfeedback = array('text' => 'I hope your story had a beginning, a middle and an end.', 'format' => FORMAT_HTML); $fromform->responseformat = 'editorfilepicker'; $fromform->responserequired = 1; $fromform->responsefieldlines = 10; $fromform->attachments = 3; $fromform->attachmentsrequired = 0;< $fromform->filetypeslist = '';> $fromform->maxbytes = 0; > $fromform->filetypeslist = ''; // Although once saved in the DB, this becomes null, the form returns '' here.$fromform->graderinfo = array('text' => '', 'format' => FORMAT_HTML); $fromform->responsetemplate = array('text' => '', 'format' => FORMAT_HTML);> $fromform->status = \core_question\local\bank\question_version_status::QUESTION_STATUS_READY;return $fromform; } /** * Makes an essay question using plain text input. * @return qtype_essay_question */ public function make_essay_question_plain() { $q = $this->initialise_essay_question(); $q->responseformat = 'plain'; return $q; } /** * Make the data what would be received from the editing form for an essay * question using the HTML editor allowing embedded files as input, and up * to three attachments. * * @return stdClass the data that would be returned by $form->get_gata(); */ public function get_essay_question_form_data_plain() { $fromform = new stdClass(); $fromform->name = 'Essay question with filepicker and attachments'; $fromform->questiontext = array('text' => 'Please write a story about a frog.', 'format' => FORMAT_HTML); $fromform->defaultmark = 1.0; $fromform->generalfeedback = array('text' => 'I hope your story had a beginning, a middle and an end.', 'format' => FORMAT_HTML); $fromform->responseformat = 'plain'; $fromform->responserequired = 1; $fromform->responsefieldlines = 10; $fromform->attachments = 0; $fromform->attachmentsrequired = 0;< $fromform->filetypeslist = '';> $fromform->maxbytes = 0; > $fromform->filetypeslist = ''; // Although once saved in the DB, this becomes null, the form returns '' here.$fromform->graderinfo = array('text' => '', 'format' => FORMAT_HTML); $fromform->responsetemplate = array('text' => '', 'format' => FORMAT_HTML);> $fromform->status = \core_question\local\bank\question_version_status::QUESTION_STATUS_READY;return $fromform; } /** * Makes an essay question using monospaced input. * @return qtype_essay_question */ public function make_essay_question_monospaced() { $q = $this->initialise_essay_question(); $q->responseformat = 'monospaced'; return $q; } public function make_essay_question_responsetemplate() { $q = $this->initialise_essay_question(); $q->responsetemplate = 'Once upon a time'; $q->responsetemplateformat = FORMAT_HTML; return $q; } /** * Makes an essay question without an online text editor. * @return qtype_essay_question */ public function make_essay_question_noinline() { $q = $this->initialise_essay_question(); $q->responseformat = 'noinline'; $q->attachments = 3; $q->attachmentsrequired = 1; $q->filetypeslist = '';> $q->maxbytes = 0;return $q; } /** * Creates an empty draft area for attachments. * @return int The draft area's itemid. */ protected function make_attachment_draft_area() { $draftid = 0; $contextid = 0; $component = 'question'; $filearea = 'response_attachments'; // Create an empty file area. file_prepare_draft_area($draftid, $contextid, $component, $filearea, null); return $draftid; } /** * Creates an attachment in the provided attachment draft area. * @param int $draftid The itemid for the draft area in which the file should be created. * @param string $name The filename for the file to be created. * @param string $contents The contents of the file to be created. */ protected function make_attachment($draftid, $name, $contents) { global $USER; $fs = get_file_storage(); $usercontext = context_user::instance($USER->id); // Create the file in the provided draft area. $fileinfo = array( 'contextid' => $usercontext->id, 'component' => 'user', 'filearea' => 'draft', 'itemid' => $draftid, 'filepath' => '/', 'filename' => $name, ); $fs->create_file_from_string($fileinfo, $contents); } /** * Generates a draft file area that contains the provided number of attachments. You should ensure * that a user is logged in with setUser before you run this function. * * @param int $attachments The number of attachments to generate. * @return int The itemid of the generated draft file area. */ public function make_attachments($attachments) { $draftid = $this->make_attachment_draft_area(); // Create the relevant amount of dummy attachments in the given draft area. for ($i = 0; $i < $attachments; ++$i) { $this->make_attachment($draftid, $i, $i); } return $draftid; } /** * Generates a question_file_saver that contains the provided number of attachments. You should ensure * that a user is logged in with setUser before you run this function. * * @param int $:attachments The number of attachments to generate. * @return question_file_saver a question_file_saver that contains the given amount of dummy files, for use in testing. */ public function make_attachments_saver($attachments) { return new question_file_saver($this->make_attachments($attachments), 'question', 'response_attachments'); } }