ILIAS  release_5-3 Revision v5.3.23-19-g915713cf615
assMatchingQuestionGUI Class Reference

Matching question GUI representation. More...

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

Public Member Functions

 __construct ($id=-1)
 assMatchingQuestionGUI constructor 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, $is_postponed=false, $user_post_solution=false, $inlineFeedback=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...
 
 getPresentationContext ()
 
 setPresentationContext ($presentationContext)
 
 isTestPresentationContext ()
 
 isPreviousSolutionPrefilled ()
 
 setPreviousSolutionPrefilled ($previousSolutionPrefilled)
 
 getRenderPurpose ()
 
 setRenderPurpose ($renderPurpose)
 
 isRenderPurposePrintPdf ()
 
 isRenderPurposePreview ()
 
 isRenderPurposeInputValue ()
 
 isRenderPurposePlayback ()
 
 isRenderPurposeDemoplay ()
 
 renderPurposeSupportsFormHtml ()
 
 getEditContext ()
 
 setEditContext ($editContext)
 
 isAuthoringEditContext ()
 
 isAdjustmentEditContext ()
 
 setAdjustmentEditContext ()
 
 getNavigationGUI ()
 
 setNavigationGUI ($navigationGUI)
 
 setTaxonomyIds ($taxonomyIds)
 
 getTaxonomyIds ()
 
 setTargetGui ($linkTargetGui)
 
 setTargetGuiClass ($targetGuiClass)
 
 getTargetGuiClass ()
 
 setQuestionHeaderBlockBuilder ($questionHeaderBlockBuilder)
 
 getQuestionHeaderBlockBuilder ()
 
 setQuestionActionCmd ($questionActionCmd)
 
 getQuestionActionCmd ()
 
createQuestionGUI ($question_type, $question_id=-1)
 Creates a question gui representation. More...
 
 populateJavascriptFilesRequiredForWorkForm (ilTemplate $tpl)
 
 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...
 
 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, $is_question_postponed=false, $user_post_solutions=false, $show_specific_inline_feedback=false)
 
 magicAfterTestOutput ()
 
 getTestOutput ( $active_id, $pass, $is_question_postponed, $user_post_solutions, $show_specific_inline_feedback)
 
 getFormEncodingType ()
 
 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...
 

Protected Member Functions

 writePostData ($always=false)
 {Evaluates a posted edit form and writes the form data in the question object.
Returns
integer A positive value, if one of the required fields wasn't set, else 0
} More...
 
- Protected Member Functions inherited from assQuestionGUI
 writePostData ($always=false)
 Evaluates a posted edit form and writes the form data in the question object. More...
 
 renderEditForm ($form)
 
 getUseUnchangedAnswerCheckboxHtml ()
 
 getPreviousSolutionProvidedMessage ()
 
 getPreviousSolutionConfirmationCheckboxHtml ()
 
 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)
 
 hasCorrectSolution ($activeId, $passIndex)
 
 writeQuestionGenericPostData ()
 
 completeTestOutputFormAction ($formAction, $active_id, $pass)
 
 addBackTab (ilTabsGUI $ilTabs)
 
 buildBasicEditFormObject ()
 
 buildEditForm ()
 

Private Member Functions

 isDefImgUploadCommand ()
 
 isTermImgUploadCommand ()
 
 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 _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...
 
static _getGUIClassNameForId ($a_q_id)
 
static _getClassNameForQType ($q_type)
 
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...
 
const PRESENTATION_CONTEXT_TEST = 'pContextTest'
 
const PRESENTATION_CONTEXT_RESULTS = 'pContextResults'
 
const RENDER_PURPOSE_PLAYBACK = 'renderPurposePlayback'
 
const RENDER_PURPOSE_DEMOPLAY = 'renderPurposeDemoplay'
 
const RENDER_PURPOSE_PREVIEW = 'renderPurposePreview'
 
const RENDER_PURPOSE_PRINT_PDF = 'renderPurposePrintPdf'
 
const RENDER_PURPOSE_INPUT_VALUE = 'renderPurposeInputValue'
 
const EDIT_CONTEXT_AUTHORING = 'authoring'
 
