MDL-27394 Moodle 2.0 backup and restore may randomise the order of multichoice/numeri...
[moodle.git] / question / type / essay / questiontype.php
CommitLineData
aeb15530 1<?php
516cf3eb 2
fe6ce234
DC
3// This file is part of Moodle - http://moodle.org/
4//
5// Moodle is free software: you can redistribute it and/or modify
6// it under the terms of the GNU General Public License as published by
7// the Free Software Foundation, either version 3 of the License, or
8// (at your option) any later version.
9//
10// Moodle is distributed in the hope that it will be useful,
11// but WITHOUT ANY WARRANTY; without even the implied warranty of
12// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13// GNU General Public License for more details.
14//
15// You should have received a copy of the GNU General Public License
16// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
17
1976496e 18/**
6d03299d
TH
19 * Question type class for the essay question type.
20 *
d3603157 21 * @package qtype
6d03299d 22 * @subpackage essay
d3603157
TH
23 * @copyright 2005 Mark Nielsen
24 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
7375c542 25 */
516cf3eb 26
516cf3eb 27
a17b297d
TH
28defined('MOODLE_INTERNAL') || die();
29
30
6d03299d
TH
31/**
32 * The essay question type.
33 *
d3603157
TH
34 * @copyright 2005 Mark Nielsen
35 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
6d03299d
TH
36 */
37class qtype_essay extends question_type {
38 public function is_manual_graded() {
516cf3eb 39 return true;
40 }
fb6179a1 41
6b5f24d3
TH
42 public function response_file_areas() {
43 return array('attachments', 'answers');
44 }
45
894e8b4e
TH
46 public function get_question_options($question) {
47 global $DB;
121fd4c1
TH
48 $question->options = $DB->get_record('qtype_essay_options',
49 array('questionid' => $question->id), '*', MUST_EXIST);
894e8b4e
TH
50 parent::get_question_options($question);
51 }
52
53 public function save_question_options($formdata) {
54 global $DB;
55 $context = $formdata->context;
56
57 $options = $DB->get_record('qtype_essay_options', array('questionid' => $formdata->id));
58 if (!$options) {
59 $options = new stdClass();
b36d2d06 60 $options->questionid = $formdata->id;
894e8b4e
TH
61 $options->id = $DB->insert_record('qtype_essay_options', $options);
62 }
63
64 $options->responseformat = $formdata->responseformat;
65 $options->responsefieldlines = $formdata->responsefieldlines;
66 $options->attachments = $formdata->attachments;
67 $options->graderinfo = $this->import_or_save_files($formdata->graderinfo,
68 $context, 'qtype_essay', 'graderinfo', $formdata->id);
69 $options->graderinfoformat = $formdata->graderinfo['format'];
70 $DB->update_record('qtype_essay_options', $options);
71 }
72
73 protected function initialise_question_instance(question_definition $question, $questiondata) {
74 parent::initialise_question_instance($question, $questiondata);
75 $question->responseformat = $questiondata->options->responseformat;
76 $question->responsefieldlines = $questiondata->options->responsefieldlines;
77 $question->attachments = $questiondata->options->attachments;
78 $question->graderinfo = $questiondata->options->graderinfo;
79 $question->graderinfoformat = $questiondata->options->graderinfoformat;
80 }
81
82 /**
83 * @return array the different response formats that the question type supports.
84 * internal name => human-readable name.
85 */
b3ae5457 86 public function response_formats() {
894e8b4e
TH
87 return array(
88 'editor' => get_string('formateditor', 'qtype_essay'),
89 'editorfilepicker' => get_string('formateditorfilepicker', 'qtype_essay'),
90 'plain' => get_string('formatplain', 'qtype_essay'),
91 'monospaced' => get_string('formatmonospaced', 'qtype_essay'),
92 );
93 }
94
95 /**
96 * @return array the choices that should be offered for the input box size.
97 */
b3ae5457 98 public function response_sizes() {
894e8b4e
TH
99 $choices = array();
100 for ($lines = 5; $lines <= 40; $lines += 5) {
101 $choices[$lines] = get_string('nlines', 'qtype_essay', $lines);
102 }
103 return $choices;
104 }
105
106 /**
107 * @return array the choices that should be offered for the number of attachments.
108 */
109 public function attachment_options() {
110 return array(
111 0 => get_string('no'),
112 1 => '1',
113 2 => '2',
114 3 => '3',
115 -1 => get_string('unlimited'),
116 );
117 }
118
c7df5006 119 public function move_files($questionid, $oldcontextid, $newcontextid) {
5d548d3e
TH
120 parent::move_files($questionid, $oldcontextid, $newcontextid);
121 $this->move_files_in_answers($questionid, $oldcontextid, $newcontextid);
fe6ce234
DC
122 }
123
9203b705
TH
124 protected function delete_files($questionid, $contextid) {
125 parent::delete_files($questionid, $contextid);
126 $this->delete_files_in_answers($questionid, $contextid);
127 }
9fc3100f 128}