class.ilAssConfigurableMultiOptionQuestionFeedback.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */

require_once 'Modules/TestQuestionPool/classes/feedback/class.ilAssMultiOptionQuestionFeedback.php';

abstract class ilAssConfigurableMultiOptionQuestionFeedback extends ilAssMultiOptionQuestionFeedback
{
        const FEEDBACK_SETTING_ALL = 1;
        const FEEDBACK_SETTING_CHECKED = 2;
        const FEEDBACK_SETTING_CORRECT = 3;

        abstract protected function getSpecificQuestionTableName();

        public function completeSpecificFormProperties(ilPropertyFormGUI $form)
        {
                if( !$this->questionOBJ->getSelfAssessmentEditingMode() )
                {
                        $header = new ilFormSectionHeaderGUI();
                        $header->setTitle($this->lng->txt('feedback_answers'));
                        $form->addItem($header);

                        require_once './Services/Form/classes/class.ilRadioGroupInputGUI.php';
                        require_once './Services/Form/classes/class.ilRadioOption.php';

                        $feedback = new ilRadioGroupInputGUI($this->lng->txt('feedback_setting'), 'feedback_setting');
                        $feedback->addOption(
                                new ilRadioOption($this->lng->txt('feedback_all'), self::FEEDBACK_SETTING_ALL), true
                        );
                        $feedback->addOption(
                                new ilRadioOption($this->lng->txt('feedback_checked'), self::FEEDBACK_SETTING_CHECKED)
                        );
                        $feedback->addOption(
                                new ilRadioOption($this->lng->txt($this->questionOBJ->getSpecificFeedbackAllCorrectOptionLabel()), self::FEEDBACK_SETTING_CORRECT)
                        );
                        
                        $feedback->setRequired(true);
                        $form->addItem($feedback);

                        foreach( $this->getAnswerOptionsByAnswerIndex() as $index => $answer )
                        {
                                $propertyLabel = $this->questionOBJ->prepareTextareaOutput(
                                        $this->buildAnswerOptionLabel($index, $answer), true
                                );

                                $propertyPostVar = "feedback_answer_$index";

                                $form->addItem($this->buildFeedbackContentFormProperty(
                                        $propertyLabel , $propertyPostVar, $this->questionOBJ->isAdditionalContentEditingModePageObject()
                                ));
                        }
                }
        }

        public function initSpecificFormProperties(ilPropertyFormGUI $form)
        {
                if (!$this->questionOBJ->getSelfAssessmentEditingMode())
                {
                        $form->getItemByPostVar('feedback_setting')->setValue(
                                $this->questionOBJ->getSpecificFeedbackSetting()
                        );

                        foreach( $this->getAnswerOptionsByAnswerIndex() as $index => $answer )
                        {
                                if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
                                {
                                        $value = $this->getPageObjectNonEditableValueHTML(
                                                $this->getSpecificAnswerFeedbackPageObjectType(),
                                                $this->getSpecificAnswerFeedbackPageObjectId($this->questionOBJ->getId(), $index)
                                        );
                                }
                                else
                                {
                                        $value = $this->questionOBJ->prepareTextareaOutput(
                                                $this->getSpecificAnswerFeedbackContent($this->questionOBJ->getId(), $index)
                                        );
                                }

                                $form->getItemByPostVar("feedback_answer_$index")->setValue($value);
                        }
                }
        }

        public function saveSpecificFormProperties(ilPropertyFormGUI $form)
        {
                $this->saveSpecificFeedbackSetting($this->questionOBJ->getId(), $form->getInput('feedback_setting'));
                
                if( !$this->questionOBJ->isAdditionalContentEditingModePageObject() )
                {
                        foreach( $this->getAnswerOptionsByAnswerIndex() as $index => $answer )
                        {
                                $this->saveSpecificAnswerFeedbackContent(
                                        $this->questionOBJ->getId(), $index, $form->getInput("feedback_answer_$index")
                                );
                        }
                }
        }

        public function isSaveableInPageObjectEditingMode()
        {
                return true;
        }

        public function saveSpecificFeedbackSetting($questionId, $specificFeedbackSetting)
        {
                $this->db->update($this->getSpecificQuestionTableName(),
                        array('feedback_setting' => array('integer', $specificFeedbackSetting)),
                        array('question_fi' => array('integer', $questionId))
                );
        }

        protected function duplicateSpecificFeedback($originalQuestionId, $duplicateQuestionId)
        {
                // sync specific feedback setting to duplicated question
                
                $this->syncSpecificFeedbackSetting($originalQuestionId, $duplicateQuestionId);

                // sync specific answer feedback to duplicated question

                $res = $this->db->queryF(
                        "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s", array('integer'), array($originalQuestionId)
                );

                while( $row = $this->db->fetchAssoc($res) )
                {
                        $nextId = $this->db->nextId($this->getSpecificFeedbackTableName());

                        $this->db->insert($this->getSpecificFeedbackTableName(), array(
                                'feedback_id' => array('integer', $nextId),
                                'question_fi' => array('integer', $duplicateQuestionId),
                                'answer' => array('integer', $row['answer']),
                                'feedback' => array('text', $row['feedback']),
                                'tstamp' => array('integer', time())
                        ));

                        if( $this->questionOBJ->isAdditionalContentEditingModePageObject() )
                        {
                                $pageObjectType = $this->getSpecificAnswerFeedbackPageObjectType();
                                $this->duplicatePageObject($pageObjectType, $row['feedback_id'], $nextId, $duplicateQuestionId);
                        }
                }
        }

        protected function syncSpecificFeedback($originalQuestionId, $duplicateQuestionId)
        {
                // sync specific feedback setting to the original
                $this->syncSpecificFeedbackSetting($duplicateQuestionId, $originalQuestionId);

                // delete specific feedback of the original
                $this->db->manipulateF(
                        "DELETE FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
                        array('integer'), array($originalQuestionId)
                );

                // get specific feedback of the actual question
                $res = $this->db->queryF(
                        "SELECT * FROM {$this->getSpecificFeedbackTableName()} WHERE question_fi = %s",
                        array('integer'), array($duplicateQuestionId)
                );

                // save specific feedback to the original
                while( $row = $this->db->fetchAssoc($res) )
                {
                        $nextId = $this->db->nextId($this->getSpecificFeedbackTableName());

                        $this->db->insert($this->getSpecificFeedbackTableName(), array(
                                'feedback_id' => array('integer', $nextId),
                                'question_fi' => array('integer', $originalQuestionId),
                                'answer' => array('integer',$row['answer']),
                                'feedback' => array('text',$row['feedback']),
                                'tstamp' => array('integer',time())
                        ));
                }
        }
        
        private function syncSpecificFeedbackSetting($sourceQuestionId, $targetQuestionId)
        {
                $res = $this->db->queryF(
                        "SELECT feedback_setting FROM {$this->getSpecificQuestionTableName()} WHERE question_fi = %s",
                        array('integer'), array($sourceQuestionId)
                );

                $row = $this->db->fetchAssoc($res);

                $this->db->update( $this->getSpecificQuestionTableName(),
                        array( 'feedback_setting' => array('integer', $row['feedback_setting']) ),
                        array( 'question_fi' => array('integer', $targetQuestionId) )
                );
        }
}