Inheritance diagram for ilAssQuestionFeedback:

Collaboration diagram for ilAssQuestionFeedback:

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

	getGenericFeedbackTestPresentation (int $question_id, bool $solution_completed)
	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 $question_id, int $question_index, int $answer_index)
	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 $question_id, bool $solution_completed)
	returns the GENERIC feedback content for a given question state. More...

	getSpecificAnswerFeedbackContent (int $question_id, int $question_index, int $answer_index)

	getAllSpecificAnswerFeedbackContents (int $question_id)

	isSpecificAnswerFeedbackAvailable (int $question_id)

	saveGenericFeedbackContent (int $question_id, bool $solution_completed, string $feedback_content)
	saves GENERIC feedback content for the given question id to the database. More...

	saveSpecificAnswerFeedbackContent (int $question_id, int $question_index, int $answer_index, string $feedback_content)

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

	deleteSpecificAnswerFeedbacks (int $question_id, 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 $question_id, bool $solution_completed)
	returns the generic feedback export presentation for given question id either for solution completed or incompleted More...

	getSpecificAnswerFeedbackExportPresentation (int $question_id, int $question_index, int $answer_index)
	returns the generic feedback export presentation for given question id either for solution completed or incompleted More...

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

	importSpecificAnswerFeedback (int $question_id, int $question_index, int $answer_index, string $feedback_content)

	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator, int $question_id)

	createFeedbackPages (string $mode)

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

Data Fields
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
	buildFeedbackContentFormProperty (string $label, string $post_var, bool $as_non_editable)
	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 $question_id, bool $solution_completed)
	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 $page_object_type, int $page_object_id)
	returns html content to be used as value for non editable value form properties in feedback editing form More...

	getPageObjectXML (string $page_object_type, int $page_object_id)

	createPageObject (string $page_object_type, int $page_object_id, string $page_object_content)

	duplicatePageObject (string $page_object_type, int $original_page_object_id, int $duplicate_page_object_id, int $duplicate_page_object_parent_id)

	ensurePageObjectDeleted (string $page_object_type, int $page_object_id)

	getGenericFeedbackPageObjectType ()

	getSpecificAnswerFeedbackPageObjectType ()

	getGenericFeedbackPageObjectId (int $question_id, bool $solution_completed)
	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)

Protected Attributes
assQuestion	$questionOBJ

ilCtrl	$ctrl

ilDBInterface	$db

ilLanguage	$lng

string	$page_obj_output_mode = "presentation"

Private Member Functions
	duplicateGenericFeedback (int $originalQuestionId, int $duplicateQuestionId)
	duplicates the GENERIC feedback relating to the given original question id and saves it for the given duplicate question id More...

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

	getPageObjectEditingLink (string $page_object_type, int $page_object_id)

	ensurePageObjectExists (string $page_object_type, int $page_object_id)

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilAssQuestionFeedback::__construct	(	assQuestion	$questionOBJ,
		ilCtrl	$ctrl,
		ilDBInterface	$db,
		ilLanguage	$lng
	)

final

constructor

public

Parameters

assQuestion	$questionOBJ
ilCtrl	$ctrl
ilDBInterface	$db
ilLanguage	$lng

Definition at line 76 of file class.ilAssQuestionFeedback.php.

References $ctrl, $db, $lng, $questionOBJ, ILIAS\Repository\ctrl(), and ILIAS\Repository\lng().

     {
         $this->questionOBJ = $questionOBJ;
         $this->ctrl = $ctrl;
         $this->lng = $lng;
         $this->db = $db;
     }

Here is the call graph for this function:

Member Function Documentation

◆ buildFeedbackContentFormProperty()

ilAssQuestionFeedback::buildFeedbackContentFormProperty	(	string	$label,
		string	$post_var,
		bool	$as_non_editable
	)

finalprotected

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

non editable gui
textarea input gui
Returns
ilTextAreaInputGUI|ilNonEditableValueGUI

Definition at line 244 of file class.ilAssQuestionFeedback.php.

References ilObjAdvancedEditing\_getUsedHTMLTags(), and ilAssSelfAssessmentQuestionFormatter\getSelfAssessmentTags().

Referenced by ilAssClozeTestFeedback\completeFbPropsForNumericGap(), ilAssClozeTestFeedback\completeFbPropsForSelectGap(), ilAssClozeTestFeedback\completeFbPropsForTextGap(), ilAssClozeTestFeedback\completeFormPropsForFeedbackModeGapQuestion(), completeGenericFormProperties(), ilAssConfigurableMultiOptionQuestionFeedback\completeSpecificFormProperties(), and ilAssMultiOptionQuestionFeedback\completeSpecificFormProperties().

                                                                                                                      : ilSubEnabledFormPropertyGUI
     {
         if ($as_non_editable) {
             $property = new ilNonEditableValueGUI($label, $post_var, true);
         } else {
             $property = new ilTextAreaInputGUI($label, $post_var);
             $property->setRequired(false);
             $property->setRows(10);
             $property->setCols(80);
 
             if (!$this->questionOBJ->getPreventRteUsage()) {
                 $property->setUseRte(true);
                 $property->addPlugin("latex");
                 $property->addButton("latex");
                 $property->addButton("pastelatex");
 
                 $property->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("assessment"));
                 $property->setRTESupport($this->questionOBJ->getId(), "qpl", "assessment");
             } else {
                 $property->setRteTags(ilAssSelfAssessmentQuestionFormatter::getSelfAssessmentTags());
                 $property->setUseTagsForRteOnly(false);
             }
 
             $property->setRTESupport($this->questionOBJ->getId(), "qpl", "assessment");
         }
 
         return $property;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkFeedbackParent()

