Inheritance diagram for ilAssQuestionFeedback:

Collaboration diagram for ilAssQuestionFeedback:

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

	getGenericFeedbackTestPresentation ($questionId, $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 ($questionId, $questionIndex, $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 ($questionId, $solutionCompleted)
	returns the GENERIC feedback content for a given question state. More...

	getSpecificAnswerFeedbackContent ($questionId, $questionIndex, $answerIndex)
	returns the SPECIFIC feedback content for a given question id and answer index. More...

	getAllSpecificAnswerFeedbackContents ($questionId)
	returns the SPECIFIC feedback content for a given question id and answer index. More...

	isSpecificAnswerFeedbackAvailable ($questionId)
	returns the fact wether any specific feedback content is available or not More...

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

	saveSpecificAnswerFeedbackContent ($questionId, $questionIndex, $answerIndex, $feedbackContent)
	saves SPECIFIC feedback content for the given question id and answer index to the database. More...

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

	deleteSpecificAnswerFeedbacks ($questionId, $isAdditionalContentEditingModePageObject)
	deletes all SPECIFIC feedback contents for the given question id More...

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

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

	checkFeedbackParent ($feedbackId)

	getClassNameByType ($a_type, $a_gui=false)
	Get class name by type. More...

	setPageObjectOutputMode ($a_val)
	Set page object output mode. More...

	getPageObjectOutputMode ()
	Get page object output mode. More...

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

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

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

	importSpecificAnswerFeedback ($questionId, $questionIndex, $answerIndex, $feedbackContent)
	imports the given feedback content as specific feedback for the given question id and answer index More...

	migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator, $questionId)

Static Public Member Functions
static	isValidFeedbackPageObjectType ($feedbackPageObjectType)
	returns the fact wether 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'
	table name for specific feedback More...

Protected Member Functions
	buildFeedbackContentFormProperty ($label, $postVar, $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 ($originalQuestionId, $duplicateQuestionId)
	duplicates the SPECIFIC feedback relating to the given original question id and saves it for the given duplicate question id More...

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

	isGenericFeedbackId ($feedbackId)

	isSpecificAnswerFeedbackId ($feedbackId)

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

	getGenericFeedbackTableName ()
	returns the table name for specific feedback More...

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

	getPageObjectContent ($pageObjectType, $pageObjectId)
	returns the content of page object with given type and id More...

	getPageObjectXML ($pageObjectType, $pageObjectId)
	returns the xml of page object with given type and id More...

	createPageObject ($pageObjectType, $pageObjectId, $pageObjectContent)
	creates a new page object with given page object id and page object type and passed page object content More...

	duplicatePageObject ($pageObjectType, $originalPageObjectId, $duplicatePageObjectId, $duplicatePageObjectParentId)
	duplicates the page object with given type and original id to new page object with same type and given duplicate id and duplicate parent id More...

	ensurePageObjectDeleted ($pageObjectType, $pageObjectId)
	ensures a no more existing page object for given type and id More...

	getGenericFeedbackPageObjectType ()
	returns the type for generic feedback page objects defined in local constant More...

	getSpecificAnswerFeedbackPageObjectType ()
	returns the type for specific feedback page objects defined in local constant More...

	getGenericFeedbackPageObjectId ($questionId, $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...

Protected Attributes
	$questionOBJ = null

	$ctrl = null

	$db = null

	$lng = null

	$page_obj_output_mode = "presentation"

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

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

	getPageObjectEditingLink ($pageObjectType, $pageObjectId)
	returns a link to page object editor for page object with given type and id More...

	ensurePageObjectExists ($pageObjectType, $pageObjectId)
	ensures an existing page object with given type and id More...

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

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

final

constructor

@final @access public

Parameters

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

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

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

References $ctrl, $db, $lng, and $questionOBJ.

Member Function Documentation

◆ buildFeedbackContentFormProperty()

ilAssQuestionFeedback::buildFeedbackContentFormProperty	(	$label,
		$postVar,
		$asNonEditable
	)

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

@final @access protected

Parameters

string	$label
string	$postVar
boolean	$asNonEditable

Returns: ilTextAreaInputGUI|ilNonEditableValueGUI $formProperty

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

    {
        if ($asNonEditable) {
            require_once 'Services/Form/classes/class.ilNonEditableValueGUI.php';
 
            $property = new ilNonEditableValueGUI($label, $postVar, true);
        } else {
            require_once 'Services/Form/classes/class.ilTextAreaInputGUI.php';
            require_once 'Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php';
 
            $property = new ilTextAreaInputGUI($label, $postVar);
            $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");
 
                require_once 'Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php';
                $property->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("assessment"));
                $property->setRTESupport($this->questionOBJ->getId(), "qpl", "assessment");
            } else {
                require_once 'Modules/TestQuestionPool/classes/questions/class.ilAssSelfAssessmentQuestionFormatter.php';
                $property->setRteTags(ilAssSelfAssessmentQuestionFormatter::getSelfAssessmentTags());
                $property->setUseTagsForRteOnly(false);
            }
 
            $property->setRTESupport($this->questionOBJ->getId(), "qpl", "assessment");
        }
 
        return $property;
    }

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ checkFeedbackParent()

ilAssQuestionFeedback::checkFeedbackParent ( $feedbackId )

final

Parameters

int $feedbackId

Returns: bool

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

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

References isGenericFeedbackId(), and isSpecificAnswerFeedbackId().

Here is the call 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

@final @access public

Parameters

ilPropertyFormGUI $form

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

    {
        $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()
        ));
    }

