Inheritance diagram for ilAssMultiOptionQuestionFeedback:

Collaboration diagram for ilAssMultiOptionQuestionFeedback:

Public Member Functions
	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)
	saves a given form object's SPECIFIC form properties relating to this question type More...

	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)
	returns the generic feedback export presentation for given question id either for solution completed or incompleted More...

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

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

	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)

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 32 of file class.ilAssMultiOptionQuestionFeedback.php.

Member Function Documentation

◆ buildAnswerOptionLabel()

ilAssMultiOptionQuestionFeedback::buildAnswerOptionLabel	(	int	$index,
			$answer
	)

protected

Reimplemented in ilAssErrorTextFeedback, ilAssImagemapQuestionFeedback, ilAssKprimChoiceFeedback, ilAssMatchingQuestionFeedback, ilAssMultipleChoiceFeedback, and ilAssSingleChoiceFeedback.

Definition at line 341 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                  : string
    {
        return $answer->getAnswertext();
    }

Referenced by ilAssConfigurableMultiOptionQuestionFeedback\completeSpecificFormProperties(), and completeSpecificFormProperties().

Here is the caller graph for this function:

◆ completeSpecificFormProperties()

ilAssMultiOptionQuestionFeedback::completeSpecificFormProperties ( ilPropertyFormGUI $form )

completes a given form object with the specific form properties required by this question type

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssClozeTestFeedback, and ilAssConfigurableMultiOptionQuestionFeedback.

Definition at line 64 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                           : void
    {
        if (!$this->questionOBJ->getSelfAssessmentEditingMode()) {
            $header = new ilFormSectionHeaderGUI();
            $header->setTitle($this->lng->txt('feedback_answers'));
            $form->addItem($header);
 
            foreach ($this->getAnswerOptionsByAnswerIndex() as $index => $answer) {
                $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
                    $this->buildAnswerOptionLabel($index, $answer),
                    true
                );
 
                $propertyPostVar = "feedback_answer_$index";
 
                $form->addItem($this->buildFeedbackContentFormProperty(
                    $propertyLabel,
                    $propertyPostVar,
                    $this->questionOBJ->isAdditionalContentEditingModePageObject()
                ));
            }
        }
    }

References $index, ilPropertyFormGUI\addItem(), buildAnswerOptionLabel(), ilAssQuestionFeedback\buildFeedbackContentFormProperty(), getAnswerOptionsByAnswerIndex(), and ILIAS\Repository\lng().

Here is the call graph for this function:

◆ deleteSpecificAnswerFeedbacks()

ilAssMultiOptionQuestionFeedback::deleteSpecificAnswerFeedbacks	(	int	$questionId,
		bool	$isAdditionalContentEditingModePageObject
	)

Reimplemented from ilAssQuestionFeedback.

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

                                                                                                                  : void
    {
        if ($isAdditionalContentEditingModePageObject) {
            require_once 'Modules/TestQuestionPool/classes/feedback/class.ilAssSpecificFeedbackIdentifierList.php';
            $feedbackIdentifiers = new ilAssSpecificFeedbackIdentifierList();
            $feedbackIdentifiers->load($questionId);
 
            foreach ($feedbackIdentifiers as $identifier) {
                $this->ensurePageObjectDeleted(
                    $this->getSpecificAnswerFeedbackPageObjectType(),
                    $identifier->getFeedbackId()
                );
            }
        }
 
        $this->db->manipulateF(
            "DELETE FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
            ['integer'],
            [$questionId]
        );
    }

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

Here is the call graph for this function:

◆ duplicateSpecificFeedback()

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

protected

duplicates the SPECIFIC feedback relating to the given original question id and saves it for the given duplicate question id

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssClozeTestFeedback, and ilAssConfigurableMultiOptionQuestionFeedback.

Definition at line 229 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                                                   : void
    {
        $res = $this->db->queryF(
            "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
            ['integer'],
            [$originalQuestionId]
        );
 
        while ($row = $this->db->fetchAssoc($res)) {
            $nextId = $this->db->nextId($this->getSpecificFeedbackTableName());
 
            $this->db->insert($this->getSpecificFeedbackTableName(), [
                'feedback_id' => ['integer', $nextId],
                'question_fi' => ['integer', $duplicateQuestionId],
                'question' => ['integer', $row['question']],
                'answer' => ['integer', $row['answer']],
                'feedback' => ['text', $row['feedback']],
                'tstamp' => ['integer', time()]
            ]);
 
            if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
                $pageObjectType = $this->getSpecificAnswerFeedbackPageObjectType();
                $this->duplicatePageObject($pageObjectType, $row['feedback_id'], $nextId, $duplicateQuestionId);
            }
        }
    }

