ILIAS  trunk Revision v11.0_alpha-1866-gfa368f7776e
All Data Structures Namespaces Files Functions Variables Enumerations Enumerator Modules Pages
ilAssQuestionFeedback Class Reference
+ Inheritance diagram for ilAssQuestionFeedback:
+ Collaboration diagram for ilAssQuestionFeedback:

Public Member Functions

 __construct (assQuestion $questionOBJ, ilCtrl $ctrl, ilDBInterface $db, ilLanguage $lng)
 constructor More...
 
 getGenericFeedbackTestPresentation (int $question_id, bool $solution_completed)
 returns the html of GENERIC feedback for the given question id for test presentation (either for the complete solution or for the incomplete solution) More...
 
 getSpecificAnswerFeedbackTestPresentation (int $question_id, int $question_index, int $answer_index)
 returns the html of SPECIFIC feedback for the given question id and answer index for test presentation More...
 
 completeGenericFormProperties (ilPropertyFormGUI $form)
 completes a given form object with the GENERIC form properties required by all question types More...
 
 completeSpecificFormProperties (ilPropertyFormGUI $form)
 completes a given form object with the SPECIFIC form properties required by this question type More...
 
 initGenericFormProperties (ilPropertyFormGUI $form)
 initialises a given form object's GENERIC form properties relating to all question types More...
 
 initSpecificFormProperties (ilPropertyFormGUI $form)
 initialises a given form object's SPECIFIC form properties relating to this question type More...
 
 saveGenericFormProperties (ilPropertyFormGUI $form)
 saves a given form object's GENERIC form properties relating to all question types More...
 
 saveSpecificFormProperties (ilPropertyFormGUI $form)
 saves a given form object's SPECIFIC form properties relating to this question type More...
 
 isSaveableInPageObjectEditingMode ()
 returns the fact wether the feedback editing form is saveable in page object editing or not. More...
 
 getGenericFeedbackContent (int $question_id, bool $solution_completed)
 returns the GENERIC feedback content for a given question state. More...
 
 getSpecificAnswerFeedbackContent (int $question_id, int $question_index, int $answer_index)
 
 getAllSpecificAnswerFeedbackContents (int $question_id)
 
 isSpecificAnswerFeedbackAvailable (int $question_id)
 
 saveGenericFeedbackContent (int $question_id, bool $solution_completed, string $feedback_content)
 saves GENERIC feedback content for the given question id to the database. More...
 
 saveSpecificAnswerFeedbackContent (int $question_id, int $question_index, int $answer_index, string $feedback_content)
 
 deleteGenericFeedbacks (int $question_id, bool $isAdditionalContentEditingModePageObject)
 deletes all GENERIC feedback contents (and page objects if required) for the given question id More...
 
 deleteSpecificAnswerFeedbacks (int $question_id, bool $isAdditionalContentEditingModePageObject)
 
 duplicateFeedback (int $originalQuestionId, int $duplicateQuestionId)
 duplicates the feedback relating to the given original question id and saves it for the given duplicate question id More...
 
 cloneFeedback (int $originalQuestionId, int $duplicateQuestionId)
 syncs the feedback from a duplicated question back to the original question More...
 
 checkFeedbackParent (int $feedbackId)
 
 getClassNameByType (string $a_type, bool $a_gui=false)
 
 setPageObjectOutputMode (string $page_obj_output_mode)
 
 getPageObjectOutputMode ()
 
 getGenericFeedbackExportPresentation (int $question_id, bool $solution_completed)
 returns the generic feedback export presentation for given question id either for solution completed or incompleted More...
 
 getSpecificAnswerFeedbackExportPresentation (int $question_id, int $question_index, int $answer_index)
 returns the generic feedback export presentation for given question id either for solution completed or incompleted More...
 
 importGenericFeedback (int $question_id, bool $solution_completed, string $feedback_content)
 imports the given feedback content as generic feedback for the given question id for either the complete or incomplete solution More...
 
 importSpecificAnswerFeedback (int $question_id, int $question_index, int $answer_index, string $feedback_content)
 
 migrateContentForLearningModule (ilAssSelfAssessmentMigrator $migrator, int $question_id)
 
 createFeedbackPages (string $mode)
 

Static Public Member Functions

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

Data Fields

const CSS_CLASS_FEEDBACK_CORRECT = 'ilc_qfeedr_FeedbackRight'
 
const CSS_CLASS_FEEDBACK_WRONG = 'ilc_qfeedw_FeedbackWrong'
 
const PAGE_OBJECT_TYPE_GENERIC_FEEDBACK = 'qfbg'
 type for generic feedback page objects More...
 
const PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK = 'qfbs'
 type for specific feedback page objects More...
 
const FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID = 1
 id for page object relating to generic incomplete solution feedback More...
 
const FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID = 2
 id for page object relating to generic complete solution feedback More...
 
const TABLE_NAME_GENERIC_FEEDBACK = 'qpl_fb_generic'
 