References ilPropertyFormGUI\addItem(), and buildFeedbackContentFormProperty().

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

@abstract @access public

Parameters

ilPropertyFormGUI $form

Reimplemented in ilAssClozeTestFeedback, ilAssConfigurableMultiOptionQuestionFeedback, ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ createPageObject()

ilAssQuestionFeedback::createPageObject	(	$pageObjectType,
		$pageObjectId,
		$pageObjectContent
	)

finalprotected

creates a new page object with given page object id and page object type and passed page object content

@final @access protected

Parameters

string	$pageObjectType
integer	$pageObjectId
string	$pageObjectContent

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

    {
        $cl = $this->getClassNameByType($pageObjectType);
        require_once 'Modules/TestQuestionPool/classes/feedback/class.' . $cl . '.php';
 
        $pageObject = new $cl();
        $pageObject->setParentId($this->questionOBJ->getId());
        $pageObject->setId($pageObjectId);
        $pageObject->setXMLContent($pageObjectContent);
        $pageObject->createFromXML();
    }

References getClassNameByType().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteGenericFeedbacks()

ilAssQuestionFeedback::deleteGenericFeedbacks	(	$questionId,
		$isAdditionalContentEditingModePageObject
	)

final

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

@final @access public

Parameters

integer	$questionId
boolean	$isAdditionalContentEditingModePageObject

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

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

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

Here is the call graph for this function:

◆ deleteSpecificAnswerFeedbacks()

ilAssQuestionFeedback::deleteSpecificAnswerFeedbacks	(	$questionId,
		$isAdditionalContentEditingModePageObject
	)

abstract

deletes all SPECIFIC feedback contents for the given question id

@abstract @access public

Parameters

integer	$questionId
boolean	$isAdditionalContentEditingModePageObject

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ duplicateFeedback()

ilAssQuestionFeedback::duplicateFeedback	(	$originalQuestionId,
		$duplicateQuestionId
	)

final

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

@final @access public

Parameters

integer	$originalQuestionId
integer	$duplicateQuestionId

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

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

References duplicateGenericFeedback(), and duplicateSpecificFeedback().

Here is the call graph for this function:

◆ duplicateGenericFeedback()

ilAssQuestionFeedback::duplicateGenericFeedback	(	$originalQuestionId,
		$duplicateQuestionId
	)

private

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

@final @access private

Parameters

integer	$originalQuestionId
integer	$duplicateQuestionId

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

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

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

Referenced by duplicateFeedback().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicatePageObject()

ilAssQuestionFeedback::duplicatePageObject	(	$pageObjectType,
		$originalPageObjectId,
		$duplicatePageObjectId,
		$duplicatePageObjectParentId
	)

finalprotected

duplicates the page object with given type and original id to new page object with same type and given duplicate id and duplicate parent id

@final @access protected

Parameters