References $res, ilAssQuestionFeedback\duplicatePageObject(), ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType(), and getSpecificFeedbackTableName().

Here is the call graph for this function:

◆ getAllSpecificAnswerFeedbackContents()

ilAssMultiOptionQuestionFeedback::getAllSpecificAnswerFeedbackContents ( int $questionId )

Reimplemented from ilAssQuestionFeedback.

Definition at line 150 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                         : string
    {
        require_once 'Services/RTE/classes/class.ilRTE.php';
 
        $res = $this->db->queryF(
            "SELECT feedback FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
            ['integer'],
            [$questionId]
        );
 
        $allFeedbackContents = '';
 
        while ($row = $this->db->fetchAssoc($res)) {
            $allFeedbackContents .= ilRTE::_replaceMediaObjectImageSrc($row['feedback'] ?? '', 1);
        }
 
        return $allFeedbackContents;
    }

References $res, and ilRTE\_replaceMediaObjectImageSrc().

Here is the call graph for this function:

◆ getAnswerOptionsByAnswerIndex()

ilAssMultiOptionQuestionFeedback::getAnswerOptionsByAnswerIndex ( )

Reimplemented in ilAssErrorTextFeedback, and ilAssMatchingQuestionFeedback.

Definition at line 336 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                   : array
    {
        return $this->questionOBJ->getAnswers();
    }

Referenced by ilAssConfigurableMultiOptionQuestionFeedback\completeSpecificFormProperties(), completeSpecificFormProperties(), ilAssConfigurableMultiOptionQuestionFeedback\initSpecificFormProperties(), initSpecificFormProperties(), ilAssConfigurableMultiOptionQuestionFeedback\saveSpecificFormProperties(), and saveSpecificFormProperties().

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackContent()

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

Reimplemented from ilAssQuestionFeedback.

Definition at line 126 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                                                           : string
    {
        require_once 'Services/RTE/classes/class.ilRTE.php';
 
        $res = $this->db->queryF(
            "SELECT * FROM {$this->getSpecificFeedbackTableName()}
                                        WHERE question_fi = %s AND question = %s AND answer = %s",
            ['integer', 'integer', 'integer'],
            [$questionId, $questionIndex, $answerIndex]
        );
 
        $feedbackContent = '';
 
        if ($this->db->numRows($res) > 0) {
            $row = $this->db->fetchAssoc($res);
            $feedbackContent = ilRTE::_replaceMediaObjectImageSrc(
                $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($row['feedback'] ?? ''),
                1
            );
        }
 
        return $feedbackContent;
    }

References $res, and ilRTE\_replaceMediaObjectImageSrc().

Referenced by getSpecificAnswerFeedbackExportPresentation(), ilAssClozeTestFeedback\getSpecificAnswerFeedbackFormValue(), getSpecificAnswerFeedbackTestPresentation(), ilAssConfigurableMultiOptionQuestionFeedback\initSpecificFormProperties(), and initSpecificFormProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackExportPresentation()

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

returns the generic feedback export presentation for given question id either for solution completed or incompleted

Reimplemented from ilAssQuestionFeedback.

Definition at line 362 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                                                                      : string
    {
        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            $specificAnswerFeedbackExportPresentation = $this->getPageObjectXML(
                $this->getSpecificAnswerFeedbackPageObjectType(),
                $this->getSpecificAnswerFeedbackPageObjectId($questionId, $questionIndex, $answerIndex)
            );
        } else {
            $specificAnswerFeedbackExportPresentation = $this->getSpecificAnswerFeedbackContent(
                $questionId,
                $questionIndex,
                $answerIndex
            );
        }
 
        return $specificAnswerFeedbackExportPresentation;
    }

References ilAssQuestionFeedback\getPageObjectXML(), getSpecificAnswerFeedbackContent(), getSpecificAnswerFeedbackPageObjectId(), and ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType().

Referenced by specificAnswerFeedbackExists().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackId()

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