Protected Member Functions

 buildFeedbackContentFormProperty (string $label, string $post_var, bool $as_non_editable)
 builds and returns a form property gui object with the given label and postvar that is addable to property forms depending on the given flag "asNonEditable" it returns a ... More...
 
 cloneSpecificFeedback (int $originalQuestionId, int $duplicateQuestionId)
 duplicates the SPECIFIC feedback relating to the given original question id and saves it for the given duplicate question id More...
 
 getGenericFeedbackId (int $question_id, bool $solution_completed)
 returns the SPECIFIC answer feedback ID for a given question id and answer index. More...
 
 isGenericFeedbackId (int $feedbackId)
 
 isSpecificAnswerFeedbackId (int $feedbackId)
 
 getGenericFeedbackTableName ()
 
 getPageObjectNonEditableValueHTML (string $page_object_type, int $page_object_id)
 returns html content to be used as value for non editable value form properties in feedback editing form More...
 
 getPageObjectXML (string $page_object_type, int $page_object_id)
 
 createPageObject (string $page_object_type, int $page_object_id, string $page_object_content)
 
 clonePageObject (string $page_object_type, int $source_page_object_id, int $target_page_object_id, int $target_page_object_parent_id)
 
 ensurePageObjectDeleted (string $page_object_type, int $page_object_id)
 
 getGenericFeedbackPageObjectType ()
 
 getSpecificAnswerFeedbackPageObjectType ()
 
 getGenericFeedbackPageObjectId (int $question_id, bool $solution_completed)
 returns a useable page object id for generic feedback page objects for the given question id for either the complete or incomplete solution (using the id sequence of non page object generic feedback) More...
 
 cleanupPageContent (string $content)
 

Protected Attributes

assQuestion $questionOBJ
 
ilCtrl $ctrl
 
ilDBInterface $db
 
ilLanguage $lng
 
string $page_obj_output_mode = "presentation"
 

Private Member Functions

 duplicateGenericFeedback (int $originalQuestionId, int $duplicateQuestionId)
 duplicates the GENERIC feedback relating to the given original question id and saves it for the given duplicate question id More...
 
 cloneGenericFeedback (int $originalQuestionId, int $duplicateQuestionId)
 syncs the GENERIC feedback from a duplicated question back to the original question More...
 
 getPageObjectEditingLink (string $page_object_type, int $page_object_id)
 
 ensurePageObjectExists (string $page_object_type, int $page_object_id)
 

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

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

constructor

public

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

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

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

+ Here is the call graph for this function:

Member Function Documentation

◆ buildFeedbackContentFormProperty()

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

builds and returns a form property gui object with the given label and postvar that is addable to property forms depending on the given flag "asNonEditable" it returns a ...

  • non editable gui
  • textarea input gui
    Returns
    ilTextAreaInputGUI|ilNonEditableValueGUI

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

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

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

245  {
246  if ($as_non_editable) {
247  $property = new ilNonEditableValueGUI($label, $post_var, true);
248  } else {
249  $property = new ilTextAreaInputGUI($label, $post_var);
250  $property->setRequired(false);
251  $property->setRows(10);
252  $property->setCols(80);
253 
254  if (!$this->questionOBJ->getPreventRteUsage()) {
255  $property->setUseRte(true);
256  $property->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("assessment"));
257  $property->setRTESupport($this->questionOBJ->getId(), "qpl", "assessment");
258  } else {
260  $property->setUseTagsForRteOnly(false);
261  }
262 
263  $property->setRTESupport($this->questionOBJ->getId(), "qpl", "assessment");
264  }
265 
266  return $property;
267  }
static getSelfAssessmentTags()
Get tags allowed in question tags in self assessment mode.
This class represents a property that may include a sub form.
This class represents a text area property in a property form.
static _getUsedHTMLTags(string $a_module="")
Returns an array of all allowed HTML tags for text editing.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ checkFeedbackParent()

ilAssQuestionFeedback::checkFeedbackParent ( int  $feedbackId)
final

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

References isGenericFeedbackId(), and isSpecificAnswerFeedbackId().

514  : bool
515  {
516  if ($this->isGenericFeedbackId($feedbackId)) {
517  return true;
518  }
519 
520  if ($this->isSpecificAnswerFeedbackId($feedbackId)) {
521  return true;
522  }
523 
524  return false;
525  }
isSpecificAnswerFeedbackId(int $feedbackId)
+ Here is the call graph for this function:

◆ cleanupPageContent()

ilAssQuestionFeedback::cleanupPageContent ( string  $content)
protected

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

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

753  : string
754  {
755  $doc = new DOMDocument('1.0', 'UTF-8');
756  if (@$doc->loadHTML('<html><body>' . $content . '</body></html>')) {
757  $xpath = new DOMXPath($doc);
758  $nodes_after_comments = $xpath->query('//comment()/following-sibling::*[1]');
759  foreach ($nodes_after_comments as $node_after_comments) {
760  if (trim($node_after_comments->nodeValue) === ''
761  && $node_after_comments->childElementCount === 0) {
762  return '';
763  }
764  }
765  }
766  return $content;
767  }
+ Here is the caller graph for this function:

◆ cloneFeedback()