string	$pageObjectType
integer	$originalPageObjectId
integer	$duplicatePageObjectId
integer	$duplicatePageObjectParentId

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

    {
        $this->ensurePageObjectExists($pageObjectType, $originalPageObjectId);
 
        $cl = $this->getClassNameByType($pageObjectType);
        require_once 'Modules/TestQuestionPool/classes/feedback/class.' . $cl . '.php';
 
        $pageObject = new $cl($originalPageObjectId);
        $pageObject->setParentId($duplicatePageObjectParentId);
        $pageObject->setId($duplicatePageObjectId);
        $pageObject->createFromXML();
    }

References ensurePageObjectExists(), and getClassNameByType().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ duplicateSpecificFeedback()

ilAssQuestionFeedback::duplicateSpecificFeedback	(	$originalQuestionId,
		$duplicateQuestionId
	)

abstractprotected

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

@abstract @access protected

Parameters

integer	$originalQuestionId
integer	$duplicateQuestionId

Reimplemented in ilAssClozeTestFeedback, ilAssConfigurableMultiOptionQuestionFeedback, ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

Referenced by duplicateFeedback().

Here is the caller graph for this function:

◆ ensurePageObjectDeleted()

ilAssQuestionFeedback::ensurePageObjectDeleted	(	$pageObjectType,
		$pageObjectId
	)

finalprotected

ensures a no more existing page object for given type and id

@final @access protected

Parameters

string	$pageObjectType
integer	$pageObjectId

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

    {
        if ($pageObjectType == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK) {
            include_once("./Modules/TestQuestionPool/classes/feedback/class.ilAssGenFeedbackPage.php");
            if (ilAssGenFeedbackPage::_exists($pageObjectType, $pageObjectId)) {
                $pageObject = new ilAssGenFeedbackPage($pageObjectId);
                $pageObject->delete();
            }
        }
        if ($pageObjectType == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK) {
            include_once("./Modules/TestQuestionPool/classes/feedback/class.ilAssSpecFeedbackPage.php");
            if (ilAssSpecFeedbackPage::_exists($pageObjectType, $pageObjectId)) {
                $pageObject = new ilAssSpecFeedbackPage($pageObjectId);
                $pageObject->delete();
            }
        }
    }

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ensurePageObjectExists()

ilAssQuestionFeedback::ensurePageObjectExists	(	$pageObjectType,
		$pageObjectId
	)

private

ensures an existing page object with given type and id

@final @access private

Parameters

string	$pageObjectType
integer	$pageObjectId

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

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

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

Referenced by duplicatePageObject(), getPageObjectContent(), and getPageObjectXML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAllSpecificAnswerFeedbackContents()

ilAssQuestionFeedback::getAllSpecificAnswerFeedbackContents ( $questionId )

abstract

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

@abstract @access public

Parameters

integer $questionId

Returns: string $feedbackContent

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ getClassNameByType()

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

Get class name by type.

Parameters

return

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

    {
        $gui = ($a_gui)
            ? "GUI"
            : "";
        include_once("./Modules/TestQuestionPool/classes/feedback/class.ilAssQuestionFeedback.php");
        if ($a_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK) {
            return "ilAssGenFeedbackPage" . $gui;
        }
        if ($a_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK) {
            return "ilAssSpecFeedbackPage" . $gui;
        }
    }

References PAGE_OBJECT_TYPE_GENERIC_FEEDBACK, and PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK.

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

Here is the caller graph for this function:

◆ getGenericFeedbackContent()

ilAssQuestionFeedback::getGenericFeedbackContent	(	$questionId,
		$solutionCompleted
	)

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.

@final @access public

Parameters

integer	$questionId
boolean	$solutionCompleted

Returns: string $feedbackContent

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

    {
        require_once 'Services/RTE/classes/class.ilRTE.php';
 
        $correctness = $solutionCompleted ? 1 : 0;
 
        $res = $this->db->queryF(
            "SELECT * FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s AND correctness = %s",
            array('integer', 'text'),
            array($questionId, $correctness)
        );
 
        $feedbackContent = null;
 
        while ($row = $this->db->fetchAssoc($res)) {
            $feedbackContent = ilRTE::_replaceMediaObjectImageSrc($row['feedback'], 1);
            break;
        }
 
        return is_null($feedbackContent) ? '' : $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($feedbackContent);
    }

References $res, and ilRTE\_replaceMediaObjectImageSrc().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGenericFeedbackExportPresentation()

ilAssQuestionFeedback::getGenericFeedbackExportPresentation	(	$questionId,
		$solutionCompleted
	)

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

@access public

Parameters