finalprotected

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

                                                                                                               : int
    {
        $res = $this->db->queryF(
            "SELECT feedback_id FROM {$this->getSpecificFeedbackTableName()}
                                        WHERE question_fi = %s AND question = %s AND answer = %s",
            ['integer', 'integer', 'integer'],
            [$questionId, $questionIndex, $answerIndex]
        );
 
        $row = $this->db->fetchAssoc($res);
        return $row['feedback_id'] ?? -1;
    }

References $res.

Referenced by getSpecificAnswerFeedbackPageObjectId(), and saveSpecificAnswerFeedbackContent().

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackPageObjectId()

ilAssMultiOptionQuestionFeedback::getSpecificAnswerFeedbackPageObjectId	(	int	$questionId,
		int	$questionIndex,
		int	$answerIndex
	)

finalprotected

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)

Definition at line 351 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                                                                         : int
    {
        $pageObjectId = $this->getSpecificAnswerFeedbackId($questionId, $questionIndex, $answerIndex);
 
        if ($pageObjectId === -1) {
            $pageObjectId = $this->saveSpecificAnswerFeedbackContent($questionId, $questionIndex, $answerIndex, '');
        }
 
        return $pageObjectId;
    }

References getSpecificAnswerFeedbackId(), and saveSpecificAnswerFeedbackContent().

Referenced by getSpecificAnswerFeedbackExportPresentation(), ilAssClozeTestFeedback\getSpecificAnswerFeedbackFormValue(), getSpecificAnswerFeedbackTestPresentation(), importSpecificAnswerFeedback(), ilAssConfigurableMultiOptionQuestionFeedback\initSpecificFormProperties(), and initSpecificFormProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackTestPresentation()

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

Reimplemented from ilAssQuestionFeedback.

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

                                                                                                                    : string
    {
        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            return $this->cleanupPageContent(
                $this->getPageObjectContent(
                    $this->getSpecificAnswerFeedbackPageObjectType(),
                    $this->getSpecificAnswerFeedbackPageObjectId($questionId, $questionIndex, $answerIndex)
                )
            );
        }
        return $this->getSpecificAnswerFeedbackContent(
            $questionId,
            $questionIndex,
            $answerIndex
        );
    }

References ilAssQuestionFeedback\cleanupPageContent(), ilAssQuestionFeedback\getPageObjectContent(), getSpecificAnswerFeedbackContent(), getSpecificAnswerFeedbackPageObjectId(), and ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType().

Referenced by ilAssClozeTestFeedback\determineTestOutputGapFeedback().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificFeedbackContentForFeedbackIds()

ilAssMultiOptionQuestionFeedback::getSpecificFeedbackContentForFeedbackIds ( array $feedback_ids )

protected

Parameters

array<int> $feedback_ids

Returns: array<int, string>

Definition at line 305 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                                    : array
    {
        $res = $this->db->query(
            "SELECT feedback_id, feedback FROM {$this->getSpecificFeedbackTableName()} WHERE "
                . $this->db->in('feedback_id', $feedback_ids, false, ilDBConstants::T_INTEGER)
        );
 
        $content = [];
        while ($row = $this->db->fetchAssoc($res)) {
            $content[$row['feedback_id']] = $row['feedback'];
        }
        return $content;
    }

References $res, and ilDBConstants\T_INTEGER.

Referenced by ilAssClozeTestFeedback\isSpecificAnswerFeedbackAvailable().

Here is the caller graph for this function:

◆ getSpecificFeedbackTableName()

ilAssMultiOptionQuestionFeedback::getSpecificFeedbackTableName ( )

finalprotected

Definition at line 331 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                           : string
    {
        return self::TABLE_NAME_SPECIFIC_FEEDBACK;
    }

References TABLE_NAME_SPECIFIC_FEEDBACK.

Referenced by duplicateSpecificFeedback(), saveSpecificAnswerFeedbackContent(), and syncSpecificFeedback().

Here is the caller graph for this function:

◆ importSpecificAnswerFeedback()

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

Reimplemented from ilAssQuestionFeedback.

Definition at line 380 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                                                                                : void
    {
        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            $pageObjectId = $this->getSpecificAnswerFeedbackPageObjectId($questionId, $questionIndex, $answerIndex);
            $pageObjectType = $this->getSpecificAnswerFeedbackPageObjectType();
 
            $this->createPageObject($pageObjectType, $pageObjectId, $feedbackContent);
        } else {
            $this->saveSpecificAnswerFeedbackContent($questionId, $questionIndex, $answerIndex, $feedbackContent);
        }
    }

