Inheritance diagram for ilAssClozeTestFeedback:

Collaboration diagram for ilAssClozeTestFeedback:

Public Member Functions
	isSaveableInPageObjectEditingMode ()

	completeSpecificFormProperties (ilPropertyFormGUI $form)

	initSpecificFormProperties (ilPropertyFormGUI $form)

	saveSpecificFormProperties (ilPropertyFormGUI $form)

	isSpecificAnswerFeedbackAvailable (int $question_id)

	determineTestOutputGapFeedback (int $gapIndex, int $answerIndex)

	determineAnswerIndexForAnswerValue (assClozeGap $gap, string $answerValue)

Public Member Functions inherited from ilAssMultiOptionQuestionFeedback
	getSpecificAnswerFeedbackTestPresentation (int $questionId, int $questionIndex, int $answerIndex)
	returns the html of SPECIFIC feedback for the given question id and answer index for test presentation More...

	completeSpecificFormProperties (ilPropertyFormGUI $form)
	completes a given form object with the specific form properties required by this question type More...

	initSpecificFormProperties (ilPropertyFormGUI $form)
	initialises a given form object's specific form properties relating to this question type More...

	saveSpecificFormProperties (ilPropertyFormGUI $form)

	getSpecificAnswerFeedbackContent (int $questionId, int $questionIndex, int $answerIndex)

	getAllSpecificAnswerFeedbackContents (int $questionId)

	saveSpecificAnswerFeedbackContent (int $questionId, int $questionIndex, int $answerIndex, string $feedbackContent)

	deleteSpecificAnswerFeedbacks (int $questionId, bool $isAdditionalContentEditingModePageObject)

	getAnswerOptionsByAnswerIndex ()

	getSpecificAnswerFeedbackExportPresentation (int $questionId, int $questionIndex, int $answerIndex)

	importSpecificAnswerFeedback (int $questionId, int $questionIndex, int $answerIndex, string $feedbackContent)

	specificAnswerFeedbackExists ()

Public Member Functions inherited from ilAssQuestionFeedback
	__construct (assQuestion $questionOBJ, ilCtrl $ctrl, ilDBInterface $db, ilLanguage $lng)
	constructor More...

	getGenericFeedbackTestPresentation (int $questionId, bool $solutionCompleted)
	returns the html of GENERIC feedback for the given question id for test presentation (either for the complete solution or for the incomplete solution) More...

	getSpecificAnswerFeedbackTestPresentation (int $questionId, int $questionIndex, int $answerIndex)
	returns the html of SPECIFIC feedback for the given question id and answer index for test presentation More...

	completeGenericFormProperties (ilPropertyFormGUI $form)
	completes a given form object with the GENERIC form properties required by all question types More...

	completeSpecificFormProperties (ilPropertyFormGUI $form)
	completes a given form object with the SPECIFIC form properties required by this question type More...

	initGenericFormProperties (ilPropertyFormGUI $form)
	initialises a given form object's GENERIC form properties relating to all question types More...

	initSpecificFormProperties (ilPropertyFormGUI $form)
	initialises a given form object's SPECIFIC form properties relating to this question type More...

	saveGenericFormProperties (ilPropertyFormGUI $form)
	saves a given form object's GENERIC form properties relating to all question types More...

	saveSpecificFormProperties (ilPropertyFormGUI $form)
	saves a given form object's SPECIFIC form properties relating to this question type More...

	isSaveableInPageObjectEditingMode ()
	returns the fact wether the feedback editing form is saveable in page object editing or not. More...

	getGenericFeedbackContent (int $questionId, bool $solutionCompleted)
	returns the GENERIC feedback content for a given question state. More...

	getSpecificAnswerFeedbackContent (int $questionId, int $questionIndex, int $answerIndex)

	getAllSpecificAnswerFeedbackContents (int $questionId)

	isSpecificAnswerFeedbackAvailable (int $questionId)

	saveGenericFeedbackContent (int $questionId, bool $solutionCompleted, string $feedbackContent)
	saves GENERIC feedback content for the given question id to the database. More...

	saveSpecificAnswerFeedbackContent (int $questionId, int $questionIndex, int $answerIndex, string $feedbackContent)

	deleteGenericFeedbacks (int $questionId, bool $isAdditionalContentEditingModePageObject)
	deletes all GENERIC feedback contents (and page objects if required) for the given question id More...

	deleteSpecificAnswerFeedbacks (int $questionId, bool $isAdditionalContentEditingModePageObject)

	duplicateFeedback (int $originalQuestionId, int $duplicateQuestionId)
	duplicates the feedback relating to the given original question id and saves it for the given duplicate question id More...

	syncFeedback (int $originalQuestionId, int $duplicateQuestionId)
	syncs the feedback from a duplicated question back to the original question More...

	checkFeedbackParent (int $feedbackId)

	getClassNameByType (string $a_type, bool $a_gui=false)

	setPageObjectOutputMode (string $page_obj_output_mode)

	getPageObjectOutputMode ()

	getGenericFeedbackExportPresentation (int $questionId, bool $solutionCompleted)
	returns the generic feedback export presentation for given question id either for solution completed or incompleted More...

	getSpecificAnswerFeedbackExportPresentation (int $questionId, int $questionIndex, int $answerIndex)
	returns the generic feedback export presentation for given question id either for solution completed or incompleted More...

	importGenericFeedback (int $questionId, bool $solutionCompleted, string $feedbackContent)
	imports the given feedback content as generic feedback for the given question id for either the complete or incomplete solution More...

	importSpecificAnswerFeedback (int $questionId, int $questionIndex, int $answerIndex, string $feedbackContent)

	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator, int $questionId)

Data Fields
const	FB_MODE_GAP_QUESTION = 'gapQuestion'
	constants for different feedback modes (per gap or per gap-answers/options) More...

const	FB_MODE_GAP_ANSWERS = 'gapAnswers'

const	FB_TEXT_GAP_EMPTY_INDEX = -1
	constants for answer indexes in case of FB_MODE_GAP_ANSWERS More...

const	FB_TEXT_GAP_NOMATCH_INDEX = -2

const	FB_SELECT_GAP_EMPTY_INDEX = -1

const	FB_NUMERIC_GAP_EMPTY_INDEX = -1

const	FB_NUMERIC_GAP_VALUE_HIT_INDEX = 0

const	FB_NUMERIC_GAP_RANGE_HIT_INDEX = 1

const	FB_NUMERIC_GAP_TOO_LOW_INDEX = 2

const	FB_NUMERIC_GAP_TOO_HIGH_INDEX = 3

const	SINGLE_GAP_FB_ANSWER_INDEX = -10

Data Fields inherited from ilAssMultiOptionQuestionFeedback
const	TABLE_NAME_SPECIFIC_FEEDBACK = 'qpl_fb_specific'
	table name for specific feedback More...

Data Fields inherited from ilAssQuestionFeedback
const	CSS_CLASS_FEEDBACK_CORRECT = 'ilc_qfeedr_FeedbackRight'

const	CSS_CLASS_FEEDBACK_WRONG = 'ilc_qfeedw_FeedbackWrong'

const	PAGE_OBJECT_TYPE_GENERIC_FEEDBACK = 'qfbg'
	type for generic feedback page objects More...

const	PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK = 'qfbs'
	type for specific feedback page objects More...

const	FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID = 1
	id for page object relating to generic incomplete solution feedback More...

const	FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID = 2
	id for page object relating to generic complete solution feedback More...

const	TABLE_NAME_GENERIC_FEEDBACK = 'qpl_fb_generic'