const EDIT_CONTEXT_ADJUSTMENT = 'adjustment'
 
- Protected Attributes inherited from assQuestionGUI
 $editForm
 

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$

@ilCtrl_Calls assMatchingQuestionGUI: ilFormPropertyDispatchGUI

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
integer$idThe database id of a image map question object
Returns
\assMatchingQuestionGUI

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

36 {
37 parent::__construct();
38 include_once "./Modules/TestQuestionPool/classes/class.assMatchingQuestion.php";
39 $this->object = new assMatchingQuestion();
40 $this->setErrorMessage($this->lng->txt("msg_form_save_error"));
41 if ($id >= 0) {
42 $this->object->loadFromDb($id);
43 }
44 }
Class for matching questions.
setErrorMessage($errormessage)
if(!array_key_exists('StateId', $_REQUEST)) $id

References $id, and assQuestionGUI\setErrorMessage().

+ Here is the call graph for this function:

Member Function Documentation

◆ adddefinitions()

assMatchingQuestionGUI::adddefinitions ( )

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

184 {
185 $this->writePostData();
186 $position = key($_POST["cmd"]["adddefinitions"]);
187 $this->object->insertDefinition($position+1);
188 $this->editQuestion();
189 }
$_POST["username"]
writePostData($always=false)
{Evaluates a posted edit form and writes the form data in the question object.integer A positive valu...

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

+ Here is the call graph for this function:

◆ addpairs()

assMatchingQuestionGUI::addpairs ( )

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

200 {
201 $this->writePostData();
202 $position = key($_POST["cmd"]["addpairs"]);
203 $this->object->insertMatchingPair($position+1);
204 $this->editQuestion();
205 }

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

+ Here is the call graph for this function:

◆ addterms()

assMatchingQuestionGUI::addterms ( )

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

168 {
169 $this->writePostData();
170 $position = key($_POST["cmd"]["addterms"]);
171 $this->object->insertTerm($position+1);
172 $this->editQuestion();
173 }

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

+ Here is the call graph for this function:

◆ checkInput()

assMatchingQuestionGUI::checkInput ( )

check input fields

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

902 {
903 if ((!$_POST["title"]) or (!$_POST["author"]) or (!$_POST["question"])) {
904 return false;
905 }
906 return true;
907 }

References $_POST.

◆ editQuestion()

assMatchingQuestionGUI::editQuestion (   $checkonly = false)

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

216 {
217 $save = $this->isSaveCommand();
218 $this->getQuestionTemplate();
219
220 include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
221 $form = new ilPropertyFormGUI();
222 $this->editForm = $form;
223
224 $form->setFormAction($this->ctrl->getFormAction($this));
225 $form->setTitle($this->outQuestionType());
226 $form->setMultipart(true);
227 $form->setTableWidth("100%");
228 $form->setId("matching");
229
230
231 // title, author, description, question, working time (assessment mode)
237
238 $errors = false;
239 if ($save) {
240 $form->setValuesByPost();
241 $errors = !$form->checkInput();
242 $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
243 if (!$errors && !$this->isValidTermAndDefinitionAmount($form) && !$this->object->getSelfAssessmentEditingMode()) {
244 $errors = true;
245 $terms = $form->getItemByPostVar('terms');
246 $terms->setAlert($this->lng->txt("msg_number_of_terms_too_low"));
247 ilUtil::sendFailure($this->lng->txt('form_input_not_valid'));
248 }
249 if ($errors) {
250 $checkonly = false;
251 }
252 }
253
254 if (!$checkonly) {
255 $this->tpl->setVariable("QUESTION_DATA", $form->getHTML());
256 }
257 return $errors;
258 }
isValidTermAndDefinitionAmount(ilPropertyFormGUI $form)
for mode 1:1 terms count must not be less than definitions count for mode n:n this limitation is canc...
populateAnswerSpecificFormPart(\ilPropertyFormGUI $form)
populateQuestionSpecificFormPart(\ilPropertyFormGUI $form)
populateTaxonomyFormSection(ilPropertyFormGUI $form)
addQuestionFormCommandButtons($form)
Add the command buttons of a question properties form.
getQuestionTemplate()
get question template
addBasicQuestionFormProperties($form)
Add basic question form properties: assessment: title, author, description, question,...
This class represents a property form user interface.
static sendFailure($a_info="", $a_keep=false)
Send Failure Message to Screen.
$errors
Definition: index.php:6
if(isset($_POST['submit'])) $form

References $errors, $form, 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 1040 of file class.assMatchingQuestionGUI.php.

1041 {
1042 return array();
1043 }

◆ 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 1054 of file class.assMatchingQuestionGUI.php.

1055 {
1056 return array();
1057 }

◆ 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 1067 of file class.assMatchingQuestionGUI.php.

1068 {
1069 return ''; //print_r($relevant_answers,true);
1070 }

◆ getPreview()

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

Reimplemented from assQuestionGUI.

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

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

References $counter, $GLOBALS, $template, 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.

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

References $i, $ok, $pass, $template, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_CORRECT, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_WRONG, assQuestionGUI\getGenericFeedbackOutput(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), getSpecificFeedbackOutput(), assQuestionGUI\hasCorrectSolution(), isCorrectMatching(), assQuestionGUI\isTestPresentationContext(), ilUtil\prepareFormOutput(), ilWACSignedPath\signFile(), and sprintf.

+ 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 989 of file class.assMatchingQuestionGUI.php.

990 {
991 $userSolution = $this->object->fetchIndexedValuesFromValuePairs(
992 $this->object->getSolutionValues($active_id, $pass)
993 );
994
995 $matches = array_values($this->object->matchingpairs);
996
997 if (!$this->object->feedbackOBJ->specificAnswerFeedbackExists($matches)) {
998 return '';
999 }
1000
1001 $feedback = '<table class="test_specific_feedback"><tbody>';
1002
1003 foreach ($matches as $idx => $ans) {
1004 if ($active_id) {
1005 if (!isset($userSolution[$ans->definition->identifier])) {
1006 continue;
1007 }
1008
1009 if (!is_array($userSolution[$ans->definition->identifier])) {
1010 continue;
1011 }
1012
1013 if (!in_array($ans->term->identifier, $userSolution[$ans->definition->identifier])) {
1014 continue;
1015 }
1016 }
1017
1018 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
1019 $this->object->getId(),
1020 $idx
1021 );
1022 $feedback .= '<tr><td>"' . $ans->definition->text . '"&nbsp;' . $this->lng->txt("matches") . '&nbsp;"';
1023 $feedback .= $ans->term->text . '"</td><td>';
1024 $feedback .= $fb . '</td> </tr>';
1025 }
1026
1027 $feedback .= '</tbody></table>';
1028 return $this->object->prepareTextareaOutput($feedback, true);
1029 }