References ilAssQuestionFeedback\createPageObject(), getSpecificAnswerFeedbackPageObjectId(), ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType(), and saveSpecificAnswerFeedbackContent().

Here is the call graph for this function:

◆ initSpecificFormProperties()

ilAssMultiOptionQuestionFeedback::initSpecificFormProperties ( ilPropertyFormGUI $form )

initialises a given form object's specific form properties relating to this question type

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssClozeTestFeedback, and ilAssConfigurableMultiOptionQuestionFeedback.

Definition at line 92 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                       : void
    {
        if (!$this->questionOBJ->getSelfAssessmentEditingMode()) {
            foreach ($this->getAnswerOptionsByAnswerIndex() as $index => $answer) {
                if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
                    $value = $this->getPageObjectNonEditableValueHTML(
                        $this->getSpecificAnswerFeedbackPageObjectType(),
                        $this->getSpecificAnswerFeedbackPageObjectId($this->questionOBJ->getId(), 0, $index)
                    );
                } else {
                    $value = $this->questionOBJ->prepareTextareaOutput(
                        $this->getSpecificAnswerFeedbackContent($this->questionOBJ->getId(), 0, $index)
                    );
                }
 
                $form->getItemByPostVar("feedback_answer_$index")->setValue($value);
            }
        }
    }

References $index, getAnswerOptionsByAnswerIndex(), ilPropertyFormGUI\getItemByPostVar(), ilAssQuestionFeedback\getPageObjectNonEditableValueHTML(), getSpecificAnswerFeedbackContent(), getSpecificAnswerFeedbackPageObjectId(), and ilAssQuestionFeedback\getSpecificAnswerFeedbackPageObjectType().

Here is the call graph for this function:

◆ isSpecificAnswerFeedbackId()

ilAssMultiOptionQuestionFeedback::isSpecificAnswerFeedbackId ( int $feedbackId )

protected

Reimplemented from ilAssQuestionFeedback.

Definition at line 319 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                  : bool
    {
        $row = $this->db->fetchAssoc($this->db->queryF(
            "SELECT COUNT(feedback_id) cnt FROM {$this->getSpecificFeedbackTableName()}
                                        WHERE question_fi = %s AND feedback_id = %s",
            ['integer', 'integer'],
            [$this->questionOBJ->getId(), $feedbackId]
        ));
 
        return (bool) $row['cnt'];
    }

◆ saveSpecificAnswerFeedbackContent()

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

Reimplemented from ilAssQuestionFeedback.

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

                                                                                                                                     : int
    {
        if ($feedbackContent !== '') {
            $feedbackContent = ilRTE::_replaceMediaObjectImageSrc(
                $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($feedbackContent),
                0
            );
        }
 
        $feedbackId = $this->getSpecificAnswerFeedbackId($questionId, $questionIndex, $answerIndex);
 
        if ($feedbackId !== -1) {
            $this->db->update(
                $this->getSpecificFeedbackTableName(),
                [
                    'feedback' => ['text', $feedbackContent],
                    'tstamp' => ['integer', time()]
                ],
                [
                    'feedback_id' => ['integer', $feedbackId],
                ]
            );
        } else {
            $feedbackId = $this->db->nextId($this->getSpecificFeedbackTableName());
 
            $this->db->insert($this->getSpecificFeedbackTableName(), [
                'feedback_id' => ['integer', $feedbackId],
                'question_fi' => ['integer', $questionId],
                'question' => ['integer', $questionIndex],
                'answer' => ['integer', $answerIndex],
                'feedback' => ['text', $feedbackContent],
                'tstamp' => ['integer', time()]
            ]);
        }
 
        return $feedbackId;
    }

References ilRTE\_replaceMediaObjectImageSrc(), getSpecificAnswerFeedbackId(), and getSpecificFeedbackTableName().

Referenced by getSpecificAnswerFeedbackPageObjectId(), importSpecificAnswerFeedback(), ilAssClozeTestFeedback\saveFbPropsForNumericGap(), ilAssClozeTestFeedback\saveFbPropsForSelectGap(), ilAssClozeTestFeedback\saveFbPropsForTextGap(), ilAssClozeTestFeedback\saveFeedbackFieldsPerGapQuestion(), ilAssConfigurableMultiOptionQuestionFeedback\saveSpecificFormProperties(), and saveSpecificFormProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveSpecificFormProperties()

