ILIAS  trunk Revision v11.0_alpha-1715-g7fc467680fb
•All Data Structures Namespaces Files Functions Variables Enumerations Enumerator Modules Pages
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 ()
 
 showHints ()
 
 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)
 
- 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 (string $feedback_correct, string $feedback_incorrect, 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_QuestionHints (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)
 
 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:827
$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 829 of file class.assMatchingQuestionGUI.php.

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

Referenced by getTestOutput().

829  : array
830  {
831  if ($active_id === 0) {
832  return [];
833  }
834  if ($user_post_solutions !== false) {
835  return $user_post_solutions['matching'];
836  }
837 
838  return array_reduce(
839  $this->object->getTestOutputSolutions($active_id, $attempt),
840  static function (array $c, array $v): array {
841  if (!array_key_exists($v['value2'], $c)) {
842  $c[$v['value2']] = [$v['value1']];
843  return $c;
844  }
845  $c[$v['value2']][] = $v['value1'];
846  return $c;
847  },
848  []
849  );
850  }
$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 790 of file class.assMatchingQuestionGUI.php.

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

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

790  : string
791  {
792  $template = new ilTemplate('tpl.il_as_qpl_matching_term_output.html', true, true, 'components/ILIAS/TestQuestionPool');
793 
794  $template->setVariable('ID_DRAGGABLE', $term->getIdentifier());
795 
796  if ($definition_id !== null) {
797  $template->setCurrentBlock('definition_id');
798  $template->setVariable('IID_DROPAREA', $definition_id);
799  $template->parseCurrentBlock();
800  }
801 
802  if ($term->getPicture() === '') {
803  $template->setCurrentBlock('term_text');
804  $template->setVariable('TERM_TEXT', ilLegacyFormElementsUtil::prepareTextareaOutput($term->getText(), true, true));
805  $template->parseCurrentBlock();
806  return $template->get();
807  }
808 
809  $template->setCurrentBlock('term_picture');
810  $template->setVariable('TERM_ID', $term->getIdentifier());
811  $template->setVariable('IMAGE_HREF', $this->object->getImagePathWeb() . $term->getPicture());
812  $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $term->getPicture();
813  $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $term->getPicture();
814  if (!file_exists($thumb)) {
815  $this->object->rebuildThumbnails();
816  }
817  $template->setVariable('THUMBNAIL_HREF', $thumbweb);
818  $template->setVariable('THUMB_ALT', $this->lng->txt('image'));
819  $template->setVariable('THUMB_TITLE', $this->lng->txt('image'));
820  $template->setVariable('TEXT_PREVIEW', $this->lng->txt('preview'));
821  $template->setVariable('TEXT_TERM', $term->getText() !== ''
822  ? ilLegacyFormElementsUtil::prepareTextareaOutput($term->getText(), true, true)
823  : '');
824  $template->setVariable('IMG_PREVIEW', ilUtil::getImagePath('media/enlarge.svg'));
825  $template->parseCurrentBlock();
826  return $template->get();
827  }
null
while($session_entry=$r->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) return null
Definition: shib_logout.php:142
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:66
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:110
+ 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 936 of file class.assMatchingQuestionGUI.php.

936  : bool
937  {
938  $title = $this->request_data_collector->string('title');
939  $author = $this->request_data_collector->string('author');
940  $question = $this->request_data_collector->string('question');
941 
942  return !empty($title) && !empty($author) && !empty($question);
943  }

◆ 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:859
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:979
assQuestionGUI\addQuestionFormCommandButtons
addQuestionFormCommandButtons(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:851
assMatchingQuestionGUI\populateQuestionSpecificFormPart
populateQuestionSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMatchingQuestionGUI.php:393
assMatchingQuestionGUI\populateAnswerSpecificFormPart
populateAnswerSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMatchingQuestionGUI.php:332
assQuestionGUI\renderEditForm
renderEditForm(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:627
+ 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 990 of file class.assMatchingQuestionGUI.php.

990  : array
991  {
992  return [];
993  }

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

1004  : array
1005  {
1006  return [];
1007  }

◆ getAnswerFrequencyTableGUI()

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

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

References getAnswersFrequency().

1102  : ilAnswerFrequencyStatisticTableGUI
1103  {
1104  $table = new ilMatchingQuestionAnswerFreqStatTableGUI($parentGui, $parentCmd, $this->object);
1105  $table->setQuestionIndex($questionIndex);
1106  $table->setData($this->getAnswersFrequency($relevantAnswers, $questionIndex));
1107  $table->initColumns();
1108 
1109  return $table;
1110  }
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:1051
+ Here is the call graph for this function:

◆ getAnswersFrequency()

assMatchingQuestionGUI::getAnswersFrequency (   $relevantAnswers,
  $questionIndex 
)

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

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

Referenced by getAnswerFrequencyTableGUI().

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

◆ getAnswerStatisticImageHtml()

assMatchingQuestionGUI::getAnswerStatisticImageHtml (   $picture)
protected

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

Referenced by getAnswerStatisticMatchingElemHtml().

1030  : string
1031  {
1032  $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $picture;
1033  return '<img src="' . $thumbweb . '" alt="' . $picture . '" title="' . $picture . '"/>';
1034  }
+ Here is the caller graph for this function:

◆ getAnswerStatisticMatchingElemHtml()

assMatchingQuestionGUI::getAnswerStatisticMatchingElemHtml (   $elem)
protected

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

References getAnswerStatisticImageHtml().

Referenced by getAnswersFrequency().

1036  : string
1037  {
1038  $html = '';
1039 
1040  if (strlen($elem->getText())) {
1041  $html .= $elem->getText();
1042  }
1043 
1044  if (strlen($elem->getPicture())) {
1045  $html .= $this->getAnswerStatisticImageHtml($elem->getPicture());
1046  }
1047 
1048  return $html;
1049  }
+ 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 780 of file class.assMatchingQuestionGUI.php.

References null.

Referenced by populateAssignedTerms().

780  : ?int
781  {
782  foreach ($terms as $key => $term) {
783  if ($term->getIdentifier() === $term_id) {
784  return $key;
785  }
786  }
787  return null;
788  }
null
while($session_entry=$r->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) return null
Definition: shib_logout.php:142
+ Here is the caller graph for this function:

◆ getPreview()

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

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

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

658  : string {
659  $template = new ilTemplate('tpl.il_as_qpl_matching_output.html', true, true, 'components/ILIAS/TestQuestionPool');
660  $this->initializePlayerJS();
661 
662  $solutions = $this->getPreviewSession()?->getParticipantsSolution() ?? [];
663 
664  // shuffle output
665  $terms = $this->object->getTerms();
666  $definitions = $this->object->getDefinitions();
667  switch ($this->object->getShuffleMode()) {
668  case 1:
669  $terms = $this->object->getShuffler()->transform($terms);
670  $definitions = $this->object->getShuffler()->transform(
671  $this->object->getShuffler()->transform($definitions)
672  );
673  break;
674  case 2:
675  $terms = $this->object->getShuffler()->transform($terms);
676  break;
677  case 3:
678  $definitions = $this->object->getShuffler()->transform($definitions);
679  break;
680  }
681 
682  foreach ($definitions as $definition) {
683  $terms = $this->populateDefinition($template, $definition, $solutions, $terms);
684  $template->setCurrentBlock('droparea');
685  $template->setVariable('ID_DROPAREA', $definition->getIdentifier());
686  $template->setVariable('QUESTION_ID', $this->object->getId());
687  $template->parseCurrentBlock();
688  }
689 
690  $template->setVariable(
691  'TERMS_PRESENTATION_SOURCE',
692  array_reduce(
693  $terms,
694  fn(string $c, assAnswerMatchingTerm $v) => $c . $this->buildTermHtml($v),
695  ''
696  )
697  );
698 
699  $template->setVariable('QUESTIONTEXT', $this->object->getQuestionForHTMLOutput());
700 
701  $questionoutput = $template->get();
702 
703  if (!$show_question_only) {
704  // get page object output
705  $questionoutput = $this->getILIASPage($questionoutput);
706  }
707 
708  return $questionoutput;
709  }
assAnswerMatchingTerm
Class for matching question terms.
Definition: class.assAnswerMatchingTerm.php:27
assMatchingQuestionGUI\populateDefinition
populateDefinition(ilTemplate $template, assAnswerMatchingDefinition $definition, array $solutions, array $terms)
Definition: class.assMatchingQuestionGUI.php:711
$c
$c
Definition: deliver.php:25
assMatchingQuestionGUI\buildTermHtml
buildTermHtml(assAnswerMatchingTerm $term, ?int $definition_id=null)
Definition: class.assMatchingQuestionGUI.php:790
assQuestionGUI\getILIASPage
getILIASPage(string $html="")
Returns the ILIAS Page around a question.
Definition: class.assQuestionGUI.php:637
+ 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 447 of file class.assMatchingQuestionGUI.php.

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

458  : string {
459  $solutions = [];
460  if (($active_id > 0) && (!$show_correct_solution)) {
461  $solutions = $this->object->getSolutionValues($active_id, $pass);
462  } else {
463  foreach ($this->object->getMaximumScoringMatchingPairs() as $pair) {
464  $solutions[] = [
465  'value1' => $pair->getTerm()->getIdentifier(),
466  'value2' => $pair->getDefinition()->getIdentifier(),
467  'points' => $pair->getPoints()
468  ];
469  }
470  }
471 
472  return $this->renderSolutionOutput(
473  $solutions,
474  $active_id,
475  $pass,
476  $graphical_output,
477  $result_output,
478  $show_question_only,
479  $show_feedback,
480  $show_correct_solution,
481  $show_manual_scoring,
482  $show_question_text,
483  false,
484  $show_inline_feedback,
485  );
486  }
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:488
+ Here is the call graph for this function:

◆ getSpecificFeedbackOutput()

assMatchingQuestionGUI::getSpecificFeedbackOutput ( array  $userSolution)

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

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

Referenced by renderSolutionOutput().

945  : string
946  {
947  $matches = array_values($this->object->matchingpairs);
948 
949  if (!$this->object->feedbackOBJ->specificAnswerFeedbackExists()) {
950  return '';
951  }
952 
953  $feedback = '<table class="test_specific_feedback"><tbody>';
954 
955  foreach ($matches as $idx => $ans) {
956  if (!isset($userSolution[$ans->getDefinition()->getIdentifier()])) {
957  continue;
958  }
959 
960  if (!is_array($userSolution[$ans->getDefinition()->getIdentifier()])) {
961  continue;
962  }
963 
964  if (!in_array($ans->getTerm()->getIdentifier(), $userSolution[$ans->getDefinition()->getIdentifier()])) {
965  continue;
966  }
967 
968  $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
969  $this->object->getId(),
970  0,
971  $idx
972  );
973  $feedback .= "<tr><td>\"{$ans->getDefinition()->getText()}\" {$this->lng->txt('matches')} ";
974  $feedback .= "\"{$ans->getTerm()->getText()}\"</td><td>{$fb}</td></tr>";
975  }
976 
977  $feedback .= '</tbody></table>';
978  return ilLegacyFormElementsUtil::prepareTextareaOutput($feedback, true);
979  }
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:110
+ 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 875 of file class.assMatchingQuestionGUI.php.

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

881  : string {
882  $template = new ilTemplate('tpl.il_as_qpl_matching_output.html', true, true, 'components/ILIAS/TestQuestionPool');
883  $this->initializePlayerJS();
884 
885  $solutions = $this->buildSolutionsArray($active_id, $attempt, $user_post_solutions);
886  $terms = $this->object->getTerms();
887  $definitions = $this->object->getDefinitions();
888  switch ($this->object->getShuffleMode()) {
889  case 1:
890  $terms = $this->object->getShuffler()->transform($terms);
891  if ($solutions !== []) {
892  $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
893  } else {
894  $definitions = $this->object->getShuffler()->transform(
895  $this->object->getShuffler()->transform($definitions)
896  );
897  }
898  break;
899  case 2:
900  $terms = $this->object->getShuffler()->transform($terms);
901  break;
902  case 3:
903  if ($solutions !== []) {
904  $definitions = $this->sortDefinitionsBySolution($solutions, $definitions);
905  } else {
906  $definitions = $this->object->getShuffler()->transform($definitions);
907  }
908  break;
909  }
910 
911  foreach ($definitions as $definition) {
912  $terms = $this->populateDefinition($template, $definition, $solutions, $terms);
913  $template->setCurrentBlock('droparea');
914  $template->setVariable('ID_DROPAREA', $definition->getIdentifier());
915  $template->setVariable('QUESTION_ID', $this->object->getId());
916  $template->parseCurrentBlock();
917  }
918 
919  $template->setVariable(
920  'TERMS_PRESENTATION_SOURCE',
921  array_reduce(
922  $terms,
923  fn(string $c, assAnswerMatchingTerm $v) => $c . $this->buildTermHtml($v),
924  ''
925  )
926  );
927 
928  $template->setVariable('QUESTIONTEXT', $this->object->getQuestionForHTMLOutput());
929 
930  return $this->outQuestionPage('', $is_question_postponed, $active_id, $template->get());
931  }
assAnswerMatchingTerm
Class for matching question terms.
Definition: class.assAnswerMatchingTerm.php:27
assMatchingQuestionGUI\populateDefinition
populateDefinition(ilTemplate $template, assAnswerMatchingDefinition $definition, array $solutions, array $terms)
Definition: class.assMatchingQuestionGUI.php:711
$c
$c
Definition: deliver.php:25
assMatchingQuestionGUI\buildTermHtml
buildTermHtml(assAnswerMatchingTerm $term, ?int $definition_id=null)
Definition: class.assMatchingQuestionGUI.php:790
assMatchingQuestionGUI\sortDefinitionsBySolution
sortDefinitionsBySolution(array $solutions, array $definitions)
Definition: class.assMatchingQuestionGUI.php:857
assMatchingQuestionGUI\buildSolutionsArray
buildSolutionsArray(int $active_id, int $attempt, array|bool $user_post_solutions)
Definition: class.assMatchingQuestionGUI.php:829
assQuestionGUI\outQuestionPage
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="", $inlineFeedbackEnabled=false)
Definition: class.assQuestionGUI.php:648
+ Here is the call graph for this function:

◆ initializePlayerJS()

assMatchingQuestionGUI::initializePlayerJS ( )
private

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

Referenced by getPreview(), and getTestOutput().

1153  : void
1154  {
1155  $this->tpl->addJavaScript('assets/js/matching.js');
1156  $this->tpl->addOnLoadCode(
1157  'il.test.matching.init('
1158  . "document.querySelector('#ilMatchingQuestionContainer_{$this->object->getId()}'),"
1159  . "'{$this->object->getMatchingMode()}');"
1160  );
1161  }
+ Here is the caller graph for this function:

◆ isCorrectMatching()

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

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

Referenced by renderSolutionOutput().

1009  : bool
1010  {
1011  if (!($pair->getPoints() > 0)) {
1012  return false;
1013  }
1014 
1015  if (!is_object($term)) {
1016  return false;
1017  }
1018 
1019  if ($pair->getDefinition()->getIdentifier() != $definition->getIdentifier()) {
1020  return false;
1021  }
1022 
1023  if ($pair->getTerm()->getIdentifier() != $term->getIdentifier()) {
1024  return false;
1025  }
1026 
1027  return true;
1028  }
+ 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:250
+ 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  $form->addItem($definitions);
356 
357  $terms = new ilMatchingWizardInputGUI($this->lng->txt("terms"), "terms");
358  if ($this->object->getSelfAssessmentEditingMode()) {
359  $terms->setHideImages(true);
360  }
361  $terms->setRequired(true);
362  $terms->setQuestionObject($this->object);
363  $terms->setTextName($this->lng->txt('term_text'));
364  $terms->setImageName($this->lng->txt('term_image'));
365 
366  if (0 === count($this->object->getTerms())) {
367  // @PHP8-CR: If you look above, how $this->object->addDefinition does in fact take an object, I take this
368  // issue as an indicator for a bigger issue and won't suppress / "quickfix" this but postpone further
369  // analysis, eventually involving T&A TechSquad
370  $this->object->addTerm(new assAnswerMatchingTerm());
371  }
372  $termvalues = array_map($stripHtmlEntitesFromValues, $this->object->getTerms());
373  $terms->setValues($termvalues);
374  if ($this->isTermImgUploadCommand()) {
375  $terms->checkInput();
376  }
377  $form->addItem($terms);
378 
379  $pairs = new ilMatchingPairWizardInputGUI($this->lng->txt('matching_pairs'), 'pairs');
380  $pairs->setRequired(true);
381  $pairs->setTerms($this->object->getTerms());
382  $pairs->setDefinitions($this->object->getDefinitions());
383  if (count($this->object->getMatchingPairs()) == 0) {
384  $this->object->addMatchingPair($termvalues[0], $definitionvalues[0], 0);
385  //$this->object->addMatchingPair(new assAnswerMatchingPair($termvalues[0], $definitionvalues[0], 0));
386  }
387  $pairs->setPairs($this->object->getMatchingPairs());
388  $form->addItem($pairs);
389 
390  return $form;
391  }
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:155
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 751 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().