ilAssQuestionFeedback::cloneFeedback ( int  $originalQuestionId,
int  $duplicateQuestionId 
)
final

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

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

References cloneGenericFeedback(), and cloneSpecificFeedback().

440  : void
441  {
442  $this->cloneGenericFeedback($originalQuestionId, $duplicateQuestionId);
443  $this->cloneSpecificFeedback($originalQuestionId, $duplicateQuestionId);
444  }
cloneSpecificFeedback(int $originalQuestionId, int $duplicateQuestionId)
duplicates the SPECIFIC feedback relating to the given original question id and saves it for the give...
cloneGenericFeedback(int $originalQuestionId, int $duplicateQuestionId)
syncs the GENERIC feedback from a duplicated question back to the original question ...
+ Here is the call graph for this function:

◆ cloneGenericFeedback()

ilAssQuestionFeedback::cloneGenericFeedback ( int  $originalQuestionId,
int  $duplicateQuestionId 
)
private

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

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

References getGenericFeedbackTableName().

Referenced by cloneFeedback().

449  : void
450  {
451  // delete generic feedback of the original question
452  $this->db->manipulateF(
453  "DELETE FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s",
454  ['integer'],
455  [$originalQuestionId]
456  );
457 
458  // get generic feedback of the actual (duplicated) question
459  $result = $this->db->queryF(
460  "SELECT * FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s",
461  ['integer'],
462  [$duplicateQuestionId]
463  );
464 
465  // save generic feedback to the original question
466  while ($row = $this->db->fetchAssoc($result)) {
467  $nextId = $this->db->nextId($this->getGenericFeedbackTableName());
468 
469  $this->db->insert($this->getGenericFeedbackTableName(), [
470  'feedback_id' => ['integer', $nextId],
471  'question_fi' => ['integer', $originalQuestionId],
472  'correctness' => ['text', $row['correctness']],
473  'feedback' => ['clob', $row['feedback']],
474  'tstamp' => ['integer', time()]
475  ]);
476  }
477  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ clonePageObject()

ilAssQuestionFeedback::clonePageObject ( string  $page_object_type,
int  $source_page_object_id,
int  $target_page_object_id,
int  $target_page_object_parent_id 
)
finalprotected

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

References ensurePageObjectExists(), and getClassNameByType().

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

636  : void {
637  $this->ensurePageObjectExists($page_object_type, $source_page_object_id);
638  $this->ensurePageObjectExists($page_object_type, $target_page_object_id);
639 
640  $cl = $this->getClassNameByType($page_object_type);
641 
642  $pageObject = new $cl($source_page_object_id);
643  $pageObject->setParentId($target_page_object_parent_id);
644  $pageObject->setId($target_page_object_id);
645  $pageObject->updateFromXML();
646  }
ensurePageObjectExists(string $page_object_type, int $page_object_id)
getClassNameByType(string $a_type, bool $a_gui=false)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ cloneSpecificFeedback()

ilAssQuestionFeedback::cloneSpecificFeedback ( int  $originalQuestionId,
int  $duplicateQuestionId 
)
abstractprotected

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

Referenced by cloneFeedback(), duplicateFeedback(), and duplicateGenericFeedback().

+ Here is the caller graph for this function:

◆ completeGenericFormProperties()

ilAssQuestionFeedback::completeGenericFormProperties ( ilPropertyFormGUI  $form)
final

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

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

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

121  : void
122  {
124  $this->lng->txt('feedback_complete_solution'),
125  'feedback_complete',
126  $this->questionOBJ->isAdditionalContentEditingModePageObject()
127  ));
128 
130  $this->lng->txt('feedback_incomplete_solution'),
131  'feedback_incomplete',
132  $this->questionOBJ->isAdditionalContentEditingModePageObject()
133  ));
134  }
buildFeedbackContentFormProperty(string $label, string $post_var, bool $as_non_editable)
builds and returns a form property gui object with the given label and postvar that is addable to pro...
+ Here is the call graph for this function:

◆ completeSpecificFormProperties()

ilAssQuestionFeedback::completeSpecificFormProperties ( ilPropertyFormGUI  $form)
abstract

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

public

Parameters
ilPropertyFormGUI$form

Referenced by completeGenericFormProperties().

+ Here is the caller graph for this function:

◆ createFeedbackPages()

ilAssQuestionFeedback::createFeedbackPages ( string  $mode)

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

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

769  : string
770  {
772  $page_object_id_complete = $this->saveGenericFeedbackContent(
773  $this->questionOBJ->getId(),
774  true,
775  ''
776  );
777  $this->ensurePageObjectExists($page_object_type, $page_object_id_complete);
778 
779  $page_object_id_incomplete = $this->saveGenericFeedbackContent(
780  $this->questionOBJ->getId(),
781  false,
782  ''
783  );
784  $this->ensurePageObjectExists($page_object_type, $page_object_id_incomplete);
785 
786  $page_object_id = ($mode === 'complete') ? $page_object_id_complete : $page_object_id_incomplete;
787  return $this->getPageObjectEditingLink(
788  $page_object_type,
789  $page_object_id
790  );
791  }
saveGenericFeedbackContent(int $question_id, bool $solution_completed, string $feedback_content)
saves GENERIC feedback content for the given question id to the database.
ensurePageObjectExists(string $page_object_type, int $page_object_id)
getPageObjectEditingLink(string $page_object_type, int $page_object_id)
const PAGE_OBJECT_TYPE_GENERIC_FEEDBACK
type for generic feedback page objects
+ Here is the call graph for this function:

◆ createPageObject()

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

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

References getClassNameByType().

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

620  : void
621  {
622  $cl = $this->getClassNameByType($page_object_type);
623 
624  $pageObject = new $cl();
625  $pageObject->setParentId($this->questionOBJ->getId());
626  $pageObject->setId($page_object_id);
627  $pageObject->setXMLContent($page_object_content);
628  $pageObject->createFromXML();
629  }
getClassNameByType(string $a_type, bool $a_gui=false)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ deleteGenericFeedbacks()

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

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

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

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

365  : void
366  {
367  if ($page_object_id === -1) {
368  return;
369  }
370  if ($isAdditionalContentEditingModePageObject) {
373  $this->getGenericFeedbackPageObjectId($question_id, true)
374  );
375 
378  $this->getGenericFeedbackPageObjectId($question_id, false)
379  );
380  }
381 
382  $this->db->manipulateF(
383  "DELETE FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s",
384  ['integer'],
385  [$question_id]
386  );
387  }
ensurePageObjectDeleted(string $page_object_type, int $page_object_id)
getGenericFeedbackPageObjectId(int $question_id, bool $solution_completed)
returns a useable page object id for generic feedback page objects for the given question id for eith...
+ Here is the call graph for this function:

◆ deleteSpecificAnswerFeedbacks()

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

Referenced by deleteGenericFeedbacks().

+ Here is the caller graph for this function:

◆ duplicateFeedback()

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

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

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

References cloneSpecificFeedback(), and duplicateGenericFeedback().

395  : void
396  {
397  $this->duplicateGenericFeedback($originalQuestionId, $duplicateQuestionId);
398  $this->cloneSpecificFeedback($originalQuestionId, $duplicateQuestionId);
399  }
cloneSpecificFeedback(int $originalQuestionId, int $duplicateQuestionId)
duplicates the SPECIFIC feedback relating to the given original question id and saves it for the give...
duplicateGenericFeedback(int $originalQuestionId, int $duplicateQuestionId)
duplicates the GENERIC feedback relating to the given original question id and saves it for the given...
+ Here is the call graph for this function:

◆ duplicateGenericFeedback()

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

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

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

References $res, clonePageObject(), cloneSpecificFeedback(), getGenericFeedbackPageObjectType(), and getGenericFeedbackTableName().

Referenced by duplicateFeedback().

405  : void
406  {
407  $res = $this->db->queryF(
408  "SELECT * FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s",
409  ['integer'],
410  [$originalQuestionId]
411  );
412 
413  while ($row = $this->db->fetchAssoc($res)) {
414  $feedbackId = $this->db->nextId($this->getGenericFeedbackTableName());
415 
416  $this->db->insert($this->getGenericFeedbackTableName(), [
417  'feedback_id' => ['integer', $feedbackId],
418  'question_fi' => ['integer', $duplicateQuestionId],
419  'correctness' => ['text', $row['correctness']],
420  'feedback' => ['clob', $row['feedback']],
421  'tstamp' => ['integer', time()]
422  ]);
423 
424  if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
425  $page_object_type = $this->getGenericFeedbackPageObjectType();
426  $this->clonePageObject($page_object_type, $row['feedback_id'], $feedbackId, $duplicateQuestionId);
427  }
428  }
429  }
clonePageObject(string $page_object_type, int $source_page_object_id, int $target_page_object_id, int $target_page_object_parent_id)
$res
Definition: ltiservices.php:66
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ ensurePageObjectDeleted()

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

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

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

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

648  : void
649  {
651  if (ilAssGenFeedbackPage::_exists($page_object_type, $page_object_id)) {
652  $pageObject = new ilAssGenFeedbackPage($page_object_id);
653  $pageObject->delete();
654  }
655  }
657  if (ilAssSpecFeedbackPage::_exists($page_object_type, $page_object_id)) {
658  $pageObject = new ilAssSpecFeedbackPage($page_object_id);
659  $pageObject->delete();
660  }
661  }
662  }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static _exists(string $a_parent_type, int $a_id, string $a_lang="", bool $a_no_cache=false)
Checks whether page exists.
const PAGE_OBJECT_TYPE_GENERIC_FEEDBACK
type for generic feedback page objects
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
const PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK
type for specific feedback page objects
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ ensurePageObjectExists()

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

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

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

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

602  : void
603  {
605  && !ilAssGenFeedbackPage::_exists($page_object_type, $page_object_id, '', true)) {
606  $pageObject = new ilAssGenFeedbackPage();
607  $pageObject->setParentId($this->questionOBJ->getId());
608  $pageObject->setId($page_object_id);
609  $pageObject->createFromXML();
610  }
612  && !ilAssSpecFeedbackPage::_exists($page_object_type, $page_object_id, '', true)) {
613  $pageObject = new ilAssSpecFeedbackPage();
614  $pageObject->setParentId($this->questionOBJ->getId());
615  $pageObject->setId($page_object_id);
616  $pageObject->createFromXML();
617  }
618  }
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
static _exists(string $a_parent_type, int $a_id, string $a_lang="", bool $a_no_cache=false)
Checks whether page exists.
const PAGE_OBJECT_TYPE_GENERIC_FEEDBACK
type for generic feedback page objects
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
const PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK
type for specific feedback page objects
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getAllSpecificAnswerFeedbackContents()

ilAssQuestionFeedback::getAllSpecificAnswerFeedbackContents ( int  $question_id)
abstract

Referenced by getGenericFeedbackContent().

+ Here is the caller graph for this function:

◆ getClassNameByType()

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

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

References PAGE_OBJECT_TYPE_GENERIC_FEEDBACK.

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

548  : string
549  {
550  $gui = ($a_gui) ? "GUI" : "";
551 
553  return "ilAssGenFeedbackPage" . $gui;
554  }
555 
556  //if ($a_type == ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK) {
557  return "ilAssSpecFeedbackPage" . $gui;
558  }
const PAGE_OBJECT_TYPE_GENERIC_FEEDBACK
type for generic feedback page objects
+ Here is the caller graph for this function:

◆ getGenericFeedbackContent()

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

returns the GENERIC feedback content for a given question state.

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

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

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

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

274  : string
275  {
276  $res = $this->db->queryF(
277  "SELECT * FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s AND correctness = %s",
278  ['integer', 'text'],
279  [$question_id, (int) $solution_completed]
280  );
281 
282  $feedback_content = '';
283 
284  if ($this->db->numRows($res) > 0) {
285  $row = $this->db->fetchAssoc($res);
286  $feedback_content = ilRTE::_replaceMediaObjectImageSrc(
287  $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($row['feedback'] ?? ''),
288  1
289  );
290  }
291  return $feedback_content;
292  }
static _replaceMediaObjectImageSrc(string $a_text, int $a_direction=0, string $nic='')
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
$res
Definition: ltiservices.php:66
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getGenericFeedbackExportPresentation()

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

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

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

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

704  : string
705  {
706  if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
707  $genericFeedbackExportPresentation = $this->getPageObjectXML(
709  $this->getGenericFeedbackPageObjectId($question_id, $solution_completed)
710  );
711  } else {
712  $genericFeedbackExportPresentation = $this->getGenericFeedbackContent($question_id, $solution_completed);
713  }
714 
715  return $genericFeedbackExportPresentation;
716  }
getPageObjectXML(string $page_object_type, int $page_object_id)
getGenericFeedbackContent(int $question_id, bool $solution_completed)
returns the GENERIC feedback content for a given question state.
getGenericFeedbackPageObjectId(int $question_id, bool $solution_completed)
returns a useable page object id for generic feedback page objects for the given question id for eith...
+ Here is the call graph for this function:

◆ getGenericFeedbackId()

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

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

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

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

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

482  : int
483  {
484  $res = $this->db->queryF(
485  "SELECT feedback_id FROM {$this->getGenericFeedbackTableName()} WHERE question_fi = %s AND correctness = %s",
486  ['integer','text'],
487  [$question_id, (int) $solution_completed]
488  );
489 
490  $feedbackId = -1;
491  if ($this->db->numRows($res)) {
492  $row = $this->db->fetchAssoc($res);
493  $feedbackId = (int) $row['feedback_id'];
494  }
495 
496  return $feedbackId;
497  }
$res
Definition: ltiservices.php:66
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getGenericFeedbackPageObjectId()

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

returns a useable page object id for generic feedback page objects for the given question id for either the complete or incomplete solution (using the id sequence of non page object generic feedback)

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

References getGenericFeedbackId().

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

694  : int
695  {
696  $page_object_id = $this->getGenericFeedbackId($question_id, $solution_completed);
697  return $page_object_id;
698  }
getGenericFeedbackId(int $question_id, bool $solution_completed)
returns the SPECIFIC answer feedback ID for a given question id and answer index. ...
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getGenericFeedbackPageObjectType()

ilAssQuestionFeedback::getGenericFeedbackPageObjectType ( )
finalprotected

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

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

664  : string
665  {
666  return self::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK;
667  }
+ Here is the caller graph for this function:

◆ getGenericFeedbackTableName()

ilAssQuestionFeedback::getGenericFeedbackTableName ( )
finalprotected

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

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

527  : string
528  {
529  return self::TABLE_NAME_GENERIC_FEEDBACK;
530  }
+ Here is the caller graph for this function:

◆ getGenericFeedbackTestPresentation()

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

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

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

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

88  : string
89  {
90  if ($this->page_obj_output_mode == "edit") {
91  return '';
92  }
93  if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
94  return $this->cleanupPageContent(
95  $this->getPageObjectContent(
97  $this->getGenericFeedbackPageObjectId($question_id, $solution_completed)
98  )
99  );
100  }
101  return $this->getGenericFeedbackContent($question_id, $solution_completed);
102  }
getGenericFeedbackContent(int $question_id, bool $solution_completed)
returns the GENERIC feedback content for a given question state.
getGenericFeedbackPageObjectId(int $question_id, bool $solution_completed)
returns a useable page object id for generic feedback page objects for the given question id for eith...
+ Here is the call graph for this function:

◆ getPageObjectEditingLink()

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

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

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

Referenced by createFeedbackPages(), and getPageObjectNonEditableValueHTML().

560  : string
561  {
562  $cl = $this->getClassNameByType($page_object_type, true);
563  $this->ctrl->setParameterByClass($cl, 'feedback_type', $page_object_type);
564  $this->ctrl->setParameterByClass($cl, 'feedback_id', $page_object_id);
565 
566  return $this->ctrl->getLinkTargetByClass($cl, 'edit');
567  }
getClassNameByType(string $a_type, bool $a_gui=false)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getPageObjectNonEditableValueHTML()

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

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

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

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

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

536  : string
537  {
538  $link = $this->getPageObjectEditingLink($page_object_type, $page_object_id);
539  $content = $this->getPageObjectContent($page_object_type, $page_object_id);
540  return sprintf(
541  '<a href="%s">%s</a><br /><br />%s',
542  $link,
543  $this->lng->txt('tst_question_feedback_edit_page'),
544  $content
545  );
546  }
getPageObjectEditingLink(string $page_object_type, int $page_object_id)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getPageObjectOutputMode()

ilAssQuestionFeedback::getPageObjectOutputMode ( )
final

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

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

574  : string
575  {
577  }
+ Here is the call graph for this function:

◆ getPageObjectXML()

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

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

References ensurePageObjectExists(), and getClassNameByType().

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

592  : string
593  {
594  $cl = $this->getClassNameByType($page_object_type);
595 
596  $this->ensurePageObjectExists($page_object_type, $page_object_id);
597 
598  $pageObject = new $cl($page_object_id);
599  return $pageObject->getXMLContent();
600  }
ensurePageObjectExists(string $page_object_type, int $page_object_id)
getClassNameByType(string $a_type, bool $a_gui=false)
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackContent()

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

Referenced by getGenericFeedbackContent().

+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackExportPresentation()

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

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

Referenced by getGenericFeedbackExportPresentation(), and isSpecificAnswerFeedbackAvailable().

+ Here is the caller graph for this function:

◆ getSpecificAnswerFeedbackPageObjectType()

◆ getSpecificAnswerFeedbackTestPresentation()

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

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

public

Parameters
integer$question_id
integer$question_index
integer$answer_index
Returns
string $specificAnswerFeedbackTestPresentationHTML

Referenced by getGenericFeedbackTestPresentation().

+ Here is the caller graph for this function:

◆ importGenericFeedback()

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

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

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

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

728  : void
729  {
730  if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
731  $page_object_id = $this->saveGenericFeedbackContent($question_id, $solution_completed, '');
732  $page_object_type = $this->getGenericFeedbackPageObjectType();
733 
734  $this->createPageObject($page_object_type, $page_object_id, $feedback_content);
735  } else {
736  $this->saveGenericFeedbackContent($question_id, $solution_completed, $feedback_content);
737  }
738  }
saveGenericFeedbackContent(int $question_id, bool $solution_completed, string $feedback_content)
saves GENERIC feedback content for the given question id to the database.
createPageObject(string $page_object_type, int $page_object_id, string $page_object_content)
+ Here is the call graph for this function:

◆ importSpecificAnswerFeedback()

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

Referenced by importGenericFeedback().

+ Here is the caller graph for this function:

◆ initGenericFormProperties()

ilAssQuestionFeedback::initGenericFormProperties ( ilPropertyFormGUI  $form)
final

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

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

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

150  : void
151  {
152  if ($this->questionOBJ->isAdditionalContentEditingModePageObject()) {
153  $page_object_type = $this->getGenericFeedbackPageObjectType();
154 
155  $page_object_id = $this->getGenericFeedbackId($this->questionOBJ->getId(), true);
156 
157  if ($page_object_id === -1) {
158  $this->ctrl->setParameterByClass(ilAssQuestionFeedbackEditingGUI::class, 'feedback_type', $page_object_type);
159  $this->ctrl->setParameterByClass(ilAssQuestionFeedbackEditingGUI::class, 'fb_mode', 'complete');
160  $link = $this->ctrl->getLinkTargetByClass(ilAssQuestionFeedbackEditingGUI::class, 'createFeedbackPage');
161  $value_feedback_solution_complete = sprintf(
162  '<a href="%s">%s</a>',
163  $link,
164  $this->lng->txt('tst_question_feedback_edit_page')
165  );
166  $this->ctrl->setParameterByClass(ilAssQuestionFeedbackEditingGUI::class, 'fb_mode', 'incomplete');
167  $link = $this->ctrl->getLinkTargetByClass(ilAssQuestionFeedbackEditingGUI::class, 'createFeedbackPage');
168  $value_feedback_solution_incomplete = sprintf(
169  '<a href="%s">%s</a>',
170  $link,
171  $this->lng->txt('tst_question_feedback_edit_page')
172  );
173  } else {
174  $this->ensurePageObjectExists($page_object_type, $page_object_id);
175 
176  $value_feedback_solution_complete = $this->getPageObjectNonEditableValueHTML(
177  $page_object_type,
178  $this->getGenericFeedbackPageObjectId($this->questionOBJ->getId(), true)
179  );
180  $value_feedback_solution_incomplete = $this->getPageObjectNonEditableValueHTML(
181  $page_object_type,
182  $this->getGenericFeedbackPageObjectId($this->questionOBJ->getId(), false)
183  );
184  }
185 
186  } else {
187  $value_feedback_solution_complete = $this->getGenericFeedbackContent(
188  $this->questionOBJ->getId(),
189  true
190  );
191 
192  $value_feedback_solution_incomplete = $this->getGenericFeedbackContent(
193  $this->questionOBJ->getId(),
194  false
195  );
196  }
197 
198  $form->getItemByPostVar('feedback_complete')->setValue($value_feedback_solution_complete);
199  $form->getItemByPostVar('feedback_incomplete')->setValue($value_feedback_solution_incomplete);
200  }
ensurePageObjectExists(string $page_object_type, int $page_object_id)
getItemByPostVar(string $a_post_var)
getGenericFeedbackContent(int $question_id, bool $solution_completed)
returns the GENERIC feedback content for a given question state.
getPageObjectNonEditableValueHTML(string $page_object_type, int $page_object_id)
returns html content to be used as value for non editable value form properties in feedback editing f...
getGenericFeedbackId(int $question_id, bool $solution_completed)
returns the SPECIFIC answer feedback ID for a given question id and answer index. ...
getGenericFeedbackPageObjectId(int $question_id, bool $solution_completed)
returns a useable page object id for generic feedback page objects for the given question id for eith...
+ Here is the call graph for this function:

◆ initSpecificFormProperties()

ilAssQuestionFeedback::initSpecificFormProperties ( ilPropertyFormGUI  $form)
abstract

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

Referenced by initGenericFormProperties().

+ Here is the caller graph for this function:

◆ isGenericFeedbackId()

ilAssQuestionFeedback::isGenericFeedbackId ( int  $feedbackId)
protected

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

References isSpecificAnswerFeedbackId().

Referenced by checkFeedbackParent().

499  : bool
500  {
501  $row = $this->db->fetchAssoc($this->db->queryF(
502  "SELECT COUNT(feedback_id) cnt FROM {$this->getGenericFeedbackTableName()}
503  WHERE question_fi = %s AND feedback_id = %s",
504  ['integer','integer'],
505  [$this->questionOBJ->getId(), $feedbackId]
506  ));
507 
508 
509  return (bool) $row['cnt'];
510  }
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ isSaveableInPageObjectEditingMode()

ilAssQuestionFeedback::isSaveableInPageObjectEditingMode ( )

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

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

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

231  : bool
232  {
233  return false;
234  }

◆ isSpecificAnswerFeedbackAvailable()

ilAssQuestionFeedback::isSpecificAnswerFeedbackAvailable ( int  $question_id)

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

References $res, and getSpecificAnswerFeedbackExportPresentation().

298  : bool
299  {
300  $res = $this->db->queryF(
301  "SELECT answer FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
302  ['integer'],
303  [$question_id]
304  );
305 
306  $all_feedback_contents = '';
307 
308  while ($row = $this->db->fetchAssoc($res)) {
309  $all_feedback_contents .= $this->getSpecificAnswerFeedbackExportPresentation(
310  $this->questionOBJ->getId(),
311  0,
312  $row['answer']
313  );
314  }
315 
316  return trim(strip_tags($all_feedback_contents)) !== '';
317  }
$res
Definition: ltiservices.php:66
getSpecificAnswerFeedbackExportPresentation(int $question_id, int $question_index, int $answer_index)
returns the generic feedback export presentation for given question id either for solution completed ...
+ Here is the call graph for this function:

◆ isSpecificAnswerFeedbackId()

ilAssQuestionFeedback::isSpecificAnswerFeedbackId ( int  $feedbackId)
abstractprotected

Referenced by checkFeedbackParent(), and isGenericFeedbackId().

+ Here is the caller graph for this function:

◆ isValidFeedbackPageObjectType()

static ilAssQuestionFeedback::isValidFeedbackPageObjectType ( string  $feedbackPageObjectType)
staticfinal

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

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

Referenced by ilAssQuestionFeedbackPageObjectCommandForwarder\__construct().

678  : bool
679  {
680  switch ($feedbackPageObjectType) {
681  case self::PAGE_OBJECT_TYPE_GENERIC_FEEDBACK:
682  case self::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK:
683  return true;
684  }
685 
686  return false;
687  }
+ Here is the caller graph for this function:

◆ migrateContentForLearningModule()

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

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

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

742  : void
743  {
744  $this->saveGenericFeedbackContent($question_id, true, $migrator->migrateToLmContent(
745  $this->getGenericFeedbackContent($question_id, true)
746  ));
747 
748  $this->saveGenericFeedbackContent($question_id, false, $migrator->migrateToLmContent(
749  $this->getGenericFeedbackContent($question_id, false)
750  ));
751  }
saveGenericFeedbackContent(int $question_id, bool $solution_completed, string $feedback_content)
saves GENERIC feedback content for the given question id to the database.
+ Here is the call graph for this function:

◆ saveGenericFeedbackContent()

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

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

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

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

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

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

324  : int
325  {
326  $feedbackId = $this->getGenericFeedbackId($question_id, $solution_completed);
327 
328  if ($feedback_content !== '') {
329  $feedback_content = $this->questionOBJ->getHtmlQuestionContentPurifier()->purify($feedback_content);
330  $feedback_content = ilRTE::_replaceMediaObjectImageSrc($feedback_content, 0);
331  }
332 
333  if ($feedbackId !== -1) {
334  $this->db->update(
336  [
337  'feedback' => ['clob', $feedback_content],
338  'tstamp' => ['integer', time()]
339  ],
340  [
341  'feedback_id' => ['integer', $feedbackId]
342  ]
343  );
344  } else {
345  $feedbackId = $this->db->nextId($this->getGenericFeedbackTableName());
346 
347  $this->db->insert($this->getGenericFeedbackTableName(), [
348  'feedback_id' => ['integer', $feedbackId],
349  'question_fi' => ['integer', $question_id],
350  'correctness' => ['text', (int) $solution_completed], // text ?
351  'feedback' => ['clob', $feedback_content],
352  'tstamp' => ['integer', time()]
353  ]);
354  }
355 
356  return $feedbackId;
357  }
static _replaceMediaObjectImageSrc(string $a_text, int $a_direction=0, string $nic='')
Replaces image source from mob image urls with the mob id or replaces mob id with the correct image s...
getGenericFeedbackId(int $question_id, bool $solution_completed)
returns the SPECIFIC answer feedback ID for a given question id and answer index. ...
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ saveGenericFormProperties()

ilAssQuestionFeedback::saveGenericFormProperties ( ilPropertyFormGUI  $form)
final

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

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

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

212  : void
213  {
214  if (!$this->questionOBJ->isAdditionalContentEditingModePageObject()) {
215  $this->saveGenericFeedbackContent($this->questionOBJ->getId(), false, (string) $form->getInput('feedback_incomplete'));
216  $this->saveGenericFeedbackContent($this->questionOBJ->getId(), true, (string) $form->getInput('feedback_complete'));
217  }
218  }
saveGenericFeedbackContent(int $question_id, bool $solution_completed, string $feedback_content)
saves GENERIC feedback content for the given question id to the database.
getInput(string $a_post_var, bool $ensureValidation=true)
Returns the input of an item, if item provides getInput method and as fallback the value of the HTTP-...
+ Here is the call graph for this function:

◆ saveSpecificAnswerFeedbackContent()

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

Referenced by saveGenericFeedbackContent().

+ Here is the caller graph for this function:

◆ saveSpecificFormProperties()

ilAssQuestionFeedback::saveSpecificFormProperties ( ilPropertyFormGUI  $form)
abstract

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

Referenced by saveGenericFormProperties().

+ Here is the caller graph for this function:

◆ setPageObjectOutputMode()

ilAssQuestionFeedback::setPageObjectOutputMode ( string  $page_obj_output_mode)
final

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

References $page_obj_output_mode.

569  : void
570  {
571  $this->page_obj_output_mode = $page_obj_output_mode;
572  }

Field Documentation

◆ $ctrl

ilCtrl ilAssQuestionFeedback::$ctrl
protected

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

Referenced by __construct().

◆ $db

ilDBInterface ilAssQuestionFeedback::$db
protected

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

Referenced by __construct().

◆ $lng

ilLanguage ilAssQuestionFeedback::$lng
protected

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

Referenced by __construct().

◆ $page_obj_output_mode

string ilAssQuestionFeedback::$page_obj_output_mode = "presentation"
protected

◆ $questionOBJ

assQuestion ilAssQuestionFeedback::$questionOBJ
protected

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

Referenced by __construct().

◆ CSS_CLASS_FEEDBACK_CORRECT

◆ CSS_CLASS_FEEDBACK_WRONG

◆ FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID

const ilAssQuestionFeedback::FEEDBACK_SOLUTION_COMPLETE_PAGE_OBJECT_ID = 2

id for page object relating to generic complete solution feedback

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

◆ FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID

const ilAssQuestionFeedback::FEEDBACK_SOLUTION_INCOMPLETE_PAGE_OBJECT_ID = 1

id for page object relating to generic incomplete solution feedback

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

◆ PAGE_OBJECT_TYPE_GENERIC_FEEDBACK

◆ PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK

const ilAssQuestionFeedback::PAGE_OBJECT_TYPE_SPECIFIC_FEEDBACK = 'qfbs'

◆ TABLE_NAME_GENERIC_FEEDBACK

const ilAssQuestionFeedback::TABLE_NAME_GENERIC_FEEDBACK = 'qpl_fb_generic'

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


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