ilAssMultiOptionQuestionFeedback::saveSpecificFormProperties ( ilPropertyFormGUI $form )

saves a given form object's SPECIFIC form properties relating to this question type

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssClozeTestFeedback, and ilAssConfigurableMultiOptionQuestionFeedback.

Definition at line 112 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                       : void
    {
        if (!$this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            foreach ($this->getAnswerOptionsByAnswerIndex() as $index => $answer) {
                $this->saveSpecificAnswerFeedbackContent(
                    $this->questionOBJ->getId(),
                    0,
                    $index,
                    (string) ($form->getInput("feedback_answer_$index") ?? '')
                );
            }
        }
    }

References $index, getAnswerOptionsByAnswerIndex(), ilPropertyFormGUI\getInput(), and saveSpecificAnswerFeedbackContent().

Here is the call graph for this function:

◆ specificAnswerFeedbackExists()

ilAssMultiOptionQuestionFeedback::specificAnswerFeedbackExists ( )

Definition at line 392 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                  : bool
    {
        $res = $this->db->queryF(
            "SELECT answer FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
            ['integer'],
            [$this->questionOBJ->getId()]
        );
 
        $allFeedbackContents = '';
 
        while ($row = $this->db->fetchAssoc($res)) {
            $allFeedbackContents .= $this->getSpecificAnswerFeedbackExportPresentation(
                $this->questionOBJ->getId(),
                0,
                $row['answer']
            );
        }
 
        return (bool) strlen(trim(strip_tags($allFeedbackContents)));
    }

References $res, and getSpecificAnswerFeedbackExportPresentation().

Here is the call graph for this function:

◆ syncSpecificFeedback()

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

protected

syncs the SPECIFIC feedback from a duplicated question back to the original question

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssClozeTestFeedback, and ilAssConfigurableMultiOptionQuestionFeedback.

Definition at line 256 of file class.ilAssMultiOptionQuestionFeedback.php.

                                                                                              : void
    {
        // delete specific feedback of the original
        $this->db->manipulateF(
            "DELETE FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
            ['integer'],
            [$originalQuestionId]
        );
 
        // get specific feedback of the actual question
        $res = $this->db->queryF(
            "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
            ['integer'],
            [$duplicateQuestionId]
        );
 
        // save specific feedback to the original
        while ($row = $this->db->fetchAssoc($res)) {
            $nextId = $this->db->nextId($this->getSpecificFeedbackTableName());
 
            $this->db->insert($this->getSpecificFeedbackTableName(), [
                'feedback_id' => ['integer', $nextId],
                'question_fi' => ['integer', $originalQuestionId],
                'question' => ['integer', $row['question']],
                'answer' => ['integer', $row['answer']],
                'feedback' => ['text', $row['feedback']],
                'tstamp' => ['integer', time()]
            ]);
        }
    }

References $res, and getSpecificFeedbackTableName().

Here is the call graph for this function:

Field Documentation

◆ TABLE_NAME_SPECIFIC_FEEDBACK

const ilAssMultiOptionQuestionFeedback::TABLE_NAME_SPECIFIC_FEEDBACK = 'qpl_fb_specific'

table name for specific feedback

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

Referenced by getSpecificFeedbackTableName(), and ilAssSpecificFeedbackIdentifierList\getSpecificFeedbackTableName().

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

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

Public Member Functions

Data Fields

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ buildAnswerOptionLabel()

◆ completeSpecificFormProperties()

◆ deleteSpecificAnswerFeedbacks()

◆ duplicateSpecificFeedback()

◆ getAllSpecificAnswerFeedbackContents()

◆ getAnswerOptionsByAnswerIndex()

◆ getSpecificAnswerFeedbackContent()

◆ getSpecificAnswerFeedbackExportPresentation()

◆ getSpecificAnswerFeedbackId()

◆ getSpecificAnswerFeedbackPageObjectId()

◆ getSpecificAnswerFeedbackTestPresentation()

◆ getSpecificFeedbackContentForFeedbackIds()

◆ getSpecificFeedbackTableName()

◆ importSpecificAnswerFeedback()

◆ initSpecificFormProperties()

◆ isSpecificAnswerFeedbackId()

◆ saveSpecificAnswerFeedbackContent()

◆ saveSpecificFormProperties()

◆ specificAnswerFeedbackExists()

◆ syncSpecificFeedback()

Field Documentation

◆ TABLE_NAME_SPECIFIC_FEEDBACK