class.exTestPlayerGUI.php

Go to the documentation of this file.

<?php
 
class exTestPlayerGUI
{
    public function showQuestion()
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
        
        $questionId = 0; // initialise with id of question to be shown
        
        $participantSolution = $this->getParticipantSolution($questionId);
        
        $questionInstance = $DIC->question()->getQuestionInstance($questionId);
        $questionPresentationGUI = $DIC->question()->getQuestionPresentationInstance($questionInstance);
        
        $questionNavigationAware; /* @var ilAsqQuestionNavigationAware $questionNavigationAware */
        $questionPresentationGUI->setQuestionNavigation($questionNavigationAware);
        
        $questionPresentationGUI->setRenderPurpose(ilAsqQuestionPresentation::RENDER_PURPOSE_PLAYBACK);
        
        if ($participantSolutionLocked = false) {
            $renderer = $questionPresentationGUI->getSolutionPresentation($participantSolution);
        } else {
            $renderer = $questionPresentationGUI->getQuestionPresentation($participantSolution);
        }
        
        $playerQstPageHTML = $renderer->getContent();
        
        if ($showFeedbacks = true && !$participantSolution->isEmpty()) {
            $genericFeedbackRenderer = $questionPresentationGUI->getGenericFeedbackOutput($participantSolution);
            $playerQstPageHTML .= $genericFeedbackRenderer->getContent();
            
            $specificFeedbackRenderer = $questionPresentationGUI->getSpecificFeedbackOutput($participantSolution);
            $playerQstPageHTML .= $specificFeedbackRenderer->getContent();
        }
        
        if ($showBestSolution = true) {
            $renderer = $questionPresentationGUI->getSolutionPresentation(
                $questionInstance->getBestSolution()
            );
            
            $playerQstPageHTML .= $renderer->getContent();
        }
        
        $playerQstPageHTML; // complete question page html
    }
    
    public function submitSolution()
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
        
        // this can also be $_REQUEST or any other future ilias post-request handler
        $serverRequestObject; /* @var \Psr\Http\Message\ServerRequestInterface $serverRequestObject */
        
        $questionId = 0; // initialise with id of question that just submits
        
        $participantSolution = $this->getParticipantSolution($questionId);
        
        $participantSolution->initFromServerRequest($serverRequestObject);
        
        $questionInstance = $DIC->question()->getQuestionInstance($questionId);
        $solutionInstance = $this->getParticipantSolution($questionId);
        $resultCalculator = $DIC->question()->getResultCalculator($questionInstance, $solutionInstance);
        
        $resultInstance = $resultCalculator->calculate();
        
        // can be stored in any ilTestResult object managed by the test
        $reachedPoints = $resultInstance->getPoints();
        
        // can be used to differ answer status in CTM's test sequence
        $isCorrect = $resultInstance->isCorrect();
    }
    
    public function getParticipantSolution($questionId)
    {
        global $DIC; /* @var ILIAS\DI\Container $DIC */
        
        $solutionId = 0;
        
        if ($solutionId) {
            return $DIC->question()->getQuestionSolutionInstance($questionId, $solutionId);
        }
        
        return $DIC->question()->getEmptyQuestionSolutionInstance($questionId);
    }
}