ILIAS  release_5-0 Revision 5.0.0-1144-gc4397b1f870
Public Member Functions | Private Member Functions
assMatchingQuestionGUI Class Reference
Modules/TestQuestionPool

Matching question GUI representation. More...

+ Inheritance diagram for assMatchingQuestionGUI:
+ Collaboration diagram for assMatchingQuestionGUI:

Public Member Functions

 __construct ($id=-1)
 assMatchingQuestionGUI constructor More...
 
 writePostData ($always=false)
 Evaluates a posted edit form and writes the form data in the question object. More...
 
 writeAnswerSpecificPostData (ilPropertyFormGUI $form)
 Extracts the answer specific values from $_POST and applies them to the data object. More...
 
 writeQuestionSpecificPostData (ilPropertyFormGUI $form)
 Extracts the question specific values from $_POST and applies them to the data object. More...
 
 uploadterms ()
 
 removeimageterms ()
 
 uploaddefinitions ()
 
 removeimagedefinitions ()
 
 addterms ()
 
 removeterms ()
 
 adddefinitions ()
 
 removedefinitions ()
 
 addpairs ()
 
 removepairs ()
 
 editQuestion ($checkonly=FALSE)
 
 populateAnswerSpecificFormPart (\ilPropertyFormGUI $form)
 
 populateQuestionSpecificFormPart (\ilPropertyFormGUI $form)
 
 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. More...
 
 getPreview ($show_question_only=FALSE, $showInlineFeedback=false)
 
 getTestOutput ($active_id, $pass=NULL, $is_postponed=FALSE, $user_post_solution=FALSE)
 
 checkInput ()
 check input fields More...
 
 setQuestionTabs ()
 Sets the ILIAS tabs for this question type. More...
 
 getSpecificFeedbackOutput ($active_id, $pass)
 Returns the answer specific feedback for the question. More...
 
 getAfterParticipationSuppressionAnswerPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 
 getAfterParticipationSuppressionQuestionPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 
 getAggregatedAnswersView ($relevant_answers)
 Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface. More...
 
- Public Member Functions inherited from assQuestionGUI
 __construct ()
 assQuestionGUI constructor More...
 
& executeCommand ()
 execute command More...
 
 getCommand ($cmd)
 
 getType ()
 needed for page editor compliance More...
 
 setTaxonomyIds ($taxonomyIds)
 
 getTaxonomyIds ()
 
 setTargetGui ($linkTargetGui)
 
 setTargetGuiClass ($targetGuiClass)
 
 getTargetGuiClass ()
 
 setQuestionHeaderBlockBuilder ($questionHeaderBlockBuilder)
 
 setQuestionActionCmd ($questionActionCmd)
 
 getQuestionActionCmd ()
 
& _getQuestionGUI ($question_type, $question_id=-1)
 Creates a question gui representation and returns the alias to the question gui note: please do not use $this inside this method to allow static calls. More...
 
 _getGUIClassNameForId ($a_q_id)
 
 _getClassNameForQType ($q_type)
 
& createQuestionGUI ($question_type, $question_id=-1)
 Creates a question gui representation. More...
 
 getQuestionTemplate ()
 get question template More...
 
 getILIASPage ($html="")
 Returns the ILIAS Page around a question. More...
 
 outQuestionPage ($a_temp_var, $a_postponed=false, $active_id="", $html="")
 output question page More...
 
 cancel ()
 cancel action More...
 
 originalSyncForm ($return_to="", $return_to_feedback='')
 
 sync ()
 
 cancelSync ()
 
 saveEdit ()
 save question More...
 
 save ()
 save question More...
 
 saveReturn ()
 save question More...
 
 apply ()
 apply changes More...
 
 getContextPath ($cont_obj, $a_endnode_id, $a_startnode_id=1)
 get context path in content object tree More...
 
 setSequenceNumber ($nr)
 
 getSequenceNumber ()
 
 setQuestionCount ($a_question_count)
 
 getQuestionCount ()
 
 getErrorMessage ()
 
 setErrorMessage ($errormessage)
 
 addErrorMessage ($errormessage)
 
 outAdditionalOutput ()
 
 getQuestionType ()
 Returns the question type string. More...
 
 getAsValueAttribute ($a_value)
 Returns a HTML value attribute. More...
 
 addNewIdListener (&$a_object, $a_method, $a_parameters="")
 Add a listener that is notified with the new question ID, when a new question is saved. More...
 
 callNewIdListeners ($a_new_id)
 Call the new id listeners. More...
 
 addQuestionFormCommandButtons ($form)
 Add the command buttons of a question properties form. More...
 
 addBasicQuestionFormProperties ($form)
 Add basic question form properties: assessment: title, author, description, question, working time. More...
 
 getSelfAssessmentTags ()
 Get tags allowed in question tags in self assessment mode. More...
 
 getAnswerFeedbackOutput ($active_id, $pass)
 Returns the answer generic feedback depending on the results of the question. More...
 
 getGenericFeedbackOutput ($active_id, $pass)
 Returns the answer specific feedback for the question. More...
 
 getGenericFeedbackOutputForCorrectSolution ()
 
 getGenericFeedbackOutputForIncorrectSolution ()
 
 getSpecificFeedbackOutput ($active_id, $pass)
 Returns the answer specific feedback for the question. More...
 
 outQuestionType ()
 
 showSuggestedSolution ()
 
 suggestedsolution ()
 Allows to add suggested solutions for questions. More...
 
 outSolutionExplorer ()
 
 saveSuggestedSolution ()
 
 cancelExplorer ()
 
 outPageSelector ()
 
 outChapterSelector ()
 
 outGlossarySelector ()
 
 linkChilds ()
 
 addPG ()
 
 addST ()
 
 addGIT ()
 
 isSaveCommand ()
 
 setQuestionTabs ()
 
 addTab_SuggestedSolution (ilTabsGUI $tabs, $classname)
 
 getEditQuestionTabCommands ()
 
 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)
 
 isAutosaveable ()
 
 getPreview ($show_question_only=FALSE, $showInlineFeedback=false)
 
 outQuestionForTest ( $formaction, $active_id, $pass=NULL, $is_question_postponed=FALSE, $user_post_solutions=FALSE, $show_specific_inline_feedback=FALSE)
 
 setPreviewSession ($previewSession)
 
 getPreviewSession ()
 
 showHints ()
 
- Public Member Functions inherited from ilGuiQuestionScoringAdjustable
 populateQuestionSpecificFormPart (ilPropertyFormGUI $form)
 Adds the question specific forms parts to a question property form gui. More...
 
 writeQuestionSpecificPostData (ilPropertyFormGUI $form)
 Extracts the question specific values from $_POST and applies them to the data object. More...
 
 getAfterParticipationSuppressionQuestionPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 
 getAggregatedAnswersView ($relevant_answers)
 Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface. More...
 
- Public Member Functions inherited from ilGuiAnswerScoringAdjustable
 populateAnswerSpecificFormPart (ilPropertyFormGUI $form)
 Adds the answer specific form parts to a question property form gui. More...
 
 writeAnswerSpecificPostData (ilPropertyFormGUI $form)
 Extracts the answer specific values from $_POST and applies them to the data object. More...
 
 getAfterParticipationSuppressionAnswerPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 

Private Member Functions

 isValidTermAndDefinitionAmount (ilPropertyFormGUI $form)
 for mode 1:1 terms count must not be less than definitions count for mode n:n this limitation is cancelled More...
 
 isCorrectMatching ($pair, $definition, $term)
 

Additional Inherited Members

- Static Public Member Functions inherited from assQuestionGUI
static getCommandsFromClassConstants ($guiClassName, $cmdConstantNameBegin='CMD_')
 extracts values of all constants of given class with given prefix as array can be used to get all possible commands in case of these commands are defined as constants More...
 