References $pass.

Referenced by getSolutionOutput().

+ Here is the caller graph for this function:

◆ getTestOutput()

assMatchingQuestionGUI::getTestOutput (   $active_id,
  $pass,
  $is_postponed = false,
  $user_post_solution = false,
  $inlineFeedback = false 
)

Reimplemented from assQuestionGUI.

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

747 {
748 if ($GLOBALS['ilBrowser']->isMobile() || $GLOBALS['ilBrowser']->isIpad()) {
749 require_once 'Services/jQuery/classes/class.iljQueryUtil.php';
752 $this->tpl->addJavaScript('./libs/bower/bower_components/jqueryui-touch-punch/jquery.ui.touch-punch.min.js');
753 } else {
754 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/jquery-ui-1-10-3-fixed.js');
755 }
756 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/ilMatchingQuestion.js');
757 $this->tpl->addCss(ilUtil::getStyleSheetLocation('output', 'test_javascript.css', 'Modules/TestQuestionPool'));
758
759 $template = new ilTemplate("tpl.il_as_qpl_matching_output.html", true, true, "Modules/TestQuestionPool");
760
761 if ($active_id) {
762 // hey: prevPassSolutions - obsolete due to central check
763 #$solutions = NULL;
764 #include_once "./Modules/Test/classes/class.ilObjTest.php";
765 #if (!ilObjTest::_getUsePreviousAnswers($active_id, true))
766 #{
767 # if (is_null($pass)) $pass = ilObjTest::_getPass($active_id);
768 #}
769 // hey.
770 if (is_array($user_post_solution)) {
771 $solutions = array();
772 foreach ($user_post_solution['matching'][$this->object->getId()] as $definition => $term) {
773 array_push($solutions, array("value1" => $term, "value2" => $definition));
774 }
775 } else {
776 // hey: prevPassSolutions - obsolete due to central check
777 $solutions = $this->object->getTestOutputSolutions($active_id, $pass);
778 // hey.
779 }
780
781 $counter = 0;
782 foreach ($solutions as $idx => $solution_value) {
783 if (($solution_value["value2"] > -1) && ($solution_value["value1"] > -1)) {
784 $template->setCurrentBlock("matching_data");
785 $template->setVariable("TERM_ID", $solution_value["value1"]);
786 $template->setVariable("DEFINITION_ID", $solution_value["value2"]);
787 $template->parseCurrentBlock();
788 }
789
790 $counter++;
791 }
792 }
793
794 $terms = $this->object->getTerms();
795 $definitions = $this->object->getDefinitions();
796 switch ($this->object->getShuffle()) {
797 case 1:
798 $seed = $this->object->getShuffler()->getSeed();
799 $this->object->getShuffler()->setSeed($seed . '1');
800 $terms = $this->object->getShuffler()->shuffle($terms);
801 if (count($solutions)) {
802 $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
803 } else {
804 $this->object->getShuffler()->setSeed($seed . '2');
805 $definitions = $this->object->getShuffler()->shuffle($definitions);
806 }
807 $this->object->getShuffler()->setSeed($seed);
808 break;
809 case 2:
810 $terms = $this->object->getShuffler()->shuffle($terms);
811 break;
812 case 3:
813 if (count($solutions)) {
814 $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
815 } else {
816 $definitions = $this->object->getShuffler()->shuffle($definitions);
817 }
818 break;
819 }
820
821 // create definitions
822 $counter = 0;
823 foreach ($definitions as $definition) {
824 if (strlen($definition->picture)) {
825 $template->setCurrentBlock("definition_picture");
826 $template->setVariable("DEFINITION_ID", $definition->identifier);
827 $template->setVariable("IMAGE_HREF", $this->object->getImagePathWeb() . $definition->picture);
828 $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $definition->picture;
829 $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $definition->picture;
830 if (!@file_exists($thumb)) {
831 $this->object->rebuildThumbnails();
832 }
833 $template->setVariable("THUMBNAIL_HREF", $thumbweb);
834 $template->setVariable("THUMB_ALT", $this->lng->txt("image"));
835 $template->setVariable("THUMB_TITLE", $this->lng->txt("image"));
836 $template->setVariable("TEXT_DEFINITION", (strlen($definition->text)) ? $this->object->prepareTextareaOutput($definition->text, true, true) : '');
837 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
838 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
839 $template->parseCurrentBlock();
840 } else {
841 $template->setCurrentBlock("definition_text");
842 $template->setVariable("DEFINITION", $this->object->prepareTextareaOutput($definition->text, true, true));
843 $template->parseCurrentBlock();
844 }
845
846 $template->setCurrentBlock("droparea");
847 $template->setVariable("ID_DROPAREA", $definition->identifier);
848 $template->setVariable("QUESTION_ID", $this->object->getId());
849 $template->parseCurrentBlock();
850
851 $template->setCurrentBlock("definition_data");
852 $template->setVariable("DEFINITION_ID", $definition->identifier);
853 $template->parseCurrentBlock();
854 }
855
856 // create terms
857 $counter = 0;
858 foreach ($terms as $term) {
859 if (strlen($term->picture)) {
860 $template->setCurrentBlock("term_picture");
861 $template->setVariable("TERM_ID", $term->identifier);
862 $template->setVariable("IMAGE_HREF", $this->object->getImagePathWeb() . $term->picture);
863 $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $term->picture;
864 $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $term->picture;
865 if (!@file_exists($thumb)) {
866 $this->object->rebuildThumbnails();
867 }
868 $template->setVariable("THUMBNAIL_HREF", $thumbweb);
869 $template->setVariable("THUMB_ALT", $this->lng->txt("image"));
870 $template->setVariable("THUMB_TITLE", $this->lng->txt("image"));
871 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
872 $template->setVariable("TEXT_TERM", (strlen($term->text)) ? $this->object->prepareTextareaOutput($term->text, true, true) : '');
873 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
874 $template->parseCurrentBlock();
875 } else {
876 $template->setCurrentBlock("term_text");
877 $template->setVariable("TERM_TEXT", $this->object->prepareTextareaOutput($term->text, true, true));
878 $template->parseCurrentBlock();
879 }
880 $template->setCurrentBlock("draggable");
881 $template->setVariable("ID_DRAGGABLE", $term->identifier);
882 $template->parseCurrentBlock();
883
884 $template->setCurrentBlock('term_data');
885 $template->setVariable('TERM_ID', $term->identifier);
886 $template->parseCurrentBlock();
887 }
888
889 $template->setVariable('MATCHING_MODE', $this->object->getMatchingMode());
890
891 $template->setVariable("RESET_BUTTON", $this->lng->txt("reset_terms"));
892
893 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($this->object->getQuestion(), true));
894
895 return $this->outQuestionPage("", $is_postponed, $active_id, $template->get());
896 }
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="")
output question page

