question/type/essay/question.php

   1 <?php
   2
   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
  18 /**
  19  * Essay question definition class.
  20  *
  21  * @package    qtype
  22  * @subpackage essay
  23  * @copyright  2009 The Open University
  24  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  25  */
  26
  27
  28 defined('MOODLE_INTERNAL') || die();
  29
  30
  31 /**
  32  * Represents an essay question.
  33  *
  34  * @copyright  2009 The Open University
  35  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  36  */
  37 class qtype_essay_question extends question_with_responses {
  38     public $responseformat;
  39     public $responsefieldlines;
  40     public $attachments;
  41     public $graderinfo;
  42     public $graderinfoformat;
  43
  44     public function make_behaviour(question_attempt $qa, $preferredbehaviour) {
  45         question_engine::load_behaviour_class('manualgraded');
  46         return new qbehaviour_manualgraded($qa, $preferredbehaviour);
  47     }
  48
  49     /**
  50      * @param moodle_page the page we are outputting to.
  51      * @return qtype_essay_format_renderer_base the response-format-specific renderer.
  52      */
  53     public function get_format_renderer(moodle_page $page) {
  54         return $page->get_renderer('qtype_essay', 'format_' . $this->responseformat);
  55     }
  56
  57     public function get_expected_data() {
  58         return array('answer' => PARAM_CLEANHTML);
  59     }
  60
  61     public function summarise_response(array $response) {
  62         if (isset($response['answer'])) {
  63             $formatoptions = new stdClass();
  64             $formatoptions->para = false;
  65             return shorten_text(html_to_text(format_text($response['answer'], FORMAT_HTML, $formatoptions), 0, false), 200);
  66         } else {
  67             return null;
  68         }
  69     }
  70
  71     public function get_correct_response() {
  72         return null;
  73     }
  74
  75     public function is_complete_response(array $response) {
  76         return !empty($response['answer']);
  77     }
  78
  79     public function is_same_response(array $prevresponse, array $newresponse) {
  80         return question_utils::arrays_same_at_key_missing_is_blank(
  81                 $prevresponse, $newresponse, 'answer');
  82     }
  83 }