- Data Fields inherited from assQuestionGUI
const FORM_MODE_EDIT = 'edit'
 
const FORM_MODE_ADJUST = 'adjust'
 
const FORM_ENCODING_URLENCODE = 'application/x-www-form-urlencoded'
 
const FORM_ENCODING_MULTIPART = 'multipart/form-data'
 
const SESSION_PREVIEW_DATA_BASE_INDEX = 'ilAssQuestionPreviewAnswers'
 
 $object
 
 $tpl
 
 $lng
 
 $error
 
 $errormessage
 
 $sequence_no
 sequence number in test More...
 
 $question_count
 question count in test More...
 
- Protected Member Functions inherited from assQuestionGUI
 writePostData ()
 Evaluates a posted edit form and writes the form data in the question object. More...
 
 saveTaxonomyAssignments ()
 
 populateTaxonomyFormSection (ilPropertyFormGUI $form)
 
 getBasicEditQuestionTabCommands ()
 
 getAdditionalEditQuestionCommands ()
 
 addTab_QuestionFeedback (ilTabsGUI $tabs)
 adds the feedback tab to ilTabsGUI More...
 
 addTab_QuestionHints (ilTabsGUI $tabs)
 adds the hints tab to ilTabsGUI More...
 
 addTab_QuestionPreview (ilTabsGUI $tabsGUI)
 
 writeQuestionGenericPostData ()
 
 getFormEncodingType ()
 
 addBackTab (ilTabsGUI $ilTabs)
 
 buildBasicEditFormObject ()
 

Detailed Description

Matching question GUI representation.

The assMatchingQuestionGUI class encapsulates the GUI representation for matching questions.

Author
Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m
Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de
Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de
Version
$Id$

Definition at line 23 of file class.assMatchingQuestionGUI.php.

Constructor & Destructor Documentation

◆ __construct()

assMatchingQuestionGUI::__construct (   $id = -1)

assMatchingQuestionGUI constructor

The constructor takes possible arguments an creates an instance of the assMatchingQuestionGUI object.

Parameters
integer$idThe database id of a image map question object
Returns
\assMatchingQuestionGUI

Definition at line 34 of file class.assMatchingQuestionGUI.php.

35 {
36 parent::__construct();
37 include_once "./Modules/TestQuestionPool/classes/class.assMatchingQuestion.php";
38 $this->object = new assMatchingQuestion();
39 $this->setErrorMessage($this->lng->txt("msg_form_save_error"));
40 if ($id >= 0)
41 {
42 $this->object->loadFromDb($id);
43 }
44 }
assMatchingQuestion
Class for matching questions.
Definition: class.assMatchingQuestion.php:25
assQuestionGUI\setErrorMessage
setErrorMessage($errormessage)
Definition: class.assQuestionGUI.php:821

References assQuestionGUI\setErrorMessage().

+ Here is the call graph for this function:

Member Function Documentation

◆ adddefinitions()

assMatchingQuestionGUI::adddefinitions ( )

Definition at line 199 of file class.assMatchingQuestionGUI.php.

200 {
201 $this->writePostData();
202 $position = key($_POST["cmd"]["adddefinitions"]);
203 $this->object->insertDefinition($position+1);
204 $this->editQuestion();
205 }
assQuestionGUI\writePostData
writePostData()
Evaluates a posted edit form and writes the form data in the question object.
Definition: class.assQuestionGUI.php:180
$_POST
$_POST['username']
Definition: cron.php:12

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ addpairs()

assMatchingQuestionGUI::addpairs ( )

Definition at line 215 of file class.assMatchingQuestionGUI.php.

216 {
217 $this->writePostData();
218 $position = key($_POST["cmd"]["addpairs"]);
219 $this->object->insertMatchingPair($position+1);
220 $this->editQuestion();
221 }

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ addterms()

assMatchingQuestionGUI::addterms ( )

Definition at line 183 of file class.assMatchingQuestionGUI.php.

184 {
185 $this->writePostData();
186 $position = key($_POST["cmd"]["addterms"]);
187 $this->object->insertTerm($position+1);
188 $this->editQuestion();
189 }

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ checkInput()

assMatchingQuestionGUI::checkInput ( )

check input fields

Definition at line 936 of file class.assMatchingQuestionGUI.php.

937 {
938 if ((!$_POST["title"]) or (!$_POST["author"]) or (!$_POST["question"]))
939 {
940 return false;
941 }
942 return true;
943 }

References $_POST.

◆ editQuestion()

assMatchingQuestionGUI::editQuestion (   $checkonly = FALSE)

Definition at line 231 of file class.assMatchingQuestionGUI.php.