Protected Member Functions
	buildGapFeedbackLabel (int $gapIndex, assClozeGap $gap)
	builds an answer option label from given (mixed type) index and answer (overwrites parent method from ilAssMultiOptionQuestionFeedback) More...

	buildTextGapGivenAnswerFeedbackLabel (int $gapIndex, assAnswerCloze $item)

	buildTextGapWrongAnswerFeedbackLabel (int $gapIndex)

	buildTextGapEmptyFeedbackLabel (int $gapIndex)

	buildSelectGapOptionFeedbackLabel (int $gapIndex, assAnswerCloze $item)

	buildSelectGapEmptyFeedbackLabel (int $gapIndex)

	buildNumericGapValueHitFeedbackLabel (int $gapIndex)

	buildNumericGapRangeHitFeedbackLabel (int $gapIndex)

	buildNumericGapTooLowFeedbackLabel (int $gapIndex)

	buildNumericGapTooHighFeedbackLabel (int $gapIndex)

	buildNumericGapEmptyFeedbackLabel (int $gapIndex)

	completeFormPropsForFeedbackModeGapQuestion (ilRadioOption $fbModeOpt)

	completeFormPropsForFeedbackModeGapAnswers (ilRadioOption $fbModeOpt)

	completeFbPropsForTextGap (ilRadioOption $fbModeOpt, assClozeGap $gap, int $gapIndex)

	completeFbPropsForSelectGap (ilRadioOption $fbModeOpt, assClozeGap $gap, int $gapIndex)

	completeFbPropsForNumericGap (ilRadioOption $fbModeOpt, assClozeGap $gap, int $gapIndex)

	initFeedbackFieldsPerGapQuestion (ilPropertyFormGUI $form)

	initFeedbackFieldsPerGapAnswers (ilPropertyFormGUI $form)

	initFbPropsForTextGap (ilPropertyFormGUI $form, assClozeGap $gap, int $gapIndex)

	initFbPropsForSelectGap (ilPropertyFormGUI $form, assClozeGap $gap, int $gapIndex)

	initFbPropsForNumericGap (ilPropertyFormGUI $form, int $gapIndex, assClozeGap $gap)

	saveFeedbackFieldsPerGapQuestion (ilPropertyFormGUI $form)

	saveFeedbackFieldsPerGapAnswers (ilPropertyFormGUI $form)

	saveFbPropsForTextGap (ilPropertyFormGUI $form, assClozeGap $gap, int $gapIndex)

	saveFbPropsForSelectGap (ilPropertyFormGUI $form, assClozeGap $gap, int $gapIndex)

	saveFbPropsForNumericGap (ilPropertyFormGUI $form, assClozeGap $gap, int $gapIndex)

	duplicateSpecificFeedback (int $originalQuestionId, int $duplicateQuestionId)

	syncSpecificFeedback (int $originalQuestionId, int $duplicateQuestionId)

	saveSpecificFeedbackMode (int $questionId, string $feedbackMode)
	saves the given specific feedback mode for the given question id to the db. More...

	buildPostVarForFbFieldPerGapQuestion (int $gapIndex)

	buildPostVarForFbFieldPerGapAnswers (int $gapIndex, int $answerIndex)

	getSpecificAnswerFeedbackFormValue (int $gapIndex, int $answerIndex)

	cleanupSpecificAnswerFeedbacks (string $fbMode)

	fetchFeedbackIdsForGapQuestionMode ()

	fetchFeedbackIdsForGapAnswersMode ()

	deleteSpecificAnswerFeedbacksByIds (array $feedbackIds)

Protected Member Functions inherited from ilAssMultiOptionQuestionFeedback
	duplicateSpecificFeedback (int $originalQuestionId, int $duplicateQuestionId)

	syncSpecificFeedback (int $originalQuestionId, int $duplicateQuestionId)

	getSpecificAnswerFeedbackId (int $questionId, int $questionIndex, int $answerIndex)

	getSpecificFeedbackContentForFeedbackIds (array $feedback_ids)

	isSpecificAnswerFeedbackId (int $feedbackId)

	getSpecificFeedbackTableName ()

	buildAnswerOptionLabel (int $index, $answer)

	getSpecificAnswerFeedbackPageObjectId (int $questionId, int $questionIndex, int $answerIndex)
	returns a useable page object id for specific answer feedback page objects for the given question id and answer index (using the id sequence of non page object specific answer feedback) More...

Protected Member Functions inherited from ilAssQuestionFeedback
	buildFeedbackContentFormProperty (string $label, string $postVar, bool $asNonEditable)
	builds and returns a form property gui object with the given label and postvar that is addable to property forms depending on the given flag "asNonEditable" it returns a ... More...

	duplicateSpecificFeedback (int $originalQuestionId, int $duplicateQuestionId)
	duplicates the SPECIFIC feedback relating to the given original question id and saves it for the given duplicate question id More...

	getGenericFeedbackId (int $questionId, bool $solutionCompleted)
	returns the SPECIFIC answer feedback ID for a given question id and answer index. More...

	isGenericFeedbackId (int $feedbackId)

	isSpecificAnswerFeedbackId (int $feedbackId)

	syncSpecificFeedback (int $originalQuestionId, int $duplicateQuestionId)
	syncs the SPECIFIC feedback from a duplicated question back to the original question More...

	getGenericFeedbackTableName ()

	getPageObjectNonEditableValueHTML (string $pageObjectType, int $pageObjectId)
	returns html content to be used as value for non editable value form properties in feedback editing form More...

	getPageObjectContent (string $pageObjectType, int $pageObjectId)

	getPageObjectXML (string $pageObjectType, int $pageObjectId)

	createPageObject (string $pageObjectType, int $pageObjectId, string $pageObjectContent)

	duplicatePageObject (string $pageObjectType, int $originalPageObjectId, int $duplicatePageObjectId, int $duplicatePageObjectParentId)

	ensurePageObjectDeleted (string $pageObjectType, int $pageObjectId)

	getGenericFeedbackPageObjectType ()

	getSpecificAnswerFeedbackPageObjectType ()

	getGenericFeedbackPageObjectId (int $questionId, bool $solutionCompleted)
	returns a useable page object id for generic feedback page objects for the given question id for either the complete or incomplete solution (using the id sequence of non page object generic feedback) More...

	cleanupPageContent (string $content)

Private Member Functions
	syncSpecificFeedbackSetting (int $sourceQuestionId, int $targetQuestionId)

	randomGroup ()

Additional Inherited Members
Static Public Member Functions inherited from ilAssQuestionFeedback
static	isValidFeedbackPageObjectType (string $feedbackPageObjectType)
	returns the fact whether the given page object type relates to generic or specific feedback page objects More...

Protected Attributes inherited from ilAssQuestionFeedback
assQuestion	$questionOBJ

ilCtrl	$ctrl

ilDBInterface	$db

ilLanguage	$lng

string	$page_obj_output_mode = "presentation"

Detailed Description

Definition at line 29 of file class.ilAssClozeTestFeedback.php.

Member Function Documentation

◆ buildGapFeedbackLabel()

ilAssClozeTestFeedback::buildGapFeedbackLabel	(	int	$gapIndex,
		assClozeGap	$gap
	)

protected

builds an answer option label from given (mixed type) index and answer (overwrites parent method from ilAssMultiOptionQuestionFeedback)

Definition at line 60 of file class.ilAssClozeTestFeedback.php.

References assClozeGap\getItems(), ILIAS\Repository\lng(), and ilLegacyFormElementsUtil\prepareFormOutput().

