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);
    }
}