References $counter, $GLOBALS, $pass, $template, ilUtil\getImagePath(), ilUtil\getStyleSheetLocation(), iljQueryUtil\initjQuery(), iljQueryUtil\initjQueryUI(), and assQuestionGUI\outQuestionPage().

+ Here is the call graph for this function:

◆ isCorrectMatching()

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

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

1073 {
1074 if (!($pair->points > 0)) {
1075 return false;
1076 }
1077
1078 if (!is_object($term)) {
1079 return false;
1080 }
1081
1082 if ($pair->definition->identifier != $definition->identifier) {
1083 return false;
1084 }
1085
1086 if ($pair->term->identifier != $term->identifier) {
1087 return false;
1088 }
1089
1090 return true;
1091 }

Referenced by getSolutionOutput().

+ Here is the caller graph for this function:

◆ isDefImgUploadCommand()

assMatchingQuestionGUI::isDefImgUploadCommand ( )
private

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

261 {
262 return $this->ctrl->getCmd() == 'uploaddefinitions';
263 }

Referenced by populateAnswerSpecificFormPart().

+ Here is the caller graph for this function:

◆ isTermImgUploadCommand()

assMatchingQuestionGUI::isTermImgUploadCommand ( )
private

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

266 {
267 return $this->ctrl->getCmd() == 'uploadterms';
268 }