756  : array {
757  $definition_template->setVariable('ASSIGNED_TERMS', json_encode($assigned_term_ids));
758  $definition_template->setVariable(
759  'TERMS_PRESENTATION_ASSIGNED',
760  array_reduce(
761  $assigned_term_ids,
762  function (string $c, int $v) use ($definition_id, &$available_terms) {
763  $key = $this->getArrayKeyForTermId($v, $available_terms);
764  if ($key === null) {
765  return $c;
766  }
767  $c .= $this->buildTermHtml($available_terms[$key], $definition_id);
768  if ($this->object->getMatchingMode() === assMatchingQuestion::MATCHING_MODE_1_ON_1) {
769  unset($available_terms[$key]);
770  }
771  return $c;
772  },
773  ''
774  )
775  );
776 
777  return $available_terms;
778  }
assMatchingQuestionGUI\getArrayKeyForTermId
getArrayKeyForTermId(int $term_id, array $terms)
Definition: class.assMatchingQuestionGUI.php:780
$c
$c
Definition: deliver.php:25
null
while($session_entry=$r->fetchRow(ilDBConstants::FETCHMODE_ASSOC)) return null
Definition: shib_logout.php:142
assMatchingQuestionGUI\buildTermHtml
buildTermHtml(assAnswerMatchingTerm $term, ?int $definition_id=null)
Definition: class.assMatchingQuestionGUI.php:790
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 1112 of file class.assMatchingQuestionGUI.php.

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