232 {
233 $save = $this->isSaveCommand();
234 $this->getQuestionTemplate();
235
236 include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
237 $form = new ilPropertyFormGUI();
238 $form->setFormAction($this->ctrl->getFormAction($this));
239 $form->setTitle($this->outQuestionType());
240 $form->setMultipart(true);
241 $form->setTableWidth("100%");
242 $form->setId("matching");
243
244
245 // title, author, description, question, working time (assessment mode)
246 $this->addBasicQuestionFormProperties($form);
247 $this->populateQuestionSpecificFormPart( $form );
248 $this->populateAnswerSpecificFormPart( $form );
249 $this->populateTaxonomyFormSection($form);
250 $this->addQuestionFormCommandButtons($form);
251
252 $errors = false;
253 if ($save)
254 {
255 $form->setValuesByPost();
256 $errors = !$form->checkInput();
257 $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
258 if( !$errors && !$this->isValidTermAndDefinitionAmount($form) && !$this->object->getSelfAssessmentEditingMode() )
259 {
260 $errors = true;
261 $terms = $form->getItemByPostVar('terms');
262 $terms->setAlert($this->lng->txt("msg_number_of_terms_too_low"));
263 ilUtil::sendFailure($this->lng->txt('form_input_not_valid'));
264 }
265 if ($errors) $checkonly = false;
266 }
267
268 if (!$checkonly) $this->tpl->setVariable("QUESTION_DATA", $form->getHTML());
269 return $errors;
270 }
assMatchingQuestionGUI\isValidTermAndDefinitionAmount
isValidTermAndDefinitionAmount(ilPropertyFormGUI $form)
for mode 1:1 terms count must not be less than definitions count for mode n:n this limitation is canc...
Definition: class.assMatchingQuestionGUI.php:279
assMatchingQuestionGUI\populateAnswerSpecificFormPart
populateAnswerSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMatchingQuestionGUI.php:299
assMatchingQuestionGUI\populateQuestionSpecificFormPart
populateQuestionSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMatchingQuestionGUI.php:357
assQuestionGUI\populateTaxonomyFormSection
populateTaxonomyFormSection(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:1037
assQuestionGUI\addQuestionFormCommandButtons
addQuestionFormCommandButtons($form)
Add the command buttons of a question properties form.
Definition: class.assQuestionGUI.php:902
assQuestionGUI\getQuestionTemplate
getQuestionTemplate()
get question template
Definition: class.assQuestionGUI.php:285
assQuestionGUI\addBasicQuestionFormProperties
addBasicQuestionFormProperties($form)
Add basic question form properties: assessment: title, author, description, question,...
Definition: class.assQuestionGUI.php:918
ilPropertyFormGUI
This class represents a property form user interface.
Definition: class.ilPropertyFormGUI.php:48
ilUtil\sendFailure
static sendFailure($a_info="", $a_keep=false)
Send Failure Message to Screen.
Definition: class.ilUtil.php:4899
$errors
$errors
Definition: imagemanager.php:73

References $errors, assQuestionGUI\addBasicQuestionFormProperties(), assQuestionGUI\addQuestionFormCommandButtons(), assQuestionGUI\getQuestionTemplate(), assQuestionGUI\isSaveCommand(), isValidTermAndDefinitionAmount(), assQuestionGUI\outQuestionType(), populateAnswerSpecificFormPart(), populateQuestionSpecificFormPart(), assQuestionGUI\populateTaxonomyFormSection(), and ilUtil\sendFailure().

Referenced by adddefinitions(), addpairs(), addterms(), removedefinitions(), removeimagedefinitions(), removeimageterms(), removepairs(), removeterms(), uploaddefinitions(), uploadterms(), and writePostData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getAfterParticipationSuppressionAnswerPostVars()

assMatchingQuestionGUI::getAfterParticipationSuppressionAnswerPostVars ( )

Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.

The form elements will be shown disabled, so the users see the usual form but can only edit the settings, which make sense in the given context.

E.g. array('cloze_type', 'image_filename')

Returns
string[]

Implements ilGuiAnswerScoringAdjustable.

Definition at line 1051 of file class.assMatchingQuestionGUI.php.

1052 {
1053 return array();
1054 }

◆ getAfterParticipationSuppressionQuestionPostVars()

assMatchingQuestionGUI::getAfterParticipationSuppressionQuestionPostVars ( )

Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.

The form elements will be shown disabled, so the users see the usual form but can only edit the settings, which make sense in the given context.

E.g. array('cloze_type', 'image_filename')

Returns
string[]

Implements ilGuiQuestionScoringAdjustable.

Definition at line 1065 of file class.assMatchingQuestionGUI.php.

1066 {
1067 return array();
1068 }

◆ getAggregatedAnswersView()

assMatchingQuestionGUI::getAggregatedAnswersView (   $relevant_answers)

Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface.

Parameters
array$relevant_answers
Returns
string

Implements ilGuiQuestionScoringAdjustable.

Definition at line 1078 of file class.assMatchingQuestionGUI.php.

1079 {
1080 return ''; //print_r($relevant_answers,true);
1081 }

◆ getPreview()

assMatchingQuestionGUI::getPreview (   $show_question_only = FALSE,
  $showInlineFeedback = false 
)

Reimplemented from assQuestionGUI.

Definition at line 594 of file class.assMatchingQuestionGUI.php.

595 {
596 $solutions = is_object($this->getPreviewSession()) ? (array)$this->getPreviewSession()->getParticipantsSolution() : array();
597
598 if($GLOBALS['ilBrowser']->isMobile() || $GLOBALS['ilBrowser']->isIpad())
599 {
600 require_once 'Services/jQuery/classes/class.iljQueryUtil.php';
601 iljQueryUtil::initjQuery();
602 iljQueryUtil::initjQueryUI();
603
604 $this->tpl->addJavaScript('./Services/jQuery/js/jquery.ui.touch-punch.min.js');
605 }
606 else
607 {
608 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/jquery-ui-1-10-3-fixed.js');
609 }
610
611 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/ilMatchingQuestion.js');
612 $this->tpl->addCss(ilUtil::getStyleSheetLocation('output', 'test_javascript.css', 'Modules/TestQuestionPool'));
613
614 $template = new ilTemplate("tpl.il_as_qpl_matching_output.html", TRUE, TRUE, "Modules/TestQuestionPool");
615
616 foreach($solutions as $defId => $terms)
617 {
618 foreach($terms as $termId)
619 {
620 $template->setCurrentBlock("matching_data");
621 $template->setVariable("DEFINITION_ID", $defId);
622 $template->setVariable("TERM_ID", $termId);
623 $template->parseCurrentBlock();
624 }
625 }
626
627 // shuffle output
628 $terms = $this->object->getTerms();
629 $definitions = $this->object->getDefinitions();
630 switch ($this->object->getShuffle())
631 {
632 case 1:
633 $terms = $this->object->pcArrayShuffle($terms);
634 $definitions = $this->object->pcArrayShuffle($definitions);
635 break;
636 case 2:
637 $terms = $this->object->pcArrayShuffle($terms);
638 break;
639 case 3:
640 $definitions = $this->object->pcArrayShuffle($definitions);
641 break;
642 }
643
644 // create definitions
645 $counter = 0;
646 foreach ($definitions as $definition)
647 {
648 if (strlen($definition->picture))
649 {
650 $template->setCurrentBlock("definition_picture");
651 $template->setVariable("DEFINITION_ID", $definition->identifier);
652 $template->setVariable("IMAGE_HREF", $this->object->getImagePathWeb() . $definition->picture);
653 $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $definition->picture;
654 $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $definition->picture;
655 if (!@file_exists($thumb)) $this->object->rebuildThumbnails();
656 $template->setVariable("THUMBNAIL_HREF", $thumbweb);
657 $template->setVariable("THUMB_ALT", $this->lng->txt("image"));
658 $template->setVariable("THUMB_TITLE", $this->lng->txt("image"));
659 $template->setVariable("TEXT_DEFINITION", (strlen($definition->text)) ? $this->object->prepareTextareaOutput($definition->text, TRUE) : '');
660 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
661 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
662 $template->parseCurrentBlock();
663 }
664 else
665 {
666 $template->setCurrentBlock("definition_text");
667 $template->setVariable("DEFINITION", $this->object->prepareTextareaOutput($definition->text, TRUE));
668 $template->parseCurrentBlock();
669 }
670
671 $template->setCurrentBlock("droparea");
672 $template->setVariable("ID_DROPAREA", $definition->identifier);
673 $template->setVariable("QUESTION_ID", $this->object->getId());
674 $template->parseCurrentBlock();
675
676 $template->setCurrentBlock("definition_data");
677 $template->setVariable("DEFINITION_ID", $definition->identifier);
678 $template->parseCurrentBlock();
679 }
680
681 // create terms
682 $counter = 0;
683 foreach ($terms as $term)
684 {
685 if (strlen($term->picture))
686 {
687 $template->setCurrentBlock("term_picture");
688 $template->setVariable("TERM_ID", $term->identifier);
689 $template->setVariable("IMAGE_HREF", $this->object->getImagePathWeb() . $term->picture);
690 $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $term->picture;
691 $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $term->picture;
692 if (!@file_exists($thumb)) $this->object->rebuildThumbnails();
693 $template->setVariable("THUMBNAIL_HREF", $thumbweb);
694 $template->setVariable("THUMB_ALT", $this->lng->txt("image"));
695 $template->setVariable("THUMB_TITLE", $this->lng->txt("image"));
696 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
697 $template->setVariable("TEXT_TERM", (strlen($term->text)) ? $this->object->prepareTextareaOutput($term->text, TRUE) : '');
698 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
699 $template->parseCurrentBlock();
700 }
701 else
702 {
703 $template->setCurrentBlock("term_text");
704 $template->setVariable("TERM_TEXT", $this->object->prepareTextareaOutput($term->text, TRUE));
705 $template->parseCurrentBlock();
706 }
707 $template->setCurrentBlock("draggable");
708 $template->setVariable("ID_DRAGGABLE", $term->identifier);
709 $template->parseCurrentBlock();
710
711 $template->setCurrentBlock("term_data");
712 $template->setVariable("TERM_ID", $term->identifier);
713 $template->parseCurrentBlock();
714 }
715
716 $template->setVariable('MATCHING_MODE', $this->object->getMatchingMode());
717
718 $template->setVariable("RESET_BUTTON", $this->lng->txt("reset_terms"));
719
720 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($this->object->getQuestion(), TRUE));
721
722 $questionoutput = $template->get();
723
724 if (!$show_question_only)
725 {
726 // get page object output
727 $questionoutput = $this->getILIASPage($questionoutput);
728 }
729
730 return $questionoutput;
731 }
assQuestionGUI\getILIASPage
getILIASPage($html="")
Returns the ILIAS Page around a question.
Definition: class.assQuestionGUI.php:298
ilTemplate
special template class to simplify handling of ITX/PEAR
Definition: class.ilTemplate.php:12
ilUtil\getStyleSheetLocation
static getStyleSheetLocation($mode="output", $a_css_name="", $a_css_location="")
get full style sheet file name (path inclusive) of current user
Definition: class.ilUtil.php:176
ilUtil\getImagePath
static getImagePath($img, $module_path="", $mode="output", $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:71
iljQueryUtil\initjQueryUI
static initjQueryUI()
Init jQuery UI (see included_components.txt for included components)
Definition: class.iljQueryUtil.php:51
iljQueryUtil\initjQuery
static initjQuery($a_tpl=null)
Init jQuery.
Definition: class.iljQueryUtil.php:20
$GLOBALS
$GLOBALS['ct_recipient']
Definition: example_form.ajax.php:4

References $GLOBALS, assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), assQuestionGUI\getPreviewSession(), ilUtil\getStyleSheetLocation(), iljQueryUtil\initjQuery(), and iljQueryUtil\initjQueryUI().