Referenced by populateAnswerSpecificFormPart().

+ 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 277 of file class.assMatchingQuestionGUI.php.

278 {
279 $matchingMode = $form->getItemByPostVar('matching_mode')->getValue();
280
281 if ($matchingMode == assMatchingQuestion::MATCHING_MODE_N_ON_N) {
282 return true;
283 }
284
285 $numTerms = count($form->getItemByPostVar('terms')->getValues());
286 $numDefinitions = count($form->getItemByPostVar('definitions')->getValues());
287
288 if ($numTerms >= $numDefinitions) {
289 return true;
290 }
291
292 return false;
293 }

References $form, and assMatchingQuestion\MATCHING_MODE_N_ON_N.

Referenced by editQuestion().

+ Here is the caller graph for this function:

◆ populateAnswerSpecificFormPart()

assMatchingQuestionGUI::populateAnswerSpecificFormPart ( \ilPropertyFormGUI  $form)

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

296 {
297 // Definitions
298 include_once "./Modules/TestQuestionPool/classes/class.ilMatchingWizardInputGUI.php";
299 $definitions = new ilMatchingWizardInputGUI($this->lng->txt("definitions"), "definitions");
300 if ($this->object->getSelfAssessmentEditingMode()) {
301 $definitions->setHideImages(true);
302 }
303
304 $definitions->setRequired(true);
305 $definitions->setQuestionObject($this->object);
306 $definitions->setTextName($this->lng->txt('definition_text'));
307 $definitions->setImageName($this->lng->txt('definition_image'));
308 include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatchingDefinition.php";
309 if (!count($this->object->getDefinitions())) {
310 $this->object->addDefinition(new assAnswerMatchingDefinition());
311 }
312 $definitionvalues = $this->object->getDefinitions();
313 $definitions->setValues($definitionvalues);
314 if ($this->isDefImgUploadCommand()) {
315 $definitions->checkInput();
316 }
317 $form->addItem($definitions);
318
319 // Terms
320 include_once "./Modules/TestQuestionPool/classes/class.ilMatchingWizardInputGUI.php";
321 $terms = new ilMatchingWizardInputGUI($this->lng->txt("terms"), "terms");
322 if ($this->object->getSelfAssessmentEditingMode()) {
323 $terms->setHideImages(true);
324 }
325 $terms->setRequired(true);
326 $terms->setQuestionObject($this->object);
327 $terms->setTextName($this->lng->txt('term_text'));
328 $terms->setImageName($this->lng->txt('term_image'));
329 include_once "./Modules/TestQuestionPool/classes/class.assAnswerMatchingTerm.php";
330 if (!count($this->object->getTerms())) {
331 $this->object->addTerm(new assAnswerMatchingTerm());
332 }
333 $termvalues = $this->object->getTerms();
334 $terms->setValues($termvalues);
335 if ($this->isTermImgUploadCommand()) {
336 $terms->checkInput();
337 }
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 $this->object->addMatchingPair(new assAnswerMatchingPair($termvalues[0], $definitionvalues[0], 0));
349 }
350 $pairs->setPairs($this->object->getMatchingPairs());
351 $form->addItem($pairs);
352
353 return $form;
354 }
Class for matching question definitions.
Class for matching question pairs.
Class for matching question terms.
This class represents a key value pair wizard property in a property form.
This class represents a single choice wizard property in a property form.