ilAssQuestionFeedback::checkFeedbackParent ( int $feedbackId )

final

Definition at line 515 of file class.ilAssQuestionFeedback.php.

References isGenericFeedbackId(), isSpecificAnswerFeedbackId(), and syncSpecificFeedback().

                                                               : bool
     {
         if ($this->isGenericFeedbackId($feedbackId)) {
             return true;
         }
 
         if ($this->isSpecificAnswerFeedbackId($feedbackId)) {
             return true;
         }
 
         return false;
     }

Here is the call graph for this function:

◆ cleanupPageContent()

ilAssQuestionFeedback::cleanupPageContent ( string $content )

protected

Definition at line 758 of file class.ilAssQuestionFeedback.php.

Referenced by ilAssMultiOptionQuestionFeedback\getAllSpecificAnswerPageEditorFeedbackContents(), getGenericFeedbackTestPresentation(), and ilAssMultiOptionQuestionFeedback\getSpecificAnswerFeedbackTestPresentation().

                                                           : string
     {
         $doc = new DOMDocument('1.0', 'UTF-8');
         if (@$doc->loadHTML('<html><body>' . $content . '</body></html>')) {
             $xpath = new DOMXPath($doc);
             $nodes_after_comments = $xpath->query('//comment()/following-sibling::*[1]');
             foreach ($nodes_after_comments as $node_after_comments) {
                 if (trim($node_after_comments->nodeValue) === ''
                     && $node_after_comments->childElementCount === 0) {
                     return '';
                 }
             }
         }
         return $content;
     }

Here is the caller graph for this function:

◆ completeGenericFormProperties()

ilAssQuestionFeedback::completeGenericFormProperties ( ilPropertyFormGUI $form )

final

completes a given form object with the GENERIC form properties required by all question types

Definition at line 121 of file class.ilAssQuestionFeedback.php.