integer	$questionId
boolean	$solutionCompleted

Returns: string $genericFeedbackExportPresentation

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

    {
        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            $genericFeedbackExportPresentation = $this->getPageObjectXML(
                $this->getGenericFeedbackPageObjectType(),
                $this->getGenericFeedbackPageObjectId($questionId, $solutionCompleted)
            );
        } else {
            $genericFeedbackExportPresentation = $this->getGenericFeedbackContent($questionId, $solutionCompleted);
        }
 
        return $genericFeedbackExportPresentation;
    }

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

Here is the call graph for this function:

◆ getGenericFeedbackId()

ilAssQuestionFeedback::getGenericFeedbackId	(	$questionId,
		$solutionCompleted
	)

finalprotected

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

@final @access protected

Parameters

integer	$questionId
boolean	$answerIndex

Returns: string $feedbackId

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

    {
        $res = $this->db->queryF(
            "SELECT feedback_id FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s AND correctness = %s",
            array('integer','text'),
            array($questionId, (int) $solutionCompleted)
        );
 
        $feedbackId = null;
 
        while ($row = $this->db->fetchAssoc($res)) {
            $feedbackId = $row['feedback_id'];
            break;
        }
 
        return $feedbackId;
    }

References $res.

Referenced by getGenericFeedbackPageObjectId(), and saveGenericFeedbackContent().

Here is the caller graph for this function:

◆ getGenericFeedbackPageObjectId()

ilAssQuestionFeedback::getGenericFeedbackPageObjectId	(	$questionId,
		$solutionCompleted
	)

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)

@final @access protected

Parameters

integer	$questionId
boolean	$solutionCompleted

Returns: integer $pageObjectId

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

    {
        $pageObjectId = $this->getGenericFeedbackId($questionId, $solutionCompleted);
 
        if (!$pageObjectId) {
            $pageObjectId = $this->saveGenericFeedbackContent($questionId, $solutionCompleted, null);
        }
 
        return $pageObjectId;
    }

References getGenericFeedbackId(), and saveGenericFeedbackContent().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getGenericFeedbackPageObjectType()

ilAssQuestionFeedback::getGenericFeedbackPageObjectType ( )

finalprotected

returns the type for generic feedback page objects defined in local constant

@final @access protected

Returns: string $genericFeedbackPageObjectType

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

    {
        return self::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK;
    }

References PAGE_OBJECT_TYPE_GENERIC_FEEDBACK.

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

Here is the caller graph for this function:

◆ getGenericFeedbackTableName()

ilAssQuestionFeedback::getGenericFeedbackTableName ( )

finalprotected

returns the table name for specific feedback

@final

Returns: string $specificFeedbackTableName

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

    {
        return self::TABLE_NAME_GENERIC_FEEDBACK;
    }

References TABLE_NAME_GENERIC_FEEDBACK.

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

Here is the caller graph for this function:

◆ getGenericFeedbackTestPresentation()

ilAssQuestionFeedback::getGenericFeedbackTestPresentation	(	$questionId,
		$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)

@access public

Parameters

integer	$questionId
boolean	$solutionCompleted

Returns: string $genericFeedbackTestPresentationHTML

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

    {
        if ($this->page_obj_output_mode == "edit") {
            return "";
        }
        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            $genericFeedbackTestPresentationHTML = $this->getPageObjectContent(
                $this->getGenericFeedbackPageObjectType(),
                $this->getGenericFeedbackPageObjectId($questionId, $solutionCompleted)
            );
        } else {
            $genericFeedbackTestPresentationHTML = $this->getGenericFeedbackContent($questionId, $solutionCompleted);
        }
 
        return $genericFeedbackTestPresentationHTML;
    }

References getGenericFeedbackContent(), getGenericFeedbackPageObjectId(), getGenericFeedbackPageObjectType(), and getPageObjectContent().

Here is the call graph for this function:

◆ getPageObjectContent()

ilAssQuestionFeedback::getPageObjectContent	(	$pageObjectType,
		$pageObjectId
	)

finalprotected

returns the content of page object with given type and id

@final @access protected

Parameters

string	$pageObjectType
integer	$pageObjectId