+ Here is the call graph for this function:

◆ getSolutionOutput()

assMatchingQuestionGUI::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.

Parameters
integer$active_idThe active user id
integer$passThe test pass
boolean$graphicalOutputShow visual feedback for right/wrong answers
boolean$result_outputShow the reached points for parts of the question
boolean$show_question_onlyShow the question without the ILIAS content around
boolean$show_feedbackShow the question feedback
boolean$show_correct_solutionShow the correct solution instead of the user solution
boolean$show_manual_scoringShow specific information for the manual scoring output
Returns
The solution output of the question as HTML code

Reimplemented from assQuestionGUI.

Definition at line 421 of file class.assMatchingQuestionGUI.php.

432 {
433 // generate the question output
434 include_once "./Services/UICore/classes/class.ilTemplate.php";
435 $template = new ilTemplate("tpl.il_as_qpl_matching_output_solution.html", TRUE, TRUE, "Modules/TestQuestionPool");
436 $solutiontemplate = new ilTemplate("tpl.il_as_tst_solution_output.html",TRUE, TRUE, "Modules/TestQuestionPool");
437
438 $solutions = array();
439 if (($active_id > 0) && (!$show_correct_solution))
440 {
441 include_once "./Modules/Test/classes/class.ilObjTest.php";
442 $solutions =& $this->object->getSolutionValues($active_id, $pass);
443 $solution_script .= "";
444 }
445 else
446 {
447 foreach ($this->object->getMaximumScoringMatchingPairs() as $pair)
448 {
449 $solutions[] = array(
450 "value1" => $pair->term->identifier,
451 "value2" => $pair->definition->identifier,
452 'points' => $pair->points
453 );
454 }
455 }
456
457 $i = 0;
458
459 foreach ($solutions as $solution)
460 {
461 $definition = $this->object->getDefinitionWithIdentifier($solution['value2']);
462 $term = $this->object->getTermWithIdentifier($solution['value1']);
463 $points = $solution['points'];
464
465 if (is_object($definition))
466 {
467 if (strlen($definition->picture))
468 {
469 if( strlen($definition->text) )
470 {
471 $template->setCurrentBlock('definition_image_text');
472 $template->setVariable("TEXT_DEFINITION", ilUtil::prepareFormOutput($definition->text));
473 $template->parseCurrentBlock();
474 }
475
476 $template->setCurrentBlock('definition_image');
477 $template->setVariable('ANSWER_IMAGE_URL', $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $definition->picture);
478 $template->setVariable('ANSWER_IMAGE_ALT', (strlen($definition->text)) ? ilUtil::prepareFormOutput($definition->text) : ilUtil::prepareFormOutput($definition->picture));
479 $template->setVariable('ANSWER_IMAGE_TITLE', (strlen($definition->text)) ? ilUtil::prepareFormOutput($definition->text) : ilUtil::prepareFormOutput($definition->picture));
480 $template->setVariable('URL_PREVIEW', $this->object->getImagePathWeb() . $definition->picture);
481 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
482 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
483 $template->parseCurrentBlock();
484 }
485 else
486 {
487 $template->setCurrentBlock('definition_text');
488 $template->setVariable("DEFINITION", $this->object->prepareTextareaOutput($definition->text, TRUE));
489 $template->parseCurrentBlock();
490 }
491 }
492 if (is_object($term))
493 {
494 if (strlen($term->picture))
495 {
496 if( strlen($term->text) )
497 {
498 $template->setCurrentBlock('term_image_text');
499 $template->setVariable("TEXT_TERM", ilUtil::prepareFormOutput($term->text));
500 $template->parseCurrentBlock();
501 }
502
503 $template->setCurrentBlock('term_image');
504 $template->setVariable('ANSWER_IMAGE_URL', $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $term->picture);
505 $template->setVariable('ANSWER_IMAGE_ALT', (strlen($term->text)) ? ilUtil::prepareFormOutput($term->text) : ilUtil::prepareFormOutput($term->picture));
506 $template->setVariable('ANSWER_IMAGE_TITLE', (strlen($term->text)) ? ilUtil::prepareFormOutput($term->text) : ilUtil::prepareFormOutput($term->picture));
507 $template->setVariable('URL_PREVIEW', $this->object->getImagePathWeb() . $term->picture);
508 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
509 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
510 $template->parseCurrentBlock();
511 }
512 else
513 {
514 $template->setCurrentBlock('term_text');
515 $template->setVariable("TERM", $this->object->prepareTextareaOutput($term->text, TRUE));
516 $template->parseCurrentBlock();
517 }
518 $i++;
519 }
520 if (($active_id > 0) && (!$show_correct_solution))
521 {
522 if ($graphicalOutput)
523 {
524 // output of ok/not ok icons for user entered solutions
525 $ok = false;
526 foreach ($this->object->getMatchingPairs() as $pair)
527 {
528 if( $this->isCorrectMatching($pair, $definition, $term) )
529 {
530 $ok = true;
531 }
532 }
533
534 if ($ok)
535 {
536 $template->setCurrentBlock("icon_ok");
537 $template->setVariable("ICON_OK", ilUtil::getImagePath("icon_ok.svg"));
538 $template->setVariable("TEXT_OK", $this->lng->txt("answer_is_right"));
539 $template->parseCurrentBlock();
540 }
541 else
542 {
543 $template->setCurrentBlock("icon_ok");
544 $template->setVariable("ICON_NOT_OK", ilUtil::getImagePath("icon_not_ok.svg"));
545 $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_wrong"));
546 $template->parseCurrentBlock();
547 }
548 }
549 }
550
551 if ($result_output)
552 {
553 $resulttext = ($points == 1) ? "(%s " . $this->lng->txt("point") . ")" : "(%s " . $this->lng->txt("points") . ")";
554 $template->setCurrentBlock("result_output");
555 $template->setVariable("RESULT_OUTPUT", sprintf($resulttext, $points));
556 $template->parseCurrentBlock();
557 }
558
559 $template->setCurrentBlock("row");
560 $template->setVariable("TEXT_MATCHES", $this->lng->txt("matches"));
561 $template->parseCurrentBlock();
562 }
563
564 $questiontext = $this->object->getQuestion();
565 if ($show_question_text==true)
566 {
567 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
568 }
569
570 $questionoutput = $template->get();
571
572 $feedback = '';
573 if($show_feedback)
574 {
575 $fb = $this->getGenericFeedbackOutput($active_id, $pass);
576 $feedback .= strlen($fb) ? $fb : '';
577
578 $fb = $this->getSpecificFeedbackOutput($active_id, $pass);
579 $feedback .= strlen($fb) ? $fb : '';
580 }
581 if (strlen($feedback)) $solutiontemplate->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($feedback, true));
582
583 $solutiontemplate->setVariable("SOLUTION_OUTPUT", $questionoutput);
584
585 $solutionoutput = $solutiontemplate->get();
586 if (!$show_question_only)
587 {
588 // get page object output
589 $solutionoutput = $this->getILIASPage($solutionoutput);
590 }
591 return $solutionoutput;
592 }
assMatchingQuestionGUI\getSpecificFeedbackOutput
getSpecificFeedbackOutput($active_id, $pass)
Returns the answer specific feedback for the question.
Definition: class.assMatchingQuestionGUI.php:1017
assMatchingQuestionGUI\isCorrectMatching
isCorrectMatching($pair, $definition, $term)
Definition: class.assMatchingQuestionGUI.php:1083
assQuestionGUI\getGenericFeedbackOutput
getGenericFeedbackOutput($active_id, $pass)
Returns the answer specific feedback for the question.
Definition: class.assQuestionGUI.php:1109
ilUtil\prepareFormOutput
static prepareFormOutput($a_str, $a_strip=false)
prepares string output for html forms @access public
Definition: class.ilUtil.php:3110