References ilPropertyFormGUI\addItem(), buildFeedbackContentFormProperty(), completeSpecificFormProperties(), and ILIAS\Repository\lng().

                                                                                 : void
     {
         $form->addItem($this->buildFeedbackContentFormProperty(
             $this->lng->txt('feedback_complete_solution'),
             'feedback_complete',
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
 
         $form->addItem($this->buildFeedbackContentFormProperty(
             $this->lng->txt('feedback_incomplete_solution'),
             'feedback_incomplete',
             $this->questionOBJ->isAdditionalContentEditingModePageObject()
         ));
     }

Here is the call graph for this function:

◆ completeSpecificFormProperties()

ilAssQuestionFeedback::completeSpecificFormProperties ( ilPropertyFormGUI $form )

abstract

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

public

Parameters

ilPropertyFormGUI $form

Referenced by completeGenericFormProperties().

Here is the caller graph for this function:

◆ createFeedbackPages()

ilAssQuestionFeedback::createFeedbackPages ( string $mode )

Definition at line 774 of file class.ilAssQuestionFeedback.php.

References ensurePageObjectExists(), getPageObjectEditingLink(), PAGE_OBJECT_TYPE_GENERIC_FEEDBACK, and saveGenericFeedbackContent().

                                                      : string
     {
         $page_object_type = ilAssQuestionFeedback::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK;
         $page_object_id_complete = $this->saveGenericFeedbackContent(
             $this->questionOBJ->getId(),
             true,
             ''
         );
         $this->ensurePageObjectExists($page_object_type, $page_object_id_complete);
 
         $page_object_id_incomplete = $this->saveGenericFeedbackContent(
             $this->questionOBJ->getId(),
             false,
             ''
         );
         $this->ensurePageObjectExists($page_object_type, $page_object_id_incomplete);
 
         $page_object_id = ($mode === 'complete') ? $page_object_id_complete : $page_object_id_incomplete;
         return $this->getPageObjectEditingLink(
             $page_object_type,
             $page_object_id
         );
     }

Here is the call graph for this function:

◆ createPageObject()

ilAssQuestionFeedback::createPageObject	(	string	$page_object_type,
		int	$page_object_id,
		string	$page_object_content
	)

finalprotected

Definition at line 626 of file class.ilAssQuestionFeedback.php.

References getClassNameByType().

Referenced by importGenericFeedback(), and ilAssMultiOptionQuestionFeedback\importSpecificAnswerFeedback().

                                                                                                                          : void
     {
         $cl = $this->getClassNameByType($page_object_type);
 
         $pageObject = new $cl();
         $pageObject->setParentId($this->questionOBJ->getId());
         $pageObject->setId($page_object_id);
         $pageObject->setXMLContent($page_object_content);
         $pageObject->createFromXML();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteGenericFeedbacks()

ilAssQuestionFeedback::deleteGenericFeedbacks	(	int	$question_id,
		bool	$isAdditionalContentEditingModePageObject
	)

final

deletes all GENERIC feedback contents (and page objects if required) for the given question id

Definition at line 369 of file class.ilAssQuestionFeedback.php.

References deleteSpecificAnswerFeedbacks(), ensurePageObjectDeleted(), getGenericFeedbackPageObjectId(), and getGenericFeedbackPageObjectType().

                                                                                                                   : void
     {
         if ($isAdditionalContentEditingModePageObject) {
             $this->ensurePageObjectDeleted(
                 $this->getGenericFeedbackPageObjectType(),
                 $this->getGenericFeedbackPageObjectId($question_id, true)
             );
 
             $this->ensurePageObjectDeleted(
                 $this->getGenericFeedbackPageObjectType(),
                 $this->getGenericFeedbackPageObjectId($question_id, false)
             );
         }
 
         $this->db->manipulateF(
             "DELETE FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s",
             ['integer'],
             [$question_id]
         );
     }

Here is the call graph for this function:

◆ deleteSpecificAnswerFeedbacks()

ilAssQuestionFeedback::deleteSpecificAnswerFeedbacks	(	int	$question_id,
		bool	$isAdditionalContentEditingModePageObject
	)

abstract

Referenced by deleteGenericFeedbacks().

Here is the caller graph for this function:

◆ duplicateFeedback()

ilAssQuestionFeedback::duplicateFeedback	(	int	$originalQuestionId,
		int	$duplicateQuestionId
	)

final

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

Definition at line 396 of file class.ilAssQuestionFeedback.php.

References duplicateGenericFeedback(), and duplicateSpecificFeedback().

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

Here is the call graph for this function:

◆ duplicateGenericFeedback()

ilAssQuestionFeedback::duplicateGenericFeedback	(	int	$originalQuestionId,
		int	$duplicateQuestionId
	)

private

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

Definition at line 406 of file class.ilAssQuestionFeedback.php.

References $res, duplicatePageObject(), duplicateSpecificFeedback(), getGenericFeedbackPageObjectType(), and getGenericFeedbackTableName().

Referenced by duplicateFeedback().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicatePageObject()

ilAssQuestionFeedback::duplicatePageObject	(	string	$page_object_type,
		int	$original_page_object_id,
		int	$duplicate_page_object_id,
		int	$duplicate_page_object_parent_id
	)

finalprotected

Definition at line 637 of file class.ilAssQuestionFeedback.php.

References ensurePageObjectExists(), and getClassNameByType().

Referenced by duplicateGenericFeedback(), and ilAssMultiOptionQuestionFeedback\duplicateSpecificFeedback().

                                                                                                                                                                              : void
     {
         $this->ensurePageObjectExists($page_object_type, $original_page_object_id);
 
         $cl = $this->getClassNameByType($page_object_type);
 
         $pageObject = new $cl($original_page_object_id);
         $pageObject->setParentId($duplicate_page_object_parent_id);
         $pageObject->setId($duplicate_page_object_id);
         $pageObject->createFromXML();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicateSpecificFeedback()

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

abstractprotected

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

Referenced by duplicateFeedback(), and duplicateGenericFeedback().

Here is the caller graph for this function:

◆ ensurePageObjectDeleted()

ilAssQuestionFeedback::ensurePageObjectDeleted	(	string	$page_object_type,
		int	$page_object_id
	)

finalprotected

Definition at line 649 of file class.ilAssQuestionFeedback.php.

References ilPageObject\_exists(), PAGE_OBJECT_TYPE_GENERIC_FEEDBACK, and PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK.

Referenced by deleteGenericFeedbacks(), ilAssMultiOptionQuestionFeedback\deleteSpecificAnswerFeedbacks(), and ilAssClozeTestFeedback\deleteSpecificAnswerFeedbacksByIds().

                                                                                                    : void
     {
         if ($page_object_id === -1) {
             return;
         }
 
         if ($page_object_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK) {
             if (ilAssGenFeedbackPage::_exists($page_object_type, $page_object_id)) {
                 $pageObject = new ilAssGenFeedbackPage($page_object_id);
                 $pageObject->delete();
             }
         }
         if ($page_object_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK) {
             if (ilAssSpecFeedbackPage::_exists($page_object_type, $page_object_id)) {
                 $pageObject = new ilAssSpecFeedbackPage($page_object_id);
                 $pageObject->delete();
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensurePageObjectExists()

ilAssQuestionFeedback::ensurePageObjectExists	(	string	$page_object_type,
		int	$page_object_id
	)

private

Definition at line 608 of file class.ilAssQuestionFeedback.php.

References ilPageObject\_exists(), PAGE_OBJECT_TYPE_GENERIC_FEEDBACK, and PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK.

Referenced by createFeedbackPages(), duplicatePageObject(), getPageObjectOutputMode(), getPageObjectXML(), and initGenericFormProperties().

                                                                                           : void
     {
         if ($page_object_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK
             && !ilAssGenFeedbackPage::_exists($page_object_type, $page_object_id, '', true)) {
             $pageObject = new ilAssGenFeedbackPage();
             $pageObject->setParentId($this->questionOBJ->getId());
             $pageObject->setId($page_object_id);
             $pageObject->createFromXML();
         }
         if ($page_object_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK
             && !ilAssSpecFeedbackPage::_exists($page_object_type, $page_object_id, '', true)) {
             $pageObject = new ilAssSpecFeedbackPage();
             $pageObject->setParentId($this->questionOBJ->getId());
             $pageObject->setId($page_object_id);
             $pageObject->createFromXML();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAllSpecificAnswerFeedbackContents()

ilAssQuestionFeedback::getAllSpecificAnswerFeedbackContents ( int $question_id )

abstract

Referenced by getGenericFeedbackContent().

Here is the caller graph for this function:

◆ getClassNameByType()

ilAssQuestionFeedback::getClassNameByType	(	string	$a_type,
		bool	$a_gui = `false`
	)

Definition at line 554 of file class.ilAssQuestionFeedback.php.

References PAGE_OBJECT_TYPE_GENERIC_FEEDBACK.

Referenced by createPageObject(), duplicatePageObject(), getPageObjectEditingLink(), getPageObjectOutputMode(), and getPageObjectXML().

                                                                            : string
     {
         $gui = ($a_gui) ? "GUI" : "";
 
         if ($a_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK) {
             return "ilAssGenFeedbackPage" . $gui;
         }
 
         //if ($a_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK) {
         return "ilAssSpecFeedbackPage" . $gui;
     }

Here is the caller graph for this function:

◆ getGenericFeedbackContent()

ilAssQuestionFeedback::getGenericFeedbackContent	(	int	$question_id,
		bool	$solution_completed
	)

final

returns the GENERIC feedback content for a given question state.

the state is either the completed solution (all answers correct) of the question or at least one incorrect answer.

Definition at line 278 of file class.ilAssQuestionFeedback.php.

References $res, ilRTE\_replaceMediaObjectImageSrc(), getAllSpecificAnswerFeedbackContents(), and getSpecificAnswerFeedbackContent().

Referenced by getGenericFeedbackExportPresentation(), getGenericFeedbackTestPresentation(), and initGenericFormProperties().

                                                                                                : string
     {
         $res = $this->db->queryF(
             "SELECT * FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s AND correctness = %s",
             ['integer', 'text'],
             [$question_id, (int) $solution_completed]
         );
 
         $feedback_content = '';
 
         if ($this->db->numRows($res) > 0) {
             $row = $this->db->fetchAssoc($res);
             $feedback_content = ilRTE::_replaceMediaObjectImageSrc(
                 $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($row['feedback'] ?? ''),
                 1
             );
         }
         return $feedback_content;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGenericFeedbackExportPresentation()

ilAssQuestionFeedback::getGenericFeedbackExportPresentation	(	int	$question_id,
		bool	$solution_completed
	)

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

Definition at line 709 of file class.ilAssQuestionFeedback.php.

References getGenericFeedbackContent(), getGenericFeedbackPageObjectId(), getGenericFeedbackPageObjectType(), getPageObjectXML(), and getSpecificAnswerFeedbackExportPresentation().

                                                                                                     : string
     {
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             $genericFeedbackExportPresentation = $this->getPageObjectXML(
                 $this->getGenericFeedbackPageObjectType(),
                 $this->getGenericFeedbackPageObjectId($question_id, $solution_completed)
             );
         } else {
             $genericFeedbackExportPresentation = $this->getGenericFeedbackContent($question_id, $solution_completed);
         }
 
         return $genericFeedbackExportPresentation;
     }

Here is the call graph for this function:

◆ getGenericFeedbackId()

ilAssQuestionFeedback::getGenericFeedbackId	(	int	$question_id,
		bool	$solution_completed
	)

finalprotected

returns the SPECIFIC answer feedback ID for a given question id and answer index.

Definition at line 483 of file class.ilAssQuestionFeedback.php.

References $res, and ILIAS\Repository\int().

Referenced by getGenericFeedbackPageObjectId(), initGenericFormProperties(), and saveGenericFeedbackContent().

                                                                                              : int
     {
         $res = $this->db->queryF(
             "SELECT feedback_id FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s AND correctness = %s",
             ['integer','text'],
             [$question_id, (int) $solution_completed]
         );
 
         $feedbackId = -1;
         if ($this->db->numRows($res)) {
             $row = $this->db->fetchAssoc($res);
             $feedbackId = (int) $row['feedback_id'];
         }
 
         return $feedbackId;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGenericFeedbackPageObjectId()

ilAssQuestionFeedback::getGenericFeedbackPageObjectId	(	int	$question_id,
		bool	$solution_completed
	)

finalprotected

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)

Definition at line 699 of file class.ilAssQuestionFeedback.php.

References getGenericFeedbackId().

Referenced by deleteGenericFeedbacks(), getGenericFeedbackExportPresentation(), getGenericFeedbackTestPresentation(), and initGenericFormProperties().

                                                                                                        : int
     {
         $page_object_id = $this->getGenericFeedbackId($question_id, $solution_completed);
         return $page_object_id;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGenericFeedbackPageObjectType()

ilAssQuestionFeedback::getGenericFeedbackPageObjectType ( )

finalprotected

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

Referenced by deleteGenericFeedbacks(), duplicateGenericFeedback(), getGenericFeedbackExportPresentation(), getGenericFeedbackTestPresentation(), importGenericFeedback(), and initGenericFormProperties().

                                                                : string
     {
         return self::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK;
     }

Here is the caller graph for this function:

◆ getGenericFeedbackTableName()

ilAssQuestionFeedback::getGenericFeedbackTableName ( )

finalprotected

Definition at line 533 of file class.ilAssQuestionFeedback.php.

Referenced by duplicateGenericFeedback(), saveGenericFeedbackContent(), and syncGenericFeedback().

                                                           : string
     {
         return self::TABLE_NAME_GENERIC_FEEDBACK;
     }

Here is the caller graph for this function:

◆ getGenericFeedbackTestPresentation()

ilAssQuestionFeedback::getGenericFeedbackTestPresentation	(	int	$question_id,
		bool	$solution_completed
	)

returns the html of GENERIC feedback for the given question id for test presentation (either for the complete solution or for the incomplete solution)

Definition at line 88 of file class.ilAssQuestionFeedback.php.

References cleanupPageContent(), getGenericFeedbackContent(), getGenericFeedbackPageObjectId(), getGenericFeedbackPageObjectType(), and getSpecificAnswerFeedbackTestPresentation().

                                                                                                   : string
     {
         if ($this->page_obj_output_mode == "edit") {
             return '';
         }
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             return $this->cleanupPageContent(
                 $this->getPageObjectContent(
                     $this->getGenericFeedbackPageObjectType(),
                     $this->getGenericFeedbackPageObjectId($question_id, $solution_completed)
                 )
             );
         }
         return $this->getGenericFeedbackContent($question_id, $solution_completed);
     }

Here is the call graph for this function:

◆ getPageObjectEditingLink()

ilAssQuestionFeedback::getPageObjectEditingLink	(	string	$page_object_type,
		int	$page_object_id
	)

private

Definition at line 566 of file class.ilAssQuestionFeedback.php.

References ILIAS\Repository\ctrl(), and getClassNameByType().

Referenced by createFeedbackPages(), and getPageObjectNonEditableValueHTML().

                                                                                             : string
     {
         $cl = $this->getClassNameByType($page_object_type, true);
         $this->ctrl->setParameterByClass($cl, 'feedback_type', $page_object_type);
         $this->ctrl->setParameterByClass($cl, 'feedback_id', $page_object_id);
 
         return $this->ctrl->getLinkTargetByClass($cl, 'edit');
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPageObjectNonEditableValueHTML()

ilAssQuestionFeedback::getPageObjectNonEditableValueHTML	(	string	$page_object_type,
		int	$page_object_id
	)

finalprotected

returns html content to be used as value for non editable value form properties in feedback editing form

Definition at line 542 of file class.ilAssQuestionFeedback.php.

References getPageObjectEditingLink(), and ILIAS\Repository\lng().

Referenced by ilAssClozeTestFeedback\getSpecificAnswerFeedbackFormValue(), initGenericFormProperties(), ilAssConfigurableMultiOptionQuestionFeedback\initSpecificFormProperties(), and ilAssMultiOptionQuestionFeedback\initSpecificFormProperties().

                                                                                                              : string
     {
         $link = $this->getPageObjectEditingLink($page_object_type, $page_object_id);
         $content = $this->getPageObjectContent($page_object_type, $page_object_id);
         return sprintf(
             '<a href="%s">%s</a><br /><br />%s',
             $link,
             $this->lng->txt('tst_question_feedback_edit_page'),
             $content
         );
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPageObjectOutputMode()

ilAssQuestionFeedback::getPageObjectOutputMode ( )

final

Definition at line 580 of file class.ilAssQuestionFeedback.php.

References $page_obj_output_mode, ILIAS\Repository\ctrl(), ensurePageObjectExists(), and getClassNameByType().

                                                    : string
     {
         return $this->page_obj_output_mode;
     }

Here is the call graph for this function:

◆ getPageObjectXML()

ilAssQuestionFeedback::getPageObjectXML	(	string	$page_object_type,
		int	$page_object_id
	)

finalprotected

Definition at line 598 of file class.ilAssQuestionFeedback.php.

References ensurePageObjectExists(), and getClassNameByType().

Referenced by getGenericFeedbackExportPresentation(), ilAssMultiOptionQuestionFeedback\getSpecificAnswerFeedbackExportPresentation(), and ilAssClozeTestFeedback\isSpecificAnswerFeedbackAvailable().

                                                                                             : string
     {
         $cl = $this->getClassNameByType($page_object_type);
 
         $this->ensurePageObjectExists($page_object_type, $page_object_id);
 
         $pageObject = new $cl($page_object_id);
         return $pageObject->getXMLContent();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackContent()

ilAssQuestionFeedback::getSpecificAnswerFeedbackContent	(	int	$question_id,
		int	$question_index,
		int	$answer_index
	)

abstract

Referenced by getGenericFeedbackContent().

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackExportPresentation()

ilAssQuestionFeedback::getSpecificAnswerFeedbackExportPresentation	(	int	$question_id,
		int	$question_index,
		int	$answer_index
	)

abstract

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

Referenced by getGenericFeedbackExportPresentation(), and isSpecificAnswerFeedbackAvailable().

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackPageObjectType()

ilAssQuestionFeedback::getSpecificAnswerFeedbackPageObjectType ( )

finalprotected

Definition at line 674 of file class.ilAssQuestionFeedback.php.

Referenced by ilAssMultiOptionQuestionFeedback\deleteSpecificAnswerFeedbacks(), ilAssClozeTestFeedback\deleteSpecificAnswerFeedbacksByIds(), ilAssMultiOptionQuestionFeedback\duplicateSpecificFeedback(), ilAssMultiOptionQuestionFeedback\getAllSpecificAnswerPageEditorFeedbackContents(), ilAssMultiOptionQuestionFeedback\getSpecificAnswerFeedbackExportPresentation(), ilAssClozeTestFeedback\getSpecificAnswerFeedbackFormValue(), ilAssMultiOptionQuestionFeedback\getSpecificAnswerFeedbackTestPresentation(), ilAssMultiOptionQuestionFeedback\importSpecificAnswerFeedback(), ilAssConfigurableMultiOptionQuestionFeedback\initSpecificFormProperties(), ilAssMultiOptionQuestionFeedback\initSpecificFormProperties(), and ilAssClozeTestFeedback\isSpecificAnswerFeedbackAvailable().

                                                                       : string
     {
         return self::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK;
     }

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackTestPresentation()

ilAssQuestionFeedback::getSpecificAnswerFeedbackTestPresentation	(	int	$question_id,
		int	$question_index,
		int	$answer_index
	)

abstract

returns the html of SPECIFIC feedback for the given question id and answer index for test presentation

public

Parameters

integer	$question_id
integer	$question_index
integer	$answer_index

Returns: string $specificAnswerFeedbackTestPresentationHTML

Referenced by getGenericFeedbackTestPresentation().

Here is the caller graph for this function:

◆ importGenericFeedback()

ilAssQuestionFeedback::importGenericFeedback	(	int	$question_id,
		bool	$solution_completed,
		string	$feedback_content
	)

imports the given feedback content as generic feedback for the given question id for either the complete or incomplete solution

Definition at line 733 of file class.ilAssQuestionFeedback.php.

References createPageObject(), getGenericFeedbackPageObjectType(), importSpecificAnswerFeedback(), and saveGenericFeedbackContent().

                                                                                                                : void
     {
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             $page_object_id = $this->saveGenericFeedbackContent($question_id, $solution_completed, '');
             $page_object_type = $this->getGenericFeedbackPageObjectType();
 
             $this->createPageObject($page_object_type, $page_object_id, $feedback_content);
         } else {
             $this->saveGenericFeedbackContent($question_id, $solution_completed, $feedback_content);
         }
     }

Here is the call graph for this function:

◆ importSpecificAnswerFeedback()

ilAssQuestionFeedback::importSpecificAnswerFeedback	(	int	$question_id,
		int	$question_index,
		int	$answer_index,
		string	$feedback_content
	)

abstract

Referenced by importGenericFeedback().

Here is the caller graph for this function:

◆ initGenericFormProperties()

ilAssQuestionFeedback::initGenericFormProperties ( ilPropertyFormGUI $form )

final

initialises a given form object's GENERIC form properties relating to all question types

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

References ILIAS\Repository\ctrl(), ensurePageObjectExists(), getGenericFeedbackContent(), getGenericFeedbackId(), getGenericFeedbackPageObjectId(), getGenericFeedbackPageObjectType(), ilPropertyFormGUI\getItemByPostVar(), getPageObjectNonEditableValueHTML(), initSpecificFormProperties(), and ILIAS\Repository\lng().

                                                                             : void
     {
         if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             $page_object_type = $this->getGenericFeedbackPageObjectType();
 
             $page_object_id = $this->getGenericFeedbackId($this->questionOBJ->getId(), true);
 
             if ($page_object_id === -1) {
                 $this->ctrl->setParameterByClass(ilAssQuestionFeedbackEditingGUI::class, 'feedback_type', $page_object_type);
                 $this->ctrl->setParameterByClass(ilAssQuestionFeedbackEditingGUI::class, 'fb_mode', 'complete');
                 $link = $this->ctrl->getLinkTargetByClass(ilAssQuestionFeedbackEditingGUI::class, 'createFeedbackPage');
                 $value_feedback_solution_complete = sprintf(
                     '<a href="%s">%s</a>',
                     $link,
                     $this->lng->txt('tst_question_feedback_edit_page')
                 );
                 $this->ctrl->setParameterByClass(ilAssQuestionFeedbackEditingGUI::class, 'fb_mode', 'incomplete');
                 $link = $this->ctrl->getLinkTargetByClass(ilAssQuestionFeedbackEditingGUI::class, 'createFeedbackPage');
                 $value_feedback_solution_incomplete = sprintf(
                     '<a href="%s">%s</a>',
                     $link,
                     $this->lng->txt('tst_question_feedback_edit_page')
                 );
             } else {
                 $this->ensurePageObjectExists($page_object_type, $page_object_id);
 
                 $value_feedback_solution_complete = $this->getPageObjectNonEditableValueHTML(
                     $page_object_type,
                     $this->getGenericFeedbackPageObjectId($this->questionOBJ->getId(), true)
                 );
                 $value_feedback_solution_incomplete = $this->getPageObjectNonEditableValueHTML(
                     $page_object_type,
                     $this->getGenericFeedbackPageObjectId($this->questionOBJ->getId(), false)
                 );
             }
 
         } else {
             $value_feedback_solution_complete = $this->getGenericFeedbackContent(
                 $this->questionOBJ->getId(),
                 true
             );
 
             $value_feedback_solution_incomplete = $this->getGenericFeedbackContent(
                 $this->questionOBJ->getId(),
                 false
             );
         }
 
         $form->getItemByPostVar('feedback_complete')->setValue($value_feedback_solution_complete);
         $form->getItemByPostVar('feedback_incomplete')->setValue($value_feedback_solution_incomplete);
     }

Here is the call graph for this function:

◆ initSpecificFormProperties()

ilAssQuestionFeedback::initSpecificFormProperties ( ilPropertyFormGUI $form )

abstract

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

Referenced by initGenericFormProperties().

Here is the caller graph for this function:

◆ isGenericFeedbackId()

ilAssQuestionFeedback::isGenericFeedbackId ( int $feedbackId )

protected

Definition at line 500 of file class.ilAssQuestionFeedback.php.

References isSpecificAnswerFeedbackId().

Referenced by checkFeedbackParent().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isSaveableInPageObjectEditingMode()

ilAssQuestionFeedback::isSaveableInPageObjectEditingMode ( )

returns the fact wether the feedback editing form is saveable in page object editing or not.

by default all properties are edited as page object unless there are additional settings (this method can be overwritten per question type if required)

Definition at line 231 of file class.ilAssQuestionFeedback.php.

                                                        : bool
     {
         return false;
     }

◆ isSpecificAnswerFeedbackAvailable()

ilAssQuestionFeedback::isSpecificAnswerFeedbackAvailable ( int $question_id )

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

References $res, and getSpecificAnswerFeedbackExportPresentation().

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

Here is the call graph for this function:

◆ isSpecificAnswerFeedbackId()

ilAssQuestionFeedback::isSpecificAnswerFeedbackId ( int $feedbackId )

abstractprotected

Referenced by checkFeedbackParent(), and isGenericFeedbackId().

Here is the caller graph for this function:

◆ isValidFeedbackPageObjectType()

static ilAssQuestionFeedback::isValidFeedbackPageObjectType ( string $feedbackPageObjectType )

staticfinal

returns the fact whether the given page object type relates to generic or specific feedback page objects

Definition at line 683 of file class.ilAssQuestionFeedback.php.

Referenced by ilAssQuestionFeedbackPageObjectCommandForwarder\__construct().

                                                                                               : bool
     {
         switch ($feedbackPageObjectType) {
             case self::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK:
             case self::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK:
                 return true;
         }
 
         return false;
     }

Here is the caller graph for this function:

◆ migrateContentForLearningModule()

ilAssQuestionFeedback::migrateContentForLearningModule	(	ilAssSelfAssessmentMigrator	$migrator,
		int	$question_id
	)

Definition at line 747 of file class.ilAssQuestionFeedback.php.

References ilAssSelfAssessmentMigrator\migrateToLmContent(), and saveGenericFeedbackContent().

                                                                                                             : void
     {
         $this->saveGenericFeedbackContent($question_id, true, $migrator->migrateToLmContent(
             $this->getGenericFeedbackContent($question_id, true)
         ));
 
         $this->saveGenericFeedbackContent($question_id, false, $migrator->migrateToLmContent(
             $this->getGenericFeedbackContent($question_id, false)
         ));
     }

Here is the call graph for this function:

◆ saveGenericFeedbackContent()

ilAssQuestionFeedback::saveGenericFeedbackContent	(	int	$question_id,
		bool	$solution_completed,
		string	$feedback_content
	)

final

saves GENERIC feedback content for the given question id to the database.

Generic feedback is either feedback for the completed solution (all answers correct) of the question or at least onen incorrect answer.

Definition at line 328 of file class.ilAssQuestionFeedback.php.

References ilRTE\_replaceMediaObjectImageSrc(), getGenericFeedbackId(), getGenericFeedbackTableName(), ILIAS\Repository\int(), and saveSpecificAnswerFeedbackContent().

Referenced by createFeedbackPages(), importGenericFeedback(), migrateContentForLearningModule(), and saveGenericFormProperties().

                                                                                                                           : int
     {
         $feedbackId = $this->getGenericFeedbackId($question_id, $solution_completed);
 
         if ($feedback_content !== '') {
             $feedback_content = $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($feedback_content);
             $feedback_content = ilRTE::_replaceMediaObjectImageSrc($feedback_content, 0);
         }
 
         if ($feedbackId !== -1) {
             $this->db->update(
                 $this->getGenericFeedbackTableName(),
                 [
                     'feedback' => ['clob', $feedback_content],
                     'tstamp' => ['integer', time()]
                 ],
                 [
                     'feedback_id' => ['integer', $feedbackId]
                 ]
             );
         } else {
             $feedbackId = $this->db->nextId($this->getGenericFeedbackTableName());
 
             $this->db->insert($this->getGenericFeedbackTableName(), [
                 'feedback_id' => ['integer', $feedbackId],
                 'question_fi' => ['integer', $question_id],
                 'correctness' => ['text', (int) $solution_completed], // text ?
                 'feedback' => ['clob', $feedback_content],
                 'tstamp' => ['integer', time()]
             ]);
         }
 
         return $feedbackId;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ saveGenericFormProperties()

ilAssQuestionFeedback::saveGenericFormProperties ( ilPropertyFormGUI $form )

final

saves a given form object's GENERIC form properties relating to all question types

Definition at line 212 of file class.ilAssQuestionFeedback.php.

References ilPropertyFormGUI\getInput(), saveGenericFeedbackContent(), and saveSpecificFormProperties().

                                                                             : void
     {
         if (!$this->questionOBJ->isAdditionalContentEditingModePageObject()) {
             $this->saveGenericFeedbackContent($this->questionOBJ->getId(), false, (string) $form->getInput('feedback_incomplete'));
             $this->saveGenericFeedbackContent($this->questionOBJ->getId(), true, (string) $form->getInput('feedback_complete'));
         }
     }

Here is the call graph for this function:

◆ saveSpecificAnswerFeedbackContent()

ilAssQuestionFeedback::saveSpecificAnswerFeedbackContent	(	int	$question_id,
		int	$question_index,
		int	$answer_index,
		string	$feedback_content
	)

abstract

Referenced by saveGenericFeedbackContent().

Here is the caller graph for this function:

◆ saveSpecificFormProperties()

ilAssQuestionFeedback::saveSpecificFormProperties ( ilPropertyFormGUI $form )

abstract

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

Referenced by saveGenericFormProperties().

Here is the caller graph for this function:

◆ setPageObjectOutputMode()

ilAssQuestionFeedback::setPageObjectOutputMode ( string $page_obj_output_mode )

final

Definition at line 575 of file class.ilAssQuestionFeedback.php.

References $page_obj_output_mode.

                                                                                : void
     {
         $this->page_obj_output_mode = $page_obj_output_mode;
     }

◆ syncFeedback()

ilAssQuestionFeedback::syncFeedback	(	int	$originalQuestionId,
		int	$duplicateQuestionId
	)

final

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

Definition at line 441 of file class.ilAssQuestionFeedback.php.

References syncGenericFeedback(), and syncSpecificFeedback().

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

Here is the call graph for this function:

◆ syncGenericFeedback()

ilAssQuestionFeedback::syncGenericFeedback	(	int	$originalQuestionId,
		int	$duplicateQuestionId
	)

private

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

Definition at line 450 of file class.ilAssQuestionFeedback.php.

References getGenericFeedbackTableName().

Referenced by syncFeedback().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ syncSpecificFeedback()

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

abstractprotected

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

Referenced by checkFeedbackParent(), and syncFeedback().

Here is the caller graph for this function:

Field Documentation

◆ $ctrl

ilCtrl ilAssQuestionFeedback::$ctrl

protected

Definition at line 58 of file class.ilAssQuestionFeedback.php.

Referenced by __construct().

◆ $db

ilDBInterface ilAssQuestionFeedback::$db

protected

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

Referenced by __construct().

◆ $lng

ilLanguage ilAssQuestionFeedback::$lng

protected

Definition at line 62 of file class.ilAssQuestionFeedback.php.

Referenced by __construct().

◆ $page_obj_output_mode

string ilAssQuestionFeedback::$page_obj_output_mode = "presentation"

protected

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

Referenced by getPageObjectOutputMode(), and setPageObjectOutputMode().

◆ $questionOBJ

assQuestion ilAssQuestionFeedback::$questionOBJ

protected

Definition at line 56 of file class.ilAssQuestionFeedback.php.

Referenced by __construct().

◆ CSS_CLASS_FEEDBACK_CORRECT

const ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_CORRECT = 'ilc_qfeedr_FeedbackRight'

Definition at line 31 of file class.ilAssQuestionFeedback.php.

◆ CSS_CLASS_FEEDBACK_WRONG

const ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_WRONG = 'ilc_qfeedw_FeedbackWrong'

Definition at line 32 of file class.ilAssQuestionFeedback.php.

◆ FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID

const ilAssQuestionFeedback::FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID = 2

id for page object relating to generic complete solution feedback

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

◆ FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID

const ilAssQuestionFeedback::FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID = 1

id for page object relating to generic incomplete solution feedback

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

◆ PAGE_OBJECT_TYPE_GENERIC_FEEDBACK

const ilAssQuestionFeedback::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK = 'qfbg'

type for generic feedback page objects

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

Referenced by createFeedbackPages(), ensurePageObjectDeleted(), ilAssQuestionFeedbackPageObjectCommandForwarder\ensurePageObjectExists(), ensurePageObjectExists(), getClassNameByType(), ilAssQuestionFeedbackPageObjectCommandForwarder\getPageObjectGUI(), and ilAssQuestionList\hasFeedback().

◆ PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK

const ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK = 'qfbs'

type for specific feedback page objects

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

Referenced by ensurePageObjectDeleted(), ilAssQuestionFeedbackPageObjectCommandForwarder\ensurePageObjectExists(), ensurePageObjectExists(), and ilAssQuestionList\hasFeedback().

◆ TABLE_NAME_GENERIC_FEEDBACK

const ilAssQuestionFeedback::TABLE_NAME_GENERIC_FEEDBACK = 'qpl_fb_generic'

Definition at line 54 of file class.ilAssQuestionFeedback.php.

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

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

Public Member Functions

Static Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ buildFeedbackContentFormProperty()

◆ checkFeedbackParent()

◆ cleanupPageContent()

◆ completeGenericFormProperties()

◆ completeSpecificFormProperties()

◆ createFeedbackPages()

◆ createPageObject()

◆ deleteGenericFeedbacks()

◆ deleteSpecificAnswerFeedbacks()

◆ duplicateFeedback()

◆ duplicateGenericFeedback()

◆ duplicatePageObject()

◆ duplicateSpecificFeedback()

◆ ensurePageObjectDeleted()

◆ ensurePageObjectExists()

◆ getAllSpecificAnswerFeedbackContents()

◆ getClassNameByType()

◆ getGenericFeedbackContent()

◆ getGenericFeedbackExportPresentation()

◆ getGenericFeedbackId()

◆ getGenericFeedbackPageObjectId()

◆ getGenericFeedbackPageObjectType()

◆ getGenericFeedbackTableName()

◆ getGenericFeedbackTestPresentation()

◆ getPageObjectEditingLink()

◆ getPageObjectNonEditableValueHTML()

◆ getPageObjectOutputMode()

◆ getPageObjectXML()

◆ getSpecificAnswerFeedbackContent()

◆ getSpecificAnswerFeedbackExportPresentation()

◆ getSpecificAnswerFeedbackPageObjectType()

◆ getSpecificAnswerFeedbackTestPresentation()

◆ importGenericFeedback()

◆ importSpecificAnswerFeedback()

◆ initGenericFormProperties()

◆ initSpecificFormProperties()

◆ isGenericFeedbackId()

◆ isSaveableInPageObjectEditingMode()

◆ isSpecificAnswerFeedbackAvailable()

◆ isSpecificAnswerFeedbackId()

◆ isValidFeedbackPageObjectType()

◆ migrateContentForLearningModule()

◆ saveGenericFeedbackContent()

◆ saveGenericFormProperties()

◆ saveSpecificAnswerFeedbackContent()

◆ saveSpecificFormProperties()

◆ setPageObjectOutputMode()

◆ syncFeedback()

◆ syncGenericFeedback()

◆ syncSpecificFeedback()

Field Documentation

◆ $ctrl

◆ $db

◆ $lng

◆ $page_obj_output_mode

◆ $questionOBJ

◆ CSS_CLASS_FEEDBACK_CORRECT

◆ CSS_CLASS_FEEDBACK_WRONG

◆ FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID

◆ FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID

◆ PAGE_OBJECT_TYPE_GENERIC_FEEDBACK

◆ PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK

◆ TABLE_NAME_GENERIC_FEEDBACK