Referenced by completeFormPropsForFeedbackModeGapQuestion().

                                                                              : string
     {
         $answers = array();
 
         foreach ($gap->getItems($this->randomGroup()->dontShuffle()) as $item) {
             $answers[] = '"' . ilLegacyFormElementsUtil::prepareFormOutput($item->getAnswertext()) . '"';
         }
 
         $answers = implode(' / ', $answers);
 
         return sprintf(
             $this->lng->txt('ass_cloze_gap_fb_gap_label'),
             $gapIndex + 1,
             $answers
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildNumericGapEmptyFeedbackLabel()

ilAssClozeTestFeedback::buildNumericGapEmptyFeedbackLabel ( int $gapIndex )

protected

Definition at line 130 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForNumericGap().

                                                                        : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_num_empty_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildNumericGapRangeHitFeedbackLabel()

ilAssClozeTestFeedback::buildNumericGapRangeHitFeedbackLabel ( int $gapIndex )

protected

Definition at line 115 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForNumericGap().

                                                                           : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_num_rangehit_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildNumericGapTooHighFeedbackLabel()

ilAssClozeTestFeedback::buildNumericGapTooHighFeedbackLabel ( int $gapIndex )

protected

Definition at line 125 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForNumericGap().

                                                                          : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_num_toohigh_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildNumericGapTooLowFeedbackLabel()

ilAssClozeTestFeedback::buildNumericGapTooLowFeedbackLabel ( int $gapIndex )

protected

Definition at line 120 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForNumericGap().

                                                                         : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_num_toolow_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildNumericGapValueHitFeedbackLabel()

ilAssClozeTestFeedback::buildNumericGapValueHitFeedbackLabel ( int $gapIndex )

protected

Definition at line 110 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForNumericGap().

                                                                           : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_num_valuehit_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildPostVarForFbFieldPerGapAnswers()

ilAssClozeTestFeedback::buildPostVarForFbFieldPerGapAnswers	(	int	$gapIndex,
		int	$answerIndex
	)

protected

Definition at line 685 of file class.ilAssClozeTestFeedback.php.

Referenced by initFbPropsForNumericGap(), initFbPropsForSelectGap(), initFbPropsForTextGap(), saveFbPropsForNumericGap(), saveFbPropsForSelectGap(), and saveFbPropsForTextGap().

                                                                                            : string
     {
         return "feedback_answer_{$gapIndex}_{$answerIndex}";
     }

Here is the caller graph for this function:

◆ buildPostVarForFbFieldPerGapQuestion()

ilAssClozeTestFeedback::buildPostVarForFbFieldPerGapQuestion ( int $gapIndex )

protected

Definition at line 680 of file class.ilAssClozeTestFeedback.php.

Referenced by completeFormPropsForFeedbackModeGapQuestion(), initFeedbackFieldsPerGapQuestion(), and saveFeedbackFieldsPerGapQuestion().

                                                                           : string
     {
         return "feedback_answer_{$gapIndex}";
     }

Here is the caller graph for this function:

◆ buildSelectGapEmptyFeedbackLabel()

ilAssClozeTestFeedback::buildSelectGapEmptyFeedbackLabel ( int $gapIndex )

protected

Definition at line 105 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForSelectGap().

                                                                       : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_sel_empty_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildSelectGapOptionFeedbackLabel()

ilAssClozeTestFeedback::buildSelectGapOptionFeedbackLabel	(	int	$gapIndex,
		assAnswerCloze	$item
	)

protected

Definition at line 96 of file class.ilAssClozeTestFeedback.php.

References ASS_AnswerSimple\getAnswertext(), ILIAS\Repository\lng(), and ilLegacyFormElementsUtil\prepareFormOutput().

Referenced by completeFbPropsForSelectGap().

                                                                                              : string
     {
         return sprintf(
             $this->lng->txt('ass_cloze_gap_fb_sel_opt_label'),
             $gapIndex + 1,
             ilLegacyFormElementsUtil::prepareFormOutput($item->getAnswertext())
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildTextGapEmptyFeedbackLabel()

ilAssClozeTestFeedback::buildTextGapEmptyFeedbackLabel ( int $gapIndex )

protected

Definition at line 91 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForTextGap().

                                                                     : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_txt_empty_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildTextGapGivenAnswerFeedbackLabel()

ilAssClozeTestFeedback::buildTextGapGivenAnswerFeedbackLabel	(	int	$gapIndex,
		assAnswerCloze	$item
	)

protected

Definition at line 77 of file class.ilAssClozeTestFeedback.php.

References ASS_AnswerSimple\getAnswertext(), ILIAS\Repository\lng(), and ilLegacyFormElementsUtil\prepareFormOutput().

Referenced by completeFbPropsForTextGap().

                                                                                                 : string
     {
         return sprintf(
             $this->lng->txt('ass_cloze_gap_fb_txt_match_label'),
             $gapIndex + 1,
             ilLegacyFormElementsUtil::prepareFormOutput($item->getAnswertext())
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildTextGapWrongAnswerFeedbackLabel()

ilAssClozeTestFeedback::buildTextGapWrongAnswerFeedbackLabel ( int $gapIndex )

protected

Definition at line 86 of file class.ilAssClozeTestFeedback.php.

References ILIAS\Repository\lng().

Referenced by completeFbPropsForTextGap().

                                                                           : string
     {
         return sprintf($this->lng->txt('ass_cloze_gap_fb_txt_nomatch_label'), $gapIndex + 1);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ cleanupSpecificAnswerFeedbacks()

ilAssClozeTestFeedback::cleanupSpecificAnswerFeedbacks ( string $fbMode )

protected

Definition at line 712 of file class.ilAssClozeTestFeedback.php.

References deleteSpecificAnswerFeedbacksByIds(), fetchFeedbackIdsForGapAnswersMode(), and fetchFeedbackIdsForGapQuestionMode().

Referenced by saveSpecificFormProperties().

                                                                      : void
     {
         switch ($fbMode) {
             case self::FB_MODE_GAP_QUESTION:
                 $feedbackIds = $this->fetchFeedbackIdsForGapQuestionMode();
                 break;
 
             case self::FB_MODE_GAP_ANSWERS:
                 $feedbackIds = $this->fetchFeedbackIdsForGapAnswersMode();
                 break;
 
             default: $feedbackIds = array();
         }
 
         $this->deleteSpecificAnswerFeedbacksByIds($feedbackIds);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeFbPropsForNumericGap()

ilAssClozeTestFeedback::completeFbPropsForNumericGap	(	ilRadioOption	$fbModeOpt,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

Parameters

ilRadioOption	$fbModeOpt
assClozeGap	$gap
integer	$gapIndex

Definition at line 287 of file class.ilAssClozeTestFeedback.php.

References ilRadioOption\addSubItem(), ilAssQuestionFeedback\buildFeedbackContentFormProperty(), buildNumericGapEmptyFeedbackLabel(), buildNumericGapRangeHitFeedbackLabel(), buildNumericGapTooHighFeedbackLabel(), buildNumericGapTooLowFeedbackLabel(), buildNumericGapValueHitFeedbackLabel(), and assClozeGap\numericRangeExists().

Referenced by completeFormPropsForFeedbackModeGapAnswers().

                                                                                                               : void
     {
         $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
             $this->buildNumericGapValueHitFeedbackLabel($gapIndex),
             true
         );
 
         $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_NUMERIC_GAP_VALUE_HIT_INDEX;
 
         $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
             $propertyLabel,
             $propertyPostVar,
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
 
         if ($gap->numericRangeExists()) {
             $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
                 $this->buildNumericGapRangeHitFeedbackLabel($gapIndex),
                 true
             );
 
             $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_NUMERIC_GAP_RANGE_HIT_INDEX;
 
             $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
                 $propertyLabel,
                 $propertyPostVar,
                 $this->questionOBJ->isAdditionalContentEditingModePageObject()
             ));
         }
 
         $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
             $this->buildNumericGapTooLowFeedbackLabel($gapIndex),
             true
         );
 
         $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_NUMERIC_GAP_TOO_LOW_INDEX;
 
         $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
             $propertyLabel,
             $propertyPostVar,
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
 
         $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
             $this->buildNumericGapTooHighFeedbackLabel($gapIndex),
             true
         );
 
         $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_NUMERIC_GAP_TOO_HIGH_INDEX;
 
         $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
             $propertyLabel,
             $propertyPostVar,
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
 
         $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
             $this->buildNumericGapEmptyFeedbackLabel($gapIndex),
             true
         );
 
         $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_NUMERIC_GAP_EMPTY_INDEX;
 
         $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
             $propertyLabel,
             $propertyPostVar,
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeFbPropsForSelectGap()

ilAssClozeTestFeedback::completeFbPropsForSelectGap	(	ilRadioOption	$fbModeOpt,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

Definition at line 251 of file class.ilAssClozeTestFeedback.php.

References ilRadioOption\addSubItem(), ilAssQuestionFeedback\buildFeedbackContentFormProperty(), buildSelectGapEmptyFeedbackLabel(), buildSelectGapOptionFeedbackLabel(), and assClozeGap\getItems().

Referenced by completeFormPropsForFeedbackModeGapAnswers().

                                                                                                              : void
     {
         foreach ($gap->getItems($this->randomGroup()->dontShuffle()) as $optIndex => $item) {
             $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
                 $this->buildSelectGapOptionFeedbackLabel($gapIndex, $item),
                 true
             );
 
             $propertyPostVar = "feedback_answer_{$gapIndex}_{$optIndex}";
 
             $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
                 $propertyLabel,
                 $propertyPostVar,
                 $this->questionOBJ->isAdditionalContentEditingModePageObject()
             ));
         }
 
         $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
             $this->buildSelectGapEmptyFeedbackLabel($gapIndex),
             true
         );
 
         $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_SELECT_GAP_EMPTY_INDEX;
 
         $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
             $propertyLabel,
             $propertyPostVar,
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeFbPropsForTextGap()

ilAssClozeTestFeedback::completeFbPropsForTextGap	(	ilRadioOption	$fbModeOpt,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

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

References ilRadioOption\addSubItem(), ilAssQuestionFeedback\buildFeedbackContentFormProperty(), buildTextGapEmptyFeedbackLabel(), buildTextGapGivenAnswerFeedbackLabel(), buildTextGapWrongAnswerFeedbackLabel(), and assClozeGap\getItems().

Referenced by completeFormPropsForFeedbackModeGapAnswers().

                                                                                                            : void
     {
         foreach ($gap->getItems($this->randomGroup()->dontShuffle()) as $answerIndex => $item) {
             $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
                 $this->buildTextGapGivenAnswerFeedbackLabel($gapIndex, $item),
                 true
             );
 
             $propertyPostVar = "feedback_answer_{$gapIndex}_{$answerIndex}";
 
             $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
                 $propertyLabel,
                 $propertyPostVar,
                 $this->questionOBJ->isAdditionalContentEditingModePageObject()
             ));
         }
 
         $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
             $this->buildTextGapWrongAnswerFeedbackLabel($gapIndex),
             true
         );
 
         $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_TEXT_GAP_NOMATCH_INDEX;
 
         $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
             $propertyLabel,
             $propertyPostVar,
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
 
         $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
             $this->buildTextGapEmptyFeedbackLabel($gapIndex),
             true
         );
 
         $propertyPostVar = "feedback_answer_{$gapIndex}_" . self::FB_TEXT_GAP_EMPTY_INDEX;
 
         $fbModeOpt->addSubItem($this->buildFeedbackContentFormProperty(
             $propertyLabel,
             $propertyPostVar,
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeFormPropsForFeedbackModeGapAnswers()

ilAssClozeTestFeedback::completeFormPropsForFeedbackModeGapAnswers ( ilRadioOption $fbModeOpt )

protected

Definition at line 185 of file class.ilAssClozeTestFeedback.php.

References completeFbPropsForNumericGap(), completeFbPropsForSelectGap(), completeFbPropsForTextGap(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

Referenced by completeSpecificFormProperties().

                                                                                            : void
     {
         foreach ($this->questionOBJ->getGaps() as $gapIndex => $gap) {
             switch ($gap->getType()) {
                 case assClozeGap::TYPE_TEXT:
 
                     $this->completeFbPropsForTextGap($fbModeOpt, $gap, $gapIndex);
                     break;
 
                 case assClozeGap::TYPE_SELECT:
 
                     $this->completeFbPropsForSelectGap($fbModeOpt, $gap, $gapIndex);
                     break;
 
                 case assClozeGap::TYPE_NUMERIC:
 
                     $this->completeFbPropsForNumericGap($fbModeOpt, $gap, $gapIndex);
                     break;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeFormPropsForFeedbackModeGapQuestion()

ilAssClozeTestFeedback::completeFormPropsForFeedbackModeGapQuestion ( ilRadioOption $fbModeOpt )

protected

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

References ilRadioOption\addSubItem(), ilAssQuestionFeedback\buildFeedbackContentFormProperty(), buildGapFeedbackLabel(), and buildPostVarForFbFieldPerGapQuestion().

Referenced by completeSpecificFormProperties().

                                                                                             : void
     {
         foreach ($this->questionOBJ->getGaps() as $gapIndex => $gap) {
             $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
                 $this->buildGapFeedbackLabel($gapIndex, $gap),
                 true
             );
 
             $fbModeOpt->addSubItem(
                 $this->buildFeedbackContentFormProperty(
                     $propertyLabel,
                     $this->buildPostVarForFbFieldPerGapQuestion($gapIndex),
                     $this->questionOBJ->isAdditionalContentEditingModePageObject()
                 )
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ completeSpecificFormProperties()

ilAssClozeTestFeedback::completeSpecificFormProperties ( ilPropertyFormGUI $form )

Definition at line 135 of file class.ilAssClozeTestFeedback.php.

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

                                                                            : void
     {
         if (!$this->questionOBJ->getSelfAssessmentEditingMode()) {
             $header = new ilFormSectionHeaderGUI();
             $header->setTitle($this->lng->txt('feedback_answers'));
             $form->addItem($header);
 
             $feedbackMode = new ilRadioGroupInputGUI(
                 $this->lng->txt('ass_cloze_fb_mode'),
                 'feedback_mode'
             );
             $feedbackMode->setRequired(true);
             $form->addItem($feedbackMode);
 
             $fbModeGapQuestion = new ilRadioOption(
                 $this->lng->txt('ass_cloze_fb_mode_gap_qst'),
                 self::FB_MODE_GAP_QUESTION,
                 $this->lng->txt('ass_cloze_fb_mode_gap_qst_info')
             );
             $this->completeFormPropsForFeedbackModeGapQuestion($fbModeGapQuestion);
             $feedbackMode->addOption($fbModeGapQuestion);
 
             $fbModeGapAnswers = new ilRadioOption(
                 $this->lng->txt('ass_cloze_fb_mode_gap_answ'),
                 self::FB_MODE_GAP_ANSWERS,
                 $this->lng->txt('ass_cloze_fb_mode_gap_answ_info')
             );
             $this->completeFormPropsForFeedbackModeGapAnswers($fbModeGapAnswers);
             $feedbackMode->addOption($fbModeGapAnswers);
         }
     }

Here is the call graph for this function:

◆ deleteSpecificAnswerFeedbacksByIds()

ilAssClozeTestFeedback::deleteSpecificAnswerFeedbacksByIds ( array $feedbackIds )

protected

Parameters

int[] $feedbackIds

Definition at line 798 of file class.ilAssClozeTestFeedback.php.

References ilAssQuestionFeedback\ensurePageObjectDeleted(), and ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType().

Referenced by cleanupSpecificAnswerFeedbacks().

                                                                              : void
     {
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             foreach ($feedbackIds as $fbId) {
                 $this->ensurePageObjectDeleted($this->getSpecificAnswerFeedbackPageObjectType(), $fbId);
             }
         }
 
         $IN_feedbackIds = $this->db->in('feedback_id', $feedbackIds, false, 'integer');
         $this->db->manipulate("DELETE FROM {$this->getSpecificFeedbackTableName()} WHERE {$IN_feedbackIds}");
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ determineAnswerIndexForAnswerValue()

ilAssClozeTestFeedback::determineAnswerIndexForAnswerValue	(	assClozeGap	$gap,
		string	$answerValue
	)

Definition at line 823 of file class.ilAssClozeTestFeedback.php.

References CLOZE_NUMERIC, CLOZE_SELECT, CLOZE_TEXT, assClozeGap\getItem(), assClozeGap\getItems(), assClozeGap\getType(), and randomGroup().

                                                                                              : int
     {
         switch ($gap->getType()) {
             case CLOZE_TEXT:
 
                 if (!strlen($answerValue)) {
                     return self::FB_TEXT_GAP_EMPTY_INDEX;
                 }
 
                 $items = $gap->getItems($this->randomGroup()->dontShuffle());
 
                 foreach ($items as $answerIndex => $answer) {
                     /* @var assAnswerCloze $answer */
 
                     if ($answer->getAnswertext() == $answerValue) {
                         return $answerIndex;
                     }
                 }
 
                 return self::FB_TEXT_GAP_NOMATCH_INDEX;
 
             case CLOZE_SELECT:
 
                 if (strlen($answerValue)) {
                     return $answerValue;
                 }
 
                 return self::FB_SELECT_GAP_EMPTY_INDEX;
 
             default:
             case CLOZE_NUMERIC:
 
                 if (!strlen($answerValue)) {
                     return self::FB_NUMERIC_GAP_EMPTY_INDEX;
                 }
 
                 /* @var assAnswerCloze $item */
 
                 $item = current($gap->getItems($this->randomGroup()->dontShuffle()));
 
                 if ($answerValue == $item->getAnswertext()) {
                     return self::FB_NUMERIC_GAP_VALUE_HIT_INDEX;
                 }
 
                 require_once 'Services/Math/classes/class.EvalMath.php';
                 $math = new EvalMath();
 
                 $item = $gap->getItem(0);
                 $lowerBound = $math->evaluate($item->getLowerBound());
                 $upperBound = $math->evaluate($item->getUpperBound());
                 $preciseValue = $math->evaluate($item->getAnswertext());
 
                 $solutionValue = $math->evaluate($answerValue);
 
                 if ($solutionValue == $preciseValue) {
                     return self::FB_NUMERIC_GAP_VALUE_HIT_INDEX;
                 } elseif ($solutionValue >= $lowerBound && $solutionValue <= $upperBound) {
                     return self::FB_NUMERIC_GAP_RANGE_HIT_INDEX;
                 } elseif ($solutionValue < $lowerBound) {
                     return self::FB_NUMERIC_GAP_TOO_LOW_INDEX;
                 }
 
                 //  if ($solutionValue > $upperBound) {
                 return self::FB_NUMERIC_GAP_TOO_HIGH_INDEX;
                 //}
         }
     }

Here is the call graph for this function:

◆ determineTestOutputGapFeedback()

ilAssClozeTestFeedback::determineTestOutputGapFeedback	(	int	$gapIndex,
		int	$answerIndex
	)

Definition at line 810 of file class.ilAssClozeTestFeedback.php.

References ilAssMultiOptionQuestionFeedback\getSpecificAnswerFeedbackTestPresentation().

                                                                                    : string
     {
         if ($this->questionOBJ->getFeedbackMode() == self::FB_MODE_GAP_QUESTION) {
             return $this->getSpecificAnswerFeedbackTestPresentation(
                 $this->questionOBJ->getId(),
                 $gapIndex,
                 self::SINGLE_GAP_FB_ANSWER_INDEX
             );
         }
 
         return $this->getSpecificAnswerFeedbackTestPresentation($this->questionOBJ->getId(), $gapIndex, $answerIndex);
     }

Here is the call graph for this function:

◆ duplicateSpecificFeedback()

ilAssClozeTestFeedback::duplicateSpecificFeedback	(	int	$originalQuestionId,
		int	$duplicateQuestionId
	)

protected

Definition at line 635 of file class.ilAssClozeTestFeedback.php.

References syncSpecificFeedbackSetting().

                                                                                                    : void
     {
         $this->syncSpecificFeedbackSetting($originalQuestionId, $duplicateQuestionId);
 
         parent::duplicateSpecificFeedback($originalQuestionId, $duplicateQuestionId);
     }

Here is the call graph for this function:

◆ fetchFeedbackIdsForGapAnswersMode()

ilAssClozeTestFeedback::fetchFeedbackIdsForGapAnswersMode ( )

protected

Returns: int[]

Definition at line 754 of file class.ilAssClozeTestFeedback.php.

Referenced by cleanupSpecificAnswerFeedbacks(), and isSpecificAnswerFeedbackAvailable().

                                                           : array
     {
         require_once 'Modules/TestQuestionPool/classes/feedback/class.ilAssSpecificFeedbackIdentifierList.php';
         $feedbackIdentifiers = new ilAssSpecificFeedbackIdentifierList();
         $feedbackIdentifiers->load($this->questionOBJ->getId());
 
         $feedbackIds = array();
 
         foreach ($feedbackIdentifiers as $identifier) {
             if ($identifier->getAnswerIndex() == self::SINGLE_GAP_FB_ANSWER_INDEX) {
                 continue;
             }
 
             $feedbackIds[] = $identifier->getFeedbackId();
         }
 
         return $feedbackIds;
     }

Here is the caller graph for this function:

◆ fetchFeedbackIdsForGapQuestionMode()

ilAssClozeTestFeedback::fetchFeedbackIdsForGapQuestionMode ( )

protected

Returns: int[]

Definition at line 732 of file class.ilAssClozeTestFeedback.php.

Referenced by cleanupSpecificAnswerFeedbacks(), and isSpecificAnswerFeedbackAvailable().

                                                            : array
     {
         require_once 'Modules/TestQuestionPool/classes/feedback/class.ilAssSpecificFeedbackIdentifierList.php';
         $feedbackIdentifiers = new ilAssSpecificFeedbackIdentifierList();
         $feedbackIdentifiers->load($this->questionOBJ->getId());
 
         $feedbackIds = array();
 
         foreach ($feedbackIdentifiers as $identifier) {
             if ($identifier->getAnswerIndex() != self::SINGLE_GAP_FB_ANSWER_INDEX) {
                 continue;
             }
 
             $feedbackIds[] = $identifier->getFeedbackId();
         }
 
         return $feedbackIds;
     }

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackFormValue()

ilAssClozeTestFeedback::getSpecificAnswerFeedbackFormValue	(	int	$gapIndex,
		int	$answerIndex
	)

protected

Definition at line 690 of file class.ilAssClozeTestFeedback.php.

References ilAssQuestionFeedback\getPageObjectNonEditableValueHTML(), ilAssMultiOptionQuestionFeedback\getSpecificAnswerFeedbackContent(), ilAssMultiOptionQuestionFeedback\getSpecificAnswerFeedbackPageObjectId(), and ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType().

Referenced by initFbPropsForNumericGap(), initFbPropsForSelectGap(), initFbPropsForTextGap(), and initFeedbackFieldsPerGapQuestion().

                                                                                           : string
     {
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             $pageObjectId = $this->getSpecificAnswerFeedbackPageObjectId(
                 $this->questionOBJ->getId(),
                 $gapIndex,
                 $answerIndex
             );
 
             $value = $this->getPageObjectNonEditableValueHTML(
                 $this->getSpecificAnswerFeedbackPageObjectType(),
                 $pageObjectId
             );
         } else {
             $value = $this->questionOBJ->prepareTextareaOutput(
                 $this->getSpecificAnswerFeedbackContent($this->questionOBJ->getId(), $gapIndex, $answerIndex)
             );
         }
 
         return $value;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFbPropsForNumericGap()

ilAssClozeTestFeedback::initFbPropsForNumericGap	(	ilPropertyFormGUI	$form,
		int	$gapIndex,
		assClozeGap	$gap
	)

protected

Definition at line 443 of file class.ilAssClozeTestFeedback.php.

References buildPostVarForFbFieldPerGapAnswers(), ilPropertyFormGUI\getItemByPostVar(), getSpecificAnswerFeedbackFormValue(), and assClozeGap\numericRangeExists().

Referenced by initFeedbackFieldsPerGapAnswers().

                                                                                                          : void
     {
         $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_NUMERIC_GAP_VALUE_HIT_INDEX);
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_VALUE_HIT_INDEX);
         $form->getItemByPostVar($postVar)->setValue($value);
 
         if ($gap->numericRangeExists()) {
             $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_NUMERIC_GAP_RANGE_HIT_INDEX);
             $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_RANGE_HIT_INDEX);
             $form->getItemByPostVar($postVar)->setValue($value);
         }
 
         $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_NUMERIC_GAP_TOO_LOW_INDEX);
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_TOO_LOW_INDEX);
         $form->getItemByPostVar($postVar)->setValue($value);
 
         $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_NUMERIC_GAP_TOO_HIGH_INDEX);
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_TOO_HIGH_INDEX);
         $form->getItemByPostVar($postVar)->setValue($value);
 
         $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_NUMERIC_GAP_EMPTY_INDEX);
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_EMPTY_INDEX);
         $form->getItemByPostVar($postVar)->setValue($value);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFbPropsForSelectGap()