References $ok, $pass, assQuestionGUI\getGenericFeedbackOutput(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), getSpecificFeedbackOutput(), isCorrectMatching(), and ilUtil\prepareFormOutput().

+ Here is the call graph for this function:

◆ getSpecificFeedbackOutput()

assMatchingQuestionGUI::getSpecificFeedbackOutput (   $active_id,
  $pass 
)

Returns the answer specific feedback for the question.

This method should be overwritten by the actual question.

Todo:
Mark this method abstract!
Parameters
integer$active_idActive ID of the user
integer$passActive pass
Returns
string HTML Code with the answer specific feedback @access public

Reimplemented from assQuestionGUI.

Definition at line 1017 of file class.assMatchingQuestionGUI.php.

1018 {
1019 $matches = array_values($this->object->getMaximumScoringMatchingPairs());
1020
1021 if( !$this->object->feedbackOBJ->specificAnswerFeedbackExists($matches) )
1022 {
1023 return '';
1024 }
1025
1026 $feedback = '<table class="test_specific_feedback"><tbody>';
1027
1028 foreach ($matches as $idx => $ans)
1029 {
1030 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
1031 $this->object->getId(), $idx
1032 );
1033 $feedback .= '<tr><td>"' . $ans->definition->text . '"&nbsp;' . $this->lng->txt("matches") . '&nbsp;"';
1034 $feedback .= $ans->term->text . '"</td><td>';
1035 $feedback .= $fb . '</td> </tr>';
1036 }
1037
1038 $feedback .= '</tbody></table>';
1039 return $this->object->prepareTextareaOutput($feedback, TRUE);
1040 }

Referenced by getSolutionOutput().

+ Here is the caller graph for this function:

◆ getTestOutput()

assMatchingQuestionGUI::getTestOutput (   $active_id,
  $pass = NULL,
  $is_postponed = FALSE,
  $user_post_solution = FALSE 
)

Definition at line 766 of file class.assMatchingQuestionGUI.php.

767 {
768 if($GLOBALS['ilBrowser']->isMobile() || $GLOBALS['ilBrowser']->isIpad())
769 {
770 require_once 'Services/jQuery/classes/class.iljQueryUtil.php';
771 iljQueryUtil::initjQuery();
772 iljQueryUtil::initjQueryUI();
773
774 $this->tpl->addJavaScript('./Services/jQuery/js/jquery.ui.touch-punch.min.js');
775 }
776 else
777 {
778 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/jquery-ui-1-10-3-fixed.js');
779 }
780
781 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/ilMatchingQuestion.js');
782 $this->tpl->addCss(ilUtil::getStyleSheetLocation('output', 'test_javascript.css', 'Modules/TestQuestionPool'));
783
784 $template = new ilTemplate("tpl.il_as_qpl_matching_output.html", true, true, "Modules/TestQuestionPool");
785
786 if ($active_id)
787 {
788 $solutions = NULL;
789 include_once "./Modules/Test/classes/class.ilObjTest.php";
790 if (!ilObjTest::_getUsePreviousAnswers($active_id, true))
791 {
792 if (is_null($pass)) $pass = ilObjTest::_getPass($active_id);
793 }
794 if (is_array($user_post_solution))
795 {
796 $solutions = array();
797 foreach ($user_post_solution['matching'][$this->object->getId()] as $definition => $term)
798 {
799 array_push($solutions, array("value1" => $term, "value2" => $definition));
800 }
801 }
802 else
803 {
804 $solutions =& $this->object->getSolutionValues($active_id, $pass);
805 }
806
807 $counter = 0;
808 foreach ($solutions as $idx => $solution_value)
809 {
810 if (($solution_value["value2"] > -1) && ($solution_value["value1"] > -1))
811 {
812 $template->setCurrentBlock("matching_data");
813 $template->setVariable("TERM_ID", $solution_value["value1"]);
814 $template->setVariable("DEFINITION_ID", $solution_value["value2"]);
815 $template->parseCurrentBlock();
816 }
817
818 $counter++;
819 }
820 }
821
822 $terms = $this->object->getTerms();
823 $definitions = $this->object->getDefinitions();
824 switch ($this->object->getShuffle())
825 {
826 case 1:
827 $terms = $this->object->pcArrayShuffle($terms);
828 if (count($solutions))
829 {
830 $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
831 }
832 else
833 {
834 $definitions = $this->object->pcArrayShuffle($definitions);
835 }
836 break;
837 case 2:
838 $terms = $this->object->pcArrayShuffle($terms);
839 break;
840 case 3:
841 if (count($solutions))
842 {
843 $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
844 }
845 else
846 {
847 $definitions = $this->object->pcArrayShuffle($definitions);
848 }
849 break;
850 }
851
852 // create definitions
853 $counter = 0;
854 foreach ($definitions as $definition)
855 {
856 if (strlen($definition->picture))
857 {
858 $template->setCurrentBlock("definition_picture");
859 $template->setVariable("DEFINITION_ID", $definition->identifier);
860 $template->setVariable("IMAGE_HREF", $this->object->getImagePathWeb() . $definition->picture);
861 $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $definition->picture;
862 $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $definition->picture;
863 if (!@file_exists($thumb)) $this->object->rebuildThumbnails();
864 $template->setVariable("THUMBNAIL_HREF", $thumbweb);
865 $template->setVariable("THUMB_ALT", $this->lng->txt("image"));
866 $template->setVariable("THUMB_TITLE", $this->lng->txt("image"));
867 $template->setVariable("TEXT_DEFINITION", (strlen($definition->text)) ? ilUtil::prepareFormOutput($definition->text) : '');
868 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
869 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
870 $template->parseCurrentBlock();
871 }
872 else
873 {
874 $template->setCurrentBlock("definition_text");
875 $template->setVariable("DEFINITION", $this->object->prepareTextareaOutput($definition->text, true));
876 $template->parseCurrentBlock();
877 }
878
879 $template->setCurrentBlock("droparea");
880 $template->setVariable("ID_DROPAREA", $definition->identifier);
881 $template->setVariable("QUESTION_ID", $this->object->getId());
882 $template->parseCurrentBlock();
883
884 $template->setCurrentBlock("definition_data");
885 $template->setVariable("DEFINITION_ID", $definition->identifier);
886 $template->parseCurrentBlock();
887 }
888
889 // create terms
890 $counter = 0;
891 foreach ($terms as $term)
892 {
893 if (strlen($term->picture))
894 {
895 $template->setCurrentBlock("term_picture");
896 $template->setVariable("TERM_ID", $term->identifier);
897 $template->setVariable("IMAGE_HREF", $this->object->getImagePathWeb() . $term->picture);
898 $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $term->picture;
899 $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $term->picture;
900 if (!@file_exists($thumb)) $this->object->rebuildThumbnails();
901 $template->setVariable("THUMBNAIL_HREF", $thumbweb);
902 $template->setVariable("THUMB_ALT", $this->lng->txt("image"));
903 $template->setVariable("THUMB_TITLE", $this->lng->txt("image"));
904 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
905 $template->setVariable("TEXT_TERM", (strlen($term->text)) ? ilUtil::prepareFormOutput($term->text) : '');
906 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
907 $template->parseCurrentBlock();
908 }
909 else
910 {
911 $template->setCurrentBlock("term_text");
912 $template->setVariable("TERM_TEXT", $this->object->prepareTextareaOutput($term->text, true));
913 $template->parseCurrentBlock();
914 }
915 $template->setCurrentBlock("draggable");
916 $template->setVariable("ID_DRAGGABLE", $term->identifier);
917 $template->parseCurrentBlock();
918
919 $template->setCurrentBlock('term_data');
920 $template->setVariable('TERM_ID', $term->identifier);
921 $template->parseCurrentBlock();
922 }
923
924 $template->setVariable('MATCHING_MODE', $this->object->getMatchingMode());
925
926 $template->setVariable("RESET_BUTTON", $this->lng->txt("reset_terms"));
927
928 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($this->object->getQuestion(), TRUE));
929
930 return $this->outQuestionPage("", $is_postponed, $active_id, $template->get());
931 }
assQuestionGUI\outQuestionPage
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="")
output question page
Definition: class.assQuestionGUI.php:312
ilObjTest\_getUsePreviousAnswers
_getUsePreviousAnswers($active_id, $user_active_user_setting=false)
Returns if the previous results should be hidden for a learner.
Definition: class.ilObjTest.php:2936
ilObjTest\_getPass
_getPass($active_id)
Retrieves the actual pass of a given user for a given test.
Definition: class.ilObjTest.php:8204