1112  : void
1113  {
1114  $pairs = new ilAssMatchingPairCorrectionsInputGUI($this->lng->txt('matching_pairs'), 'pairs');
1115  $pairs->setRequired(true);
1116  $pairs->setTerms($this->object->getTerms());
1117  $pairs->setDefinitions($this->object->getDefinitions());
1118  $pairs->setPairs($this->object->getMatchingPairs());
1119  $pairs->setThumbsWebPathWithPrefix($this->object->getImagePathWeb() . $this->object->getThumbPrefix());
1120  $form->addItem($pairs);
1121  }
ilFormPropertyGUI\setRequired
setRequired(bool $a_required)
Definition: class.ilFormPropertyGUI.php:155
+ Here is the call graph for this function:

◆ populateDefinition()

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

Definition at line 711 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(), ilTemplate\setCurrentBlock(), and HTML_Template_IT\setVariable().

Referenced by getPreview(), and getTestOutput().

716  : array {
717  if ($definition->getPicture() !== '') {
718  $template->setCurrentBlock('definition_picture');
719  $template->setVariable('DEFINITION_ID', $definition->getIdentifier());
720  $template->setVariable('IMAGE_HREF', $this->object->getImagePathWeb() . $definition->getPicture());
721  $thumbweb = $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $definition->getPicture();
722  $thumb = $this->object->getImagePath() . $this->object->getThumbPrefix() . $definition->getPicture();
723  if (!file_exists($thumb)) {
724  $this->object->rebuildThumbnails();
725  }
726  $template->setVariable('THUMBNAIL_HREF', $thumbweb);
727  $template->setVariable('THUMB_ALT', $this->lng->txt('image'));
728  $template->setVariable('THUMB_TITLE', $this->lng->txt('image'));
729  $template->setVariable('TEXT_DEFINITION', (strlen($definition->getText())) ? ilLegacyFormElementsUtil::prepareTextareaOutput($definition->getText(), true, true) : '');
730  $template->setVariable('TEXT_PREVIEW', $this->lng->txt('preview'));
731  $template->setVariable('IMG_PREVIEW', ilUtil::getImagePath('media/enlarge.svg'));
732  $template->parseCurrentBlock();
733  } else {
734  $template->setCurrentBlock('definition_text');
735  $template->setVariable('DEFINITION', ilLegacyFormElementsUtil::prepareTextareaOutput($definition->getText(), true, true));
736  $template->parseCurrentBlock();
737  }
738 
739  if ($solutions === []
740  || !array_key_exists($definition->getIdentifier(), $solutions)) {
741  $template->setVariable('ASSIGNED_TERMS', json_encode([]));
742  return $terms;
743  }
744 
745  return $this->populateAssignedTerms($template, $definition->getIdentifier(), $solutions[$definition->getIdentifier()], $terms);
746  }
ilTemplate\parseCurrentBlock
parseCurrentBlock(string $part=ilGlobalTemplateInterface::DEFAULT_BLOCK)
Definition: class.ilTemplate.php:216
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:66
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:751
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:110
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateQuestionSpecificFormPart()

