ILIAS  trunk Revision v11.0_alpha-2638-g80c1d007f79
Public Member Functions | Protected Member Functions | Private Member Functions
assMatchingQuestionGUI Class Reference

Matching question GUI representation. More...

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

Public Member Functions

 __construct ($id=-1)
 
 writeAnswerSpecificPostData (ilPropertyFormGUI $form)
 Extracts the answer specific values from the request and applies them to the data object. More...
 
 writeQuestionSpecificPostData (ilPropertyFormGUI $form)
 Extracts the question specific values from the request and applies them to the data object. More...
 
 uploadterms ()
 
 removeimageterms ()
 
 uploaddefinitions ()
 
 removeimagedefinitions ()
 
 addterms ()
 
 removeterms ()
 
 adddefinitions ()
 
 removedefinitions ()
 
 addpairs ()
 
 removepairs ()
 
 editQuestion (bool $checkonly=false, ?bool $is_save_cmd=null)
 
 populateAnswerSpecificFormPart (\ilPropertyFormGUI $form)
 
 populateQuestionSpecificFormPart (\ilPropertyFormGUI $form)
 
 getSolutionOutput (int $active_id, ?int $pass=null, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_inline_feedback=true)
 
 renderSolutionOutput (mixed $user_solutions, int $active_id, ?int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false,)
 
 getPreview (bool $show_question_only=false, bool $show_inline_feedback=false)
 
 getTestOutput (int $active_id, int $attempt, bool $is_question_postponed=false, array|bool $user_post_solutions=false, bool $show_specific_inline_feedback=false)
 
 checkInput ()
 check input fields More...
 
 getSpecificFeedbackOutput (array $userSolution)
 
 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...
 
 getAnswersFrequency ($relevantAnswers, $questionIndex)
 
 getAnswerFrequencyTableGUI ($parentGui, $parentCmd, $relevantAnswers, $questionIndex)
 
 populateCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 saveCorrectionsFormProperties (ilPropertyFormGUI $form)
 
- Public Member Functions inherited from assQuestionGUI
 editQuestion (bool $checkonly=false, ?bool $is_save_cmd=null)
 
 getSpecificFeedbackOutput (array $userSolution)
 Returns the answer specific feedback for the question. More...
 
 getSolutionOutput (int $active_id, ?int $pass=null, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_inline_feedback=true)
 
 getPreview (bool $show_question_only=false, bool $show_inline_feedback=false)
 
 getTestOutput (int $active_id, int $pass, bool $is_question_postponed=false, array|bool $user_post_solutions=false, bool $show_specific_inline_feedback=false)
 
 renderSolutionOutput (mixed $user_solutions, int $active_id, ?int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false,)
 
 getObject ()
 
 setObject (assQuestion $question)
 
 setCopyToExistingPoolOnSave (?int $pool_ref_id)
 
 getCopyToExistingPoolOnSave ()
 
 setCopyToNewPoolOnSave (?string $pool_title)
 
 getCopyToNewPoolOnSave ()
 
 setMoveAfterQuestionId (?int $question_id)
 
 getMoveAfterQuestionId ()
 
 hasInlineFeedback ()
 
 addHeaderAction ()
 
 redrawHeaderAction ()
 
 getHeaderAction ()
 
 getCommentsPanelHTML ()
 
 executeCommand ()
 
 getType ()
 needed for page editor compliance More...
 
 getPresentationContext ()
 
 setPresentationContext (string $presentationContext)
 
 isTestPresentationContext ()
 
 isPreviousSolutionPrefilled ()
 
 setPreviousSolutionPrefilled (bool $previousSolutionPrefilled)
 
 getRenderPurpose ()
 
 setRenderPurpose (string $renderPurpose)
 
 isRenderPurposePrintPdf ()
 
 isRenderPurposePreview ()
 
 isRenderPurposeInputValue ()
 
 isRenderPurposePlayback ()
 
 isRenderPurposeDemoplay ()
 
 renderPurposeSupportsFormHtml ()
 
 getEditContext ()
 
 setEditContext (string $editContext)
 
 isAuthoringEditContext ()
 
 isAdjustmentEditContext ()
 
 setAdjustmentEditContext ()
 
 getNavigationGUI ()
 
 setNavigationGUI (?ilTestQuestionNavigationGUI $navigationGUI)
 
 setTaxonomyIds (array $taxonomyIds)
 
 getTaxonomyIds ()
 
 setTargetGui ($linkTargetGui)
 
 setTargetGuiClass (string $targetGuiClass)
 
 getTargetGuiClass ()
 
 setQuestionHeaderBlockBuilder (\ilQuestionHeaderBlockBuilder $questionHeaderBlockBuilder)
 
 getQuestionHeaderBlockBuilder ()
 
 setQuestionActionCmd (string $questionActionCmd)
 
 getQuestionActionCmd ()
 
 assessment ()
 
 populateJavascriptFilesRequiredForWorkForm (ilGlobalTemplateInterface $tpl)
 
 getPresentationJavascripts ()
 
 getQuestionTemplate ()
 
 getILIASPage (string $html="")
 Returns the ILIAS Page around a question. More...
 
 outQuestionPage ($a_temp_var, $a_postponed=false, $active_id="", $html="", $inlineFeedbackEnabled=false)
 
 syncQuestion ()
 
 saveReturn ()
 
 saveQuestion ()
 
 setAdditionalContentEditingModeFromPost ()
 
 getContextPath ($cont_obj, int $a_endnode_id, int $a_startnode_id=1)
 get context path in content object tree More...
 
 setSequenceNumber (int $nr)
 
 getSequenceNumber ()
 
 setQuestionCount (int $a_question_count)
 
 getQuestionCount ()
 
 getErrorMessage ()
 
 setErrorMessage (string $errormessage)
 
 addErrorMessage (string $errormessage)
 
 getQuestionType ()
 
 getAsValueAttribute (string $a_value)
 
 addQuestionFormCommandButtons (ilPropertyFormGUI $form)
 
 addBasicQuestionFormProperties (ilPropertyFormGUI $form)
 
 getGenericFeedbackOutput (int $active_id, ?int $pass)
 
 getGenericFeedbackOutputForCorrectSolution ()
 
 getGenericFeedbackOutputForIncorrectSolution ()
 
 outQuestionType ()
 
 saveSuggestedSolution ()
 
 cancelSuggestedSolution ()
 
 suggestedsolution (bool $save=false)
 
 outSolutionExplorer ()
 
 saveSuggestedSolutionType ()
 
 cancelExplorer ()
 
 outPageSelector ()
 
 outChapterSelector ()
 
 outGlossarySelector ()
 
 linkChilds ()
 
 addPG ()
 
 addST ()
 
 addGIT ()
 
 isSaveCommand ()
 
 setQuestionTabs ()
 
 addTab_SuggestedSolution (ilTabsGUI $tabs, string $classname)
 
 getEditQuestionTabCommands ()
 
 isAutosaveable ()
 
 outQuestionForTest (string $formaction, int $active_id, ?int $pass, bool $is_question_postponed=false, array|bool $user_post_solutions=false, bool $show_specific_inline_feedback=false)
 
 magicAfterTestOutput ()
 
 getFormEncodingType ()
 
 setPreviewSession (ilAssQuestionPreviewSession $preview_session)
 
 getPreviewSession ()
 
 buildFocusAnchorHtml ()
 
 isAnswerFrequencyStatisticSupported ()
 
 getSubQuestionsIndex ()
 
 getAnswersFrequency ($relevantAnswers, $questionIndex)
 
 getAnswerFrequencyTableGUI ($parentGui, $parentCmd, $relevantAnswers, $questionIndex)
 
 prepareReprintableCorrectionsForm (ilPropertyFormGUI $form)
 
 populateCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 saveCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 isInLearningModuleContext ()
 
 setInLearningModuleContext (bool $flag)
 
 cmdNeedsExistingQuestion (string $cmd)
 
 setContextAllowsSyncToPool (bool $sync_allowed)
 
 needsSyncQuery ()
 
 getQuestionSyncModal (string $cmd, string $cmd_class='')
 
 getAutoSavedSolutionOutput (int $active_id, int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false)
 
 buildFileDownloadLink ()
 
- Public Member Functions inherited from ilGuiQuestionScoringAdjustable
 populateQuestionSpecificFormPart (ilPropertyFormGUI $form)
 Adds the question specific forms parts to a question property form gui. More...
 
- Public Member Functions inherited from ilGuiAnswerScoringAdjustable
 populateAnswerSpecificFormPart (ilPropertyFormGUI $form)
 Adds the answer specific form parts to a question property form gui. More...
 

Protected Member Functions

 writePostData (bool $always=false)
 {} More...
 
 sortDefinitionsBySolution (array $solutions, array $definitions)
 
 getAnswerStatisticImageHtml ($picture)
 
 getAnswerStatisticMatchingElemHtml ($elem)
 