Returns: string $pageObjectContent

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

    {
        global $DIC;
        $ilCtrl = $DIC['ilCtrl'];
 
        $cl = $this->getClassNameByType($pageObjectType, true);
        require_once 'Modules/TestQuestionPool/classes/feedback/class.' . $cl . '.php';
 
        $this->ensurePageObjectExists($pageObjectType, $pageObjectId);
 
        $mode = ($ilCtrl->isAsynch())
            ? "presentation"
            : $this->getPageObjectOutputMode();
 
        $pageObjectGUI = new $cl($pageObjectId);
        $pageObjectGUI->setOutputMode($mode);
 
        return $pageObjectGUI->presentation($mode);
    }

References $DIC, ensurePageObjectExists(), getClassNameByType(), and getPageObjectOutputMode().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPageObjectEditingLink()

ilAssQuestionFeedback::getPageObjectEditingLink	(	$pageObjectType,
		$pageObjectId
	)

private

returns a link to page object editor for page object with given type and id

@final @access private

Parameters

string	$pageObjectType
integer	$pageObjectId

Returns: string $pageObjectEditingLink

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

    {
        $cl = $this->getClassNameByType($pageObjectType, true);
        $this->ctrl->setParameterByClass($cl, 'feedback_type', $pageObjectType);
        $this->ctrl->setParameterByClass($cl, 'feedback_id', $pageObjectId);
 
        $linkHREF = $this->ctrl->getLinkTargetByClass($cl, 'edit');
        $linkTEXT = $this->lng->txt('tst_question_feedback_edit_page');
 
        return "<a href='$linkHREF'>$linkTEXT</a>";
    }

References getClassNameByType().

Referenced by getPageObjectNonEditableValueHTML().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPageObjectNonEditableValueHTML()

ilAssQuestionFeedback::getPageObjectNonEditableValueHTML	(	$pageObjectType,
		$pageObjectId
	)

finalprotected

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

@final @access protected

Parameters

string	$pageObjectType
integer	$pageObjectId

Returns: string $nonEditableValueHTML

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

    {
        $link = $this->getPageObjectEditingLink($pageObjectType, $pageObjectId);
        $content = $this->getPageObjectContent($pageObjectType, $pageObjectId);
 
        return "$link<br /><br />$content";
    }

References getPageObjectContent(), and getPageObjectEditingLink().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPageObjectOutputMode()

ilAssQuestionFeedback::getPageObjectOutputMode ( )

final

Get page object output mode.

Returns: string page output mode

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

    {
        return $this->page_obj_output_mode;
    }

References $page_obj_output_mode.

Referenced by getPageObjectContent().

Here is the caller graph for this function:

◆ getPageObjectXML()

ilAssQuestionFeedback::getPageObjectXML	(	$pageObjectType,
		$pageObjectId
	)

finalprotected

returns the xml of page object with given type and id

@final @access protected

Parameters

string	$pageObjectType
integer	$pageObjectId

Returns: string $pageObjectXML

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

    {
        $cl = $this->getClassNameByType($pageObjectType);
        require_once 'Modules/TestQuestionPool/classes/feedback/class.' . $cl . '.php';
 
        $this->ensurePageObjectExists($pageObjectType, $pageObjectId);
 
        $pageObject = new $cl($pageObjectId);
        return $pageObject->getXMLContent();
    }

References ensurePageObjectExists(), and getClassNameByType().

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

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackContent()

ilAssQuestionFeedback::getSpecificAnswerFeedbackContent	(	$questionId,
		$questionIndex,
		$answerIndex
	)

abstract

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

@abstract @access public

Parameters

integer	$questionId
integer	$questionIndex
integer	$answerIndex

Returns: string $feedbackContent

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ getSpecificAnswerFeedbackExportPresentation()

ilAssQuestionFeedback::getSpecificAnswerFeedbackExportPresentation	(	$questionId,
		$questionIndex,
		$answerIndex
	)

abstract

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

@abstract @access public

Parameters

integer	$questionId
integer	$questionIndex
integer	$answerIndex

Returns: string $specificFeedbackExportPresentation

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

Referenced by isSpecificAnswerFeedbackAvailable().

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackPageObjectType()

ilAssQuestionFeedback::getSpecificAnswerFeedbackPageObjectType ( )

finalprotected

returns the type for specific feedback page objects defined in local constant

@final @access protected

Returns: string $specificFeedbackPageObjectType

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

    {
        return self::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK;
    }

References PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK.

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

Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackTestPresentation()

ilAssQuestionFeedback::getSpecificAnswerFeedbackTestPresentation	(	$questionId,
		$questionIndex,
		$answerIndex
	)

abstract

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

@abstract @access public

Parameters

integer	$questionId
integer	$questionIndex
integer	$answerIndex

Returns: string $specificAnswerFeedbackTestPresentationHTML

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ importGenericFeedback()

ilAssQuestionFeedback::importGenericFeedback	(	$questionId,
		$solutionCompleted,
		$feedbackContent
	)

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

@access public

Parameters

integer	$questionId
boolean	$solutionCompleted
string	$feedbackContent

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

    {
        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            $pageObjectId = $this->getGenericFeedbackPageObjectId($questionId, $solutionCompleted);
            $pageObjectType = $this->getGenericFeedbackPageObjectType();
 
            $this->createPageObject($pageObjectType, $pageObjectId, $feedbackContent);
        } else {
            $this->saveGenericFeedbackContent($questionId, $solutionCompleted, $feedbackContent);
        }
    }

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

Here is the call graph for this function:

◆ importSpecificAnswerFeedback()

ilAssQuestionFeedback::importSpecificAnswerFeedback	(	$questionId,
		$questionIndex,
		$answerIndex,
		$feedbackContent
	)

abstract

imports the given feedback content as specific feedback for the given question id and answer index

@abstract @access public

Parameters

integer	$questionId
integer	$questionIndex
integer	$answerIndex
string	$feedbackContent

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ initGenericFormProperties()

ilAssQuestionFeedback::initGenericFormProperties ( ilPropertyFormGUI $form )

final

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

@final @access public

Parameters

ilPropertyFormGUI $form

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

    {
        if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
            $pageObjectType = $this->getGenericFeedbackPageObjectType();
 
            $valueFeedbackSolutionComplete = $this->getPageObjectNonEditableValueHTML(
                $pageObjectType,
                $this->getGenericFeedbackPageObjectId($this->questionOBJ->getId(), true)
            );
 
            $valueFeedbackSolutionIncomplete = $this->getPageObjectNonEditableValueHTML(
                $pageObjectType,
                $this->getGenericFeedbackPageObjectId($this->questionOBJ->getId(), false)
            );
        } else {
            $valueFeedbackSolutionComplete = $this->getGenericFeedbackContent(
                $this->questionOBJ->getId(),
                true
            );
 
            $valueFeedbackSolutionIncomplete = $this->getGenericFeedbackContent(
                $this->questionOBJ->getId(),
                false
            );
        }
 
        $form->getItemByPostVar('feedback_complete')->setValue($valueFeedbackSolutionComplete);
        $form->getItemByPostVar('feedback_incomplete')->setValue($valueFeedbackSolutionIncomplete);
    }

References getGenericFeedbackContent(), getGenericFeedbackPageObjectId(), getGenericFeedbackPageObjectType(), ilPropertyFormGUI\getItemByPostVar(), and getPageObjectNonEditableValueHTML().

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

@abstract @access public

Parameters

ilPropertyFormGUI $form

Reimplemented in ilAssClozeTestFeedback, ilAssConfigurableMultiOptionQuestionFeedback, ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ isGenericFeedbackId()

ilAssQuestionFeedback::isGenericFeedbackId ( $feedbackId )

protected

Parameters

int $feedbackId

Returns: bool

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

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

Referenced by checkFeedbackParent().

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)

@access public

Returns: boolean $isSaveableInPageObjectEditingMode

Reimplemented in ilAssClozeTestFeedback, and ilAssConfigurableMultiOptionQuestionFeedback.

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

    {
        return false;
    }

◆ isSpecificAnswerFeedbackAvailable()

ilAssQuestionFeedback::isSpecificAnswerFeedbackAvailable ( $questionId )

returns the fact wether any specific feedback content is available or not

Parameters

integer $questionId

Returns: bool

Reimplemented in ilAssClozeTestFeedback.

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

    {
        $res = $this->db->queryF(
            "SELECT answer FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
            ['integer'],
            [$questionId]
        );
 
        $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:

◆ isSpecificAnswerFeedbackId()

ilAssQuestionFeedback::isSpecificAnswerFeedbackId ( $feedbackId )

abstractprotected

Parameters

int $feedbackId

Returns: bool

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

Referenced by checkFeedbackParent().

Here is the caller graph for this function:

◆ isValidFeedbackPageObjectType()

static ilAssQuestionFeedback::isValidFeedbackPageObjectType ( $feedbackPageObjectType )

staticfinal

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

@final

@access public

Parameters

string $feedbackPageObjectType

Returns: array $validFeedbackPageObjectTypes

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

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

References PAGE_OBJECT_TYPE_GENERIC_FEEDBACK, and PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK.

Referenced by ilAssQuestionFeedbackPageObjectCommandForwarder\__construct().

Here is the caller graph for this function:

◆ migrateContentForLearningModule()

ilAssQuestionFeedback::migrateContentForLearningModule	(	ilAssSelfAssessmentMigrator	$migrator,
			$questionId
	)

Parameters

ilAssSelfAssessmentMigrator	$migrator
integer	$questionId

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

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

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

Here is the call graph for this function:

◆ saveGenericFeedbackContent()

ilAssQuestionFeedback::saveGenericFeedbackContent	(	$questionId,
		$solutionCompleted,
		$feedbackContent
	)

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.

@final @access public

Parameters

integer	$questionId
boolean	$solutionCompleted
string	$feedbackContent

Returns: integer $feedbackId

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

    {
        require_once 'Services/RTE/classes/class.ilRTE.php';
 
        $correctness = $solutionCompleted ? 1 : 0;
 
        $feedbackId = $this->getGenericFeedbackId($questionId, $solutionCompleted);
 
        if (strlen($feedbackContent)) {
            $feedbackContent = $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($feedbackContent);
            $feedbackContent = ilRTE::_replaceMediaObjectImageSrc($feedbackContent, 0);
        }
 
        if ($feedbackId) {
            $this->db->update(
                $this->getGenericFeedbackTableName(),
                array(
                    'feedback' => array('clob', $feedbackContent),
                    'tstamp' => array('integer', time())
                ),
                array(
                    'feedback_id' => array('integer', $feedbackId)
                )
            );
        } else {
            $feedbackId = $this->db->nextId($this->getGenericFeedbackTableName());
 
            $this->db->insert($this->getGenericFeedbackTableName(), array(
                'feedback_id' => array('integer', $feedbackId),
                'question_fi' => array('integer', $questionId),
                'correctness' => array('text', $correctness), // text ?
                'feedback' => array('clob', $feedbackContent),
                'tstamp' => array('integer', time())
            ));
        }
 
        return $feedbackId;
    }

References ilRTE\_replaceMediaObjectImageSrc(), getGenericFeedbackId(), and getGenericFeedbackTableName().

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

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

@final @access public

Parameters

ilPropertyFormGUI $form

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

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

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

Here is the call graph for this function:

◆ saveSpecificAnswerFeedbackContent()

ilAssQuestionFeedback::saveSpecificAnswerFeedbackContent	(	$questionId,
		$questionIndex,
		$answerIndex,
		$feedbackContent
	)

abstract

saves SPECIFIC feedback content for the given question id and answer index to the database.

@abstract @access public

Parameters

integer	$questionId
integer	$questionIndex
integer	$answerIndex
string	$feedbackContent

Returns: integer $feedbackId

Reimplemented in ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ saveSpecificFormProperties()

ilAssQuestionFeedback::saveSpecificFormProperties ( ilPropertyFormGUI $form )

abstract

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

@abstract @access public

Parameters

ilPropertyFormGUI $form

Reimplemented in ilAssClozeTestFeedback, ilAssConfigurableMultiOptionQuestionFeedback, ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

◆ setPageObjectOutputMode()

ilAssQuestionFeedback::setPageObjectOutputMode ( $a_val )

final

Set page object output mode.

Parameters

string $a_val page output mode

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

    {
        $this->page_obj_output_mode = $a_val;
    }

◆ syncFeedback()

ilAssQuestionFeedback::syncFeedback	(	$originalQuestionId,
		$duplicateQuestionId
	)

final

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

@final @access public

Parameters

integer	$originalQuestionId
integer	$duplicateQuestionId

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

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

References syncGenericFeedback(), and syncSpecificFeedback().

Here is the call graph for this function:

◆ syncGenericFeedback()

ilAssQuestionFeedback::syncGenericFeedback	(	$originalQuestionId,
		$duplicateQuestionId
	)

private

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

@final @access private

Parameters

integer	$originalQuestionId
integer	$duplicateQuestionId

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

    {
        // delete generic feedback of the original question
        $this->db->manipulateF(
            "DELETE FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s",
            array('integer'),
            array($originalQuestionId)
        );
 
        // get generic feedback of the actual (duplicated) question
        $result = $this->db->queryF(
            "SELECT * FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s",
            array('integer'),
            array($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(), array(
                'feedback_id' => array('integer', $nextId),
                'question_fi' => array('integer', $originalQuestionId),
                'correctness' => array('text', $row['correctness']),
                'feedback' => array('clob', $row['feedback']),
                'tstamp' => array('integer', time())
            ));
        }
    }

References $result, and getGenericFeedbackTableName().

Referenced by syncFeedback().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ syncSpecificFeedback()

ilAssQuestionFeedback::syncSpecificFeedback	(	$originalQuestionId,
		$duplicateQuestionId
	)

abstractprotected

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

@abstract @access protected

Parameters

integer	$originalQuestionId
integer	$duplicateQuestionId

Reimplemented in ilAssClozeTestFeedback, ilAssConfigurableMultiOptionQuestionFeedback, ilAssMultiOptionQuestionFeedback, and ilAssSingleOptionQuestionFeedback.

Referenced by syncFeedback().

Here is the caller graph for this function:

Field Documentation

◆ $ctrl

ilAssQuestionFeedback::$ctrl = null

protected

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

Referenced by __construct().

◆ $db

ilAssQuestionFeedback::$db = null

protected

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

Referenced by __construct().

◆ $lng

ilAssQuestionFeedback::$lng = null

protected

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

Referenced by __construct().

◆ $page_obj_output_mode

ilAssQuestionFeedback::$page_obj_output_mode = "presentation"

protected

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

Referenced by getPageObjectOutputMode().

◆ $questionOBJ

ilAssQuestionFeedback::$questionOBJ = null

protected

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

Referenced by __construct().

◆ CSS_CLASS_FEEDBACK_CORRECT

const ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_CORRECT = 'ilc_qfeedr_FeedbackRight'

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

◆ CSS_CLASS_FEEDBACK_WRONG

const ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_WRONG = 'ilc_qfeedw_FeedbackWrong'

Definition at line 17 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 37 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 32 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 22 of file class.ilAssQuestionFeedback.php.

Referenced by ensurePageObjectDeleted(), ilAssQuestionFeedbackPageObjectCommandForwarder\ensurePageObjectExists(), ensurePageObjectExists(), getClassNameByType(), getGenericFeedbackPageObjectType(), ilAssQuestionFeedbackPageObjectCommandForwarder\getPageObjectGUI(), and isValidFeedbackPageObjectType().

◆ PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK

const ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK = 'qfbs'

type for specific feedback page objects

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

Referenced by ensurePageObjectDeleted(), ilAssQuestionFeedbackPageObjectCommandForwarder\ensurePageObjectExists(), ensurePageObjectExists(), getClassNameByType(), ilAssQuestionFeedbackPageObjectCommandForwarder\getPageObjectGUI(), getSpecificAnswerFeedbackPageObjectType(), and isValidFeedbackPageObjectType().

◆ TABLE_NAME_GENERIC_FEEDBACK

const ilAssQuestionFeedback::TABLE_NAME_GENERIC_FEEDBACK = 'qpl_fb_generic'

table name for specific feedback

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

Referenced by getGenericFeedbackTableName().

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()

◆ completeGenericFormProperties()

◆ completeSpecificFormProperties()

◆ createPageObject()

◆ deleteGenericFeedbacks()

◆ deleteSpecificAnswerFeedbacks()

◆ duplicateFeedback()

◆ duplicateGenericFeedback()

◆ duplicatePageObject()

◆ duplicateSpecificFeedback()

◆ ensurePageObjectDeleted()

◆ ensurePageObjectExists()

◆ getAllSpecificAnswerFeedbackContents()

◆ getClassNameByType()

◆ getGenericFeedbackContent()

◆ getGenericFeedbackExportPresentation()

◆ getGenericFeedbackId()

◆ getGenericFeedbackPageObjectId()

◆ getGenericFeedbackPageObjectType()

◆ getGenericFeedbackTableName()

◆ getGenericFeedbackTestPresentation()

◆ getPageObjectContent()

◆ 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