References $form, isDefImgUploadCommand(), and isTermImgUploadCommand().

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 356 of file class.assMatchingQuestionGUI.php.

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

References $form, assMatchingQuestion\MATCHING_MODE_1_ON_1, and assMatchingQuestion\MATCHING_MODE_N_ON_N.

Referenced by editQuestion().

+ Here is the caller graph for this function:

◆ removedefinitions()

assMatchingQuestionGUI::removedefinitions ( )

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

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

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

+ Here is the call graph for this function:

◆ removeimagedefinitions()

assMatchingQuestionGUI::removeimagedefinitions ( )

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

160 {
161 $this->writePostData(true);
162 $position = key($_POST['cmd']['removeimagedefinitions']);
163 $this->object->removeDefinitionImage($position);
164 $this->editQuestion();
165 }

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

+ Here is the call graph for this function:

◆ removeimageterms()

assMatchingQuestionGUI::removeimageterms ( )

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

146 {
147 $this->writePostData(true);
148 $position = key($_POST['cmd']['removeimageterms']);
149 $this->object->removeTermImage($position);
150 $this->editQuestion();
151 }

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

+ Here is the call graph for this function:

◆ removepairs()

assMatchingQuestionGUI::removepairs ( )

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

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

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

+ Here is the call graph for this function:

◆ removeterms()

assMatchingQuestionGUI::removeterms ( )

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

176 {
177 $this->writePostData();
178 $position = key($_POST["cmd"]["removeterms"]);
179 $this->object->deleteTerm($position);
180 $this->editQuestion();
181 }

References $_POST, editQuestion(), and 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 916 of file class.assMatchingQuestionGUI.php.