ilAssClozeTestFeedback::initFbPropsForSelectGap	(	ilPropertyFormGUI	$form,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

Definition at line 430 of file class.ilAssClozeTestFeedback.php.

References buildPostVarForFbFieldPerGapAnswers(), ilPropertyFormGUI\getItemByPostVar(), assClozeGap\getItems(), and getSpecificAnswerFeedbackFormValue().

Referenced by initFeedbackFieldsPerGapAnswers().

                                                                                                         : void
     {
         foreach ($gap->getItems($this->randomGroup()->dontShuffle()) as $optIndex => $item) {
             $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, $optIndex);
             $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, $optIndex);
             $form->getItemByPostVar($postVar)->setValue($value);
         }
 
         $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_SELECT_GAP_EMPTY_INDEX);
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_SELECT_GAP_EMPTY_INDEX);
         $form->getItemByPostVar($postVar)->setValue($value);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFbPropsForTextGap()

ilAssClozeTestFeedback::initFbPropsForTextGap	(	ilPropertyFormGUI	$form,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

Definition at line 413 of file class.ilAssClozeTestFeedback.php.

References buildPostVarForFbFieldPerGapAnswers(), ilPropertyFormGUI\getItemByPostVar(), assClozeGap\getItems(), and getSpecificAnswerFeedbackFormValue().

Referenced by initFeedbackFieldsPerGapAnswers().

                                                                                                       : void
     {
         foreach ($gap->getItems($this->randomGroup()->dontShuffle()) as $answerIndex => $item) {
             $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, $answerIndex);
             $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, $answerIndex);
             $form->getItemByPostVar($postVar)->setValue($value);
         }
 
         $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_TEXT_GAP_NOMATCH_INDEX);
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_TEXT_GAP_NOMATCH_INDEX);
         $form->getItemByPostVar($postVar)->setValue($value);
 
         $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::FB_TEXT_GAP_EMPTY_INDEX);
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_TEXT_GAP_EMPTY_INDEX);
         $form->getItemByPostVar($postVar)->setValue($value);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFeedbackFieldsPerGapAnswers()

ilAssClozeTestFeedback::initFeedbackFieldsPerGapAnswers ( ilPropertyFormGUI $form )

protected

Definition at line 391 of file class.ilAssClozeTestFeedback.php.

References initFbPropsForNumericGap(), initFbPropsForSelectGap(), initFbPropsForTextGap(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

Referenced by initSpecificFormProperties().

                                                                                : void
     {
         foreach ($this->questionOBJ->getGaps() as $gapIndex => $gap) {
             switch ($gap->getType()) {
                 case assClozeGap::TYPE_TEXT:
 
                     $this->initFbPropsForTextGap($form, $gap, $gapIndex);
                     break;
 
                 case assClozeGap::TYPE_SELECT:
 
                     $this->initFbPropsForSelectGap($form, $gap, $gapIndex);
                     break;
 
                 case assClozeGap::TYPE_NUMERIC:
 
                     $this->initFbPropsForNumericGap($form, $gapIndex, $gap);
                     break;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initFeedbackFieldsPerGapQuestion()

ilAssClozeTestFeedback::initFeedbackFieldsPerGapQuestion ( ilPropertyFormGUI $form )

protected

Definition at line 383 of file class.ilAssClozeTestFeedback.php.

References buildPostVarForFbFieldPerGapQuestion(), ilPropertyFormGUI\getItemByPostVar(), and getSpecificAnswerFeedbackFormValue().

Referenced by initSpecificFormProperties().

                                                                                 : void
     {
         foreach ($this->questionOBJ->getGaps() as $gapIndex => $gap) {
             $value = $this->getSpecificAnswerFeedbackFormValue($gapIndex, self::SINGLE_GAP_FB_ANSWER_INDEX);
             $form->getItemByPostVar($this->buildPostVarForFbFieldPerGapQuestion($gapIndex))->setValue($value);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initSpecificFormProperties()

ilAssClozeTestFeedback::initSpecificFormProperties ( ilPropertyFormGUI $form )

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

References ilPropertyFormGUI\getItemByPostVar(), initFeedbackFieldsPerGapAnswers(), and initFeedbackFieldsPerGapQuestion().

                                                                        : void
     {
         if (!$this->questionOBJ->getSelfAssessmentEditingMode()) {
             /* @var ilRadioGroupInputGUI $fbMode */
             $fbMode = $form->getItemByPostVar('feedback_mode');
             $fbMode->setValue($this->questionOBJ->getFeedbackMode());
 
             if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
                 $this->initFeedbackFieldsPerGapQuestion($form);
                 $this->initFeedbackFieldsPerGapAnswers($form);
             } else {
                 switch ($this->questionOBJ->getFeedbackMode()) {
                     case self::FB_MODE_GAP_QUESTION:
 
                         $this->initFeedbackFieldsPerGapQuestion($form);
                         break;
 
                     case self::FB_MODE_GAP_ANSWERS:
 
                         $this->initFeedbackFieldsPerGapAnswers($form);
                         break;
                 }
             }
         }
     }

Here is the call graph for this function:

◆ isSaveableInPageObjectEditingMode()

ilAssClozeTestFeedback::isSaveableInPageObjectEditingMode ( )

Definition at line 51 of file class.ilAssClozeTestFeedback.php.

                                                        : bool
     {
         return true;
     }

◆ isSpecificAnswerFeedbackAvailable()

ilAssClozeTestFeedback::isSpecificAnswerFeedbackAvailable ( int $question_id )

Definition at line 773 of file class.ilAssClozeTestFeedback.php.

References fetchFeedbackIdsForGapAnswersMode(), fetchFeedbackIdsForGapQuestionMode(), ilAssQuestionFeedback\getPageObjectXML(), ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType(), and ilAssMultiOptionQuestionFeedback\getSpecificFeedbackContentForFeedbackIds().

                                                                        : bool
     {
         if ($this->questionOBJ->getFeedbackMode() === self::FB_MODE_GAP_QUESTION) {
             $feedback_ids = $this->fetchFeedbackIdsForGapQuestionMode();
         } else {
             $feedback_ids = $this->fetchFeedbackIdsForGapAnswersMode();
         }
 
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             $all_feedback_content = '';
             foreach ($feedback_ids as $feedback_id) {
                 $all_feedback_content .= $this->getPageObjectXML(
                     $this->getSpecificAnswerFeedbackPageObjectType(),
                     $feedback_id
                 );
             }
             return trim(strip_tags($all_feedback_content)) !== '';
         }
 
         return implode('', $this->getSpecificFeedbackContentForFeedbackIds($feedback_ids)) !== '';
     }

Here is the call graph for this function:

◆ randomGroup()

ilAssClozeTestFeedback::randomGroup ( )

private

Definition at line 891 of file class.ilAssClozeTestFeedback.php.

References $DIC.

Referenced by determineAnswerIndexForAnswerValue().

                                   : RandomGroup
     {
         global $DIC;
 
         return $DIC->refinery()->random();
     }

Here is the caller graph for this function:

◆ saveFbPropsForNumericGap()

ilAssClozeTestFeedback::saveFbPropsForNumericGap	(	ilPropertyFormGUI	$form,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

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

References buildPostVarForFbFieldPerGapAnswers(), ilPropertyFormGUI\getItemByPostVar(), assClozeGap\numericRangeExists(), and ilAssMultiOptionQuestionFeedback\saveSpecificAnswerFeedbackContent().

Referenced by saveFeedbackFieldsPerGapAnswers().

                                                                                                          : void
     {
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_VALUE_HIT_INDEX);
         $value = $form->getItemByPostVar($postVar)->getValue();
         $this->saveSpecificAnswerFeedbackContent(
             $this->questionOBJ->getId(),
             $gapIndex,
             self::FB_NUMERIC_GAP_VALUE_HIT_INDEX,
             $value
         );
 
         if ($gap->numericRangeExists()) {
             $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_RANGE_HIT_INDEX);
             $value = $form->getItemByPostVar($postVar)->getValue();
             $this->saveSpecificAnswerFeedbackContent(
                 $this->questionOBJ->getId(),
                 $gapIndex,
                 self::FB_NUMERIC_GAP_RANGE_HIT_INDEX,
                 $value
             );
         }
 
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_TOO_LOW_INDEX);
         $value = $form->getItemByPostVar($postVar)->getValue();
         $this->saveSpecificAnswerFeedbackContent(
             $this->questionOBJ->getId(),
             $gapIndex,
             self::FB_NUMERIC_GAP_TOO_LOW_INDEX,
             $value
         );
 
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_TOO_HIGH_INDEX);
         $value = $form->getItemByPostVar($postVar)->getValue();
         $this->saveSpecificAnswerFeedbackContent(
             $this->questionOBJ->getId(),
             $gapIndex,
             self::FB_NUMERIC_GAP_TOO_HIGH_INDEX,
             $value
         );
 
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_NUMERIC_GAP_EMPTY_INDEX);
         $value = $form->getItemByPostVar($postVar)->getValue();
         $this->saveSpecificAnswerFeedbackContent(
             $this->questionOBJ->getId(),
             $gapIndex,
             self::FB_NUMERIC_GAP_EMPTY_INDEX,
             $value
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveFbPropsForSelectGap()

ilAssClozeTestFeedback::saveFbPropsForSelectGap	(	ilPropertyFormGUI	$form,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

Definition at line 562 of file class.ilAssClozeTestFeedback.php.

References buildPostVarForFbFieldPerGapAnswers(), ilPropertyFormGUI\getItemByPostVar(), assClozeGap\getItems(), and ilAssMultiOptionQuestionFeedback\saveSpecificAnswerFeedbackContent().

Referenced by saveFeedbackFieldsPerGapAnswers().

                                                                                                         : void
     {
         foreach ($gap->getItems($this->randomGroup()->dontShuffle()) as $optIndex => $item) {
             $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, $optIndex);
             $value = $form->getItemByPostVar($postVar)->getValue();
             $this->saveSpecificAnswerFeedbackContent(
                 $this->questionOBJ->getId(),
                 $gapIndex,
                 $optIndex,
                 $value
             );
         }
 
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_SELECT_GAP_EMPTY_INDEX);
         $value = $form->getItemByPostVar($postVar)->getValue();
         $this->saveSpecificAnswerFeedbackContent(
             $this->questionOBJ->getId(),
             $gapIndex,
             self::FB_SELECT_GAP_EMPTY_INDEX,
             $value
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveFbPropsForTextGap()

ilAssClozeTestFeedback::saveFbPropsForTextGap	(	ilPropertyFormGUI	$form,
		assClozeGap	$gap,
		int	$gapIndex
	)

protected

Definition at line 530 of file class.ilAssClozeTestFeedback.php.

References buildPostVarForFbFieldPerGapAnswers(), ilPropertyFormGUI\getItemByPostVar(), assClozeGap\getItems(), and ilAssMultiOptionQuestionFeedback\saveSpecificAnswerFeedbackContent().

Referenced by saveFeedbackFieldsPerGapAnswers().

                                                                                                       : void
     {
         foreach ($gap->getItems($this->randomGroup()->dontShuffle()) as $answerIndex => $item) {
             $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, $answerIndex);
             $value = $form->getItemByPostVar($postVar)->getValue();
             $this->saveSpecificAnswerFeedbackContent(
                 $this->questionOBJ->getId(),
                 $gapIndex,
                 $answerIndex,
                 $value
             );
         }
 
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_TEXT_GAP_NOMATCH_INDEX);
         $value = $form->getItemByPostVar($postVar)->getValue();
         $this->saveSpecificAnswerFeedbackContent(
             $this->questionOBJ->getId(),
             $gapIndex,
             self::FB_TEXT_GAP_NOMATCH_INDEX,
             $value
         );
 
         $postVar = $this->buildPostVarForFbFieldPerGapAnswers($gapIndex, self::FB_TEXT_GAP_EMPTY_INDEX);
         $value = $form->getItemByPostVar($postVar)->getValue();
         $this->saveSpecificAnswerFeedbackContent(
             $this->questionOBJ->getId(),
             $gapIndex,
             self::FB_TEXT_GAP_EMPTY_INDEX,
             $value
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveFeedbackFieldsPerGapAnswers()

ilAssClozeTestFeedback::saveFeedbackFieldsPerGapAnswers ( ilPropertyFormGUI $form )

protected

Definition at line 508 of file class.ilAssClozeTestFeedback.php.

References saveFbPropsForNumericGap(), saveFbPropsForSelectGap(), saveFbPropsForTextGap(), assClozeGap\TYPE_NUMERIC, assClozeGap\TYPE_SELECT, and assClozeGap\TYPE_TEXT.

Referenced by saveSpecificFormProperties().

                                                                                : void
     {
         foreach ($this->questionOBJ->getGaps() as $gapIndex => $gap) {
             switch ($gap->getType()) {
                 case assClozeGap::TYPE_TEXT:
 
                     $this->saveFbPropsForTextGap($form, $gap, $gapIndex);
                     break;
 
                 case assClozeGap::TYPE_SELECT:
 
                     $this->saveFbPropsForSelectGap($form, $gap, $gapIndex);
                     break;
 
                 case assClozeGap::TYPE_NUMERIC:
 
                     $this->saveFbPropsForNumericGap($form, $gap, $gapIndex);
                     break;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveFeedbackFieldsPerGapQuestion()

ilAssClozeTestFeedback::saveFeedbackFieldsPerGapQuestion ( ilPropertyFormGUI $form )

protected

Definition at line 493 of file class.ilAssClozeTestFeedback.php.

References buildPostVarForFbFieldPerGapQuestion(), ilPropertyFormGUI\getItemByPostVar(), and ilAssMultiOptionQuestionFeedback\saveSpecificAnswerFeedbackContent().

Referenced by saveSpecificFormProperties().

                                                                                 : void
     {
         foreach ($this->questionOBJ->getGaps() as $gapIndex => $gap) {
             $postVar = $this->buildPostVarForFbFieldPerGapQuestion($gapIndex);
             $value = $form->getItemByPostVar($postVar)->getValue();
 
             $this->saveSpecificAnswerFeedbackContent(
                 $this->questionOBJ->getId(),
                 $gapIndex,
                 self::SINGLE_GAP_FB_ANSWER_INDEX,
                 $value
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveSpecificFeedbackMode()

ilAssClozeTestFeedback::saveSpecificFeedbackMode	(	int	$questionId,
		string	$feedbackMode
	)

protected

saves the given specific feedback mode for the given question id to the db.

(It's stored to dataset of question itself)

Definition at line 669 of file class.ilAssClozeTestFeedback.php.

Referenced by saveSpecificFormProperties().

                                                                                       : void
     {
         $this->questionOBJ->setFeedbackMode($feedbackMode);
 
         $this->db->update(
             $this->questionOBJ->getAdditionalTableName(),
             array('feedback_mode' => array('text', $feedbackMode)),
             array('question_fi' => array('integer', $questionId))
         );
     }

Here is the caller graph for this function:

◆ saveSpecificFormProperties()

ilAssClozeTestFeedback::saveSpecificFormProperties ( ilPropertyFormGUI $form )

Definition at line 468 of file class.ilAssClozeTestFeedback.php.

References cleanupSpecificAnswerFeedbacks(), ilPropertyFormGUI\getItemByPostVar(), saveFeedbackFieldsPerGapAnswers(), saveFeedbackFieldsPerGapQuestion(), and saveSpecificFeedbackMode().

                                                                        : void
     {
         if (!$this->questionOBJ->getSelfAssessmentEditingMode()) {
             $fbMode = $form->getItemByPostVar('feedback_mode')->getValue();
 
             if ($fbMode != $this->questionOBJ->getFeedbackMode()) {
                 $this->cleanupSpecificAnswerFeedbacks($this->questionOBJ->getFeedbackMode());
             }
 
             $this->saveSpecificFeedbackMode($this->questionOBJ->getId(), $fbMode);
 
             switch ($this->questionOBJ->getFeedbackMode()) {
                 case self::FB_MODE_GAP_QUESTION:
 
                     $this->saveFeedbackFieldsPerGapQuestion($form);
                     break;
 
                 case self::FB_MODE_GAP_ANSWERS:
 
                     $this->saveFeedbackFieldsPerGapAnswers($form);
                     break;
             }
         }
     }

Here is the call graph for this function:

◆ syncSpecificFeedback()

ilAssClozeTestFeedback::syncSpecificFeedback	(	int	$originalQuestionId,
		int	$duplicateQuestionId
	)

protected

Definition at line 659 of file class.ilAssClozeTestFeedback.php.

References syncSpecificFeedbackSetting().

                                                                                               : void
     {
         $this->syncSpecificFeedbackSetting($originalQuestionId, $duplicateQuestionId);
         parent::syncSpecificFeedback($originalQuestionId, $duplicateQuestionId);
     }

Here is the call graph for this function:

◆ syncSpecificFeedbackSetting()

ilAssClozeTestFeedback::syncSpecificFeedbackSetting	(	int	$sourceQuestionId,
		int	$targetQuestionId
	)

private

Definition at line 642 of file class.ilAssClozeTestFeedback.php.

References $res.

Referenced by duplicateSpecificFeedback(), and syncSpecificFeedback().

                                                                                               : void
     {
         $res = $this->db->queryF(
             "SELECT feedback_mode FROM {$this->questionOBJ->getAdditionalTableName()} WHERE question_fi = %s",
             array('integer'),
             array($sourceQuestionId)
         );
 
         $row = $this->db->fetchAssoc($res);
 
         $this->db->update(
             $this->questionOBJ->getAdditionalTableName(),
             array( 'feedback_mode' => array('text', $row['feedback_mode']) ),
             array( 'question_fi' => array('integer', $targetQuestionId) )
         );
     }

Here is the caller graph for this function:

Field Documentation

◆ FB_MODE_GAP_ANSWERS

const ilAssClozeTestFeedback::FB_MODE_GAP_ANSWERS = 'gapAnswers'

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

◆ FB_MODE_GAP_QUESTION

const ilAssClozeTestFeedback::FB_MODE_GAP_QUESTION = 'gapQuestion'

constants for different feedback modes (per gap or per gap-answers/options)

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

Referenced by assClozeTestImport\fromXML(), and assClozeTest\loadFromDb().

◆ FB_NUMERIC_GAP_EMPTY_INDEX

const ilAssClozeTestFeedback::FB_NUMERIC_GAP_EMPTY_INDEX = -1

Definition at line 43 of file class.ilAssClozeTestFeedback.php.

◆ FB_NUMERIC_GAP_RANGE_HIT_INDEX

const ilAssClozeTestFeedback::FB_NUMERIC_GAP_RANGE_HIT_INDEX = 1

Definition at line 45 of file class.ilAssClozeTestFeedback.php.

◆ FB_NUMERIC_GAP_TOO_HIGH_INDEX

const ilAssClozeTestFeedback::FB_NUMERIC_GAP_TOO_HIGH_INDEX = 3

Definition at line 47 of file class.ilAssClozeTestFeedback.php.

◆ FB_NUMERIC_GAP_TOO_LOW_INDEX

const ilAssClozeTestFeedback::FB_NUMERIC_GAP_TOO_LOW_INDEX = 2

Definition at line 46 of file class.ilAssClozeTestFeedback.php.

◆ FB_NUMERIC_GAP_VALUE_HIT_INDEX

const ilAssClozeTestFeedback::FB_NUMERIC_GAP_VALUE_HIT_INDEX = 0

Definition at line 44 of file class.ilAssClozeTestFeedback.php.

◆ FB_SELECT_GAP_EMPTY_INDEX

const ilAssClozeTestFeedback::FB_SELECT_GAP_EMPTY_INDEX = -1

Definition at line 42 of file class.ilAssClozeTestFeedback.php.

◆ FB_TEXT_GAP_EMPTY_INDEX

const ilAssClozeTestFeedback::FB_TEXT_GAP_EMPTY_INDEX = -1

constants for answer indexes in case of FB_MODE_GAP_ANSWERS

Definition at line 40 of file class.ilAssClozeTestFeedback.php.

◆ FB_TEXT_GAP_NOMATCH_INDEX

const ilAssClozeTestFeedback::FB_TEXT_GAP_NOMATCH_INDEX = -2

Definition at line 41 of file class.ilAssClozeTestFeedback.php.

◆ SINGLE_GAP_FB_ANSWER_INDEX

const ilAssClozeTestFeedback::SINGLE_GAP_FB_ANSWER_INDEX = -10

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

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

Modules/TestQuestionPool/classes/feedback/class.ilAssClozeTestFeedback.php

Public Member Functions

Data Fields

Protected Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ buildGapFeedbackLabel()

◆ buildNumericGapEmptyFeedbackLabel()

◆ buildNumericGapRangeHitFeedbackLabel()

◆ buildNumericGapTooHighFeedbackLabel()

◆ buildNumericGapTooLowFeedbackLabel()

◆ buildNumericGapValueHitFeedbackLabel()

◆ buildPostVarForFbFieldPerGapAnswers()

◆ buildPostVarForFbFieldPerGapQuestion()

◆ buildSelectGapEmptyFeedbackLabel()

◆ buildSelectGapOptionFeedbackLabel()

◆ buildTextGapEmptyFeedbackLabel()

◆ buildTextGapGivenAnswerFeedbackLabel()

◆ buildTextGapWrongAnswerFeedbackLabel()

◆ cleanupSpecificAnswerFeedbacks()

◆ completeFbPropsForNumericGap()

◆ completeFbPropsForSelectGap()

◆ completeFbPropsForTextGap()

◆ completeFormPropsForFeedbackModeGapAnswers()

◆ completeFormPropsForFeedbackModeGapQuestion()

◆ completeSpecificFormProperties()

◆ deleteSpecificAnswerFeedbacksByIds()

◆ determineAnswerIndexForAnswerValue()

◆ determineTestOutputGapFeedback()

◆ duplicateSpecificFeedback()

◆ fetchFeedbackIdsForGapAnswersMode()

◆ fetchFeedbackIdsForGapQuestionMode()

◆ getSpecificAnswerFeedbackFormValue()

◆ initFbPropsForNumericGap()

◆ initFbPropsForSelectGap()

◆ initFbPropsForTextGap()

◆ initFeedbackFieldsPerGapAnswers()

◆ initFeedbackFieldsPerGapQuestion()

◆ initSpecificFormProperties()

◆ isSaveableInPageObjectEditingMode()

◆ isSpecificAnswerFeedbackAvailable()

◆ randomGroup()

◆ saveFbPropsForNumericGap()

◆ saveFbPropsForSelectGap()

◆ saveFbPropsForTextGap()

◆ saveFeedbackFieldsPerGapAnswers()

◆ saveFeedbackFieldsPerGapQuestion()

◆ saveSpecificFeedbackMode()

◆ saveSpecificFormProperties()

◆ syncSpecificFeedback()

◆ syncSpecificFeedbackSetting()

Field Documentation

◆ FB_MODE_GAP_ANSWERS

◆ FB_MODE_GAP_QUESTION

◆ FB_NUMERIC_GAP_EMPTY_INDEX

◆ FB_NUMERIC_GAP_RANGE_HIT_INDEX

◆ FB_NUMERIC_GAP_TOO_HIGH_INDEX

◆ FB_NUMERIC_GAP_TOO_LOW_INDEX

◆ FB_NUMERIC_GAP_VALUE_HIT_INDEX

◆ FB_SELECT_GAP_EMPTY_INDEX

◆ FB_TEXT_GAP_EMPTY_INDEX

◆ FB_TEXT_GAP_NOMATCH_INDEX

◆ SINGLE_GAP_FB_ANSWER_INDEX