assMatchingQuestionGUI::populateQuestionSpecificFormPart ( \ilPropertyFormGUI  $form)

Definition at line 393 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().

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

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

References $id.

1126  : void
1127  {
1128  $pairs = $this->object->getMatchingPairs();
1129  $nu_pairs = [];
1130 
1131  if ($this->request_data_collector->isset('pairs')) {
1132  $points_of_pairs = $this->request_data_collector->raw('pairs')['points'];
1133  $pair_terms = explode(',', $this->request_data_collector->raw('pairs')['term_id']);
1134  $pair_definitions = explode(',', $this->request_data_collector->raw('pairs')['definition_id']);
1135  $values = [];
1136  foreach ($points_of_pairs as $idx => $points) {
1137  $k = implode('.', [$pair_terms[$idx], $pair_definitions[$idx]]);
1138  $values[$k] = (float) str_replace(',', '.', $points);
1139  }
1140 
1141  foreach ($pairs as $idx => $pair) {
1142  $id = implode('.', [
1143  $pair->getTerm()->getIdentifier(),
1144  $pair->getDefinition()->getIdentifier()
1145  ]);
1146  $nu_pairs[$id] = $pair->withPoints($values[$id]);
1147  }
1148 
1149  $this->object = $this->object->withMatchingPairs($nu_pairs);
1150  }
1151  }
$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 857 of file class.assMatchingQuestionGUI.php.

Referenced by getTestOutput().

857  : array
858  {
859  $neworder = [];
860  $handled_definitions = [];
861  foreach (array_keys($solutions) as $definition_id) {
862  $neworder[] = $this->object->getDefinitionWithIdentifier($definition_id);
863  $handled_definitions[$definition_id] = $definition_id;
864  }
865 
866  foreach ($definitions as $definition) {
867  if (!isset($handled_definitions[$definition->getIdentifier()])) {
868  $neworder[] = $definition;
869  }
870  }
871 
872  return $neworder;
873  }
+ 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:390
$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: