AutorÃa | Ultima modificación | Ver Log |
<?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/>.
namespace mod_questionnaire\question;
use \html_writer;
use mod_questionnaire\question\choice;
use mod_questionnaire\responsetype\response\response;
/**
* This file contains the parent class for drop question types.
*
* @author Mike Churchward
* @copyright 2016 onward Mike Churchward (mike.churchward@poetopensource.org)
* @license http://www.gnu.org/copyleft/gpl.html GNU Public License
* @package mod_questionnaire
*/
class drop extends question {
/**
* Each question type must define its response class.
* @return string The response object based off of questionnaire_response_base.
*/
protected function responseclass() {
return '\\mod_questionnaire\\responsetype\\single';
}
/**
* Short name for this question type - no spaces, etc..
* @return string
*/
public function helpname() {
return 'dropdown';
}
/**
* Return true if the question has choices.
*/
public function has_choices() {
return true;
}
/**
* Override and return a form template if provided. Output of question_survey_display is iterpreted based on this.
* @return string
*/
public function question_template() {
return 'mod_questionnaire/question_drop';
}
/**
* Override and return a form template if provided. Output of response_survey_display is iterpreted based on this.
* @return string
*/
public function response_template() {
return 'mod_questionnaire/response_drop';
}
/**
* Override this and return true if the question type allows dependent questions.
* @return bool
*/
public function allows_dependents() {
return true;
}
/**
* True if question type supports feedback options. False by default.
* @return bool
*/
public function supports_feedback() {
return true;
}
/**
* Return the context tags for the check question template.
* @param \mod_questionnaire\responsetype\response\response $response
* @param array $dependants Array of all questions/choices depending on this question.
* @param boolean $blankquestionnaire
* @return object The check question context tags.
*
*/
protected function question_survey_display($response, $dependants, $blankquestionnaire=false) {
// Drop.
$options = [];
$choicetags = new \stdClass();
$choicetags->qelements = new \stdClass();
$options[] = (object)['value' => '', 'label' => get_string('choosedots')];
foreach ($this->choices as $key => $choice) {
if ($pos = strpos($choice->content, '=')) {
$choice->content = substr($choice->content, $pos + 1);
}
$option = new \stdClass();
$option->value = $key;
$option->label = format_string($choice->content);
if (isset($response->answers[$this->id][$key])) {
$option->selected = true;
}
$options[] = $option;
}
$chobj = new \stdClass();
$chobj->name = 'q'.$this->id;
$chobj->id = self::qtypename($this->type_id) . $this->name;
$chobj->class = 'select custom-select menu q'.$this->id;
$chobj->options = $options;
$choicetags->qelements->choice = $chobj;
return $choicetags;
}
/**
* Return the context tags for the drop response template.
* @param \mod_questionnaire\responsetype\response\response $response
* @return \stdClass The check question response context tags.
*/
protected function response_survey_display($response) {
static $uniquetag = 0; // To make sure all radios have unique names.
$resptags = new \stdClass();
$resptags->name = 'q' . $this->id.$uniquetag++;
$resptags->id = 'menu' . $resptags->name;
$resptags->class = 'select custom-select ' . $resptags->id;
$resptags->options = [];
$resptags->options[] = (object)['value' => '', 'label' => get_string('choosedots')];
if (!isset($response->answers[$this->id])) {
$response->answers[$this->id][] = new \mod_questionnaire\responsetype\answer\answer();
}
foreach ($this->choices as $id => $choice) {
$contents = questionnaire_choice_values($choice->content);
$chobj = new \stdClass();
$chobj->value = $id;
$chobj->label = format_text($contents->text, FORMAT_HTML, ['noclean' => true]);
if (isset($response->answers[$this->id][$id])) {
$chobj->selected = 1;
$resptags->selectedlabel = $chobj->label;
}
$resptags->options[] = $chobj;
}
return $resptags;
}
/**
* Return the length form element.
* @param \MoodleQuickForm $mform
* @param string $helpname
*/
protected function form_length(\MoodleQuickForm $mform, $helpname = '') {
return question::form_length_hidden($mform);
}
/**
* Return the precision form element.
* @param \MoodleQuickForm $mform
* @param string $helpname
*/
protected function form_precise(\MoodleQuickForm $mform, $helpname = '') {
return question::form_precise_hidden($mform);
}
/**
* True if question provides mobile support.
* @return bool
*/
public function supports_mobile() {
return true;
}
/**
* Return the mobile question display.
* @param int $qnum
* @param bool $autonum
* @return \stdClass
*/
public function mobile_question_display($qnum, $autonum = false) {
$mobiledata = parent::mobile_question_display($qnum, $autonum);
$mobiledata->isselect = true;
return $mobiledata;
}
/**
* Return the mobile response data.
* @param response $response
* @return array
*/
public function get_mobile_response_data($response) {
$resultdata = [];
if (isset($response->answers[$this->id])) {
foreach ($response->answers[$this->id] as $answer) {
// Add a fieldkey for each choice.
$resultdata[$this->mobile_fieldkey()] = $answer->choiceid;
}
}
return $resultdata;
}
}