- Protected Member Functions inherited from assQuestionGUI
 hasSpecialQuestionCommands ()
 
 writePostData (bool $always=false)
 Evaluates a posted edit form and writes the form data in the question object. More...
 
 renderEditForm (ilPropertyFormGUI $form)
 
 getUseUnchangedAnswerCheckboxHtml ()
 
 getPreviousSolutionProvidedMessage ()
 
 getPreviousSolutionConfirmationCheckboxHtml ()
 
 setTestSpecificProperties ()
 
 addNumberOfTriesToFormIfNecessary (ilPropertyFormGUI $form)
 
 saveTaxonomyAssignments ()
 
 populateTaxonomyFormSection (ilPropertyFormGUI $form)
 
 genericFeedbackOutputBuilder (int $active_id, ?int $pass)
 
 getTypeOptions ()
 
 createSuggestedSolutionLinkingTo (string $type, string $target)
 
 setDefaultTabs (ilTabsGUI $tabs_gui)
 
 setQuestionSpecificTabs (ilTabsGUI $tabs_gui)
 
 getBasicEditQuestionTabCommands ()
 
 getAdditionalEditQuestionCommands ()
 
 addTab_QuestionFeedback (ilTabsGUI $tabs)
 
 addTab_Question (ilTabsGUI $tabs_gui)
 
 hasCorrectSolution ($activeId, $passIndex)
 
 writeQuestionGenericPostData ()
 
 completeTestOutputFormAction (string $form_action, int $active_id, int $pass)
 
 addBackTab (ilTabsGUI $tabs_gui)
 
 buildBasicEditFormObject ()
 
 escapeTemplatePlaceholders (string $text)
 
 buildEditForm ()
 
 generateCorrectnessIconsForCorrectness (int $correctness)
 
 renderLatex ($content)
 Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in the browser. More...
 
 getSuggestedSolutionsRepo ()
 
 cleanupAnswerText (array $answer_text, bool $is_rte)
 sk - 12.05.2023: This is one more of those that we need, but don't want. More...
 
 addSaveOnEnterOnLoadCode ()
 

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...
 
 populateDefinition (ilTemplate $template, assAnswerMatchingDefinition $definition, array $solutions, array $terms)
 
 populateAssignedTerms (ilTemplate $definition_template, int $definition_id, array $assigned_term_ids, array $available_terms)
 
 getArrayKeyForTermId (int $term_id, array $terms)
 
 buildTermHtml (assAnswerMatchingTerm $term, ?int $definition_id=null)
 
 buildSolutionsArray (int $active_id, int $attempt, array|bool $user_post_solutions)
 
 isCorrectMatching ($pair, $definition, $term)
 
 initializePlayerJS ()
 

Additional Inherited Members

- Static Public Member Functions inherited from assQuestionGUI
static _getQuestionGUI (string $question_type='', int $question_id=-1)
 Creates a question gui representation and returns the alias to the question gui. More...
 
static getCommandsFromClassConstants (string $guiClassName, string $cmdConstantNameBegin='CMD_')
 