References $GLOBALS, $pass, ilObjTest\_getPass(), ilObjTest\_getUsePreviousAnswers(), ilUtil\getImagePath(), ilUtil\getStyleSheetLocation(), iljQueryUtil\initjQuery(), iljQueryUtil\initjQueryUI(), assQuestionGUI\outQuestionPage(), and ilUtil\prepareFormOutput().

+ Here is the call graph for this function:

◆ isCorrectMatching()

assMatchingQuestionGUI::isCorrectMatching (   $pair,
  $definition,
  $term 
)
private

Definition at line 1083 of file class.assMatchingQuestionGUI.php.

1084 {
1085 if( !($pair->points > 0) )
1086 {
1087 return false;
1088 }
1089
1090 if( !is_object($term) )
1091 {
1092 return false;
1093 }
1094
1095 if( $pair->definition->identifier != $definition->identifier )
1096 {
1097 return false;
1098 }
1099
1100 if( $pair->term->identifier != $term->identifier )
1101 {
1102 return false;
1103 }
1104
1105 return true;
1106 }

Referenced by getSolutionOutput().

+ Here is the caller graph for this function:

◆ isValidTermAndDefinitionAmount()

assMatchingQuestionGUI::isValidTermAndDefinitionAmount ( ilPropertyFormGUI  $form)
private

for mode 1:1 terms count must not be less than definitions count for mode n:n this limitation is cancelled

Parameters
ilPropertyFormGUI$form
Returns
bool

Definition at line 279 of file class.assMatchingQuestionGUI.php.

280 {
281 $matchingMode = $form->getItemByPostVar('matching_mode')->getValue();
282
283 if( $matchingMode == assMatchingQuestion::MATCHING_MODE_N_ON_N )
284 {
285 return true;
286 }
287
288 $numTerms = count($form->getItemByPostVar('terms')->getValues());
289 $numDefinitions = count($form->getItemByPostVar('definitions')->getValues());
290
291 if($numTerms >= $numDefinitions)
292 {
293 return true;
294 }
295
296 return false;
297 }
ilPropertyFormGUI\getItemByPostVar
getItemByPostVar($a_post_var)
Get Item by POST variable.
Definition: class.ilPropertyFormGUI.php:277

References ilPropertyFormGUI\getItemByPostVar(), and assMatchingQuestion\MATCHING_MODE_N_ON_N.

Referenced by editQuestion().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateAnswerSpecificFormPart()

assMatchingQuestionGUI::populateAnswerSpecificFormPart ( \ilPropertyFormGUI  $form)

Definition at line 299 of file class.assMatchingQuestionGUI.php.

300 {
301 // Definitions
302 include_once "./Modules/TestQuestionPool/classes/class.ilMatchingWizardInputGUI.php";
303 $definitions = new ilMatchingWizardInputGUI($this->lng->txt( "definitions" ), "definitions");
304 if ($this->object->getSelfAssessmentEditingMode())
305 {
306 $definitions->setHideImages( true );
307 }
308
309 $definitions->setRequired( true );
310 $definitions->setQuestionObject( $this->object );
311 $definitions->setTextName( $this->lng->txt( 'definition_text' ) );
312 $definitions->setImageName( $this->lng->txt( 'definition_image' ) );
313 include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatchingDefinition.php";
314 if (!count( $this->object->getDefinitions() ))
315 {
316 $this->object->addDefinition( new assAnswerMatchingDefinition() );
317 }
318 $definitionvalues = $this->object->getDefinitions();
319 $definitions->setValues( $definitionvalues );
320 $definitions->checkInput();
321 $form->addItem( $definitions );
322
323 // Terms
324 include_once "./Modules/TestQuestionPool/classes/class.ilMatchingWizardInputGUI.php";
325 $terms = new ilMatchingWizardInputGUI($this->lng->txt( "terms" ), "terms");
326 if ($this->object->getSelfAssessmentEditingMode())
327 $terms->setHideImages( true );
328 $terms->setRequired( true );
329 $terms->setQuestionObject( $this->object );
330 $terms->setTextName( $this->lng->txt( 'term_text' ) );
331 $terms->setImageName( $this->lng->txt( 'term_image' ) );
332 include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatchingTerm.php";
333 if (!count( $this->object->getTerms() ))
334 $this->object->addTerm( new assAnswerMatchingTerm() );
335 $termvalues = $this->object->getTerms();
336 $terms->setValues( $termvalues );
337 $terms->checkInput();
338 $form->addItem( $terms );
339
340 // Matching Pairs
341 include_once "./Modules/TestQuestionPool/classes/class.ilMatchingPairWizardInputGUI.php";
342 $pairs = new ilMatchingPairWizardInputGUI($this->lng->txt( 'matching_pairs' ), 'pairs');
343 $pairs->setRequired( true );
344 $pairs->setTerms( $this->object->getTerms() );
345 $pairs->setDefinitions( $this->object->getDefinitions() );
346 include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatchingPair.php";
347 if (count( $this->object->getMatchingPairs() ) == 0)
348 {
349 $this->object->addMatchingPair( new assAnswerMatchingPair($termvalues[0], $definitionvalues[0], 0) );
350 }
351 $pairs->setPairs( $this->object->getMatchingPairs() );
352 $form->addItem( $pairs );
353
354 return $form;
355 }
assAnswerMatchingDefinition
Class for matching question definitions.
Definition: class.assAnswerMatchingDefinition.php:14
assAnswerMatchingPair
Class for matching question pairs.
Definition: class.assAnswerMatchingPair.php:12
assAnswerMatchingTerm
Class for matching question terms.
Definition: class.assAnswerMatchingTerm.php:12
ilMatchingPairWizardInputGUI
This class represents a key value pair wizard property in a property form.
Definition: class.ilMatchingPairWizardInputGUI.php:14
ilMatchingWizardInputGUI
This class represents a single choice wizard property in a property form.
Definition: class.ilMatchingWizardInputGUI.php:18