917 {
918 global $rbacsystem, $ilTabs;
919
920 $ilTabs->clearTargets();
921
922 $this->ctrl->setParameterByClass("ilAssQuestionPageGUI", "q_id", $_GET["q_id"]);
923 include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
924 $q_type = $this->object->getQuestionType();
925
926 if (strlen($q_type)) {
927 $classname = $q_type . "GUI";
928 $this->ctrl->setParameterByClass(strtolower($classname), "sel_question_types", $q_type);
929 $this->ctrl->setParameterByClass(strtolower($classname), "q_id", $_GET["q_id"]);
930 }
931
932 if ($_GET["q_id"]) {
933 if ($rbacsystem->checkAccess('write', $_GET["ref_id"])) {
934 // edit page
935 $ilTabs->addTarget(
936 "edit_page",
937 $this->ctrl->getLinkTargetByClass("ilAssQuestionPageGUI", "edit"),
938 array("edit", "insert", "exec_pg"),
939 "",
940 "",
941 $force_active
942 );
943 }
944
945 $this->addTab_QuestionPreview($ilTabs);
946 }
947
948 $force_active = false;
949 if ($rbacsystem->checkAccess('write', $_GET["ref_id"])) {
950 $url = "";
951 if ($classname) {
952 $url = $this->ctrl->getLinkTargetByClass($classname, "editQuestion");
953 }
954 // edit question properties
955 $ilTabs->addTarget(
956 "edit_question",
957 $url,
958 array("editQuestion", "save", "saveEdit", "removeimageterms", "uploadterms", "removeimagedefinitions", "uploaddefinitions",
959 "addpairs", "removepairs", "addterms", "removeterms", "adddefinitions", "removedefinitions", "originalSyncForm"),
960 $classname,
961 "",
962 $force_active
963 );
964 }
965
966 // add tab for question feedback within common class assQuestionGUI
967 $this->addTab_QuestionFeedback($ilTabs);
968
969 // add tab for question hint within common class assQuestionGUI
970 $this->addTab_QuestionHints($ilTabs);
971
972 // add tab for question's suggested solution within common class assQuestionGUI
973 $this->addTab_SuggestedSolution($ilTabs, $classname);
974
975 // Assessment of questions sub menu entry
976 if ($_GET["q_id"]) {
977 $ilTabs->addTarget(
978 "statistics",
979 $this->ctrl->getLinkTargetByClass($classname, "assessment"),
980 array("assessment"),
981 $classname,
982 ""
983 );
984 }
985
986 $this->addBackTab($ilTabs);
987 }
$_GET["client_id"]
addTab_QuestionHints(ilTabsGUI $tabs)
adds the hints tab to ilTabsGUI
addTab_SuggestedSolution(ilTabsGUI $tabs, $classname)
addBackTab(ilTabsGUI $ilTabs)
addTab_QuestionFeedback(ilTabsGUI $tabs)
adds the feedback tab to ilTabsGUI
addTab_QuestionPreview(ilTabsGUI $tabsGUI)
$url

References $_GET, $url, 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 153 of file class.assMatchingQuestionGUI.php.

154 {
155 $this->writePostData(true);
156 $this->editQuestion();
157 }

References editQuestion(), and writePostData().

+ Here is the call graph for this function:

◆ uploadterms()

assMatchingQuestionGUI::uploadterms ( )

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

140 {
141 $this->writePostData(true);
142 $this->editQuestion();
143 }

References editQuestion(), and 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 63 of file class.assMatchingQuestionGUI.php.

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

References $_POST, $filename, $index, and $name.

Referenced by writePostData().

+ Here is the caller graph for this function:

◆ writePostData()

assMatchingQuestionGUI::writePostData (   $always = false)
protected

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

Returns
integer A positive value, if one of the required fields wasn't set, else 0
}

Reimplemented from assQuestionGUI.

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

50 {
51 $hasErrors = (!$always) ? $this->editQuestion(true) : false;
52 if (!$hasErrors) {
53 require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
58 return 0;
59 }
60 return 1;
61 }
writeQuestionSpecificPostData(ilPropertyFormGUI $form)
Extracts the question specific values from $_POST and applies them to the data object.
writeAnswerSpecificPostData(ilPropertyFormGUI $form)
Extracts the answer specific values from $_POST and applies them to the data object.

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

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

+ Here is the call graph for this function:
+ Here is the caller 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 128 of file class.assMatchingQuestionGUI.php.

129 {
130 if (!$this->object->getSelfAssessmentEditingMode()) {
131 $this->object->setShuffle($_POST["shuffle"]);
132 } else {
133 $this->object->setShuffle(1);
134 }
135 $this->object->setThumbGeometry($_POST["thumb_geometry"]);
136 $this->object->setMatchingMode($_POST['matching_mode']);
137 }

References $_POST.

Referenced by writePostData().

+ Here is the caller graph for this function:

The documentation for this class was generated from the following file: