ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5f
ilAssMultiOptionQuestionFeedback Class Reference
+ Inheritance diagram for ilAssMultiOptionQuestionFeedback:
+ Collaboration diagram for ilAssMultiOptionQuestionFeedback:

Public Member Functions

 getSpecificAnswerFeedbackTestPresentation ($questionId, $answerIndex)
 returns the html of SPECIFIC feedback for the given question id and answer index for test presentation More...
 
 completeSpecificFormProperties (ilPropertyFormGUI $form)
 completes a given form object with the specific form properties required by this question type More...
 
 initSpecificFormProperties (ilPropertyFormGUI $form)
 initialises a given form object's specific form properties relating to this question type More...
 
 saveSpecificFormProperties (ilPropertyFormGUI $form)
 saves a given form object's specific form properties relating to this question type More...
 
 getSpecificAnswerFeedbackContent ($questionId, $answerIndex)
 returns the SPECIFIC answer 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...
 
 saveSpecificAnswerFeedbackContent ($questionId, $answerIndex, $feedbackContent)
 saves SPECIFIC answer feedback content for the given question id and answer index to the database. More...
 
 deleteSpecificAnswerFeedbacks ($questionId, $isAdditionalContentEditingModePageObject)
 deletes all SPECIFIC answer feedback contents (and page objects if required) for the given question id More...
 
 getSpecificAnswerFeedbackExportPresentation ($questionId, $answerIndex)
 returns the generic feedback export presentation for given question id either for solution completed or incompleted More...
 
 importSpecificAnswerFeedback ($questionId, $answerIndex, $feedbackContent)
 imports the given feedback content as specific feedback for the given question id and answer index More...
 
 specificAnswerFeedbackExists ($answerIndexes)
 
- Public Member Functions inherited from ilAssQuestionFeedback
 __construct (assQuestion $questionOBJ, ilCtrl $ctrl, ilDB $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, $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, $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...
 
 saveGenericFeedbackContent ($questionId, $solutionCompleted, $feedbackContent)
 saves GENERIC feedback content for the given question id to the database. More...
 
 saveSpecificAnswerFeedbackContent ($questionId, $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...
 
 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, $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, $answerIndex, $feedbackContent)
 imports the given feedback content as specific feedback for the given question id and answer index More...
 
 migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator, $questionId)
 

Data Fields

const TABLE_NAME_SPECIFIC_FEEDBACK = 'qpl_fb_specific'
 table name for specific feedback More...
 
- Data Fields inherited from ilAssQuestionFeedback
const CSS_CLASS_FEEDBACK_CORRECT = 'ilc_qfeedr_FeedbackRight'
 
const CSS_CLASS_FEEDBACK_WRONG = 'ilc_qfeedw_FeedbackWrong'
 
const PAGE_OBJECT_TYPE_GENERIC_FEEDBACK = 'qfbg'
 type for generic feedback page objects More...
 
const PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK = 'qfbs'
 type for specific feedback page objects More...
 
const FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID = 1
 id for page object relating to generic incomplete solution feedback More...
 
const FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID = 2
 id for page object relating to generic complete solution feedback More...
 
const TABLE_NAME_GENERIC_FEEDBACK = 'qpl_fb_generic'
 table name for specific feedback More...
 

Protected Member Functions

 duplicateSpecificFeedback ($originalQuestionId, $duplicateQuestionId)
 duplicates the SPECIFIC feedback relating to the given original question id and saves it for the given duplicate question id More...
 
 syncSpecificFeedback ($originalQuestionId, $duplicateQuestionId)
 syncs the SPECIFIC feedback from a duplicated question back to the original question More...
 
 getSpecificAnswerFeedbackId ($questionId, $answerIndex)
 returns the SPECIFIC answer feedback ID for a given question id and answer index. More...
 
 getSpecificAnswerFeedbackIdByAnswerIndexMap ($questionId)
 returns an array mapping feedback ids to answer indexes for all answer options of question More...
 
 getSpecificFeedbackTableName ()
 returns the table name for specific feedback More...
 
 getAnswerOptionsByAnswerIndex ()
 returns the answer options mapped by answer index (can be overwritten by concrete question type class) More...
 
 buildAnswerOptionLabel ($index, $answer)
 builds an answer option label from given (mixed type) index and answer (can be overwritten by concrete question types) More...
 
 getSpecificAnswerFeedbackPageObjectId ($questionId, $answerIndex)
 returns a useable page object id for specific answer feedback page objects for the given question id and answer index (using the id sequence of non page object specific answer feedback) More...
 
- Protected Member Functions inherited from ilAssQuestionFeedback
 buildFeedbackContentFormProperty ($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...
 
 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...
 

Additional Inherited Members

- Static Public Member Functions inherited from ilAssQuestionFeedback
static isValidFeedbackPageObjectType ($feedbackPageObjectType)
 returns the fact wether the given page object type relates to generic or specific feedback page objects More...
 
- Protected Attributes inherited from ilAssQuestionFeedback
 $questionOBJ = null
 
 $ctrl = null
 
 $db = null
 
 $lng = null
 
 $page_obj_output_mode = "presentation"
 

Detailed Description

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

Member Function Documentation

◆ buildAnswerOptionLabel()

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

builds an answer option label from given (mixed type) index and answer (can be overwritten by concrete question types)

@access protected

Parameters
integer$index
mixed$answer
Returns
string $answerOptionLabel

Reimplemented in ilAssOrderingHorizontalFeedback, ilAssClozeTestFeedback, ilAssErrorTextFeedback, ilAssImagemapQuestionFeedback, ilAssKprimChoiceFeedback, ilAssMatchingQuestionFeedback, ilAssMultipleChoiceFeedback, ilAssSingleChoiceFeedback, ilAssTextQuestionFeedback, and ilAssLongMenuFeedback.

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

412 {
413 return $answer->getAnswertext();
414 }

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

+ Here is the caller graph for this function:

◆ completeSpecificFormProperties()

ilAssMultiOptionQuestionFeedback::completeSpecificFormProperties ( ilPropertyFormGUI  $form)

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

@access public

Parameters
ilPropertyFormGUI$form

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssConfigurableMultiOptionQuestionFeedback.

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

60 {
61 if( !$this->questionOBJ->getSelfAssessmentEditingMode() )
62 {
64 $header->setTitle($this->lng->txt('feedback_answers'));
65 $form->addItem($header);
66
67 foreach( $this->getAnswerOptionsByAnswerIndex() as $index => $answer )
68 {
69 $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
70 $this->buildAnswerOptionLabel($index, $answer), true
71 );
72
73 $propertyPostVar = "feedback_answer_$index";
74
76 $propertyLabel , $propertyPostVar, $this->questionOBJ->isAdditionalContentEditingModePageObject()
77 ));
78 }
79 }
80 }
getAnswerOptionsByAnswerIndex()
returns the answer options mapped by answer index (can be overwritten by concrete question type class...
buildAnswerOptionLabel($index, $answer)
builds an answer option label from given (mixed type) index and answer (can be overwritten by concret...
buildFeedbackContentFormProperty($label, $postVar, $asNonEditable)
builds and returns a form property gui object with the given label and postvar that is addable to pro...
This class represents a section header in a property form.
addItem($a_item)
Add Item (Property, SectionHeader).
$header

References $header, ilPropertyFormGUI\addItem(), buildAnswerOptionLabel(), ilAssQuestionFeedback\buildFeedbackContentFormProperty(), and getAnswerOptionsByAnswerIndex().

+ Here is the call graph for this function:

◆ deleteSpecificAnswerFeedbacks()

ilAssMultiOptionQuestionFeedback::deleteSpecificAnswerFeedbacks (   $questionId,
  $isAdditionalContentEditingModePageObject 
)

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

@access public

Parameters
integer$questionId
boolean$isAdditionalContentEditingModePageObject

Reimplemented from ilAssQuestionFeedback.

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

244 {
245 if( $isAdditionalContentEditingModePageObject )
246 {
247 foreach( $this->getSpecificAnswerFeedbackIdByAnswerIndexMap($questionId) as $answerIndex => $pageObjectId )
248 {
250 }
251 }
252
253 $this->db->manipulateF(
254 "DELETE FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
255 array('integer'), array($questionId)
256 );
257 }
getSpecificAnswerFeedbackIdByAnswerIndexMap($questionId)
returns an array mapping feedback ids to answer indexes for all answer options of question
getSpecificAnswerFeedbackPageObjectType()
returns the type for specific feedback page objects defined in local constant
ensurePageObjectDeleted($pageObjectType, $pageObjectId)
ensures a no more existing page object for given type and id

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

+ Here is the call graph for this function:

◆ duplicateSpecificFeedback()

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

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

@access protected

Parameters
integer$originalQuestionId
integer$duplicateQuestionId

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssConfigurableMultiOptionQuestionFeedback.

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

267 {
268 $res = $this->db->queryF(
269 "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
270 array('integer'), array($originalQuestionId)
271 );
272
273 while( $row = $this->db->fetchAssoc($res) )
274 {
275 $nextId = $this->db->nextId($this->getSpecificFeedbackTableName());
276
277 $this->db->insert($this->getSpecificFeedbackTableName(), array(
278 'feedback_id' => array('integer', $nextId),
279 'question_fi' => array('integer', $duplicateQuestionId),
280 'answer' => array('integer', $row['answer']),
281 'feedback' => array('text', $row['feedback']),
282 'tstamp' => array('integer', time())
283 ));
284
285 if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
286 {
287 $pageObjectType = $this->getSpecificAnswerFeedbackPageObjectType();
288 $this->duplicatePageObject($pageObjectType, $row['feedback_id'], $nextId, $duplicateQuestionId);
289 }
290 }
291 }
getSpecificFeedbackTableName()
returns the table name for specific feedback
duplicatePageObject($pageObjectType, $originalPageObjectId, $duplicatePageObjectId, $duplicatePageObjectParentId)
duplicates the page object with given type and original id to new page object with same type and give...

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

+ Here is the call graph for this function:

◆ getAllSpecificAnswerFeedbackContents()

ilAssMultiOptionQuestionFeedback::getAllSpecificAnswerFeedbackContents (   $questionId)

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

@abstract @access public

Parameters
integer$questionId
Returns
string $feedbackContent

Reimplemented from ilAssQuestionFeedback.

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

169 {
170 require_once 'Services/RTE/classes/class.ilRTE.php';
171
172 $res = $this->db->queryF(
173 "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
174 array('integer'), array($questionId)
175 );
176
177 $allFeedbackContents = '';
178
179 while( $row = $this->db->fetchAssoc($res) )
180 {
181 $allFeedbackContents .= ilRTE::_replaceMediaObjectImageSrc($row['feedback'], 1);
182 }
183
184 return $allFeedbackContents;
185 }
static _replaceMediaObjectImageSrc($a_text, $a_direction=0, $nic=IL_INST_ID)
replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...

References $res, $row, and ilRTE\_replaceMediaObjectImageSrc().

+ Here is the call graph for this function:

◆ getAnswerOptionsByAnswerIndex()

ilAssMultiOptionQuestionFeedback::getAnswerOptionsByAnswerIndex ( )
protected

returns the answer options mapped by answer index (can be overwritten by concrete question type class)

Returns
array $answerOptionsByAnswerIndex

Reimplemented in ilAssClozeTestFeedback, ilAssErrorTextFeedback, ilAssLongMenuFeedback, ilAssMatchingQuestionFeedback, and ilAssOrderingHorizontalFeedback.

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

398 {
399 return $this->questionOBJ->getAnswers();
400 }

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

+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackContent()

ilAssMultiOptionQuestionFeedback::getSpecificAnswerFeedbackContent (   $questionId,
  $answerIndex 
)

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

@access public

Parameters
integer$questionId
boolean$answerIndex
Returns
string $feedbackContent

Reimplemented from ilAssQuestionFeedback.

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

143 {
144 require_once 'Services/RTE/classes/class.ilRTE.php';
145
146 $res = $this->db->queryF(
147 "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s AND answer = %s",
148 array('integer','integer'), array($questionId, $answerIndex)
149 );
150
151 while( $row = $this->db->fetchAssoc($res) )
152 {
153 $feedbackContent = ilRTE::_replaceMediaObjectImageSrc($row['feedback'], 1);
154 break;
155 }
156
157 return $feedbackContent;
158 }

References $res, $row, and ilRTE\_replaceMediaObjectImageSrc().

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackExportPresentation()

ilAssMultiOptionQuestionFeedback::getSpecificAnswerFeedbackExportPresentation (   $questionId,
  $answerIndex 
)

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

@access public

Parameters
integer$questionId
integer$answerIndex
Returns
string $specificAnswerFeedbackExportPresentation

Reimplemented from ilAssQuestionFeedback.

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

449 {
450 if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
451 {
452 $specificAnswerFeedbackExportPresentation = $this->getPageObjectXML(
454 $this->getSpecificAnswerFeedbackPageObjectId($questionId, $answerIndex)
455 );
456 }
457 else
458 {
459 $specificAnswerFeedbackExportPresentation = $this->getSpecificAnswerFeedbackContent(
460 $questionId, $answerIndex
461 );
462 }
463
464 return $specificAnswerFeedbackExportPresentation;
465 }
getSpecificAnswerFeedbackContent($questionId, $answerIndex)
returns the SPECIFIC answer feedback content for a given question id and answer index.
getSpecificAnswerFeedbackPageObjectId($questionId, $answerIndex)
returns a useable page object id for specific answer feedback page objects for the given question id ...
getPageObjectXML($pageObjectType, $pageObjectId)
returns the xml of page object with given type and id

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

Referenced by specificAnswerFeedbackExists().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackId()

ilAssMultiOptionQuestionFeedback::getSpecificAnswerFeedbackId (   $questionId,
  $answerIndex 
)
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 336 of file class.ilAssMultiOptionQuestionFeedback.php.

337 {
338 $res = $this->db->queryF(
339 "SELECT feedback_id FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s AND answer = %s",
340 array('integer','integer'), array($questionId, $answerIndex)
341 );
342
343 $feedbackId = null;
344
345 while( $row = $this->db->fetchAssoc($res) )
346 {
347 $feedbackId = $row['feedback_id'];
348 break;
349 }
350
351 return $feedbackId;
352 }

References $res, and $row.

Referenced by getSpecificAnswerFeedbackPageObjectId(), and saveSpecificAnswerFeedbackContent().

+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackIdByAnswerIndexMap()

ilAssMultiOptionQuestionFeedback::getSpecificAnswerFeedbackIdByAnswerIndexMap (   $questionId)
finalprotected

returns an array mapping feedback ids to answer indexes for all answer options of question

@final @access protected

Parameters
integer$questionId
Returns
array $feedbackIdByAnswerIndexMap

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

364 {
365 $res = $this->db->queryF(
366 "SELECT feedback_id, answer FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
367 array('integer'), array($questionId)
368 );
369
370 $feedbackIdByAnswerIndexMap = array();
371
372 while( $row = $this->db->fetchAssoc($res) )
373 {
374 $feedbackIdByAnswerIndexMap[ $row['answer'] ] = $row['feedback_id'];
375 }
376
377 return $feedbackIdByAnswerIndexMap;
378 }

References $res, and $row.

Referenced by deleteSpecificAnswerFeedbacks().

+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackPageObjectId()

ilAssMultiOptionQuestionFeedback::getSpecificAnswerFeedbackPageObjectId (   $questionId,
  $answerIndex 
)
finalprotected

returns a useable page object id for specific answer feedback page objects for the given question id and answer index (using the id sequence of non page object specific answer feedback)

@final @access protected

Parameters
integer$questionId
integer$answerIndex
Returns
integer $pageObjectId

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

428 {
429 $pageObjectId = $this->getSpecificAnswerFeedbackId($questionId, $answerIndex);
430
431 if( !$pageObjectId )
432 {
433 $pageObjectId = $this->saveSpecificAnswerFeedbackContent($questionId, $answerIndex, null);
434 }
435
436 return $pageObjectId;
437 }
saveSpecificAnswerFeedbackContent($questionId, $answerIndex, $feedbackContent)
saves SPECIFIC answer feedback content for the given question id and answer index to the database.
getSpecificAnswerFeedbackId($questionId, $answerIndex)
returns the SPECIFIC answer feedback ID for a given question id and answer index.

References getSpecificAnswerFeedbackId(), and saveSpecificAnswerFeedbackContent().

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackTestPresentation()

ilAssMultiOptionQuestionFeedback::getSpecificAnswerFeedbackTestPresentation (   $questionId,
  $answerIndex 
)

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

@access public

Parameters
integer$questionId
integer$answerIndex
Returns
string $specificAnswerFeedbackTestPresentationHTML

Reimplemented from ilAssQuestionFeedback.

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

34 {
35 if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
36 {
37 $specificAnswerFeedbackTestPresentationHTML = $this->getPageObjectContent(
39 $this->getSpecificAnswerFeedbackPageObjectId($questionId, $answerIndex)
40 );
41 }
42 else
43 {
44 $specificAnswerFeedbackTestPresentationHTML = $this->getSpecificAnswerFeedbackContent(
45 $questionId, $answerIndex
46 );
47 }
48
49 return $specificAnswerFeedbackTestPresentationHTML;
50 }
getPageObjectContent($pageObjectType, $pageObjectId)
returns the content of page object with given type and id

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

+ Here is the call graph for this function:

◆ getSpecificFeedbackTableName()

ilAssMultiOptionQuestionFeedback::getSpecificFeedbackTableName ( )
finalprotected

returns the table name for specific feedback

@final

Returns
string $specificFeedbackTableName

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

387 {
389 }
const TABLE_NAME_SPECIFIC_FEEDBACK
table name for specific feedback

References TABLE_NAME_SPECIFIC_FEEDBACK.

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

+ Here is the caller graph for this function:

◆ importSpecificAnswerFeedback()

ilAssMultiOptionQuestionFeedback::importSpecificAnswerFeedback (   $questionId,
  $answerIndex,
  $feedbackContent 
)

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

@access public

Parameters
integer$questionId
integer$answerIndex
string$feedbackContent

Reimplemented from ilAssQuestionFeedback.

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

477 {
478 if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
479 {
480 $pageObjectId = $this->getSpecificAnswerFeedbackPageObjectId($questionId, $answerIndex);
481 $pageObjectType = $this->getSpecificAnswerFeedbackPageObjectType();
482
483 $this->createPageObject($pageObjectType, $pageObjectId, $feedbackContent);
484 }
485 else
486 {
487 $this->saveSpecificAnswerFeedbackContent($questionId, $answerIndex, $feedbackContent);
488 }
489 }
createPageObject($pageObjectType, $pageObjectId, $pageObjectContent)
creates a new page object with given page object id and page object type and passed page object conte...

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

+ Here is the call graph for this function:

◆ initSpecificFormProperties()

ilAssMultiOptionQuestionFeedback::initSpecificFormProperties ( ilPropertyFormGUI  $form)

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

@access public

Parameters
ilPropertyFormGUI$form

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssConfigurableMultiOptionQuestionFeedback.

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

90 {
91 if (!$this->questionOBJ->getSelfAssessmentEditingMode())
92 {
93 foreach( $this->getAnswerOptionsByAnswerIndex() as $index => $answer )
94 {
95 if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
96 {
99 $this->getSpecificAnswerFeedbackPageObjectId($this->questionOBJ->getId(), $index)
100 );
101 }
102 else
103 {
104 $value = $this->questionOBJ->prepareTextareaOutput(
105 $this->getSpecificAnswerFeedbackContent($this->questionOBJ->getId(), $index)
106 );
107 }
108
109 $form->getItemByPostVar("feedback_answer_$index")->setValue($value);
110 }
111 }
112 }
getPageObjectNonEditableValueHTML($pageObjectType, $pageObjectId)
returns html content to be used as value for non editable value form properties in feedback editing f...
getItemByPostVar($a_post_var)
Get Item by POST variable.

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

+ Here is the call graph for this function:

◆ saveSpecificAnswerFeedbackContent()

ilAssMultiOptionQuestionFeedback::saveSpecificAnswerFeedbackContent (   $questionId,
  $answerIndex,
  $feedbackContent 
)

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

@access public

Parameters
integer$questionId
integer$answerIndex
string$feedbackContent
Returns
integer $feedbackId

Reimplemented from ilAssQuestionFeedback.

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

197 {
198 require_once 'Services/RTE/classes/class.ilRTE.php';
199
200 if( strlen($feedbackContent) )
201 {
202 $feedbackContent = ilRTE::_replaceMediaObjectImageSrc($feedbackContent, 0);
203 }
204
205 $feedbackId = $this->getSpecificAnswerFeedbackId($questionId, $answerIndex);
206
207 if( $feedbackId )
208 {
209 $this->db->update($this->getSpecificFeedbackTableName(),
210 array(
211 'feedback' => array('text', $feedbackContent),
212 'tstamp' => array('integer', time())
213 ),
214 array(
215 'feedback_id' => array('integer', $feedbackId),
216 )
217 );
218 }
219 else
220 {
221 $feedbackId = $this->db->nextId($this->getSpecificFeedbackTableName());
222
223 $this->db->insert($this->getSpecificFeedbackTableName(), array(
224 'feedback_id' => array('integer', $feedbackId),
225 'question_fi' => array('integer', $questionId),
226 'answer' => array('integer', $answerIndex),
227 'feedback' => array('text', $feedbackContent),
228 'tstamp' => array('integer', time())
229 ));
230 }
231
232 return $feedbackId;
233 }

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

Referenced by getSpecificAnswerFeedbackPageObjectId(), importSpecificAnswerFeedback(), ilAssConfigurableMultiOptionQuestionFeedback\saveSpecificFormProperties(), and saveSpecificFormProperties().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ saveSpecificFormProperties()

ilAssMultiOptionQuestionFeedback::saveSpecificFormProperties ( ilPropertyFormGUI  $form)

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

@access public

Parameters
ilPropertyFormGUI$form

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssConfigurableMultiOptionQuestionFeedback.

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

122 {
123 if( !$this->questionOBJ->isAdditionalContentEditingModePageObject() )
124 {
125 foreach( $this->getAnswerOptionsByAnswerIndex() as $index => $answer )
126 {
128 $this->questionOBJ->getId(), $index, $form->getInput("feedback_answer_$index")
129 );
130 }
131 }
132 }
getInput($a_post_var, $ensureValidation=true)
Returns the value of a HTTP-POST variable, identified by the passed id.

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

+ Here is the call graph for this function:

◆ specificAnswerFeedbackExists()

ilAssMultiOptionQuestionFeedback::specificAnswerFeedbackExists (   $answerIndexes)

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

492 {
493 foreach($answerIndexes as $answerIndex)
494 {
495 $fb = $this->getSpecificAnswerFeedbackExportPresentation($this->questionOBJ->getId(), $answerIndex);
496
497 if( strlen($fb) )
498 {
499 return true;
500 }
501 }
502
503 return false;
504 }
getSpecificAnswerFeedbackExportPresentation($questionId, $answerIndex)
returns the generic feedback export presentation for given question id either for solution completed ...

References getSpecificAnswerFeedbackExportPresentation().

+ Here is the call graph for this function:

◆ syncSpecificFeedback()

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

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

@access protected

Parameters
integer$originalQuestionId
integer$duplicateQuestionId

Reimplemented from ilAssQuestionFeedback.

Reimplemented in ilAssConfigurableMultiOptionQuestionFeedback.

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

301 {
302 // delete specific feedback of the original
303 $this->db->manipulateF(
304 "DELETE FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s", array('integer'), array($originalQuestionId)
305 );
306
307 // get specific feedback of the actual question
308 $res = $this->db->queryF(
309 "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s", array('integer'), array($duplicateQuestionId)
310 );
311
312 // save specific feedback to the original
313 while( $row = $this->db->fetchAssoc($res) )
314 {
315 $nextId = $this->db->nextId($this->getSpecificFeedbackTableName());
316
317 $this->db->insert($this->getSpecificFeedbackTableName(), array(
318 'feedback_id' => array('integer', $nextId),
319 'question_fi' => array('integer', $originalQuestionId),
320 'answer' => array('integer',$row['answer']),
321 'feedback' => array('text',$row['feedback']),
322 'tstamp' => array('integer',time())
323 ));
324 }
325 }

References $res, $row, and getSpecificFeedbackTableName().

+ Here is the call graph for this function:

Field Documentation

◆ TABLE_NAME_SPECIFIC_FEEDBACK

const ilAssMultiOptionQuestionFeedback::TABLE_NAME_SPECIFIC_FEEDBACK = 'qpl_fb_specific'

table name for specific feedback

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

Referenced by getSpecificFeedbackTableName().


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