References ilPropertyFormGUI\addItem().

Referenced by editQuestion().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateQuestionSpecificFormPart()

assMatchingQuestionGUI::populateQuestionSpecificFormPart ( \ilPropertyFormGUI  $form)

Definition at line 357 of file class.assMatchingQuestionGUI.php.

358 {
359 // Edit mode
360 $hidden = new ilHiddenInputGUI("matching_type");
361 $hidden->setValue($matchingtype);
362 $form->addItem($hidden);
363
364 if (!$this->object->getSelfAssessmentEditingMode())
365 {
366 // shuffle
367 $shuffle = new ilSelectInputGUI($this->lng->txt( "shuffle_answers" ), "shuffle");
368 $shuffle_options = array(
369 0 => $this->lng->txt( "no" ),
370 1 => $this->lng->txt( "matching_shuffle_terms_definitions" ),
371 2 => $this->lng->txt( "matching_shuffle_terms" ),
372 3 => $this->lng->txt( "matching_shuffle_definitions" )
373 );
374 $shuffle->setOptions( $shuffle_options );
375 $shuffle->setValue($this->object->getShuffle() != null ? $this->object->getShuffle() : 1);
376 $shuffle->setRequired( FALSE );
377 $form->addItem( $shuffle );
378
379 $geometry = new ilNumberInputGUI($this->lng->txt( "thumb_geometry" ), "thumb_geometry");
380 $geometry->setValue( $this->object->getThumbGeometry() );
381 $geometry->setRequired( true );
382 $geometry->setMaxLength( 6 );
383 $geometry->setMinValue( 20 );
384 $geometry->setSize( 6 );
385 $geometry->setInfo( $this->lng->txt( "thumb_geometry_info" ) );
386 $form->addItem( $geometry );
387 }
388
389 // Matching Mode
390 $mode = new ilRadioGroupInputGUI($this->lng->txt('qpl_qst_inp_matching_mode'), 'matching_mode');
391 $mode->setRequired(true);
392
393 $modeONEonONE = new ilRadioOption(
394 $this->lng->txt('qpl_qst_inp_matching_mode_one_on_one'), assMatchingQuestion::MATCHING_MODE_1_ON_1
395 );
396 $mode->addOption($modeONEonONE);
397
398 $modeALLonALL = new ilRadioOption(
399 $this->lng->txt('qpl_qst_inp_matching_mode_all_on_all'), assMatchingQuestion::MATCHING_MODE_N_ON_N
400 );
401 $mode->addOption($modeALLonALL);
402
403 $mode->setValue($this->object->getMatchingMode());
404
405 $form->addItem($mode);
406 }
ilHiddenInputGUI
This class represents a hidden form property in a property form.
Definition: class.ilHiddenInputGUI.php:32
ilNumberInputGUI
This class represents a number property in a property form.
Definition: class.ilNumberInputGUI.php:15
ilRadioGroupInputGUI
This class represents a property in a property form.
Definition: class.ilRadioGroupInputGUI.php:34
ilRadioOption
This class represents an option in a radio group.
Definition: class.ilRadioOption.php:32
ilSelectInputGUI
This class represents a selection list property in a property form.
Definition: class.ilSelectInputGUI.php:18

References ilPropertyFormGUI\addItem(), assMatchingQuestion\MATCHING_MODE_1_ON_1, and assMatchingQuestion\MATCHING_MODE_N_ON_N.

Referenced by editQuestion().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ removedefinitions()

assMatchingQuestionGUI::removedefinitions ( )

Definition at line 207 of file class.assMatchingQuestionGUI.php.

208 {
209 $this->writePostData();
210 $position = key($_POST["cmd"]["removedefinitions"]);
211 $this->object->deleteDefinition($position);
212 $this->editQuestion();
213 }

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ removeimagedefinitions()

assMatchingQuestionGUI::removeimagedefinitions ( )

Definition at line 175 of file class.assMatchingQuestionGUI.php.

176 {
177 $this->writePostData(true);
178 $position = key($_POST['cmd']['removeimagedefinitions']);
179 $this->object->removeDefinitionImage($position);
180 $this->editQuestion();
181 }

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ removeimageterms()

assMatchingQuestionGUI::removeimageterms ( )

Definition at line 161 of file class.assMatchingQuestionGUI.php.

162 {
163 $this->writePostData(true);
164 $position = key($_POST['cmd']['removeimageterms']);
165 $this->object->removeTermImage($position);
166 $this->editQuestion();
167 }

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ removepairs()

assMatchingQuestionGUI::removepairs ( )

Definition at line 223 of file class.assMatchingQuestionGUI.php.

224 {
225 $this->writePostData();
226 $position = key($_POST["cmd"]["removepairs"]);
227 $this->object->deleteMatchingPair($position);
228 $this->editQuestion();
229 }

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ removeterms()

assMatchingQuestionGUI::removeterms ( )

Definition at line 191 of file class.assMatchingQuestionGUI.php.

192 {
193 $this->writePostData();
194 $position = key($_POST["cmd"]["removeterms"]);
195 $this->object->deleteTerm($position);
196 $this->editQuestion();
197 }

References $_POST, editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ setQuestionTabs()

assMatchingQuestionGUI::setQuestionTabs ( )

Sets the ILIAS tabs for this question type.

@access public

Todo:
: MOVE THIS STEPS TO COMMON QUESTION CLASS assQuestionGUI

Reimplemented from assQuestionGUI.

Definition at line 952 of file class.assMatchingQuestionGUI.php.

953 {
954 global $rbacsystem, $ilTabs;
955
956 $ilTabs->clearTargets();
957
958 $this->ctrl->setParameterByClass("ilAssQuestionPageGUI", "q_id", $_GET["q_id"]);
959 include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
960 $q_type = $this->object->getQuestionType();
961
962 if (strlen($q_type))
963 {
964 $classname = $q_type . "GUI";
965 $this->ctrl->setParameterByClass(strtolower($classname), "sel_question_types", $q_type);
966 $this->ctrl->setParameterByClass(strtolower($classname), "q_id", $_GET["q_id"]);
967 }
968
969 if ($_GET["q_id"])
970 {
971 if ($rbacsystem->checkAccess('write', $_GET["ref_id"]))
972 {
973 // edit page
974 $ilTabs->addTarget("edit_page",
975 $this->ctrl->getLinkTargetByClass("ilAssQuestionPageGUI", "edit"),
976 array("edit", "insert", "exec_pg"),
977 "", "", $force_active);
978 }
979
980 $this->addTab_QuestionPreview($ilTabs);
981 }
982
983 $force_active = false;
984 if ($rbacsystem->checkAccess('write', $_GET["ref_id"]))
985 {
986 $url = "";
987 if ($classname) $url = $this->ctrl->getLinkTargetByClass($classname, "editQuestion");
988 // edit question properties
989 $ilTabs->addTarget("edit_question",
990 $url,
991 array("editQuestion", "save", "saveEdit", "removeimageterms", "uploadterms", "removeimagedefinitions", "uploaddefinitions",
992 "addpairs", "removepairs", "addterms", "removeterms", "adddefinitions", "removedefinitions", "originalSyncForm"),
993 $classname, "", $force_active);
994 }
995
996 // add tab for question feedback within common class assQuestionGUI
997 $this->addTab_QuestionFeedback($ilTabs);
998
999 // add tab for question hint within common class assQuestionGUI
1000 $this->addTab_QuestionHints($ilTabs);
1001
1002 // add tab for question's suggested solution within common class assQuestionGUI
1003 $this->addTab_SuggestedSolution($ilTabs, $classname);
1004
1005 // Assessment of questions sub menu entry
1006 if ($_GET["q_id"])
1007 {
1008 $ilTabs->addTarget("statistics",
1009 $this->ctrl->getLinkTargetByClass($classname, "assessment"),
1010 array("assessment"),
1011 $classname, "");
1012 }
1013
1014 $this->addBackTab($ilTabs);
1015 }
$_GET
$_GET["client_id"]
Definition: cfg.phpunit.template.php:12
assQuestionGUI\addTab_QuestionHints
addTab_QuestionHints(ilTabsGUI $tabs)
adds the hints tab to ilTabsGUI
Definition: class.assQuestionGUI.php:1853
assQuestionGUI\addTab_SuggestedSolution
addTab_SuggestedSolution(ilTabsGUI $tabs, $classname)
Definition: class.assQuestionGUI.php:1786
assQuestionGUI\addBackTab
addBackTab(ilTabsGUI $ilTabs)
Definition: class.assQuestionGUI.php:1968
assQuestionGUI\addTab_QuestionFeedback
addTab_QuestionFeedback(ilTabsGUI $tabs)
adds the feedback tab to ilTabsGUI
Definition: class.assQuestionGUI.php:1822
assQuestionGUI\addTab_QuestionPreview
addTab_QuestionPreview(ilTabsGUI $tabsGUI)
Definition: class.assQuestionGUI.php:1882