static prepareTextareaOutput (?string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
 Prepares a string for a text area output where latex code may be in it If the text is HTML-free, CHR(13) will be converted to a line break. More...
 
- Data Fields inherited from assQuestionGUI
const ALLOWED_PLAIN_TEXT_TAGS = "<em>, <strong>"
 sk - 12.05.2023: This const is also used in ilKprimChoiceWizardInputGUI. More...
 
const SESSION_PREVIEW_DATA_BASE_INDEX = 'ilAssQuestionPreviewAnswers'
 
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 CORRECTNESS_NOT_OK = 0
 
const CORRECTNESS_MOSTLY_OK = 1
 
const CORRECTNESS_OK = 2
 
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'
 
const PRESENTATION_CONTEXT_TEST = 'pContextTest'
 
const PRESENTATION_CONTEXT_RESULTS = 'pContextResults'
 
const CMD_SYNC_QUESTION_AND_RETURN = 'syncQuestionReturn'
 
- Protected Attributes inherited from assQuestionGUI
const HAS_SPECIAL_QUESTION_COMMANDS = false
 
const SUGGESTED_SOLUTION_COMMANDS_CANCEL = 'cancelSuggestedSolution'
 
const SUGGESTED_SOLUTION_COMMANDS_SAVE = 'saveSuggestedSolution'
 
const SUGGESTED_SOLUTION_COMMANDS_DEFAULT = 'suggestedsolution'
 
const QUESTION_SAVE_CMDS
 
const ADDITIONAL_CMDS_NEEDING_EXISTING_QST
 There are functions that need an existing question. More...
 
ilLogger $logger
 
GeneralQuestionPropertiesRepository $questionrepository
 
GUIService $notes_gui
 
ilCtrl $ctrl
 
assQuestion $object
 
ilGlobalPageTemplate $tpl
 
ilLanguage $lng
 
Refinery $refinery
 
 $error
 
string $errormessage
 
int $sequence_no
 sequence number in test More...
 
int $question_count
 question count in test More...
 
ilPropertyFormGUI $editForm = null
 
readonly ilTestLegacyFormsHelper $forms_helper
 
readonly RequestDataCollector $request_data_collector
 
bool $parent_type_is_lm = false
 
SuggestedSolutionsDatabaseRepository $suggestedsolution_repo = null
 

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$

\ assMatchingQuestionGUI: ilFormPropertyDispatchGUI

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

Constructor & Destructor Documentation

◆ __construct()

assMatchingQuestionGUI::__construct (   $id = -1)

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

References $id, ILIAS\GlobalScreen\Provider\__construct(), ILIAS\Repository\lng(), and assQuestionGUI\setErrorMessage().

40  {
41  parent::__construct();
42  $this->object = new assMatchingQuestion();
43  $this->setErrorMessage($this->lng->txt('msg_form_save_error'));
44  if ($id >= 0) {
45  $this->object->loadFromDb($id);
46  }
47  }
assMatchingQuestion
Class for matching questions.
Definition: class.assMatchingQuestion.php:40
assQuestionGUI\setErrorMessage
setErrorMessage(string $errormessage)
Definition: class.assQuestionGUI.php:821
$id
$id
plugin.php for ilComponentBuildPluginInfoObjectiveTest::testAddPlugins
Definition: plugin.php:23
ILIAS\GlobalScreen\Provider\__construct
__construct(Container $dic, ilPlugin $plugin)
Definition: PluginProviderHelper.php:37
+ Here is the call graph for this function:

Member Function Documentation

◆ adddefinitions()

assMatchingQuestionGUI::adddefinitions ( )

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

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

222  : void
223  {
224  $this->setAdditionalContentEditingModeFromPost();
225  $this->writePostData(true);
226  $this->object->insertDefinition($this->request_data_collector->getCmdIndex('adddefinitions') + 1);
227  $this->editQuestion();
228  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ addpairs()

assMatchingQuestionGUI::addpairs ( )

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

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

238  : void
239  {
240  $this->setAdditionalContentEditingModeFromPost();
241  $this->writePostData(true);
242  $this->object->insertMatchingPair($this->request_data_collector->getCmdIndex('addpairs') + 1);
243  $this->editQuestion();
244  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ addterms()

assMatchingQuestionGUI::addterms ( )

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

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

205  : void
206  {
207  $this->setAdditionalContentEditingModeFromPost();
208  $this->writePostData(true);
209  $add_terms = $this->request_data_collector->getCmdIndex('addterms');
210  $this->object->insertTerm($add_terms + 1);
211  $this->editQuestion();
212  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ buildSolutionsArray()

assMatchingQuestionGUI::buildSolutionsArray ( int  $active_id,
int  $attempt,
array|bool  $user_post_solutions 
)
private

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

References $c, and ILIAS\Repository\object().

Referenced by getTestOutput().

839  : array
840  {
841  if ($active_id === 0) {
842  return [];
843  }
844  if ($user_post_solutions !== false) {
845  return $user_post_solutions['matching'];
846  }
847 
848  return array_reduce(
849  $this->object->getTestOutputSolutions($active_id, $attempt),
850  static function (array $c, array $v): array {
851  if (!array_key_exists($v['value2'], $c)) {
852  $c[$v['value2']] = [$v['value1']];
853  return $c;
854  }
855  $c[$v['value2']][] = $v['value1'];
856  return $c;
857  },
858  []
859  );
860  }
$c
$c
Definition: deliver.php:25
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ buildTermHtml()

assMatchingQuestionGUI::buildTermHtml ( assAnswerMatchingTerm  $term,
?int  $definition_id = null 
)
private

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

References assAnswerMatchingTerm\getIdentifier(), ilUtil\getImagePath(), assAnswerMatchingTerm\getPicture(), assAnswerMatchingTerm\getText(), ILIAS\Repository\lng(), null, ILIAS\Repository\object(), ilLegacyFormElementsUtil\prepareTextareaOutput(), and assQuestionGUI\renderLatex().

Referenced by getPreview(), getTestOutput(), and populateAssignedTerms().

796  : string
797  {
798  $template = new ilTemplate('tpl.il_as_qpl_matching_term_output.html', true, true, 'components/ILIAS/TestQuestionPool');
799 
800  $template->setVariable('ID_DRAGGABLE', $term->getIdentifier());
801 
802  if ($definition_id !== null) {
803  $template->setCurrentBlock('definition_id');
804  $template->setVariable('IID_DROPAREA', $definition_id);
805  $template->parseCurrentBlock();
806  }
807 
808  if ($term->getPicture() === '') {
809  $template->setCurrentBlock('term_text');
810  $template->setVariable('TERM_TEXT', $this->renderLatex(
811  ilLegacyFormElementsUtil::prepareTextareaOutput($term->getText(), true, true)
812  ));
813  $template->parseCurrentBlock();
814  return $template->get();
815  }
816 
817  $template->setCurrentBlock('term_picture');
818  $template->setVariable('TERM_ID', $term->getIdentifier());
819  $template->setVariable('IMAGE_HREF', $this->object->getImagePathWeb() . $term->getPicture());
820  $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $term->getPicture();
821  $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $term->getPicture();
822  if (!file_exists($thumb)) {
823  $this->object->rebuildThumbnails();
824  }
825  $template->setVariable('THUMBNAIL_HREF', $thumbweb);
826  $template->setVariable('THUMB_ALT', $this->lng->txt('image'));
827  $template->setVariable('THUMB_TITLE', $this->lng->txt('image'));
828  $template->setVariable('TEXT_PREVIEW', $this->lng->txt('preview'));
829  $template->setVariable('TEXT_TERM', $term->getText() !== ''
830  ? $this->renderLatex(
831  ilLegacyFormElementsUtil::prepareTextareaOutput($term->getText(), true, true)
832  )
833  : '');
834  $template->setVariable('IMG_PREVIEW', ilUtil::getImagePath('media/enlarge.svg'));
835  $template->parseCurrentBlock();
836  return $template->get();
837  }
assQuestionGUI\renderLatex
renderLatex($content)
Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in th...
Definition: class.assQuestionGUI.php:1904
null
while($session_entry=$r->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) return null
Definition: shib_logout.php:144
ilUtil\getImagePath
static getImagePath(string $image_name, string $module_path="", string $mode="output", bool $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:68
ilLegacyFormElementsUtil\prepareTextareaOutput
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free...
Definition: class.ilLegacyFormElementsUtil.php:109
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ checkInput()

assMatchingQuestionGUI::checkInput ( )

check input fields

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

946  : bool
947  {
948  $title = $this->request_data_collector->string('title');
949  $author = $this->request_data_collector->string('author');
950  $question = $this->request_data_collector->string('question');
951 
952  return !empty($title) && !empty($author) && !empty($question);
953  }

◆ editQuestion()

assMatchingQuestionGUI::editQuestion ( bool  $checkonly = false,
?bool  $is_save_cmd = null 
)

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

References assQuestionGUI\addBasicQuestionFormProperties(), assQuestionGUI\addQuestionFormCommandButtons(), ILIAS\Repository\ctrl(), assQuestionGUI\isSaveCommand(), isValidTermAndDefinitionAmount(), ILIAS\Repository\lng(), ILIAS\Repository\object(), assQuestionGUI\outQuestionType(), populateAnswerSpecificFormPart(), populateQuestionSpecificFormPart(), assQuestionGUI\populateTaxonomyFormSection(), and assQuestionGUI\renderEditForm().

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

257  : bool {
258  $save = $is_save_cmd ?? $this->isSaveCommand();
259 
260  $form = new ilPropertyFormGUI();
261  $this->editForm = $form;
262 
263  $form->setFormAction($this->ctrl->getFormAction($this));
264  $form->setTitle($this->outQuestionType());
265  $form->setMultipart(true);
266  $form->setTableWidth("100%");
267  $form->setId("matching");
268 
269  $this->addBasicQuestionFormProperties($form);
270  $this->populateQuestionSpecificFormPart($form);
271  $this->populateAnswerSpecificFormPart($form);
272  $this->populateTaxonomyFormSection($form);
273  $this->addQuestionFormCommandButtons($form);
274 
275  $errors = false;
276  if ($save) {
277  $form->setValuesByPost();
278  $errors = !$form->checkInput();
279  $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
280  if (!$errors && !$this->isValidTermAndDefinitionAmount($form) && !$this->object->getSelfAssessmentEditingMode()) {
281  $errors = true;
282  $terms = $form->getItemByPostVar('terms');
283  $terms->setAlert($this->lng->txt("msg_number_of_terms_too_low"));
284  $this->tpl->setOnScreenMessage('failure', $this->lng->txt('form_input_not_valid'));
285  }
286  if ($errors) {
287  $checkonly = false;
288  }
289  }
290 
291  if (!$checkonly) {
292  $this->renderEditForm($form);
293  }
294  return $errors;
295  }
assQuestionGUI\addBasicQuestionFormProperties
addBasicQuestionFormProperties(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:853
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:314
assQuestionGUI\populateTaxonomyFormSection
populateTaxonomyFormSection(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:974
assQuestionGUI\addQuestionFormCommandButtons
addQuestionFormCommandButtons(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:845
assMatchingQuestionGUI\populateQuestionSpecificFormPart
populateQuestionSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMatchingQuestionGUI.php:395
assMatchingQuestionGUI\populateAnswerSpecificFormPart
populateAnswerSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMatchingQuestionGUI.php:332
assQuestionGUI\renderEditForm
renderEditForm(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:619
+ 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 1000 of file class.assMatchingQuestionGUI.php.

1000  : array
1001  {
1002  return [];
1003  }

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

1014  : array
1015  {
1016  return [];
1017  }

◆ getAnswerFrequencyTableGUI()

assMatchingQuestionGUI::getAnswerFrequencyTableGUI (   $parentGui,
  $parentCmd,
  $relevantAnswers,
  $questionIndex 
)
Parameters
$parentGui
$parentCmd
$relevantAnswers
$questionIndex
Returns
ilMatchingQuestionAnswerFreqStatTableGUI

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

References getAnswersFrequency().

1112  : ilAnswerFrequencyStatisticTableGUI
1113  {
1114  $table = new ilMatchingQuestionAnswerFreqStatTableGUI($parentGui, $parentCmd, $this->object);
1115  $table->setQuestionIndex($questionIndex);
1116  $table->setData($this->getAnswersFrequency($relevantAnswers, $questionIndex));
1117  $table->initColumns();
1118 
1119  return $table;
1120  }
ilAnswerFrequencyStatisticTableGUI
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilAnswerFrequencyStatisticTableGUI.php:23
assMatchingQuestionGUI\getAnswersFrequency
getAnswersFrequency($relevantAnswers, $questionIndex)
Definition: class.assMatchingQuestionGUI.php:1061
+ Here is the call graph for this function:

◆ getAnswersFrequency()

assMatchingQuestionGUI::getAnswersFrequency (   $relevantAnswers,
  $questionIndex 
)

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

References getAnswerStatisticMatchingElemHtml(), and ILIAS\Repository\object().

Referenced by getAnswerFrequencyTableGUI().

1061  : array
1062  {
1063  $answersByActiveAndPass = [];
1064 
1065  foreach ($relevantAnswers as $row) {
1066  $key = $row['active_fi'] . ':' . $row['pass'];
1067 
1068  if (!isset($answersByActiveAndPass[$key])) {
1069  $answersByActiveAndPass[$key] = [];
1070  }
1071 
1072  $answersByActiveAndPass[$key][$row['value1']] = $row['value2'];
1073  }
1074 
1075  $answers = [];
1076 
1077  foreach ($answersByActiveAndPass as $key => $matchingPairs) {
1078  foreach ($matchingPairs as $termId => $defId) {
1079  $hash = md5($termId . ':' . $defId);
1080 
1081  if (!isset($answers[$hash])) {
1082  $termHtml = $this->getAnswerStatisticMatchingElemHtml(
1083  $this->object->getTermWithIdentifier($termId)
1084  );
1085 
1086  $defHtml = $this->getAnswerStatisticMatchingElemHtml(
1087  $this->object->getDefinitionWithIdentifier($defId)
1088  );
1089 
1090  $answers[$hash] = [
1091  'answer' => $termHtml . $defHtml,
1092  'term' => $termHtml,
1093  'definition' => $defHtml,
1094  'frequency' => 0
1095  ];
1096  }
1097 
1098  $answers[$hash]['frequency']++;
1099  }
1100  }
1101 
1102  return $answers;
1103  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getAnswerStatisticImageHtml()

assMatchingQuestionGUI::getAnswerStatisticImageHtml (   $picture)
protected

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

Referenced by getAnswerStatisticMatchingElemHtml().

1040  : string
1041  {
1042  $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $picture;
1043  return '<img src="' . $thumbweb . '" alt="' . $picture . '" title="' . $picture . '"/>';
1044  }
+ Here is the caller graph for this function:

◆ getAnswerStatisticMatchingElemHtml()

assMatchingQuestionGUI::getAnswerStatisticMatchingElemHtml (   $elem)
protected

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

References getAnswerStatisticImageHtml().

Referenced by getAnswersFrequency().

1046  : string
1047  {
1048  $html = '';
1049 
1050  if (strlen($elem->getText())) {
1051  $html .= $elem->getText();
1052  }
1053 
1054  if (strlen($elem->getPicture())) {
1055  $html .= $this->getAnswerStatisticImageHtml($elem->getPicture());
1056  }
1057 
1058  return $html;
1059  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getArrayKeyForTermId()

assMatchingQuestionGUI::getArrayKeyForTermId ( int  $term_id,
array  $terms 
)
private

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

References null.

Referenced by populateAssignedTerms().

786  : ?int
787  {
788  foreach ($terms as $key => $term) {
789  if ($term->getIdentifier() === $term_id) {
790  return $key;
791  }
792  }
793  return null;
794  }
null
while($session_entry=$r->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) return null
Definition: shib_logout.php:144
+ Here is the caller graph for this function:

◆ getPreview()

assMatchingQuestionGUI::getPreview ( bool  $show_question_only = false,
bool  $show_inline_feedback = false 
)

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

References $c, buildTermHtml(), assQuestionGUI\getILIASPage(), assQuestionGUI\getPreviewSession(), initializePlayerJS(), ILIAS\Repository\object(), populateDefinition(), and assQuestionGUI\renderLatex().

660  : string {
661  $template = new ilTemplate('tpl.il_as_qpl_matching_output.html', true, true, 'components/ILIAS/TestQuestionPool');
662  $this->initializePlayerJS();
663 
664  $solutions = $this->getPreviewSession()?->getParticipantsSolution() ?? [];
665 
666  // shuffle output
667  $terms = $this->object->getTerms();
668  $definitions = $this->object->getDefinitions();
669  switch ($this->object->getShuffleMode()) {
670  case 1:
671  $terms = $this->object->getShuffler()->transform($terms);
672  $definitions = $this->object->getShuffler()->transform(
673  $this->object->getShuffler()->transform($definitions)
674  );
675  break;
676  case 2:
677  $terms = $this->object->getShuffler()->transform($terms);
678  break;
679  case 3:
680  $definitions = $this->object->getShuffler()->transform($definitions);
681  break;
682  }
683 
684  foreach ($definitions as $definition) {
685  $terms = $this->populateDefinition($template, $definition, $solutions, $terms);
686  $template->setCurrentBlock('droparea');
687  $template->setVariable('ID_DROPAREA', $definition->getIdentifier());
688  $template->setVariable('QUESTION_ID', $this->object->getId());
689  $template->parseCurrentBlock();
690  }
691 
692  $template->setVariable(
693  'TERMS_PRESENTATION_SOURCE',
694  array_reduce(
695  $terms,
696  fn(string $c, assAnswerMatchingTerm $v) => $c . $this->buildTermHtml($v),
697  ''
698  )
699  );
700 
701  $template->setVariable('QUESTIONTEXT', $this->renderLatex($this->object->getQuestionForHTMLOutput()));
702 
703  $questionoutput = $template->get();
704 
705  if (!$show_question_only) {
706  // get page object output
707  $questionoutput = $this->getILIASPage($questionoutput);
708  }
709 
710  return $questionoutput;
711  }
assAnswerMatchingTerm
Class for matching question terms.
Definition: class.assAnswerMatchingTerm.php:27
assQuestionGUI\renderLatex
renderLatex($content)
Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in th...
Definition: class.assQuestionGUI.php:1904
assMatchingQuestionGUI\populateDefinition
populateDefinition(ilTemplate $template, assAnswerMatchingDefinition $definition, array $solutions, array $terms)
Definition: class.assMatchingQuestionGUI.php:713
$c
$c
Definition: deliver.php:25
assMatchingQuestionGUI\buildTermHtml
buildTermHtml(assAnswerMatchingTerm $term, ?int $definition_id=null)
Definition: class.assMatchingQuestionGUI.php:796
assQuestionGUI\getILIASPage
getILIASPage(string $html="")
Returns the ILIAS Page around a question.
Definition: class.assQuestionGUI.php:629
+ Here is the call graph for this function:

◆ getSolutionOutput()

assMatchingQuestionGUI::getSolutionOutput ( int  $active_id,
?int  $pass = null,
bool  $graphical_output = false,
bool  $result_output = false,
bool  $show_question_only = true,
bool  $show_feedback = false,
bool  $show_correct_solution = false,
bool  $show_manual_scoring = false,
bool  $show_question_text = true,
bool  $show_inline_feedback = true 
)

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

References ILIAS\Repository\object(), and renderSolutionOutput().

460  : string {
461  $solutions = [];
462  if (($active_id > 0) && (!$show_correct_solution)) {
463  $solutions = $this->object->getSolutionValues($active_id, $pass);
464  } else {
465  foreach ($this->object->getMaximumScoringMatchingPairs() as $pair) {
466  $solutions[] = [
467  'value1' => $pair->getTerm()->getIdentifier(),
468  'value2' => $pair->getDefinition()->getIdentifier(),
469  'points' => $pair->getPoints()
470  ];
471  }
472  }
473 
474  return $this->renderSolutionOutput(
475  $solutions,
476  $active_id,
477  $pass,
478  $graphical_output,
479  $result_output,
480  $show_question_only,
481  $show_feedback,
482  $show_correct_solution,
483  $show_manual_scoring,
484  $show_question_text,
485  false,
486  $show_inline_feedback,
487  );
488  }
assMatchingQuestionGUI\renderSolutionOutput
renderSolutionOutput(mixed $user_solutions, int $active_id, ?int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false,)
Definition: class.assMatchingQuestionGUI.php:490
+ Here is the call graph for this function:

◆ getSpecificFeedbackOutput()

assMatchingQuestionGUI::getSpecificFeedbackOutput ( array  $userSolution)

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

References ILIAS\Repository\object(), ilLegacyFormElementsUtil\prepareTextareaOutput(), and assQuestionGUI\renderLatex().

Referenced by renderSolutionOutput().

955  : string
956  {
957  $matches = array_values($this->object->matchingpairs);
958 
959  if (!$this->object->feedbackOBJ->specificAnswerFeedbackExists()) {
960  return '';
961  }
962 
963  $feedback = '<table class="test_specific_feedback"><tbody>';
964 
965  foreach ($matches as $idx => $ans) {
966  if (!isset($userSolution[$ans->getDefinition()->getIdentifier()])) {
967  continue;
968  }
969 
970  if (!is_array($userSolution[$ans->getDefinition()->getIdentifier()])) {
971  continue;
972  }
973 
974  if (!in_array($ans->getTerm()->getIdentifier(), $userSolution[$ans->getDefinition()->getIdentifier()])) {
975  continue;
976  }
977 
978  $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
979  $this->object->getId(),
980  0,
981  $idx
982  );
983  $feedback .= "<tr><td>\"{$ans->getDefinition()->getText()}\" {$this->lng->txt('matches')} ";
984  $feedback .= "\"{$ans->getTerm()->getText()}\"</td><td>{$fb}</td></tr>";
985  }
986 
987  $feedback .= '</tbody></table>';
988  return $this->renderLatex(ilLegacyFormElementsUtil::prepareTextareaOutput($feedback, true));
989  }
assQuestionGUI\renderLatex
renderLatex($content)
Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in th...
Definition: class.assQuestionGUI.php:1904
ilLegacyFormElementsUtil\prepareTextareaOutput
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free...
Definition: class.ilLegacyFormElementsUtil.php:109
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getTestOutput()

assMatchingQuestionGUI::getTestOutput ( int  $active_id,
int  $attempt,
bool  $is_question_postponed = false,
array|bool  $user_post_solutions = false,
bool  $show_specific_inline_feedback = false 
)

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

References $c, buildSolutionsArray(), buildTermHtml(), initializePlayerJS(), ILIAS\Repository\object(), assQuestionGUI\outQuestionPage(), populateDefinition(), assQuestionGUI\renderLatex(), and sortDefinitionsBySolution().

891  : string {
892  $template = new ilTemplate('tpl.il_as_qpl_matching_output.html', true, true, 'components/ILIAS/TestQuestionPool');
893  $this->initializePlayerJS();
894 
895  $solutions = $this->buildSolutionsArray($active_id, $attempt, $user_post_solutions);
896  $terms = $this->object->getTerms();
897  $definitions = $this->object->getDefinitions();
898  switch ($this->object->getShuffleMode()) {
899  case 1:
900  $terms = $this->object->getShuffler()->transform($terms);
901  if ($solutions !== []) {
902  $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
903  } else {
904  $definitions = $this->object->getShuffler()->transform(
905  $this->object->getShuffler()->transform($definitions)
906  );
907  }
908  break;
909  case 2:
910  $terms = $this->object->getShuffler()->transform($terms);
911  break;
912  case 3:
913  if ($solutions !== []) {
914  $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
915  } else {
916  $definitions = $this->object->getShuffler()->transform($definitions);
917  }
918  break;
919  }
920 
921  foreach ($definitions as $definition) {
922  $terms = $this->populateDefinition($template, $definition, $solutions, $terms);
923  $template->setCurrentBlock('droparea');
924  $template->setVariable('ID_DROPAREA', $definition->getIdentifier());
925  $template->setVariable('QUESTION_ID', $this->object->getId());
926  $template->parseCurrentBlock();
927  }
928 
929  $template->setVariable(
930  'TERMS_PRESENTATION_SOURCE',
931  array_reduce(
932  $terms,
933  fn(string $c, assAnswerMatchingTerm $v) => $c . $this->buildTermHtml($v),
934  ''
935  )
936  );
937 
938  $template->setVariable('QUESTIONTEXT', $this->renderLatex($this->object->getQuestionForHTMLOutput()));
939 
940  return $this->outQuestionPage('', $is_question_postponed, $active_id, $template->get());
941  }
assAnswerMatchingTerm
Class for matching question terms.
Definition: class.assAnswerMatchingTerm.php:27
assQuestionGUI\renderLatex
renderLatex($content)
Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in th...
Definition: class.assQuestionGUI.php:1904
assMatchingQuestionGUI\populateDefinition
populateDefinition(ilTemplate $template, assAnswerMatchingDefinition $definition, array $solutions, array $terms)
Definition: class.assMatchingQuestionGUI.php:713
$c
$c
Definition: deliver.php:25
assMatchingQuestionGUI\buildTermHtml
buildTermHtml(assAnswerMatchingTerm $term, ?int $definition_id=null)
Definition: class.assMatchingQuestionGUI.php:796
assMatchingQuestionGUI\sortDefinitionsBySolution
sortDefinitionsBySolution(array $solutions, array $definitions)
Definition: class.assMatchingQuestionGUI.php:867
assMatchingQuestionGUI\buildSolutionsArray
buildSolutionsArray(int $active_id, int $attempt, array|bool $user_post_solutions)
Definition: class.assMatchingQuestionGUI.php:839
assQuestionGUI\outQuestionPage
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="", $inlineFeedbackEnabled=false)
Definition: class.assQuestionGUI.php:641
+ Here is the call graph for this function:

◆ initializePlayerJS()

assMatchingQuestionGUI::initializePlayerJS ( )
private

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

Referenced by getPreview(), and getTestOutput().

1163  : void
1164  {
1165  $this->tpl->addJavaScript('assets/js/matching.js');
1166  $this->tpl->addOnLoadCode(
1167  'il.test.matching.init('
1168  . "document.querySelector('#ilMatchingQuestionContainer_{$this->object->getId()}'),"
1169  . "'{$this->object->getMatchingMode()}');"
1170  );
1171  }
+ Here is the caller graph for this function:

◆ isCorrectMatching()

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

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

Referenced by renderSolutionOutput().

1019  : bool
1020  {
1021  if (!($pair->getPoints() > 0)) {
1022  return false;
1023  }
1024 
1025  if (!is_object($term)) {
1026  return false;
1027  }
1028 
1029  if ($pair->getDefinition()->getIdentifier() != $definition->getIdentifier()) {
1030  return false;
1031  }
1032 
1033  if ($pair->getTerm()->getIdentifier() != $term->getIdentifier()) {
1034  return false;
1035  }
1036 
1037  return true;
1038  }
+ Here is the caller graph for this function:

◆ isDefImgUploadCommand()

assMatchingQuestionGUI::isDefImgUploadCommand ( )
private

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

References ILIAS\Repository\ctrl().

Referenced by populateAnswerSpecificFormPart().

297  : bool
298  {
299  return $this->ctrl->getCmd() == 'uploaddefinitions';
300  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ isTermImgUploadCommand()

assMatchingQuestionGUI::isTermImgUploadCommand ( )
private

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

References ILIAS\Repository\ctrl().

Referenced by populateAnswerSpecificFormPart().

302  : bool
303  {
304  return $this->ctrl->getCmd() == 'uploadterms';
305  }
+ Here is the call graph for this function:
+ 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 314 of file class.assMatchingQuestionGUI.php.

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

Referenced by editQuestion().

314  : bool
315  {
316  $matchingMode = $form->getItemByPostVar('matching_mode')->getValue();
317 
318  if ($matchingMode == assMatchingQuestion::MATCHING_MODE_N_ON_N) {
319  return true;
320  }
321 
322  $numTerms = count($form->getItemByPostVar('terms')->getValues());
323  $numDefinitions = count($form->getItemByPostVar('definitions')->getValues());
324 
325  if ($numTerms >= $numDefinitions) {
326  return true;
327  }
328 
329  return false;
330  }
ilPropertyFormGUI\getItemByPostVar
getItemByPostVar(string $a_post_var)
Definition: class.ilPropertyFormGUI.php:251
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateAnswerSpecificFormPart()

assMatchingQuestionGUI::populateAnswerSpecificFormPart ( \ilPropertyFormGUI  $form)

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

References ilPropertyFormGUI\addItem(), isDefImgUploadCommand(), isTermImgUploadCommand(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ilMatchingWizardInputGUI\setHideImages(), and ilFormPropertyGUI\setRequired().

Referenced by editQuestion().

332  : ilPropertyFormGUI
333  {
334  $definitions = new ilMatchingWizardInputGUI($this->lng->txt("definitions"), "definitions");
335  if ($this->object->getSelfAssessmentEditingMode()) {
336  $definitions->setHideImages(true);
337  }
338 
339  $stripHtmlEntitesFromValues = function (assAnswerMatchingTerm $value) {
340  return $value->withText(html_entity_decode($value->getText()));
341  };
342 
343  $definitions->setRequired(true);
344  $definitions->setQuestionObject($this->object);
345  $definitions->setTextName($this->lng->txt('definition_text'));
346  $definitions->setImageName($this->lng->txt('definition_image'));
347  if (!count($this->object->getDefinitions())) {
348  $this->object->addDefinition(new assAnswerMatchingDefinition());
349  }
350  $definitionvalues = array_map($stripHtmlEntitesFromValues, $this->object->getDefinitions());
351  $definitions->setValues($definitionvalues);
352  if ($this->isDefImgUploadCommand()) {
353  $definitions->checkInput();
354  }
355  $definitions->setInfo($this->lng->txt('latex_edit_info'));
356  $form->addItem($definitions);
357 
358  $terms = new ilMatchingWizardInputGUI($this->lng->txt("terms"), "terms");
359  if ($this->object->getSelfAssessmentEditingMode()) {
360  $terms->setHideImages(true);
361  }
362  $terms->setRequired(true);
363  $terms->setQuestionObject($this->object);
364  $terms->setTextName($this->lng->txt('term_text'));
365  $terms->setImageName($this->lng->txt('term_image'));
366 
367  if (0 === count($this->object->getTerms())) {
368  // @PHP8-CR: If you look above, how $this->object->addDefinition does in fact take an object, I take this
369  // issue as an indicator for a bigger issue and won't suppress / "quickfix" this but postpone further
370  // analysis, eventually involving T&A TechSquad
371  $this->object->addTerm(new assAnswerMatchingTerm());
372  }
373  $termvalues = array_map($stripHtmlEntitesFromValues, $this->object->getTerms());
374  $terms->setValues($termvalues);
375  if ($this->isTermImgUploadCommand()) {
376  $terms->checkInput();
377  }
378  $terms->setInfo($this->lng->txt('latex_edit_info'));
379  $form->addItem($terms);
380 
381  $pairs = new ilMatchingPairWizardInputGUI($this->lng->txt('matching_pairs'), 'pairs');
382  $pairs->setRequired(true);
383  $pairs->setTerms($this->object->getTerms());
384  $pairs->setDefinitions($this->object->getDefinitions());
385  if (count($this->object->getMatchingPairs()) == 0) {
386  $this->object->addMatchingPair($termvalues[0], $definitionvalues[0], 0);
387  //$this->object->addMatchingPair(new assAnswerMatchingPair($termvalues[0], $definitionvalues[0], 0));
388  }
389  $pairs->setPairs($this->object->getMatchingPairs());
390  $form->addItem($pairs);
391 
392  return $form;
393  }
assAnswerMatchingTerm
Class for matching question terms.
Definition: class.assAnswerMatchingTerm.php:27
ilMatchingWizardInputGUI
This class represents a single choice wizard property in a property form.
Definition: class.ilMatchingWizardInputGUI.php:34
ilMatchingWizardInputGUI\setHideImages
setHideImages($a_hide)
Set hide images.
Definition: class.ilMatchingWizardInputGUI.php:94
array_map
ilFormPropertyGUI\setRequired
setRequired(bool $a_required)
Definition: class.ilFormPropertyGUI.php:156
assAnswerMatchingDefinition
Class for matching question definitions.
Definition: class.assAnswerMatchingDefinition.php:27
ilMatchingPairWizardInputGUI
This class represents a key value pair wizard property in a property form.
Definition: class.ilMatchingPairWizardInputGUI.php:31
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateAssignedTerms()

assMatchingQuestionGUI::populateAssignedTerms ( ilTemplate  $definition_template,
int  $definition_id,
array  $assigned_term_ids,
array  $available_terms 
)
private
Parameters
array<int>$term_ids

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

References $c, buildTermHtml(), getArrayKeyForTermId(), assMatchingQuestion\MATCHING_MODE_1_ON_1, null, ILIAS\Repository\object(), and HTML_Template_IT\setVariable().

Referenced by populateDefinition().

762  : array {
763  $definition_template->setVariable('ASSIGNED_TERMS', json_encode($assigned_term_ids));
764  $definition_template->setVariable(
765  'TERMS_PRESENTATION_ASSIGNED',
766  array_reduce(
767  $assigned_term_ids,
768  function (string $c, int $v) use ($definition_id, &$available_terms) {
769  $key = $this->getArrayKeyForTermId($v, $available_terms);
770  if ($key === null) {
771  return $c;
772  }
773  $c .= $this->buildTermHtml($available_terms[$key], $definition_id);
774  if ($this->object->getMatchingMode() === assMatchingQuestion::MATCHING_MODE_1_ON_1) {
775  unset($available_terms[$key]);
776  }
777  return $c;
778  },
779  ''
780  )
781  );
782 
783  return $available_terms;
784  }
assMatchingQuestionGUI\getArrayKeyForTermId
getArrayKeyForTermId(int $term_id, array $terms)
Definition: class.assMatchingQuestionGUI.php:786
$c
$c
Definition: deliver.php:25
null
while($session_entry=$r->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) return null
Definition: shib_logout.php:144
assMatchingQuestionGUI\buildTermHtml
buildTermHtml(assAnswerMatchingTerm $term, ?int $definition_id=null)
Definition: class.assMatchingQuestionGUI.php:796
HTML_Template_IT\setVariable
setVariable($variable, $value='')
Sets a variable value.
Definition: IT.php:544
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateCorrectionsFormProperties()

assMatchingQuestionGUI::populateCorrectionsFormProperties ( ilPropertyFormGUI  $form)

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

References ilPropertyFormGUI\addItem(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilFormPropertyGUI\setRequired().

1122  : void
1123  {
1124  $pairs = new ilAssMatchingPairCorrectionsInputGUI($this->lng->txt('matching_pairs'), 'pairs');
1125  $pairs->setRequired(true);
1126  $pairs->setTerms($this->object->getTerms());
1127  $pairs->setDefinitions($this->object->getDefinitions());
1128  $pairs->setPairs($this->object->getMatchingPairs());
1129  $pairs->setThumbsWebPathWithPrefix($this->object->getImagePathWeb() . $this->object->getThumbPrefix());
1130  $form->addItem($pairs);
1131  }
ilFormPropertyGUI\setRequired
setRequired(bool $a_required)
Definition: class.ilFormPropertyGUI.php:156
+ Here is the call graph for this function:

◆ populateDefinition()

assMatchingQuestionGUI::populateDefinition ( ilTemplate  $template,
assAnswerMatchingDefinition  $definition,
array  $solutions,
array  $terms 
)
private

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

References assAnswerMatchingTerm\getIdentifier(), ilUtil\getImagePath(), assAnswerMatchingTerm\getPicture(), assAnswerMatchingTerm\getText(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ilTemplate\parseCurrentBlock(), populateAssignedTerms(), ilLegacyFormElementsUtil\prepareTextareaOutput(), assQuestionGUI\renderLatex(), ilTemplate\setCurrentBlock(), and HTML_Template_IT\setVariable().

Referenced by getPreview(), and getTestOutput().

718  : array {
719  if ($definition->getPicture() !== '') {
720  $template->setCurrentBlock('definition_picture');
721  $template->setVariable('DEFINITION_ID', $definition->getIdentifier());
722  $template->setVariable('IMAGE_HREF', $this->object->getImagePathWeb() . $definition->getPicture());
723  $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $definition->getPicture();
724  $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $definition->getPicture();
725  if (!file_exists($thumb)) {
726  $this->object->rebuildThumbnails();
727  }
728  $template->setVariable('THUMBNAIL_HREF', $thumbweb);
729  $template->setVariable('THUMB_ALT', $this->lng->txt('image'));
730  $template->setVariable('THUMB_TITLE', $this->lng->txt('image'));
731  $template->setVariable('TEXT_DEFINITION', (strlen($definition->getText())) ? $this->renderLatex(
732  ilLegacyFormElementsUtil::prepareTextareaOutput($definition->getText(), true, true)
733  ) : '');
734  $template->setVariable('TEXT_PREVIEW', $this->lng->txt('preview'));
735  $template->setVariable('IMG_PREVIEW', ilUtil::getImagePath('media/enlarge.svg'));
736  $template->parseCurrentBlock();
737  } else {
738  $template->setCurrentBlock('definition_text');
739  $template->setVariable('DEFINITION', $this->renderLatex(
740  ilLegacyFormElementsUtil::prepareTextareaOutput($definition->getText(), true, true)
741  ));
742  $template->parseCurrentBlock();
743  }
744 
745  if ($solutions === []
746  || !array_key_exists($definition->getIdentifier(), $solutions)) {
747  $template->setVariable('ASSIGNED_TERMS', json_encode([]));
748  return $terms;
749  }
750 
751  return $this->populateAssignedTerms($template, $definition->getIdentifier(), $solutions[$definition->getIdentifier()], $terms);
752  }
ilTemplate\parseCurrentBlock
parseCurrentBlock(string $part=ilGlobalTemplateInterface::DEFAULT_BLOCK)
Definition: class.ilTemplate.php:216
assQuestionGUI\renderLatex
renderLatex($content)
Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in th...
Definition: class.assQuestionGUI.php:1904
HTML_Template_IT\setVariable
setVariable($variable, $value='')
Sets a variable value.
Definition: IT.php:544
ilUtil\getImagePath
static getImagePath(string $image_name, string $module_path="", string $mode="output", bool $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:68
ilTemplate\setCurrentBlock
setCurrentBlock(string $part=ilGlobalTemplateInterface::DEFAULT_BLOCK)
Definition: class.ilTemplate.php:186
assMatchingQuestionGUI\populateAssignedTerms
populateAssignedTerms(ilTemplate $definition_template, int $definition_id, array $assigned_term_ids, array $available_terms)
Definition: class.assMatchingQuestionGUI.php:757
ilLegacyFormElementsUtil\prepareTextareaOutput
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free...
Definition: class.ilLegacyFormElementsUtil.php:109
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateQuestionSpecificFormPart()

assMatchingQuestionGUI::populateQuestionSpecificFormPart ( \ilPropertyFormGUI  $form)

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

References ilPropertyFormGUI\addItem(), ILIAS\Repository\lng(), assMatchingQuestion\MATCHING_MODE_1_ON_1, assMatchingQuestion\MATCHING_MODE_N_ON_N, ILIAS\Repository\object(), ilSelectInputGUI\setOptions(), ilFormPropertyGUI\setRequired(), ilNumberInputGUI\setValue(), and ilRadioOption\setValue().

Referenced by editQuestion().

395  : ilPropertyFormGUI
396  {
397  // Edit mode
398  $hidden = new ilHiddenInputGUI("matching_type");
399  $hidden->setValue('');
400  $form->addItem($hidden);
401 
402  if (!$this->object->getSelfAssessmentEditingMode()) {
403  // shuffle
404  $shuffle = new ilSelectInputGUI($this->lng->txt("shuffle_answers"), "shuffle");
405  $shuffle_options = [
406  0 => $this->lng->txt("no"),
407  1 => $this->lng->txt("matching_shuffle_terms_definitions"),
408  2 => $this->lng->txt("matching_shuffle_terms"),
409  3 => $this->lng->txt("matching_shuffle_definitions")
410  ];
411  $shuffle->setOptions($shuffle_options);
412  $shuffle->setValue($this->object->getShuffleMode());
413  $shuffle->setRequired(false);
414  $form->addItem($shuffle);
415 
416  $geometry = new ilNumberInputGUI($this->lng->txt('thumb_size'), 'thumb_geometry');
417  $geometry->setValue((string) $this->object->getThumbGeometry());
418  $geometry->setRequired(true);
419  $geometry->setMaxLength(6);
420  $geometry->setMinValue($this->object->getMinimumThumbSize());
421  $geometry->setMaxValue($this->object->getMaximumThumbSize());
422  $geometry->setSize(6);
423  $geometry->setInfo($this->lng->txt('thumb_size_info'));
424  $form->addItem($geometry);
425  }
426 
427  // Matching Mode
428  $mode = new ilRadioGroupInputGUI($this->lng->txt('qpl_qst_inp_matching_mode'), 'matching_mode');
429  $mode->setRequired(true);
430 
431  $modeONEonONE = new ilRadioOption(
432  $this->lng->txt('qpl_qst_inp_matching_mode_one_on_one'),
433  assMatchingQuestion::MATCHING_MODE_1_ON_1
434  );
435  $mode->addOption($modeONEonONE);
436 
437  $modeALLonALL = new ilRadioOption(
438  $this->lng->txt('qpl_qst_inp_matching_mode_all_on_all'),
439  assMatchingQuestion::MATCHING_MODE_N_ON_N
440  );
441  $mode->addOption($modeALLonALL);
442 
443  $mode->setValue($this->object->getMatchingMode());
444 
445  $form->addItem($mode);
446  return $form;
447  }
ilRadioOption
This class represents an option in a radio group.
Definition: class.ilRadioOption.php:27
ilSelectInputGUI
This class represents a selection list property in a property form.
Definition: class.ilSelectInputGUI.php:27
ilSelectInputGUI\setOptions
setOptions(array $a_options)
Definition: class.ilSelectInputGUI.php:49
ilHiddenInputGUI
This class represents a hidden form property in a property form.
Definition: class.ilHiddenInputGUI.php:27
ilRadioGroupInputGUI
This class represents a property in a property form.
Definition: class.ilRadioGroupInputGUI.php:27
ilNumberInputGUI
This class represents a number property in a property form.
Definition: class.ilNumberInputGUI.php:27
ilNumberInputGUI\setValue
setValue(?string $a_value)
Definition: class.ilNumberInputGUI.php:63
ilRadioOption\setValue
setValue(string $a_value)
Definition: class.ilRadioOption.php:65
ilFormPropertyGUI\setRequired
setRequired(bool $a_required)
Definition: class.ilFormPropertyGUI.php:156
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ removedefinitions()

assMatchingQuestionGUI::removedefinitions ( )

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

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

230  : void
231  {
232  $this->setAdditionalContentEditingModeFromPost();
233  $this->writePostData(true);
234  $this->object->deleteDefinition($this->request_data_collector->getCmdIndex('removedefinitions'));
235  $this->editQuestion();
236  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ removeimagedefinitions()

assMatchingQuestionGUI::removeimagedefinitions ( )

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

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

197  : void
198  {
199  $this->setAdditionalContentEditingModeFromPost();
200  $this->writePostData(true);
201  $this->object->removeDefinitionImage($this->request_data_collector->getCmdIndex('removeimagedefinitions'));
202  $this->editQuestion();
203  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ removeimageterms()

assMatchingQuestionGUI::removeimageterms ( )

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

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

182  : void
183  {
184  $this->setAdditionalContentEditingModeFromPost();
185  $this->writePostData(true);
186  $this->object->removeTermImage($this->request_data_collector->getCmdIndex('removeimageterms'));
187  $this->editQuestion();
188  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ removepairs()

assMatchingQuestionGUI::removepairs ( )

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

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

246  : void
247  {
248  $this->setAdditionalContentEditingModeFromPost();
249  $this->writePostData(true);
250  $this->object->deleteMatchingPair($this->request_data_collector->getCmdIndex('removepairs'));
251  $this->editQuestion();
252  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ removeterms()

assMatchingQuestionGUI::removeterms ( )

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

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

214  : void
215  {
216  $this->setAdditionalContentEditingModeFromPost();
217  $this->writePostData(true);
218  $this->object->deleteTerm($this->request_data_collector->getCmdIndex('removeterms'));
219  $this->editQuestion();
220  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ renderSolutionOutput()

assMatchingQuestionGUI::renderSolutionOutput ( mixed  $user_solutions,
int  $active_id,
?int  $pass,
bool  $graphical_output = false,
bool  $result_output = false,
bool  $show_question_only = true,
bool  $show_feedback = false,
bool  $show_correct_solution = false,
bool  $show_manual_scoring = false,
bool  $show_question_text = true,
bool  $show_autosave_title = false,
bool  $show_inline_feedback = false 
)

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

References ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_CORRECT, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_WRONG, assQuestionGUI\generateCorrectnessIconsForCorrectness(), assQuestionGUI\getGenericFeedbackOutput(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), getSpecificFeedbackOutput(), assQuestionGUI\hasCorrectSolution(), isCorrectMatching(), assQuestionGUI\isTestPresentationContext(), ILIAS\Repository\lng(), null, ILIAS\Repository\object(), ilLegacyFormElementsUtil\prepareFormOutput(), ilLegacyFormElementsUtil\prepareTextareaOutput(), and ilWACSignedPath\signFile().

Referenced by getSolutionOutput().

503  : ?string {
504  $template = new ilTemplate('tpl.il_as_qpl_matching_output_solution.html', true, true, 'components/ILIAS/TestQuestionPool');
505  $solutiontemplate = new ilTemplate('tpl.il_as_tst_solution_output.html', true, true, 'components/ILIAS/TestQuestionPool');
506  $i = 0;
507 
508  foreach ($user_solutions as $solution) {
509  $definition = $this->object->getDefinitionWithIdentifier($solution['value2']);
510  $term = $this->object->getTermWithIdentifier($solution['value1']);
511  $points = $solution['points'];
512 
513  if (is_object($definition)) {
514  if ($definition->getPicture() !== '') {
515  if ($definition->getText() !== '') {
516  $template->setCurrentBlock('definition_image_text');
517  $template->setVariable(
518  'TEXT_DEFINITION',
519  ilLegacyFormElementsUtil::prepareFormOutput($definition->getText())
520  );
521  $template->parseCurrentBlock();
522  }
523 
524  $answerImageSrc = ilWACSignedPath::signFile(
525  $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $definition->getPicture()
526  );
527 
528  $template->setCurrentBlock('definition_image');
529  $template->setVariable('ANSWER_IMAGE_URL', $answerImageSrc);
530  $template->setVariable(
531  'ANSWER_IMAGE_ALT',
532  (strlen($definition->getText())) ? ilLegacyFormElementsUtil::prepareFormOutput(
533  $definition->getText()
534  ) : ilLegacyFormElementsUtil::prepareFormOutput($definition->getPicture())
535  );
536  $template->setVariable(
537  'ANSWER_IMAGE_TITLE',
538  (strlen($definition->getText())) ? ilLegacyFormElementsUtil::prepareFormOutput(
539  $definition->getText()
540  ) : ilLegacyFormElementsUtil::prepareFormOutput($definition->getPicture())
541  );
542  $template->setVariable('URL_PREVIEW', $this->object->getImagePathWeb() . $definition->getPicture());
543  $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
544  $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('media/enlarge.svg'));
545  $template->parseCurrentBlock();
546  } else {
547  $template->setCurrentBlock('definition_text');
548  $template->setVariable("DEFINITION", ilLegacyFormElementsUtil::prepareTextareaOutput($definition->getText(), true));
549  $template->parseCurrentBlock();
550  }
551  }
552  if ($term !== null) {
553  if (strlen($term->getPicture())) {
554  if (strlen($term->getText())) {
555  $template->setCurrentBlock('term_image_text');
556  $template->setVariable("TEXT_TERM", ilLegacyFormElementsUtil::prepareFormOutput($term->getText()));
557  $template->parseCurrentBlock();
558  }
559 
560  $answerImageSrc = ilWACSignedPath::signFile(
561  $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $term->getPicture()
562  );
563 
564  $template->setCurrentBlock('term_image');
565  $template->setVariable('ANSWER_IMAGE_URL', $answerImageSrc);
566  $template->setVariable(
567  'ANSWER_IMAGE_ALT',
568  (strlen($term->getText())) ? ilLegacyFormElementsUtil::prepareFormOutput(
569  $term->getText()
570  ) : ilLegacyFormElementsUtil::prepareFormOutput($term->getPicture())
571  );
572  $template->setVariable(
573  'ANSWER_IMAGE_TITLE',
574  (strlen($term->getText())) ? ilLegacyFormElementsUtil::prepareFormOutput(
575  $term->getText()
576  ) : ilLegacyFormElementsUtil::prepareFormOutput($term->getPicture())
577  );
578  $template->setVariable('URL_PREVIEW', $this->object->getImagePathWeb() . $term->getPicture());
579  $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
580  $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('media/enlarge.svg'));
581  $template->parseCurrentBlock();
582  } else {
583  $template->setCurrentBlock('term_text');
584  $template->setVariable("TERM", ilLegacyFormElementsUtil::prepareTextareaOutput($term->getText(), true));
585  $template->parseCurrentBlock();
586  }
587  $i++;
588  }
589  if (($active_id > 0) && (!$show_correct_solution)) {
590  if ($graphical_output) {
591  // output of ok/not ok icons for user entered solutions
592  $ok = false;
593  foreach ($this->object->getMatchingPairs() as $pair) {
594  if ($this->isCorrectMatching($pair, $definition, $term)) {
595  $ok = true;
596  }
597  }
598 
599  $correctness_icon = $this->generateCorrectnessIconsForCorrectness(self::CORRECTNESS_NOT_OK);
600  if ($ok) {
601  $correctness_icon = $this->generateCorrectnessIconsForCorrectness(self::CORRECTNESS_OK);
602  }
603  $template->setCurrentBlock('icon_ok');
604  $template->setVariable('ICON_OK', $correctness_icon);
605  $template->parseCurrentBlock();
606  }
607  }
608 
609  if ($result_output) {
610  $resulttext = ($points == 1) ? '(%s ' . $this->lng->txt('point') . ')' : '(%s ' . $this->lng->txt('points') . ')';
611  $template->setCurrentBlock('result_output');
612  $template->setVariable('RESULT_OUTPUT', sprintf($resulttext, $points));
613  $template->parseCurrentBlock();
614  }
615 
616  $template->setCurrentBlock('row');
617  $template->setVariable('TEXT_MATCHES', $this->lng->txt('matches'));
618  $template->parseCurrentBlock();
619  }
620 
621  if ($show_question_text == true) {
622  $template->setVariable('QUESTIONTEXT', $this->object->getQuestionForHTMLOutput());
623  }
624 
625  $questionoutput = $template->get();
626 
627  $feedback = '';
628  if ($show_feedback) {
629  if (!$this->isTestPresentationContext()) {
630  $fb = $this->getGenericFeedbackOutput((int) $active_id, $pass);
631  $feedback .= strlen($fb) ? $fb : '';
632  }
633 
634  $fb = $this->getSpecificFeedbackOutput([]);
635  $feedback .= strlen($fb) ? $fb : '';
636  }
637  if (strlen($feedback)) {
638  $cssClass = (
639  $this->hasCorrectSolution($active_id, $pass) ?
640  ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_CORRECT : ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_WRONG
641  );
642 
643  $solutiontemplate->setVariable('ILC_FB_CSS_CLASS', $cssClass);
644  $solutiontemplate->setVariable('FEEDBACK', ilLegacyFormElementsUtil::prepareTextareaOutput($feedback, true));
645  }
646 
647  $solutiontemplate->setVariable('SOLUTION_OUTPUT', $questionoutput);
648 
649  $solutionoutput = $solutiontemplate->get();
650  if (!$show_question_only) {
651  // get page object output
652  $solutionoutput = $this->getILIASPage($solutionoutput);
653  }
654  return $solutionoutput;
655  }
assQuestionGUI\hasCorrectSolution
hasCorrectSolution($activeId, $passIndex)
Definition: class.assQuestionGUI.php:1627
assQuestionGUI\generateCorrectnessIconsForCorrectness
generateCorrectnessIconsForCorrectness(int $correctness)
Definition: class.assQuestionGUI.php:1818
ilLegacyFormElementsUtil\prepareFormOutput
static prepareFormOutput($a_str, bool $a_strip=false)
Definition: class.ilLegacyFormElementsUtil.php:37
null
while($session_entry=$r->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) return null
Definition: shib_logout.php:144
ilUtil\getImagePath
static getImagePath(string $image_name, string $module_path="", string $mode="output", bool $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:68
assMatchingQuestionGUI\isCorrectMatching
isCorrectMatching($pair, $definition, $term)
Definition: class.assMatchingQuestionGUI.php:1019
assMatchingQuestionGUI\getSpecificFeedbackOutput
getSpecificFeedbackOutput(array $userSolution)
Definition: class.assMatchingQuestionGUI.php:955
assQuestionGUI\getILIASPage
getILIASPage(string $html="")
Returns the ILIAS Page around a question.
Definition: class.assQuestionGUI.php:629
ilWACSignedPath\signFile
static signFile(string $path_to_file)
Definition: class.ilWACSignedPath.php:212
ilLegacyFormElementsUtil\prepareTextareaOutput
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free...
Definition: class.ilLegacyFormElementsUtil.php:109
assQuestionGUI\getGenericFeedbackOutput
getGenericFeedbackOutput(int $active_id, ?int $pass)
Definition: class.assQuestionGUI.php:1004
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ saveCorrectionsFormProperties()

assMatchingQuestionGUI::saveCorrectionsFormProperties ( ilPropertyFormGUI  $form)
Parameters
ilPropertyFormGUI$form

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

References $id.

1136  : void
1137  {
1138  $pairs = $this->object->getMatchingPairs();
1139  $nu_pairs = [];
1140 
1141  if ($this->request_data_collector->isset('pairs')) {
1142  $points_of_pairs = $this->request_data_collector->raw('pairs')['points'];
1143  $pair_terms = explode(',', $this->request_data_collector->raw('pairs')['term_id']);
1144  $pair_definitions = explode(',', $this->request_data_collector->raw('pairs')['definition_id']);
1145  $values = [];
1146  foreach ($points_of_pairs as $idx => $points) {
1147  $k = implode('.', [$pair_terms[$idx], $pair_definitions[$idx]]);
1148  $values[$k] = (float) str_replace(',', '.', $points);
1149  }
1150 
1151  foreach ($pairs as $idx => $pair) {
1152  $id = implode('.', [
1153  $pair->getTerm()->getIdentifier(),
1154  $pair->getDefinition()->getIdentifier()
1155  ]);
1156  $nu_pairs[$id] = $pair->withPoints($values[$id]);
1157  }
1158 
1159  $this->object = $this->object->withMatchingPairs($nu_pairs);
1160  }
1161  }
$id
$id
plugin.php for ilComponentBuildPluginInfoObjectiveTest::testAddPlugins
Definition: plugin.php:23

◆ sortDefinitionsBySolution()

assMatchingQuestionGUI::sortDefinitionsBySolution ( array  $solutions,
array  $definitions 
)
protected
Parameters
array<int,int>$solution
array<assAnswerMatchingDefinition>$definitions
Returns
array

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

Referenced by getTestOutput().

867  : array
868  {
869  $neworder = [];
870  $handled_definitions = [];
871  foreach (array_keys($solutions) as $definition_id) {
872  $neworder[] = $this->object->getDefinitionWithIdentifier($definition_id);
873  $handled_definitions[$definition_id] = $definition_id;
874  }
875 
876  foreach ($definitions as $definition) {
877  if (!isset($handled_definitions[$definition->getIdentifier()])) {
878  $neworder[] = $definition;
879  }
880  }
881 
882  return $neworder;
883  }
+ Here is the caller graph for this function:

◆ uploaddefinitions()

assMatchingQuestionGUI::uploaddefinitions ( )

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

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

190  : void
191  {
192  $this->setAdditionalContentEditingModeFromPost();
193  $this->writePostData(true);
194  $this->editQuestion();
195  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ uploadterms()

assMatchingQuestionGUI::uploadterms ( )

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

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

175  : void
176  {
177  $this->setAdditionalContentEditingModeFromPost();
178  $this->writePostData(true);
179  $this->editQuestion();
180  }
assMatchingQuestionGUI\writePostData
writePostData(bool $always=false)
{}
Definition: class.assMatchingQuestionGUI.php:52
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ Here is the call graph for this function:

◆ writeAnswerSpecificPostData()

assMatchingQuestionGUI::writeAnswerSpecificPostData ( ilPropertyFormGUI  $form)

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

Implements ilGuiAnswerScoringAdjustable.

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

References $filename, ILIAS\Repository\object(), ILIAS\Repository\refinery(), and ilUtil\stripSlashes().

Referenced by writePostData().

65  : void
66  {
67  // Delete all existing answers and create new answers from the form data
68  $this->object->flushMatchingPairs();
69  $this->object->flushTerms();
70  $this->object->flushDefinitions();
71 
72  $kindlyTo = $this->refinery->kindlyTo();
73 
74  $uploads = $this->request_data_collector->getProcessedUploads();
75  $allowed_mime_types = ['image/jpeg', 'image/png', 'image/gif'];
76 
77  if ($this->request_data_collector->isset('terms')) {
78  $terms = $this->request_data_collector->raw('terms');
79  $answers = $this->forms_helper->transformArray($terms, 'answer', $kindlyTo->string());
80  $terms_image_names = $this->forms_helper->transformArray($terms, 'imagename', $kindlyTo->string());
81  $terms_identifiers = $this->forms_helper->transformArray($terms, 'identifier', $kindlyTo->int());
82 
83  foreach ($answers as $index => $answer) {
84  $filename = $terms_image_names[$index] ?? '';
85 
86  $upload_tmp_name = $this->request_data_collector->getUploadFilename(['terms', 'image'], $index);
87 
88  if (isset($uploads[$upload_tmp_name]) && $uploads[$upload_tmp_name]->isOk() &&
89  in_array($uploads[$upload_tmp_name]->getMimeType(), $allowed_mime_types)) {
90  $filename = '';
91  $name = $uploads[$upload_tmp_name]->getName();
92  if ($this->object->setImageFile(
93  $uploads[$upload_tmp_name]->getPath(),
94  $this->object->getEncryptedFilename($name)
95  )) {
96  $filename = $this->object->getEncryptedFilename($name);
97  }
98  }
99  // @PHP8-CR: There seems to be a bigger issue lingering here and won't suppress / "quickfix" this but
100  // postpone further analysis, eventually involving T&A TechSquad (see also remark in assMatchingQuestionGUI
101  $this->object->addTerm(
102  new assAnswerMatchingTerm(
103  ilUtil::stripSlashes(htmlentities($answer)),
104  $filename,
105  $terms_identifiers[$index] ?? 0
106  )
107  );
108  }
109  }
110 
111  if ($this->request_data_collector->isset('definitions')) {
112  $definitions = $this->request_data_collector->raw('definitions');
113  $answers = $this->forms_helper->transformArray($definitions, 'answer', $kindlyTo->string());
114  $definitions_image_names = $this->forms_helper->transformArray($definitions, 'imagename', $kindlyTo->string());
115  $definitions_identifiers = $this->forms_helper->transformArray($definitions, 'identifier', $kindlyTo->int());
116 
117  foreach ($answers as $index => $answer) {
118  $filename = $definitions_image_names[$index] ?? '';
119 
120  $upload_tmp_name = $this->request_data_collector->getUploadFilename(['definitions', 'image'], $index);
121 
122  if (isset($uploads[$upload_tmp_name]) && $uploads[$upload_tmp_name]->isOk() &&
123  in_array($uploads[$upload_tmp_name]->getMimeType(), $allowed_mime_types)) {
124  $filename = '';
125  $name = $uploads[$upload_tmp_name]->getName();
126  if ($this->object->setImageFile(
127  $uploads[$upload_tmp_name]->getPath(),
128  $this->object->getEncryptedFilename($name)
129  )) {
130  $filename = $this->object->getEncryptedFilename($name);
131  }
132  }
133 
134  $this->object->addDefinition(
135  new assAnswerMatchingDefinition(
136  ilUtil::stripSlashes(htmlentities($answer)),
137  $filename,
138  $definitions_identifiers[$index] ?? 0
139  )
140  );
141  }
142  }
143 
144  if ($this->request_data_collector->isset('pairs')) {
145  $pairs = $this->request_data_collector->raw('pairs');
146  $points_of_pairs = $this->forms_helper->transformArray($pairs, 'points', $kindlyTo->float());
147  $pair_terms = $this->forms_helper->transformArray($pairs, 'term', $kindlyTo->int());
148  $pair_definitions = $this->forms_helper->transformArray($pairs, 'definition', $kindlyTo->int());
149 
150  foreach ($points_of_pairs as $index => $points) {
151  $term_id = $pair_terms[$index] ?? 0;
152  $definition_id = $pair_definitions[$index] ?? 0;
153  $this->object->addMatchingPair(
154  $this->object->getTermWithIdentifier($term_id),
155  $this->object->getDefinitionWithIdentifier($definition_id),
156  $points
157  );
158  }
159  }
160  }
assAnswerMatchingTerm
Class for matching question terms.
Definition: class.assAnswerMatchingTerm.php:27
ilUtil\stripSlashes
static stripSlashes(string $a_str, bool $a_strip_html=true, string $a_allow="")
Definition: class.ilUtil.php:392
$filename
$filename
Definition: buildRTE.php:78
assAnswerMatchingDefinition
Class for matching question definitions.
Definition: class.assAnswerMatchingDefinition.php:27
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ writePostData()

assMatchingQuestionGUI::writePostData ( bool  $always = false)
protected

{}

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

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

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

52  : int
53  {
54  $hasErrors = (!$always) ? $this->editQuestion(true) : false;
55  if (!$hasErrors) {
56  $this->writeQuestionGenericPostData();
57  $this->writeQuestionSpecificPostData(new ilPropertyFormGUI());
58  $this->writeAnswerSpecificPostData(new ilPropertyFormGUI());
59  $this->saveTaxonomyAssignments();
60  return 0;
61  }
62  return 1;
63  }
assMatchingQuestionGUI\writeAnswerSpecificPostData
writeAnswerSpecificPostData(ilPropertyFormGUI $form)
Extracts the answer specific values from the request and applies them to the data object...
Definition: class.assMatchingQuestionGUI.php:65
assMatchingQuestionGUI\writeQuestionSpecificPostData
writeQuestionSpecificPostData(ilPropertyFormGUI $form)
Extracts the question specific values from the request and applies them to the data object...
Definition: class.assMatchingQuestionGUI.php:162
assMatchingQuestionGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assMatchingQuestionGUI.php:254
+ 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 the request and applies them to the data object.

Implements ilGuiQuestionScoringAdjustable.

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

References ILIAS\Repository\object().

Referenced by writePostData().

162  : void
163  {
164  if (!$this->object->getSelfAssessmentEditingMode()) {
165  $this->object->setShuffle($this->request_data_collector->int('shuffle'));
166  $this->object->setShuffleMode($this->request_data_collector->int('shuffle'));
167  } else {
168  $this->object->setShuffle(1);
169  $this->object->setShuffleMode(1);
170  }
171  $this->object->setThumbGeometry($this->request_data_collector->int('thumb_geometry'));
172  $this->object->setMatchingMode($this->request_data_collector->string('matching_mode'));
173  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:
The documentation for this class was generated from the following file: