ILIAS  release_5-4 Revision v5.4.26-12-gabc799a52e6
class.assSingleChoiceGUI.php
Go to the documentation of this file.
1 <?php
2 /* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */
3 
4 require_once './Modules/TestQuestionPool/classes/class.assQuestionGUI.php';
5 require_once './Modules/TestQuestionPool/interfaces/interface.ilGuiQuestionScoringAdjustable.php';
6 require_once './Modules/TestQuestionPool/interfaces/interface.ilGuiAnswerScoringAdjustable.php';
7 require_once './Modules/Test/classes/inc.AssessmentConstants.php';
8 
24 {
32  public function __construct($id = -1)
33  {
34  parent::__construct();
35  include_once "./Modules/TestQuestionPool/classes/class.assSingleChoice.php";
36  $this->object = new assSingleChoice();
37  if ($id >= 0) {
38  $this->object->loadFromDb($id);
39  }
40  }
41 
45  public function hasInlineFeedback()
46  {
47  return $this->object->feedbackOBJ->isSpecificAnswerFeedbackAvailable($this->object->getId());
48  }
49 
53  protected function writePostData($always = false)
54  {
55  $hasErrors = (!$always) ? $this->editQuestion(true) : false;
56  if (!$hasErrors) {
57  require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
61  $this->saveTaxonomyAssignments();
62  return 0;
63  }
64  return 1;
65  }
66 
74  protected function getEditAnswersSingleLine($checkonly = false)
75  {
76  if ($checkonly) {
77  // form posting is checked
78  return ($_POST['types'] == 0) ? true : false;
79  }
80 
81  $lastChange = $this->object->getLastChange();
82  if (empty($lastChange) && !isset($_POST['types'])) {
83  // a new question is edited
84  return $this->object->getMultilineAnswerSetting() ? false : true;
85  } else {
86  // a saved question is edited
87  return $this->object->isSingleline;
88  }
89  }
90 
95  public function editQuestion($checkonly = false)
96  {
97  $save = $this->isSaveCommand();
98  $this->getQuestionTemplate();
99 
100  include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
101  $form = new ilPropertyFormGUI();
102  $this->editForm = $form;
103 
104  $form->setFormAction($this->ctrl->getFormAction($this));
105  $form->setTitle($this->outQuestionType());
106  $isSingleline = $this->getEditAnswersSingleLine($checkonly);
107  if ($isSingleline) {
108  $form->setMultipart(true);
109  } else {
110  $form->setMultipart(false);
111  }
112  $form->setTableWidth("100%");
113  $form->setId("asssinglechoice");
114 
118 
119 
121 
123 
124  $errors = false;
125 
126  if ($save) {
127  $form->setValuesByPost();
128  $errors = !$form->checkInput();
129  $form->setValuesByPost(); // again, because checkInput now performs the whole stripSlashes handling and we need this if we don't want to have duplication of backslashes
130  if ($errors) {
131  $checkonly = false;
132  }
133  }
134 
135  if (!$checkonly) {
136  $this->tpl->setVariable("QUESTION_DATA", $form->getHTML());
137  }
138  return $errors;
139  }
140 
144  public function uploadchoice()
145  {
146  $this->writePostData(true);
147  $position = key($_POST['cmd']['uploadchoice']);
148  $this->editQuestion();
149  }
150 
154  public function removeimagechoice()
155  {
156  $this->writePostData(true);
157  $position = key($_POST['cmd']['removeimagechoice']);
158  $filename = $_POST['choice']['imagename'][$position];
159  $this->object->removeAnswerImage($position);
160  $this->editQuestion();
161  }
162 
166  public function addchoice()
167  {
168  $this->writePostData(true);
169  $position = key($_POST['cmd']['addchoice']);
170  $this->object->addAnswer("", 0, $position + 1);
171  $this->editQuestion();
172  }
173 
177  public function removechoice()
178  {
179  $this->writePostData(true);
180  $position = key($_POST['cmd']['removechoice']);
181  $this->object->deleteAnswer($position);
182  $this->editQuestion();
183  }
184 
191  {
192  return true;
193  }
194 
208  public function getSolutionOutput(
209  $active_id,
210  $pass = null,
211  $graphicalOutput = false,
212  $result_output = false,
213  $show_question_only = true,
214  $show_feedback = false,
215  $show_correct_solution = false,
216  $show_manual_scoring = false,
217  $show_question_text = true
218  ) {
219  // shuffle output
220  $keys = $this->getChoiceKeys();
221 
222  // get the solution of the user for the active pass or from the last pass if allowed
223  $user_solution = "";
224  if (($active_id > 0) && (!$show_correct_solution)) {
225  $solutions = $this->object->getSolutionValues($active_id, $pass, !$this->getUseIntermediateSolution());
226  foreach ($solutions as $idx => $solution_value) {
227  $user_solution = $solution_value["value1"];
228  }
229  } else {
230  $found_index = -1;
231  $max_points = 0;
232  foreach ($this->object->answers as $index => $answer) {
233  if ($answer->getPoints() > $max_points) {
234  $max_points = $answer->getPoints();
235  $found_index = $index;
236  }
237  }
238  $user_solution = $found_index;
239  }
240  // generate the question output
241  include_once "./Services/UICore/classes/class.ilTemplate.php";
242  $template = new ilTemplate("tpl.il_as_qpl_mc_sr_output_solution.html", true, true, "Modules/TestQuestionPool");
243  $solutiontemplate = new ilTemplate("tpl.il_as_tst_solution_output.html", true, true, "Modules/TestQuestionPool");
244  foreach ($keys as $answer_id) {
245  $answer = $this->object->answers[$answer_id];
246  if (($active_id > 0) && (!$show_correct_solution)) {
247  if ($graphicalOutput) {
248  // output of ok/not ok icons for user entered solutions
249  $ok = false;
250  if (strcmp($user_solution, $answer_id) == 0) {
251  if ($answer->getPoints() == $this->object->getMaximumPoints()) {
252  $ok = true;
253  } else {
254  $ok = false;
255  }
256  if ($ok) {
257  $template->setCurrentBlock("icon_ok");
258  $template->setVariable("ICON_OK", ilUtil::getImagePath("icon_ok.svg"));
259  $template->setVariable("TEXT_OK", $this->lng->txt("answer_is_right"));
260  $template->parseCurrentBlock();
261  } else {
262  $template->setCurrentBlock("icon_not_ok");
263  if ($answer->getPoints() > 0) {
264  $template->setVariable("ICON_NOT_OK", ilUtil::getImagePath("icon_mostly_ok.svg"));
265  $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_not_correct_but_positive"));
266  } else {
267  $template->setVariable("ICON_NOT_OK", ilUtil::getImagePath("icon_not_ok.svg"));
268  $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_wrong"));
269  }
270  $template->parseCurrentBlock();
271  }
272  }
273  if (strlen($user_solution) == 0) {
274  $template->setCurrentBlock("icon_not_ok");
275  $template->setVariable("ICON_NOT_OK", ilUtil::getImagePath("icon_not_ok.svg"));
276  $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_wrong"));
277  $template->parseCurrentBlock();
278  }
279  }
280  }
281  if (strlen($answer->getImage())) {
282  $template->setCurrentBlock("answer_image");
283  if ($this->object->getThumbSize()) {
284  $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
285  } else {
286  $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
287  }
288  $alt = $answer->getImage();
289  if (strlen($answer->getAnswertext())) {
290  $alt = $answer->getAnswertext();
291  }
292  $alt = preg_replace("/<[^>]*?>/", "", $alt);
293  $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
294  $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
295  $template->parseCurrentBlock();
296  }
297  if ($show_feedback) {
298  $this->populateInlineFeedback($template, $answer_id, $user_solution);
299  }
300  $template->setCurrentBlock("answer_row");
301  $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), true));
302 
303  if ($this->renderPurposeSupportsFormHtml() || $this->isRenderPurposePrintPdf()) {
304  if (strcmp($user_solution, $answer_id) == 0) {
305  $template->setVariable("SOLUTION_IMAGE", ilUtil::getHtmlPath(ilUtil::getImagePath("radiobutton_checked.png")));
306  $template->setVariable("SOLUTION_ALT", $this->lng->txt("checked"));
307  } else {
308  $template->setVariable("SOLUTION_IMAGE", ilUtil::getHtmlPath(ilUtil::getImagePath("radiobutton_unchecked.png")));
309  $template->setVariable("SOLUTION_ALT", $this->lng->txt("unchecked"));
310  }
311  } else {
312  $template->setVariable('QID', $this->object->getId());
313  $template->setVariable('SUFFIX', $show_correct_solution ? 'bestsolution' : 'usersolution');
314  $template->setVariable('SOLUTION_VALUE', $answer_id);
315  if (strcmp($user_solution, $answer_id) == 0) {
316  $template->setVariable('SOLUTION_CHECKED', 'checked');
317  }
318  }
319 
320  if ($result_output) {
321  $points = $this->object->answers[$answer_id]->getPoints();
322  $resulttext = ($points == 1) ? "(%s " . $this->lng->txt("point") . ")" : "(%s " . $this->lng->txt("points") . ")";
323  $template->setVariable("RESULT_OUTPUT", sprintf($resulttext, $points));
324  }
325  $template->parseCurrentBlock();
326  }
327  $questiontext = $this->object->getQuestion();
328  if ($show_question_text == true) {
329  $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, true));
330  }
331  $questionoutput = $template->get();
332  $feedback = ($show_feedback && !$this->isTestPresentationContext()) ? $this->getAnswerFeedbackOutput($active_id, $pass) : "";
333  if (strlen($feedback)) {
334  $cssClass = (
335  $this->hasCorrectSolution($active_id, $pass) ?
337  );
338 
339  $solutiontemplate->setVariable("ILC_FB_CSS_CLASS", $cssClass);
340  $solutiontemplate->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($feedback, true));
341  }
342  $solutiontemplate->setVariable("SOLUTION_OUTPUT", $questionoutput);
343 
344  $solutionoutput = $solutiontemplate->get();
345 
346  if ($show_feedback && $this->hasInlineFeedback()) {
347  $solutionoutput = $this->buildFocusAnchorHtml() . $solutionoutput;
348  }
349 
350  if (!$show_question_only) {
351  // get page object output
352  $solutionoutput = $this->getILIASPage($solutionoutput);
353  }
354  return $solutionoutput;
355  }
356 
357  public function getPreview($show_question_only = false, $showInlineFeedback = false)
358  {
359  $keys = $this->getChoiceKeys();
360 
361  // generate the question output
362  include_once "./Services/UICore/classes/class.ilTemplate.php";
363  $template = new ilTemplate("tpl.il_as_qpl_mc_sr_output.html", true, true, "Modules/TestQuestionPool");
364  foreach ($keys as $answer_id) {
365  $answer = $this->object->answers[$answer_id];
366  if (strlen($answer->getImage())) {
367  if ($this->object->getThumbSize()) {
368  $template->setCurrentBlock("preview");
369  $template->setVariable("URL_PREVIEW", $this->object->getImagePathWeb() . $answer->getImage());
370  $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
371  $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
372  $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
373  list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
374  $alt = $answer->getImage();
375  if (strlen($answer->getAnswertext())) {
376  $alt = $answer->getAnswertext();
377  }
378  $alt = preg_replace("/<[^>]*?>/", "", $alt);
379  $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
380  $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
381  $template->parseCurrentBlock();
382  } else {
383  $template->setCurrentBlock("answer_image");
384  $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
385  list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
386  $alt = $answer->getImage();
387  if (strlen($answer->getAnswertext())) {
388  $alt = $answer->getAnswertext();
389  }
390  $alt = preg_replace("/<[^>]*?>/", "", $alt);
391  $template->setVariable("ATTR", $attr);
392  $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
393  $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
394  $template->parseCurrentBlock();
395  }
396  }
397  if ($showInlineFeedback && is_object($this->getPreviewSession())) {
398  $this->populateInlineFeedback($template, $answer_id, $this->getPreviewSession()->getParticipantsSolution());
399  }
400  $template->setCurrentBlock("answer_row");
401  $template->setVariable("QID", $this->object->getId() . 'ID');
402  $template->setVariable("ANSWER_ID", $answer_id);
403  $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), true));
404 
405  if (is_object($this->getPreviewSession())) {
406  $user_solution = $this->getPreviewSession()->getParticipantsSolution();
407  if (strcmp($user_solution, $answer_id) == 0) {
408  $template->setVariable("CHECKED_ANSWER", " checked=\"checked\"");
409  }
410  }
411 
412  $template->parseCurrentBlock();
413  }
414  $questiontext = $this->object->getQuestion();
415  $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, true));
416  $questionoutput = $template->get();
417  if (!$show_question_only) {
418  // get page object output
419  $questionoutput = $this->getILIASPage($questionoutput);
420  }
421  return $questionoutput;
422  }
423 
424  // hey: prevPassSolutions - pass will be always available from now on
425  public function getTestOutput($active_id, $pass, $is_postponed = false, $use_post_solutions = false, $show_feedback = false)
426  // hey.
427  {
428  $keys = $this->getChoiceKeys();
429 
430  // get the solution of the user for the active pass or from the last pass if allowed
431  $user_solution = "";
432  if ($active_id) {
433  // hey: prevPassSolutions - obsolete due to central check
434  #$solutions = NULL;
435  #include_once "./Modules/Test/classes/class.ilObjTest.php";
436  #if (!ilObjTest::_getUsePreviousAnswers($active_id, true))
437  #{
438  # if (is_null($pass)) $pass = ilObjTest::_getPass($active_id);
439  #}
440  // hey.
441  $solutions = $this->object->getTestOutputSolutions($active_id, $pass);
442  foreach ($solutions as $idx => $solution_value) {
443  $user_solution = $solution_value["value1"];
444  }
445  }
446 
447  // generate the question output
448  include_once "./Services/UICore/classes/class.ilTemplate.php";
449  $template = new ilTemplate("tpl.il_as_qpl_mc_sr_output.html", true, true, "Modules/TestQuestionPool");
450  foreach ($keys as $answer_id) {
451  $answer = $this->object->answers[$answer_id];
452  if (strlen($answer->getImage())) {
453  if ($this->object->getThumbSize()) {
454  $template->setCurrentBlock("preview");
455  $template->setVariable("URL_PREVIEW", $this->object->getImagePathWeb() . $answer->getImage());
456  $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
457  $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
458  $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
459  list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
460  $alt = $answer->getImage();
461  if (strlen($answer->getAnswertext())) {
462  $alt = $answer->getAnswertext();
463  }
464  $alt = preg_replace("/<[^>]*?>/", "", $alt);
465  $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
466  $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
467  $template->parseCurrentBlock();
468  } else {
469  $template->setCurrentBlock("answer_image");
470  $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
471  list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
472  $alt = $answer->getImage();
473  if (strlen($answer->getAnswertext())) {
474  $alt = $answer->getAnswertext();
475  }
476  $alt = preg_replace("/<[^>]*?>/", "", $alt);
477  $template->setVariable("ATTR", $attr);
478  $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
479  $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
480  $template->parseCurrentBlock();
481  }
482  }
483  if ($show_feedback) {
484  $feedbackOutputRequired = false;
485 
486  switch ($this->object->getSpecificFeedbackSetting()) {
487  case 1:
488  $feedbackOutputRequired = true;
489  break;
490 
491  case 2:
492  if (strcmp($user_solution, $answer_id) == 0) {
493  $feedbackOutputRequired = true;
494  }
495  break;
496 
497  case 3:
498  if ($this->object->getAnswer($answer_id)->getPoints() > 0) {
499  $feedbackOutputRequired = true;
500  }
501  break;
502  }
503 
504  if ($feedbackOutputRequired) {
505  $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
506  $this->object->getId(),
507  0,
508  $answer_id
509  );
510  if (strlen($fb)) {
511  $template->setCurrentBlock("feedback");
512  $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
513  $template->parseCurrentBlock();
514  }
515  }
516  }
517  $template->setCurrentBlock("answer_row");
518  $template->setVariable("ANSWER_ID", $answer_id);
519  $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), true));
520  if (strcmp($user_solution, $answer_id) == 0) {
521  $template->setVariable("CHECKED_ANSWER", " checked=\"checked\"");
522  }
523  $template->parseCurrentBlock();
524  }
525  $questiontext = $this->object->getQuestion();
526  $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, true));
527  $questionoutput = $template->get();
528  $pageoutput = $this->outQuestionPage("", $is_postponed, $active_id, $questionoutput, $show_feedback);
529  return $pageoutput;
530  }
531 
539  public function setQuestionTabs()
540  {
541  global $DIC;
542  $rbacsystem = $DIC['rbacsystem'];
543  $ilTabs = $DIC['ilTabs'];
544 
545  $ilTabs->clearTargets();
546 
547  $this->ctrl->setParameterByClass("ilAssQuestionPageGUI", "q_id", $_GET["q_id"]);
548  include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
549  $q_type = $this->object->getQuestionType();
550 
551  if (strlen($q_type)) {
552  $classname = $q_type . "GUI";
553  $this->ctrl->setParameterByClass(strtolower($classname), "sel_question_types", $q_type);
554  $this->ctrl->setParameterByClass(strtolower($classname), "q_id", $_GET["q_id"]);
555  }
556 
557  if ($_GET["q_id"]) {
558  if ($rbacsystem->checkAccess('write', $_GET["ref_id"])) {
559  // edit page
560  $ilTabs->addTarget(
561  "edit_page",
562  $this->ctrl->getLinkTargetByClass("ilAssQuestionPageGUI", "edit"),
563  array("edit", "insert", "exec_pg"),
564  "",
565  "",
566  $force_active
567  );
568  }
569 
570  $this->addTab_QuestionPreview($ilTabs);
571  }
572 
573  $force_active = false;
574  if ($rbacsystem->checkAccess('write', $_GET["ref_id"])) {
575  $url = "";
576  if ($classname) {
577  $url = $this->ctrl->getLinkTargetByClass($classname, "editQuestion");
578  }
579  // edit question properties
580  $ilTabs->addTarget(
581  "edit_question",
582  $url,
583  array("editQuestion", "save", "saveEdit", "addchoice", "removechoice", "removeimagechoice", "uploadchoice", "originalSyncForm"),
584  $classname,
585  "",
586  $force_active
587  );
588  }
589 
590  // add tab for question feedback within common class assQuestionGUI
591  $this->addTab_QuestionFeedback($ilTabs);
592 
593  // add tab for question hint within common class assQuestionGUI
594  $this->addTab_QuestionHints($ilTabs);
595 
596  // add tab for question's suggested solution within common class assQuestionGUI
597  $this->addTab_SuggestedSolution($ilTabs, $classname);
598 
599  // Assessment of questions sub menu entry
600  if ($_GET["q_id"]) {
601  $ilTabs->addTarget(
602  "statistics",
603  $this->ctrl->getLinkTargetByClass($classname, "assessment"),
604  array("assessment"),
605  $classname,
606  ""
607  );
608  }
609 
610  $this->addBackTab($ilTabs);
611  }
612 
613  /*
614  * Create the key index numbers for the array of choices
615  *
616  * @return array
617  */
618  public function getChoiceKeys()
619  {
620  $choiceKeys = array_keys($this->object->answers);
621 
622  if ($this->object->getShuffle()) {
623  $choiceKeys = $this->object->getShuffler()->shuffle($choiceKeys);
624  }
625 
626  return $choiceKeys;
627  }
628 
629  public function getSpecificFeedbackOutput($userSolution)
630  {
631  // No return value, this question type supports inline specific feedback.
632  $output = "";
633  return $this->object->prepareTextareaOutput($output, true);
634  }
635 
637  {
638  $this->object->setShuffle($_POST["shuffle"]);
639  $this->object->setMultilineAnswerSetting($_POST["types"]);
640  if (is_array($_POST['choice']['imagename']) && $_POST["types"] == 1) {
641  $this->object->isSingleline = true;
642  ilUtil::sendInfo($this->lng->txt('info_answer_type_change'), true);
643  } else {
644  $this->object->isSingleline = ($_POST["types"] == 0) ? true : false;
645  }
646  $this->object->setThumbSize((strlen($_POST["thumb_size"])) ? $_POST["thumb_size"] : "");
647  }
648 
650  {
651  $isSingleline = $this->getEditAnswersSingleLine();
652  // shuffle
653  $shuffle = new ilCheckboxInputGUI($this->lng->txt("shuffle_answers"), "shuffle");
654  $shuffle->setValue(1);
655  $shuffle->setChecked($this->object->getShuffle());
656  $shuffle->setRequired(false);
657  $form->addItem($shuffle);
658 
659  if ($this->object->getId()) {
660  $hidden = new ilHiddenInputGUI("", "ID");
661  $hidden->setValue($this->object->getId());
662  $form->addItem($hidden);
663  }
664 
665  if (!$this->object->getSelfAssessmentEditingMode()) {
666  // Answer types
667  $types = new ilSelectInputGUI($this->lng->txt("answer_types"), "types");
668  $types->setRequired(false);
669  $types->setValue(($isSingleline) ? 0 : 1);
670  $types->setOptions(
671  array(
672  0 => $this->lng->txt('answers_singleline'),
673  1 => $this->lng->txt('answers_multiline'),
674  )
675  );
676  $form->addItem($types);
677  }
678 
679  if ($isSingleline) {
680  // thumb size
681  $thumb_size = new ilNumberInputGUI($this->lng->txt("thumb_size"), "thumb_size");
682  $thumb_size->setSuffix($this->lng->txt("thumb_size_unit_pixel"));
683  $thumb_size->setMinValue(20);
684  $thumb_size->setDecimals(0);
685  $thumb_size->setSize(6);
686  $thumb_size->setInfo($this->lng->txt('thumb_size_info'));
687  $thumb_size->setValue($this->object->getThumbSize());
688  $thumb_size->setRequired(false);
689  $form->addItem($thumb_size);
690  }
691  return $form;
692  }
693 
704  {
705  return array();
706  }
707 
709  {
710  // Delete all existing answers and create new answers from the form data
711  $this->object->flushAnswers();
712  if ($this->object->isSingleline) {
713  foreach ($_POST['choice']['answer'] as $index => $answertext) {
714  $answertext = ilUtil::secureString($answertext);
715 
716  $picturefile = $_POST['choice']['imagename'][$index];
717  $file_org_name = $_FILES['choice']['name']['image'][$index];
718  $file_temp_name = $_FILES['choice']['tmp_name']['image'][$index];
719 
720  if (strlen($file_temp_name)) {
721  // check suffix
722  $suffix = strtolower(array_pop(explode(".", $file_org_name)));
723  if (in_array($suffix, array( "jpg", "jpeg", "png", "gif" ))) {
724  // upload image
725  $filename = $this->object->buildHashedImageFilename($file_org_name);
726  if ($this->object->setImageFile($filename, $file_temp_name) == 0) {
727  $picturefile = $filename;
728  }
729  }
730  }
731 
732  $this->object->addAnswer($answertext, $_POST['choice']['points'][$index], $index, $picturefile);
733  }
734  } else {
735  foreach ($_POST['choice']['answer'] as $index => $answer) {
736  $answertext = $answer;
737  $this->object->addAnswer($answertext, $_POST['choice']['points'][$index], $index);
738  }
739  }
740  }
741 
743  {
744  $isSingleline = $this->getEditAnswersSingleLine();
745 
746  // Choices
747  include_once "./Modules/TestQuestionPool/classes/class.ilSingleChoiceWizardInputGUI.php";
748  $choices = new ilSingleChoiceWizardInputGUI($this->lng->txt("answers"), "choice");
749  $choices->setRequired(true);
750  $choices->setQuestionObject($this->object);
751  $choices->setSingleline($isSingleline);
752  $choices->setAllowMove(false);
753  if ($this->object->getSelfAssessmentEditingMode()) {
754  $choices->setSize(40);
755  }
756  $choices->setMaxLength(800);
757  if ($this->object->getAnswerCount() == 0) {
758  $this->object->addAnswer("", 0, 0);
759  }
760  $choices->setValues($this->object->getAnswers());
761  $form->addItem($choices);
762  }
763 
774  {
775  return array();
776  }
777 
786  public function getAggregatedAnswersView($relevant_answers)
787  {
788  return $this->renderAggregateView(
789  $this->aggregateAnswers($relevant_answers, $this->object->getAnswers())
790  )->get();
791  }
792 
793  public function aggregateAnswers($relevant_answers_chosen, $answers_defined_on_question)
794  {
795  $aggregate = array();
796  foreach ($answers_defined_on_question as $answer) {
797  $aggregated_info_for_answer = array();
798  $aggregated_info_for_answer['answertext'] = $answer->getAnswerText();
799  $aggregated_info_for_answer['count_checked'] = 0;
800 
801  foreach ($relevant_answers_chosen as $relevant_answer) {
802  if ($relevant_answer['value1'] == $answer->getOrder()) {
803  $aggregated_info_for_answer['count_checked']++;
804  }
805  }
806  $aggregated_info_for_answer['count_unchecked'] =
807  ceil(count($relevant_answers_chosen) / count($answers_defined_on_question))
808  - $aggregated_info_for_answer['count_checked'];
809 
810  $aggregate[] = $aggregated_info_for_answer;
811  }
812  return $aggregate;
813  }
814 
820  public function renderAggregateView($aggregate)
821  {
822  $tpl = new ilTemplate('tpl.il_as_aggregated_answers_table.html', true, true, "Modules/TestQuestionPool");
823 
824  $tpl->setCurrentBlock('headercell');
825  $tpl->setVariable('HEADER', $this->lng->txt('tst_answer_aggr_answer_header'));
826  $tpl->parseCurrentBlock();
827 
828  $tpl->setCurrentBlock('headercell');
829  $tpl->setVariable('HEADER', $this->lng->txt('tst_answer_aggr_frequency_header'));
830  $tpl->parseCurrentBlock();
831 
832  foreach ($aggregate as $line_data) {
833  $tpl->setCurrentBlock('aggregaterow');
834  $tpl->setVariable('OPTION', $line_data['answertext']);
835  $tpl->setVariable('COUNT', $line_data['count_checked']);
836  $tpl->parseCurrentBlock();
837  }
838  return $tpl;
839  }
840 
841  private function populateInlineFeedback($template, $answer_id, $user_solution)
842  {
843  $feedbackOutputRequired = false;
844 
845  switch ($this->object->getSpecificFeedbackSetting()) {
846  case 1:
847  $feedbackOutputRequired = true;
848  break;
849 
850  case 2:
851  if (strcmp($user_solution, $answer_id) == 0) {
852  $feedbackOutputRequired = true;
853  }
854  break;
855 
856  case 3:
857  if ($this->object->getAnswer($answer_id)->getPoints() > 0) {
858  $feedbackOutputRequired = true;
859  }
860  break;
861  }
862 
863  if ($feedbackOutputRequired) {
864  $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), 0, $answer_id);
865  if (strlen($fb)) {
866  $template->setCurrentBlock("feedback");
867  $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
868  $template->parseCurrentBlock();
869  }
870  }
871  }
872 
873  public function getAnswersFrequency($relevantAnswers, $questionIndex)
874  {
875  $agg = $this->aggregateAnswers($relevantAnswers, $this->object->getAnswers());
876 
877  $answers = array();
878 
879  foreach ($agg as $ans) {
880  $answers[] = array(
881  'answer' => $ans['answertext'],
882  'frequency' => $ans['count_checked']
883  );
884  }
885 
886  return $answers;
887  }
888 
890  {
891  require_once 'Modules/TestQuestionPool/classes/forms/class.ilAssSingleChoiceCorrectionsInputGUI.php';
892  $choices = new ilAssSingleChoiceCorrectionsInputGUI($this->lng->txt("answers"), "choice");
893  $choices->setRequired(true);
894  $choices->setQuestionObject($this->object);
895  $choices->setValues($this->object->getAnswers());
896  $form->addItem($choices);
897  }
898 
903  {
904  $points = $form->getInput('choice')['points'];
905 
906  foreach ($this->object->getAnswers() as $index => $answer) {
907  /* @var ASS_AnswerMultipleResponseImage $answer */
908  $answer->setPoints((float) $points[$index]);
909  }
910  }
911 }
static prepareFormOutput($a_str, $a_strip=false)
prepares string output for html forms public
hasCorrectSolution($activeId, $passIndex)
addTab_QuestionPreview(ilTabsGUI $tabsGUI)
aggregateAnswers($relevant_answers_chosen, $answers_defined_on_question)
addBasicQuestionFormProperties($form)
Add basic question form properties: assessment: title, author, description, question, working time.
getAggregatedAnswersView($relevant_answers)
Returns an html string containing a question specific representation of the answers so far given in t...
getSolutionOutput( $active_id, $pass=null, $graphicalOutput=false, $result_output=false, $show_question_only=true, $show_feedback=false, $show_correct_solution=false, $show_manual_scoring=false, $show_question_text=true)
Get the question solution output.
writePostData($always=false)
{}
This class represents a selection list property in a property form.
addTab_QuestionHints(ilTabsGUI $tabs)
adds the hints tab to ilTabsGUI
$template
This class represents a property form user interface.
$type
global $DIC
Definition: saml.php:7
setQuestionTabs()
Sets the ILIAS tabs for this question type.
writeAnswerSpecificPostData(ilPropertyFormGUI $form)
Extracts the answer specific values from $_POST and applies them to the data object.
$_GET["client_id"]
populateInlineFeedback($template, $answer_id, $user_solution)
supportsIntermediateSolutionOutput()
Question type specific support of intermediate solution output The function getSolutionOutput respect...
if(!array_key_exists('StateId', $_REQUEST)) $id
This class represents a checkbox property in a property form.
populateQuestionSpecificFormPart(\ilPropertyFormGUI $form)
addItem($a_item)
Add Item (Property, SectionHeader).
$index
Definition: metadata.php:60
getQuestionTemplate()
get question template
$keys
getAnswersFrequency($relevantAnswers, $questionIndex)
populateTaxonomyFormSection(ilPropertyFormGUI $form)
getUseIntermediateSolution()
Get if intermediate solution should be used for solution output.
static sendInfo($a_info="", $a_keep=false)
Send Info Message to Screen.
This class represents a hidden form property in a property form.
getTestOutput($active_id, $pass, $is_postponed=false, $use_post_solutions=false, $show_feedback=false)
setSuffix($a_value)
Set suffix.
if(isset($_POST['submit'])) $form
getSpecificFeedbackOutput($userSolution)
getPreview($show_question_only=false, $showInlineFeedback=false)
getAfterParticipationSuppressionAnswerPostVars()
Returns a list of postvars which will be suppressed in the form output when used in scoring adjustmen...
getILIASPage($html="")
Returns the ILIAS Page around a question.
static getImagePath($img, $module_path="", $mode="output", $offline=false)
get image path (for images located in a template directory)
This class represents a number property in a property form.
Class for single choice questions.
setValue($a_value)
Set Value.
special template class to simplify handling of ITX/PEAR
getAfterParticipationSuppressionQuestionPostVars()
Returns a list of postvars which will be suppressed in the form output when used in scoring adjustmen...
addTab_QuestionFeedback(ilTabsGUI $tabs)
adds the feedback tab to ilTabsGUI
removechoice()
Remove an answer.
getInput($a_post_var, $ensureValidation=true)
Returns the value of a HTTP-POST variable, identified by the passed id.
Basic GUI class for assessment questions.
static getHtmlPath($relative_path)
get url of path
$filename
Definition: buildRTE.php:89
getAnswerFeedbackOutput($active_id, $pass)
Returns the answer generic feedback depending on the results of the question.
populateAnswerSpecificFormPart(\ilPropertyFormGUI $form)
populateCorrectionsFormProperties(ilPropertyFormGUI $form)
addchoice()
Add a new answer.
This class represents a single choice wizard property in a property form.
$errors
Definition: index.php:6
saveCorrectionsFormProperties(ilPropertyFormGUI $form)
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="", $inlineFeedbackEnabled=false)
output question page
addBackTab(ilTabsGUI $ilTabs)
static secureString($a_str, $a_strip_html=true, $a_allow="")
Remove unsecure tags.
Interface ilGuiAnswerScoringAdjustable.
Single choice question GUI representation.
$url
__construct($id=-1)
assSingleChoiceGUI constructor
editQuestion($checkonly=false)
Creates an output of the edit form for the question.
removeimagechoice()
Remove an image.
Interface ilGuiQuestionScoringAdjustable.
getEditAnswersSingleLine($checkonly=false)
Get the single/multiline editing of answers.
$_POST["username"]
uploadchoice()
Upload an image.
setRequired($a_required)
Set Required.
addTab_SuggestedSolution(ilTabsGUI $tabs, $classname)
addQuestionFormCommandButtons($form)
Add the command buttons of a question properties form.
writeQuestionSpecificPostData(ilPropertyFormGUI $form)
Extracts the question specific values from $_POST and applies them to the data object.