References $_GET, assQuestionGUI\addBackTab(), assQuestionGUI\addTab_QuestionFeedback(), assQuestionGUI\addTab_QuestionHints(), assQuestionGUI\addTab_QuestionPreview(), and assQuestionGUI\addTab_SuggestedSolution().

+ Here is the call graph for this function:

◆ uploaddefinitions()

assMatchingQuestionGUI::uploaddefinitions ( )

Definition at line 169 of file class.assMatchingQuestionGUI.php.

170 {
171 $this->writePostData(true);
172 $this->editQuestion();
173 }

References editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ uploadterms()

assMatchingQuestionGUI::uploadterms ( )

Definition at line 155 of file class.assMatchingQuestionGUI.php.

156 {
157 $this->writePostData(true);
158 $this->editQuestion();
159 }

References editQuestion(), and assQuestionGUI\writePostData().

+ Here is the call graph for this function:

◆ writeAnswerSpecificPostData()

assMatchingQuestionGUI::writeAnswerSpecificPostData ( ilPropertyFormGUI  $form)

Extracts the answer specific values from $_POST and applies them to the data object.

Parameters
bool$alwaysIf true, a check for form validity is omitted.
Returns
void

Implements ilGuiAnswerScoringAdjustable.

Definition at line 68 of file class.assMatchingQuestionGUI.php.

69 {
70 // Delete all existing answers and create new answers from the form data
71 $this->object->flushMatchingPairs();
72 $this->object->flushTerms();
73 $this->object->flushDefinitions();
74
75 // add terms
76 require_once './Modules/TestQuestionPool/classes/class.assAnswerMatchingTerm.php';
77 foreach ($_POST['terms']['answer'] as $index => $answer)
78 {
79 $filename = $_POST['terms']['imagename'][$index];
80 if (strlen( $_FILES['terms']['name']['image'][$index] ))
81 {
82 // upload the new file
83 $name = $_FILES['terms']['name']['image'][$index];
84 if ($this->object->setImageFile( $_FILES['terms']['tmp_name']['image'][$index],
85 $this->object->getEncryptedFilename( $name )
86 )
87 )
88 {
89 $filename = $this->object->getEncryptedFilename( $name );
90 }
91 else
92 {
93 $filename = "";
94 }
95 }
96 $this->object->addTerm( new assAnswerMatchingTerm($answer, $filename, $_POST['terms']['identifier'][$index])
97 );
98 }
99 // add definitions
100 require_once './Modules/TestQuestionPool/classes/class.assAnswerMatchingDefinition.php';
101 foreach ($_POST['definitions']['answer'] as $index => $answer)
102 {
103 $filename = $_POST['definitions']['imagename'][$index];
104 if (strlen( $_FILES['definitions']['name']['image'][$index] ))
105 {
106 // upload the new file
107 $name = $_FILES['definitions']['name']['image'][$index];
108 if ($this->object->setImageFile( $_FILES['definitions']['tmp_name']['image'][$index],
109 $this->object->getEncryptedFilename( $name )
110 )
111 )
112 {
113 $filename = $this->object->getEncryptedFilename( $name );
114 }
115 else
116 {
117 $filename = "";
118 }
119 }
120 $this->object->addDefinition(
121 new assAnswerMatchingDefinition($answer, $filename, $_POST['definitions']['identifier'][$index])
122 );
123 }
124
125 // add matching pairs
126 if (is_array( $_POST['pairs']['points'] ))
127 {
128 require_once './Modules/TestQuestionPool/classes/class.assAnswerMatchingPair.php';
129 foreach ($_POST['pairs']['points'] as $index => $points)
130 {
131 $term_id = $_POST['pairs']['term'][$index];
132 $definition_id = $_POST['pairs']['definition'][$index];
133 $this->object->addMatchingPair( $this->object->getTermWithIdentifier( $term_id ),
134 $this->object->getDefinitionWithIdentifier( $definition_id ),
135 $points
136 );
137 }
138 }
139 }
$filename
$filename
Definition: buildRTE.php:89

References $_POST, and $filename.

Referenced by writePostData().

+ Here is the caller graph for this function:

◆ writePostData()

assMatchingQuestionGUI::writePostData (   $always = false)

Evaluates a posted edit form and writes the form data in the question object.

Parameters
bool$always
Returns
integer A positive value, if one of the required fields wasn't set, else 0

Definition at line 53 of file class.assMatchingQuestionGUI.php.

54 {
55 $hasErrors = (!$always) ? $this->editQuestion(true) : false;
56 if (!$hasErrors)
57 {
58 require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
59 $this->writeQuestionGenericPostData();
60 $this->writeQuestionSpecificPostData(new ilPropertyFormGUI());
61 $this->writeAnswerSpecificPostData(new ilPropertyFormGUI());
62 $this->saveTaxonomyAssignments();
63 return 0;
64 }
65 return 1;
66 }
assMatchingQuestionGUI\writeQuestionSpecificPostData
writeQuestionSpecificPostData(ilPropertyFormGUI $form)
Extracts the question specific values from $_POST and applies them to the data object.
Definition: class.assMatchingQuestionGUI.php:141
assMatchingQuestionGUI\writeAnswerSpecificPostData
writeAnswerSpecificPostData(ilPropertyFormGUI $form)
Extracts the answer specific values from $_POST and applies them to the data object.
Definition: class.assMatchingQuestionGUI.php:68

References editQuestion(), assQuestionGUI\saveTaxonomyAssignments(), writeAnswerSpecificPostData(), assQuestionGUI\writeQuestionGenericPostData(), and writeQuestionSpecificPostData().

+ Here is the call graph for this function:

◆ writeQuestionSpecificPostData()

assMatchingQuestionGUI::writeQuestionSpecificPostData ( ilPropertyFormGUI  $form)

Extracts the question specific values from $_POST and applies them to the data object.

Parameters
bool$alwaysIf true, a check for form validity is omitted.
Returns
void

Implements ilGuiQuestionScoringAdjustable.

Definition at line 141 of file class.assMatchingQuestionGUI.php.

142 {
143 if (!$this->object->getSelfAssessmentEditingMode())
144 {
145 $this->object->setShuffle( $_POST["shuffle"] );
146 }
147 else
148 {
149 $this->object->setShuffle( 1 );
150 }
151 $this->object->setThumbGeometry( $_POST["thumb_geometry"] );
152 $this->object->setMatchingMode($_POST['matching_mode']);
153 }

References $_POST.

Referenced by writePostData().

+ Here is the caller graph for this function:
The documentation for this class was generated from the following file: