class.ilTestRandomQuestionSetConfigStateMessageHandler.php

Go to the documentation of this file.

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


class ilTestRandomQuestionSetConfigStateMessageHandler
{
    protected $lng;

    protected $ctrl;

    protected $targetGUI;

    const CONTEXT_GENERAL_CONFIG = 'generalConfigContext';
    const CONTEXT_POOL_SELECTION = 'poolSelectionContext';

    protected $context;

    protected $participantDataExists;

    protected $lostPools;

    protected $questionSetConfig;

    protected $validationFailed;
    
    protected $validationReports;
    
    public function __construct(ilLanguage $lng, ilCtrl $ctrl)
    {
        $this->lng = $lng;
        $this->ctrl = $ctrl;
        $this->validationFailed = false;
        $this->validationReports = array();
    }

    public function getLostPools()
    {
        return $this->lostPools;
    }

    public function setLostPools($lostPools)
    {
        $this->lostPools = $lostPools;
    }

    public function doesParticipantDataExists()
    {
        return $this->participantDataExists;
    }

    public function setParticipantDataExists($participantDataExists)
    {
        $this->participantDataExists = $participantDataExists;
    }

    public function getTargetGUI()
    {
        return $this->targetGUI;
    }

    public function setTargetGUI($targetGUI)
    {
        $this->targetGUI = $targetGUI;
    }
    
    public function getContext()
    {
        return $this->context;
    }

    public function setContext($context)
    {
        $this->context = $context;
    }

    public function getQuestionSetConfig()
    {
        return $this->questionSetConfig;
    }

    public function setQuestionSetConfig($questionSetConfig)
    {
        $this->questionSetConfig = $questionSetConfig;
    }

    public function isValidationFailed()
    {
        return $this->validationFailed;
    }

    public function setValidationFailed($validationFailed)
    {
        $this->validationFailed = $validationFailed;
    }
    
    public function getValidationReportHtml()
    {
        return implode('<br />', $this->validationReports);
    }
    
    public function hasValidationReports()
    {
        return count($this->validationReports);
    }
    
    public function addValidationReport($validationReport)
    {
        $this->validationReports[] = $validationReport;
    }

    public function handle()
    {
        if ($this->isNoAvailableQuestionPoolsHintRequired()) {
            $this->addValidationReport($this->lng->txt('tst_msg_rand_quest_set_no_pools_available'));
        } elseif ($this->getLostPools()) {
            $this->addValidationReport($this->buildLostPoolsReport());
        } elseif (!$this->questionSetConfig->isQuestionAmountConfigComplete()) {
            $this->addValidationReport($this->lng->txt('tst_msg_rand_quest_set_incomplete_quest_amount_cfg'));

            if ($this->isQuestionAmountConfigPerTestHintRequired()) {
                $this->addValidationReport(
                    sprintf(
                    $this->lng->txt('tst_msg_rand_quest_set_change_quest_amount_here'),
                    $this->buildGeneralConfigSubTabLink()
                )
                );
            } elseif ($this->isQuestionAmountConfigPerPoolHintRequired()) {
                $this->addValidationReport(
                    sprintf(
                    $this->lng->txt('tst_msg_rand_quest_set_change_quest_amount_here'),
                    $this->buildQuestionSelectionSubTabLink()
                )
                );
            }
        } elseif (!$this->questionSetConfig->hasSourcePoolDefinitions()) {
            $this->addValidationReport($this->lng->txt('tst_msg_rand_quest_set_no_src_pool_defs'));
        }
        // fau: delayCopyRandomQuestions - show info message if date of last synchronisation is empty
        elseif ($this->questionSetConfig->getLastQuestionSyncTimestamp() == 0) {
            $this->addValidationReport($this->lng->txt('tst_msg_rand_quest_set_not_sync'));
            $this->addValidationReport("<br />{$this->buildQuestionStageRebuildLink()}");
            $this->addValidationReport("<br><small>" . $this->lng->txt('tst_msg_rand_quest_set_sync_duration') . "</small>");
        }
        // fau.

        elseif (!$this->questionSetConfig->isQuestionSetBuildable()) {
            $this->setValidationFailed(true);
            $this->addValidationReport($this->lng->txt('tst_msg_rand_quest_set_pass_not_buildable'));

            //fau: fixRandomTestBuildable - show the messages if set is not buildable
            $this->addValidationReport(implode('<br />', $this->questionSetConfig->getBuildableMessages()));
        //fau.
        } else {
            //fau: fixRandomTestBuildable - show the messages if set is buildable but messages exist
            #if (count($this->questionSetConfig->getBuildableMessages()))
            #{
            //$this->setValidationFailed(true);

            // REALLY REQUIRED !?? vielleicht doch?
            //ilUtil::sendFailure(implode('<br />', $this->questionSetConfig->getBuildableMessages()));
            #}
            //fau.
            
            $this->addValidationReport($this->lng->txt('tst_msg_rand_quest_set_pass_buildable'));
            
            if ($this->questionSetConfig->getLastQuestionSyncTimestamp()) {
                $syncDate = new ilDateTime(
                    $this->questionSetConfig->getLastQuestionSyncTimestamp(),
                    IL_CAL_UNIX
                );
                
                $this->addValidationReport(sprintf(
                    $this->lng->txt('tst_msg_rand_quest_set_stage_pool_last_sync'),
                    ilDatePresentation::formatDate($syncDate)
                ));
            }

            if (!$this->doesParticipantDataExists() && !$this->getLostPools()) {
                $this->addValidationReport($this->buildQuestionStageRebuildLink());
            }
        }
    }
    
    private function buildLostQuestionPoolsString()
    {
        $titles = array();
        
        foreach ($this->getLostPools() as $lostPool) {
            $titles[] = $lostPool->getTitle();
        }
        
        return implode(', ', $titles);
    }
    
    private function getAfterRebuildQuestionStageCommand()
    {
        switch ($this->getContext()) {
            case self::CONTEXT_POOL_SELECTION:
                
                return ilTestRandomQuestionSetConfigGUI::CMD_SHOW_SRC_POOL_DEF_LIST;
                
            case self::CONTEXT_GENERAL_CONFIG:
            default:

                return ilTestRandomQuestionSetConfigGUI::CMD_SHOW_GENERAL_CONFIG_FORM;
        }
    }

    private function buildQuestionStageRebuildLink()
    {
        $this->ctrl->setParameter(
            $this->getTargetGUI(),
            ilTestRandomQuestionSetConfigGUI::HTTP_PARAM_AFTER_REBUILD_QUESTION_STAGE_CMD,
            $this->getAfterRebuildQuestionStageCommand()
        );

        $href = $this->ctrl->getLinkTarget(
            $this->getTargetGUI(),
            ilTestRandomQuestionSetConfigGUI::CMD_BUILD_QUESTION_STAGE
        );
        $label = $this->lng->txt('tst_btn_rebuild_random_question_stage');

        return "<a href=\"{$href}\">{$label}</a>";
    }

    private function buildGeneralConfigSubTabLink()
    {
        $href = $this->ctrl->getLinkTarget(
            $this->getTargetGUI(),
            ilTestRandomQuestionSetConfigGUI::CMD_SHOW_GENERAL_CONFIG_FORM
        );
        
        $label = $this->lng->txt('tst_rnd_quest_cfg_tab_general');

        return "<a href=\"{$href}\">{$label}</a>";
    }

    private function buildQuestionSelectionSubTabLink()
    {
        $href = $this->ctrl->getLinkTarget(
            $this->getTargetGUI(),
            ilTestRandomQuestionSetConfigGUI::CMD_SHOW_SRC_POOL_DEF_LIST
        );
        
        $label = $this->lng->txt('tst_rnd_quest_cfg_tab_pool');

        return "<a href=\"{$href}\">{$label}</a>";
    }

    private function isNoAvailableQuestionPoolsHintRequired()
    {
        if ($this->getContext() != self::CONTEXT_POOL_SELECTION) {
            return false;
        }

        if ($this->questionSetConfig->doesSelectableQuestionPoolsExist()) {
            return false;
        }

        return true;
    }

    private function isQuestionAmountConfigPerPoolHintRequired()
    {
        if ($this->getContext() != self::CONTEXT_GENERAL_CONFIG) {
            return false;
        }

        if (!$this->questionSetConfig->isQuestionAmountConfigurationModePerPool()) {
            return false;
        }

        return true;
    }

    private function isQuestionAmountConfigPerTestHintRequired()
    {
        if ($this->getContext() != self::CONTEXT_POOL_SELECTION) {
            return false;
        }

        if (!$this->questionSetConfig->isQuestionAmountConfigurationModePerTest()) {
            return false;
        }

        return true;
    }
    
    protected function buildLostPoolsReport()
    {
        $report = sprintf(
            $this->lng->txt('tst_msg_rand_quest_set_lost_pools'),
            $this->buildLostQuestionPoolsString()
        );
        
        if ($this->getContext() == self::CONTEXT_GENERAL_CONFIG) {
            $report .= '<br /><br />' . sprintf(
                $this->lng->txt('tst_msg_rand_quest_set_lost_pools_link'),
                $this->buildQuestionPoolsTabLink()
            );
        }
        
        return $report;
    }
    
    protected function buildQuestionPoolsTabLink()
    {
        $href = $this->ctrl->getLinkTarget(
            $this->getTargetGUI(),
            ilTestRandomQuestionSetConfigGUI::CMD_SHOW_SRC_POOL_DEF_LIST
        );
        
        $label = $this->getTargetGUI()->getPoolConfigTabLabel();
        
        return "<a href=\"{$href}\">{$label}</a>";
    }
}