ilTestPlayerAbstractGUI Class Reference

Output class for assessment test execution. More...

Inheritance diagram for ilTestPlayerAbstractGUI:

Collaboration diagram for ilTestPlayerAbstractGUI:

Public Member Functions
	__construct (ilObjTest $object)
	saveTagsCmd ()
	Save tags for tagging gui. More...
	updateWorkingTime ()
	updates working time and stores state saveresult to see if question has to be stored or not More...
	removeIntermediateSolution ()
	saveQuestionSolution ($authorized=true, $force=false)
	saves the user input of a question More...
	suspendTestCmd ()
	isMaxProcessingTimeReached ()
	setAnonymousIdCmd ()
	Sets a session variable with the test access code for an anonymous test user. More...
	getLockParameter ()
	displayAccessCodeCmd ()
	accessCodeConfirmedCmd ()
	handleUserSettings ()
	Handles some form parameters on starting and resuming a test. More...
	redirectAfterAutosaveCmd ()
	Redirect the user after an automatic save when the time limit is reached. More...
	redirectAfterQuestionListCmd ()
	autosaveCmd ()
	Automatically save a user answer while working on the test (called repeatedly by asynchronous posts in configured autosave interval) More...
	autosaveOnTimeLimitCmd ()
	Automatically save a user answer when the limited duration of a test run is reached (called by synchronous form submit when the remaining time count down reaches zero) More...
	finishTestCmd ()
	buildFinishTestModal ()
	redirectBackCmd ()
	showFinalStatementCmd ()
	checkOnlineTestAccess ()
	isTestAccessible ()
	test accessible returns true if the user can perform the test More...
	isNrOfTriesReached ()
	nr of tries exceeded More...
	endingTimeReached ()
	handle endingTimeReached More...
	maxProcessingTimeReached ()
	Outputs a message when the maximum processing time is reached. More...
	confirmSubmitAnswers ()
	confirm submit results if confirm then results are submitted and the screen will be redirected to the startpage of the test public More...
	checkWorkingTimeCmd ()
	This is asynchronously called by tpl.workingtime.js to check for changes in the user's processing time for a test. More...
	outQuestionSummaryCmd (bool $obligations_info=false, bool $obligations_filter=false)
	Output of a summary of all test questions for test participants. More...
	outQuestionSummaryWithObligationsInfoCmd ()
	outObligationsOnlySummaryCmd ()
	backFromFinishingCmd ()
	outCorrectSolution ()
	Creates an output of the solution of an answer compared to the correct solution. More...
	showListOfAnswers ($active_id, $pass=null, $top_data="", $bottom_data="")
	Creates an output of the list of answers for a test participant during the test (only the actual pass will be shown) More...
	getContentBlockName ()
	Returns the name of the current content block (depends on the kiosk mode setting) More...
	outUserResultsOverviewCmd ()
Public Member Functions inherited from ilTestServiceGUI
	isContextResultPresentation ()
	setContextResultPresentation (bool $contextResultPresentation)
	setParticipantData (ilTestParticipantData $participantData)
	getParticipantData ()
	getPassOverviewTableData (ilTestSession $testSession, $passes, $withResults)
	This method uses the data of a given test pass to create an evaluation for displaying into a table used in the ilTestEvaluationGUI. More...
	setObjectiveOrientedContainer (ilTestObjectiveOrientedContainer $objective_oriented_container)
	getObjectiveOrientedContainer ()
	executeCommand ()
	execute command More...
	getCommand ($cmd)
	Retrieves the ilCtrl command. More...
	buildPassOverviewTableGUI (ilTestEvaluationGUI $target_gui)
	getPassListOfAnswers (&$result_array, $active_id, $pass, $show_solutions=false, $only_answered_questions=false, $show_question_only=false, $show_reached_points=false, $anchorNav=false, ilTestQuestionRelatedObjectivesList $objectives_list=null, ilTestResultHeaderLabelBuilder $testResultHeaderLabelBuilder=null)
	Returns the list of answers of a users test pass. More...
	getPassListOfAnswersWithScoring (&$result_array, $active_id, $pass, $show_solutions=false)
	Returns the list of answers of a users test pass and offers a scoring option. More...
	getResultsSignature ()
	Returns HTML code for a signature field. More...
	getAdditionalUsrDataHtmlAndPopulateWindowTitle ($testSession, $active_id, $overwrite_anonymity=false)
	Returns the user data for a test results output. More...
	getCorrectSolutionOutput ($question_id, $active_id, $pass, ilTestQuestionRelatedObjectivesList $objectives_list=null)
	Returns an output of the solution to an answer compared to the correct solution. More...
	getResultsOfUserOutput (ilTestSession $testSession, int $active_id, int $pass, ilParticipantsTestResultsGUI $target_gui, bool $show_pass_details=true, bool $show_answers=true, bool $show_question_only=false, bool $show_reached_points=false)
	Output of the pass overview for a test called by a test participant. More...
	getResultsHeadUserAndPass ($active_id, $pass)
	Returns the user and pass data for a test results output. More...
	getQuestionResultForTestUsers (int $question_id, int $test_id)
	getObject ()

Data Fields
const	PRESENTATION_MODE_VIEW = 'view'
const	PRESENTATION_MODE_EDIT = 'edit'
const	FIXED_SHUFFLER_SEED_MIN_LENGTH = 8
bool	$maxProcessingTimeReached
bool	$endingTimeReached
int	$ref_id
const	FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM = 'followup_qst_locks_prevent_confirmation'

Protected Member Functions
	checkReadAccess ()
	checkTestExecutable ()
	checkTestSessionUser (ilTestSession $test_session)
	ensureExistingTestSession (ilTestSession $test_session)
	initProcessLocker ($activeId)
	canSaveResult ()
	determineInlineScoreDisplay ()
	populateTestNavigationToolbar (ilTestNavigationToolbarGUI $toolbar_gui)
	populateQuestionNavigation ($sequence_element, $primary_next)
	populatePreviousButtons ()
	populateNextButtons ($primary_next)
	populateLowerNextButtonBlock ($primary_next)
	populateUpperNextButtonBlock ($primaryNext)
	populateLowerPreviousButtonBlock ()
	populateUpperPreviousButtonBlock ()
	populateSpecificFeedbackBlock (assQuestionGUI $question_gui)
	populateGenericFeedbackBlock (assQuestionGUI $question_gui, $solutionCorrect)
	populateScoreBlock ($reachedPoints, $maxPoints)
	populateSolutionBlock ($solutionoutput)
	populateSyntaxStyleBlock ()
	populateContentStyleBlock ()
	startPlayerCmd ()
	Start a test for the first time. More...
	resumePlayerCmd ()
	Resume a test at the last position. More...
	initTestCmd ()
	Start a test for the first time after a redirect. More...
	redirectAfterFinish ()
	getCurrentQuestionId ()
	detectChangesCmd ()
	Detect changes sent in the background to the server This is called by ajax from ilTestPlayerQuestionEditControl.js It is needed by Java and Flash question and eventually plgin question vtypes. More...
	submitIntermediateSolutionCmd ()
	markQuestionAndSaveIntermediateCmd ()
	markQuestionCmd ()
	Set a question solved. More...
	unmarkQuestionAndSaveIntermediateCmd ()
	unmarkQuestionCmd ()
	Set a question unsolved. More...
	performTestPassFinishedTasks ()
	sendNewPassFinishedNotificationEmailIfActivated (int $active_id, int $pass)
	afterTestPassFinishedCmd ()
	prepareTestPage ($sequenceElement, $questionId)
	isOptionalQuestionAnsweringConfirmationRequired ($sequenceElement)
	isShowingPostponeStatusReguired ($questionId)
	showQuestionViewable (assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)
	showQuestionEditable (assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)
	determineSolutionPassIndex (assQuestionGUI $questionGui)
	showQuestionCmd ()
	editSolutionCmd ()
	submitSolutionCmd ()
	revertChangesCmd ()
	discardSolutionCmd ()
	skipQuestionCmd ()
	startTestCmd ()
	showSideList ($current_sequence_element)
	isQuestionSummaryFinishTestButtonRequired ()
	showRequestedHintListCmd ()
	Go to requested hint list. More...
	confirmHintRequestCmd ()
	Go to hint request confirmation. More...
	isFirstQuestionInSequence ($sequenceElement)
	isLastQuestionInSequence ($sequenceElement)
	handleQuestionActionCmd ()
	showInstantResponseCmd ()
	nextQuestionCmd ()
	previousQuestionCmd ()
	prepareSummaryPage ()
	initTestPageTemplate ()
	handlePasswordProtectionRedirect ()
	isParticipantsAnswerFixed ($questionId)
	getIntroductionPageButtonLabel ()
	initAssessmentSettings ()
	handleSkillTriggering (ilTestSession $test_session)
	buildTestPassQuestionList ()
	showAnswerOptionalQuestionsConfirmation ()
	confirmAnswerOptionalQuestionsCmd ()
	cancelAnswerOptionalQuestionsCmd ()
	populateHelperGuiContent ($helperGui)
	getTestNavigationToolbarGUI ()
	buildReadOnlyStateQuestionNavigationGUI ($questionId)
	buildEditableStateQuestionNavigationGUI ($questionId)
	getFinishTestCommand ()
	populateInstantResponseModal (assQuestionGUI $questionGui, $navUrl)
	populateInstantResponseBlocks (assQuestionGUI $questionGui, $authorizedSolution)
	populateFeedbackBlockHeader ($withFocusAnchor)
	populateFeedbackBlockMessage (string $a_message)
	getCurrentSequenceElement ()
	getSequenceElementParameter ()
	getPresentationModeParameter ()
	getInstantResponseParameter ()
	getNextCommandParameter ()
	getNextSequenceParameter ()
	getNavigationUrlParameter ()
	getAnswerChangedParameter ()
	Get the 'answer changed' status from the current request It may be set by ilTestPlayerNavigationControl.js or by a previousRequest. More...
	setAnswerChangedParameter ($changed=true)
	Set the 'answer changed' url parameter for generated links. More...
	handleIntermediateSubmit ()
	Check the 'answer changed' parameter when a question form is intermediately submitted. More...
	saveNavigationPreventConfirmation ()
	Save the save the switch to prevent the navigation confirmation. More...
	getQuestionGuiInstance ($question_id, $fromCache=true)
	getQuestionInstance (int $question_id, bool $from_cache=true)
	initTestQuestionConfig (assQuestion $questionOBJ)
	handleTearsAndAngerQuestionIsNull (int $question_id, $sequence_element)
	populateMessageContent ($contentHTML)
	populateModals ()
	populateDiscardSolutionModal ()
	populateNavWhenChangedModal ()
	populateNextLocksUnchangedModal ()
	populateNextLocksChangedModal ()
	setFollowUpQuestionLocksConfirmationPrevented ()
	isFollowUpQuestionLocksConfirmationPrevented ()
	getQuestionsDefaultPresentationMode ($isQuestionWorkedThrough)
	registerForcedFeedbackNavUrl ($forcedFeedbackNavUrl)
	getRegisteredForcedFeedbackNavUrl ()
	isForcedFeedbackNavUrlRegistered ()
	unregisterForcedFeedbackNavUrl ()
	handleFileUploadCmd ()
Protected Member Functions inherited from ilTestServiceGUI
	getPassDetailsOverviewTableGUI (array $result_array, int $active_id, int $pass, ilTestServiceGUI|ilParticipantsTestResultsGUI $target_gui, string $target_cmd, ilTestQuestionRelatedObjectivesList $objectives_list=null, bool $multiple_objectives_involved=true)
	buildPassDetailsOverviewTableGUI (ilTestServiceGUI|ilParticipantsTestResultsGUI $target_gui, string $target_cmd)
	isGradingMessageRequired ()
	getGradingMessageBuilder (int $active_id)
	buildQuestionRelatedObjectivesList (ilLOTestQuestionAdapter $objectives_adapter, ilTestQuestionSequence $test_sequence)
	getFilteredTestResult (int $active_id, int $pass, bool $considerHiddenQuestions, bool $considerOptionalQuestions)
	populateContent ($content)
	buildUserTestResultsToolbarGUI ()
	outCorrectSolutionCmd ()
	outCorrectSolution ()
	Creates an output of the solution of an answer compared to the correct solution. More...
	populatePassFinishDate (ilTemplate $tpl, ?int $pass_finish_date)
	populateExamId (ilTemplate $tpl, int $active_id, int $pass)

Protected Attributes
ilTestPasswordChecker	$passwordChecker
ilTestProcessLocker	$processLocker
ilTestSession	$test_session = null
ilSetting	$assSettings = null
ilTestSequence	$testSequence = null
InterruptiveModal	$finish_test_modal = null
Protected Attributes inherited from ilTestServiceGUI
InternalRequestService	$testrequest
ILIAS TestQuestionPool QuestionInfoService	$questioninfo
ilTestService	$service = null
ilDBInterface	$db
ilLanguage	$lng
LoggingServices	$logging_services
ilHelpGUI	$help
ilRbacSystem	$rbac_system
ilGlobalTemplateInterface ilTemplate	$tpl
	sk 2023-08-01: We need this union type, even if it is wrong! To change this More...
ContentStyle	$content_style
ilErrorHandling	$error
ilAccess	$access
HTTPServices	$http
ilCtrl	$ctrl
ilToolbarGUI	$toolbar
ilTabsGUI	$tabs
ilObjectDataCache	$obj_cache
ilComponentRepository	$component_repository
ilObjUser	$user
ArrayBasedRequestWrapper	$post_wrapper
ilNavigationHistory	$navigation_history
Refinery	$refinery
UIFactory	$ui_factory
UIRenderer	$ui_renderer
SkillService	$skills_service
ilTestShuffler	$shuffler
ilTestResultsFactory	$results_factory
ilTestResultsPresentationFactory	$results_presentation_factory
ILIAS	$ilias
ilSetting	$settings
GlobalScreenServices	$global_screen
ilTree	$tree
int	$ref_id
ilTestSessionFactory	$testSessionFactory = null
ilTestSequenceFactory	$testSequenceFactory = null
ilTestParticipantData	$participantData = null
ilTestParticipantAccessFilterFactory	$participant_access_filter

Private Member Functions
	buildNextButtonInstance ($primaryNext)
	buildPreviousButtonInstance ()
	getOnLoadCodeForNavigationButtons (string $target, string $cmd)
	outProcessingTime (int $active_id, bool $verbose)

Private Attributes
	$cachedQuestionGuis = []
	$cachedQuestionObjects = []

Detailed Description

Output class for assessment test execution.

The ilTestOutputGUI class creates the output for the ilObjTestGUI class when learners execute a test. This saves some heap space because the ilObjTestGUI class will be much smaller then

Author

Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Version

$Id$

ModulesTest

Definition at line 40 of file class.ilTestPlayerAbstractGUI.php.

Constructor & Destructor Documentation

__construct()

ilTestPlayerAbstractGUI::__construct

(

ilObjTest

$object

)

Definition at line 59 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\MetaData\Repository\Validation\Data\__construct(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

    {
        parent::__construct($object);
        $this->ref_id = $this->testrequest->getRefId();
        $this->passwordChecker = new ilTestPasswordChecker($this->rbac_system, $this->user, $this->object, $this->lng);
    }

Here is the call graph for this function:

Member Function Documentation

accessCodeConfirmedCmd()

ilTestPlayerAbstractGUI::accessCodeConfirmedCmd

(

)

Definition at line 502 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), and ilTestPlayerCommands\START_TEST.

    {
        $this->ctrl->redirect($this, ilTestPlayerCommands::START_TEST);
    }

Here is the call graph for this function:

afterTestPassFinishedCmd()

ilTestPlayerAbstractGUI::afterTestPassFinishedCmd ( )

protected

Definition at line 751 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Repository\object(), ilUtil\redirect(), ilObjTest\REDIRECT_NONE, redirectBackCmd(), and ilTestPlayerCommands\SHOW_FINAL_STATMENT.

    {
        // show final statement
        if (!$this->testrequest->isset('skipfinalstatement')) {
            if ($this->object->getMainSettings()->getFinishingSettings()->getConcludingRemarksEnabled()) {
                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_FINAL_STATMENT);
            }
        }

        // redirect after test
        $redirection_url = $this->object->getMainSettings()->getFinishingSettings()->getRedirectionUrl();
        if (!empty($redirection_url)
            && !$this->object->canShowTestResults($this->test_session)
            && $this->object->getMainSettings()->getFinishingSettings()->getRedirectionMode() !== ilObjTest::REDIRECT_NONE) {
            if ($this->object->isRedirectModeKiosk()) {
                if ($this->object->getKioskMode()) {
                    ilUtil::redirect($redirection_url);
                }
            } else {
                ilUtil::redirect($redirection_url);
            }
        }

        // default redirect (pass overview when enabled, otherwise testscreen)
        $this->redirectBackCmd();
    }

Here is the call graph for this function:

autosaveCmd()

ilTestPlayerAbstractGUI::autosaveCmd

(

)

Automatically save a user answer while working on the test (called repeatedly by asynchronous posts in configured autosave interval)

Definition at line 557 of file class.ilTestPlayerAbstractGUI.php.

References $res, ILIAS\Repository\access(), canSaveResult(), exit, getAnswerChangedParameter(), getCurrentQuestionId(), isParticipantsAnswerFixed(), ILIAS\Repository\lng(), and saveQuestionSolution().

                                 : void
    {
        if (!$this->access->checkAccess('read', '', $this->ref_id)) {
            echo $this->lng->txt('autosave_failed') . ': ' . $this->lng->txt('msg_no_perm_read_item');
            exit;
        }
        $test_can_run = $this->object->isExecutable($this->test_session, $this->test_session->getUserId());
        if (!$test_can_run['executable']) {
            echo $test_can_run['errormessage'];
            exit;
        }
        if (!is_countable($_POST) || count($_POST) === 0) {
            echo '';
            exit;
        }

        if (!$this->canSaveResult() || $this->isParticipantsAnswerFixed($this->getCurrentQuestionId())) {
            echo '-IGNORE-';
            exit;
        }

        $authorize = !$this->getAnswerChangedParameter();
        $res = $this->saveQuestionSolution($authorize, true);

        if ($res) {
            echo $this->lng->txt("autosave_success");
            exit;
        }

        echo $this->lng->txt("autosave_failed");
        exit;
    }

Here is the call graph for this function:

autosaveOnTimeLimitCmd()

ilTestPlayerAbstractGUI::autosaveOnTimeLimitCmd

(

)

Automatically save a user answer when the limited duration of a test run is reached (called by synchronous form submit when the remaining time count down reaches zero)

Definition at line 594 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getCurrentQuestionId(), isParticipantsAnswerFixed(), ilTestPlayerCommands\REDIRECT_ON_TIME_LIMIT, and saveQuestionSolution().

    {
        if (!$this->isParticipantsAnswerFixed($this->getCurrentQuestionId())) {
            $this->saveQuestionSolution(false, true);
        }
        $this->ctrl->redirect($this, ilTestPlayerCommands::REDIRECT_ON_TIME_LIMIT);
    }

Here is the call graph for this function:

backFromFinishingCmd()

ilTestPlayerAbstractGUI::backFromFinishingCmd

(

)

Definition at line 1320 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), and ilTestPlayerCommands\SHOW_QUESTION.

    {
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

buildEditableStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildEditableStateQuestionNavigationGUI (   $questionId )

protected

Definition at line 1723 of file class.ilTestPlayerAbstractGUI.php.

References ilObjTest\_getSolvedQuestions(), ilTestPlayerCommands\CONFIRM_HINT_REQUEST, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilTestPlayerCommands\MARK_QUESTION_SAVE, ILIAS\Repository\object(), ilTestPlayerCommands\REVERT_CHANGES, ilTestPlayerCommands\SHOW_INSTANT_RESPONSE, ilTestPlayerCommands\SHOW_REQUESTED_HINTS_LIST, ilTestPlayerCommands\SUBMIT_SOLUTION, and ilTestPlayerCommands\UNMARK_QUESTION_SAVE.

Referenced by showQuestionEditable().

                                                                           : ilTestQuestionNavigationGUI
    {
        $navigationGUI = new ilTestQuestionNavigationGUI(
            $this->lng,
            $this->ui_factory,
            $this->ui_renderer
        );

        if ($this->object->isForceInstantFeedbackEnabled()) {
            $navigationGUI->setSubmitSolutionCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
        } else {
            // fau: testNav - use simple "submitSolution" button instead of "submitSolutionAndNext"
            $navigationGUI->setSubmitSolutionCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
            // fau.
        }

        // fau: testNav - add a 'revert changes' link for editable question
        $navigationGUI->setRevertChangesLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::REVERT_CHANGES));
        // fau.


        // feedback
        switch (1) {
            case $this->object->getSpecificAnswerFeedback():
            case $this->object->getGenericAnswerFeedback():
            case $this->object->getAnswerFeedbackPoints():
            case $this->object->getInstantFeedbackSolution():

                $navigationGUI->setAnswerFreezingEnabled($this->object->isInstantFeedbackAnswerFixationEnabled());

                if ($this->object->isForceInstantFeedbackEnabled()) {
                    $navigationGUI->setForceInstantResponseEnabled(true);
                    $navigationGUI->setInstantFeedbackCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
                } else {
                    $navigationGUI->setInstantFeedbackCommand(ilTestPlayerCommands::SHOW_INSTANT_RESPONSE);
                }
        }

        // hints
        if ($this->object->isOfferingQuestionHintsEnabled()) {
            $activeId = $this->test_session->getActiveId();
            $pass = $this->test_session->getPass();

            $questionHintTracking = new ilAssQuestionHintTracking($questionId, $activeId, $pass);

            if ($questionHintTracking->requestsPossible()) {
                $navigationGUI->setRequestHintCommand(ilTestPlayerCommands::CONFIRM_HINT_REQUEST);
            }

            if ($questionHintTracking->requestsExist()) {
                $navigationGUI->setShowHintsCommand(ilTestPlayerCommands::SHOW_REQUESTED_HINTS_LIST);
            }
        }

        if ($this->object->getShowMarker()) {
            $solved_array = ilObjTest::_getSolvedQuestions($this->test_session->getActiveId(), $questionId);
            $solved = 0;

            if (count($solved_array) > 0) {
                $solved = array_pop($solved_array);
                $solved = $solved["solved"];
            }

            // fau: testNav - change question mark command to link target
            if ($solved == 1) {
                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::UNMARK_QUESTION_SAVE));
                $navigationGUI->setQuestionMarked(true);
            } else {
                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::MARK_QUESTION_SAVE));
                $navigationGUI->setQuestionMarked(false);
            }
        }
        // fau.
        return $navigationGUI;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildFinishTestModal()

ilTestPlayerAbstractGUI::buildFinishTestModal

(

)

Definition at line 778 of file class.ilTestPlayerAbstractGUI.php.

References $message, ILIAS\Repository\ctrl(), ilTestPlayerCommands\FINISH_TEST, ILIAS\Repository\lng(), and ILIAS\Repository\object().

Referenced by finishTestCmd().

                                          : InterruptiveModal
    {
        $class = get_class($this);
        $this->ctrl->setParameterByClass($class, 'finalization_confirmed', 'confirmed');
        $next_url = $this->ctrl->getLinkTargetByClass($class, ilTestPlayerCommands::FINISH_TEST);
        $this->ctrl->clearParameterByClass($class, 'finalization_confirmed');

        $message = $this->lng->txt('tst_finish_confirmation_question');
        if (($this->object->getNrOfTries() - 1) === $this->test_session->getPass()) {
            $message = $this->lng->txt('tst_finish_confirmation_question_no_attempts_left');
        }

        return $this->ui_factory->modal()->interruptive(
            $this->lng->txt('finish_test'),
            $message,
            $next_url
        )->withActionButtonLabel($this->lng->txt('tst_finish_confirm_button'));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildNextButtonInstance()

ilTestPlayerAbstractGUI::buildNextButtonInstance (   $primaryNext )

private

Parameters

bool

$primaryNext

Returns

Definition at line 280 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getOnLoadCodeForNavigationButtons(), ILIAS\Repository\lng(), and ilTestPlayerCommands\NEXT_QUESTION.

Referenced by populateLowerNextButtonBlock(), and populateUpperNextButtonBlock().

    {
        $target = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::NEXT_QUESTION);
        if ($primaryNext) {
            $button = $this->ui_factory->button()->primary(
                $this->lng->txt('next_question') . '<span class="glyphicon glyphicon-arrow-right"></span> ',
                ''
            )->withUnavailableAction(true)
             ->withOnLoadCode($this->getOnLoadCodeForNavigationButtons($target, ilTestPlayerCommands::NEXT_QUESTION));
        } else {
            $button = $this->ui_factory->button()->standard(
                $this->lng->txt('next_question') . '<span class="glyphicon glyphicon-arrow-right"></span> ',
                ''
            )->withUnavailableAction(true)
             ->withOnLoadCode($this->getOnLoadCodeForNavigationButtons($target, ilTestPlayerCommands::NEXT_QUESTION));
        }
        return $button;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildPreviousButtonInstance()

ilTestPlayerAbstractGUI::buildPreviousButtonInstance ( )

private

Parameters

$disabled

Returns

Definition at line 303 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getOnLoadCodeForNavigationButtons(), ILIAS\Repository\lng(), and ilTestPlayerCommands\PREVIOUS_QUESTION.

Referenced by populateLowerPreviousButtonBlock(), and populateUpperPreviousButtonBlock().

    {
        $target = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::PREVIOUS_QUESTION);
        $button = $this->ui_factory->button()->standard(
            '<span class="glyphicon glyphicon-arrow-left"></span> ' . $this->lng->txt('previous_question'),
            ''
        )->withUnavailableAction(true)
         ->withOnLoadCode($this->getOnLoadCodeForNavigationButtons($target, ilTestPlayerCommands::PREVIOUS_QUESTION));
        return $button;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildReadOnlyStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildReadOnlyStateQuestionNavigationGUI (   $questionId )

protected

Definition at line 1689 of file class.ilTestPlayerAbstractGUI.php.

References ilObjTest\_getSolvedQuestions(), ILIAS\Repository\ctrl(), ilTestPlayerCommands\EDIT_SOLUTION, isParticipantsAnswerFixed(), ILIAS\Repository\lng(), ilTestPlayerCommands\MARK_QUESTION, ILIAS\Repository\object(), and ilTestPlayerCommands\UNMARK_QUESTION.

Referenced by showQuestionViewable().

                                                                           : ilTestQuestionNavigationGUI
    {
        $navigationGUI = new ilTestQuestionNavigationGUI(
            $this->lng,
            $this->ui_factory,
            $this->ui_renderer
        );

        if (!$this->isParticipantsAnswerFixed($questionId)) {
            $navigationGUI->setEditSolutionCommand(ilTestPlayerCommands::EDIT_SOLUTION);
        }

        if ($this->object->getShowMarker()) {
            $solved_array = ilObjTest::_getSolvedQuestions($this->test_session->getActiveId(), $questionId);
            $solved = 0;

            if (count($solved_array) > 0) {
                $solved = array_pop($solved_array);
                $solved = $solved["solved"];
            }
            // fau: testNav - change question mark command to link target
            if ($solved == 1) {
                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::UNMARK_QUESTION));
                $navigationGUI->setQuestionMarked(true);
            } else {
                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::MARK_QUESTION));
                $navigationGUI->setQuestionMarked(false);
            }
        }
        // fau.

        return $navigationGUI;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildTestPassQuestionList()

ilTestPlayerAbstractGUI::buildTestPassQuestionList ( )

abstractprotected

Referenced by handleSkillTriggering().

Here is the caller graph for this function:

cancelAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::cancelAnswerOptionalQuestionsCmd ( )

protected

Definition at line 1654 of file class.ilTestPlayerAbstractGUI.php.

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

    {
        if ($this->object->getListOfQuestions()) {
            $this->ctrl->setParameter($this, 'activecommand', 'summary');
        } else {
            $this->ctrl->setParameter($this, 'activecommand', 'previous');
        }

        $this->ctrl->redirect($this, 'redirectQuestion');
    }

Here is the call graph for this function:

canSaveResult()

ilTestPlayerAbstractGUI::canSaveResult ( )

abstractprotected

Referenced by autosaveCmd(), and removeIntermediateSolution().

Here is the caller graph for this function:

checkOnlineTestAccess()

ilTestPlayerAbstractGUI::checkOnlineTestAccess

(

)

Definition at line 1068 of file class.ilTestPlayerAbstractGUI.php.

References $_SERVER, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

    {
        $user_filtered_for_invitation = $this->object->getInvitedUsers($this->user->getId());
        if ($user_filtered_for_invitation === []) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('user_not_invited'), true);
            $this->ctrl->redirectByClass('ilobjtestgui', 'backToRepository');
        }

        $client_ip = $user_filtered_for_invitation['client_ip'];
        if ($client_ip !== ''
            && $client_ip !== $_SERVER['REMOTE_ADDR']) {
            $this->tpl->setOnScreenMessage('info', $this->lng->txt('user_wrong_clientip'), true);
            $this->ctrl->redirectByClass('ilobjtestgui', 'backToRepository');
        }
    }

Here is the call graph for this function:

checkReadAccess()

ilTestPlayerAbstractGUI::checkReadAccess ( )

protected

Definition at line 66 of file class.ilTestPlayerAbstractGUI.php.

References ilObjTestAccess\_lookupOnlineTestAccess(), ILIAS\Survey\Mode\getId(), ilTestServiceGUI\getObject(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

Referenced by ilTestOutputGUI\executeCommand().

                                        : bool|string
    {
        if (!$this->rbac_system->checkAccess('read', $this->object->getRefId())) {
            return $this->lng->txt('cannot_execute_test');
        }

        if (ilObjTestAccess::_lookupOnlineTestAccess($this->getObject()->getId(), $this->user->getId()) !== true) {
            return $this->lng->txt('user_wrong_clientip');
        }

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

checkTestExecutable()

ilTestPlayerAbstractGUI::checkTestExecutable ( )

protected

Definition at line 79 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), and ilTestScreenGUI\DEFAULT_CMD.

Referenced by ilTestOutputGUI\executeCommand().

    {
        $executable = $this->object->isExecutable($this->test_session, $this->test_session->getUserId());

        if (!$executable['executable']) {
            $this->tpl->setOnScreenMessage('info', $executable['errormessage'], true);
            $this->ctrl->redirectByClass(ilTestScreenGUI::class, ilTestScreenGUI::DEFAULT_CMD);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

checkTestSessionUser()

ilTestPlayerAbstractGUI::checkTestSessionUser ( ilTestSession  $test_session )

protected

Definition at line 89 of file class.ilTestPlayerAbstractGUI.php.

References ilTestSession\getUserId(), and ILIAS\Repository\user().

Referenced by ilTestOutputGUI\executeCommand().

                                                                        : void
    {
        if ($test_session->getUserId() != $this->user->getId()) {
            throw new ilTestException('active id given does not relate to current user!');
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

checkWorkingTimeCmd()

ilTestPlayerAbstractGUI::checkWorkingTimeCmd

(

)

This is asynchronously called by tpl.workingtime.js to check for changes in the user's processing time for a test.

This includes extra time added during the test, as this is checked by ilObjTest::getProcessingTimeInSeconds(). The Javascript side then updates the test timer without needing to reload the test page.

Definition at line 1186 of file class.ilTestPlayerAbstractGUI.php.

References exit.

                                         : void
    {
        $active_id = $this->test_session->getActiveId();
        echo (string) $this->object->getProcessingTimeInSeconds($active_id);
        exit;
    }

confirmAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::confirmAnswerOptionalQuestionsCmd ( )

protected

Definition at line 1645 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl().

    {
        $this->testSequence->setAnsweringOptionalQuestionsConfirmed(true);
        $this->testSequence->saveToDb();

        $this->ctrl->setParameter($this, 'activecommand', 'gotoquestion');
        $this->ctrl->redirect($this, 'redirectQuestion');
    }

Here is the call graph for this function:

confirmHintRequestCmd()

ilTestPlayerAbstractGUI::confirmHintRequestCmd ( )

protected

Go to hint request confirmation.

Definition at line 1479 of file class.ilTestPlayerAbstractGUI.php.

References ilAssQuestionHintRequestGUI\CMD_CONFIRM_REQUEST, ILIAS\Repository\ctrl(), handleIntermediateSubmit(), handleQuestionActionCmd(), isFirstQuestionInSequence(), isLastQuestionInSequence(), nextQuestionCmd(), previousQuestionCmd(), and showInstantResponseCmd().

    {
        // fau: testNav - handle intermediate submit for confirming hint requests
        $this->handleIntermediateSubmit();
        // fau.

        $this->ctrl->setParameter($this, 'pmode', self::PRESENTATION_MODE_EDIT);

        $this->ctrl->redirectByClass('ilAssQuestionHintRequestGUI', ilAssQuestionHintRequestGUI::CMD_CONFIRM_REQUEST);
    }

Here is the call graph for this function:

confirmSubmitAnswers()

ilTestPlayerAbstractGUI::confirmSubmitAnswers

(

)

confirm submit results if confirm then results are submitted and the screen will be redirected to the startpage of the test public

Definition at line 1136 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getContentBlockName(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

    {
        $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_submit_answers_confirm.html", "Modules/Test");
        $this->tpl->setCurrentBlock("adm_content");
        if ($this->object->isTestFinished($this->test_session->getActiveId())) {
            $this->tpl->setCurrentBlock("not_submit_allowed");
            $this->tpl->setVariable("TEXT_ALREADY_SUBMITTED", $this->lng->txt("tst_already_submitted"));
            $this->tpl->setVariable("BTN_OK", $this->lng->txt("tst_show_answer_sheet"));
        } else {
            $this->tpl->setCurrentBlock("submit_allowed");
            $this->tpl->setVariable("TEXT_CONFIRM_SUBMIT_RESULTS", $this->lng->txt("tst_confirm_submit_answers"));
            $this->tpl->setVariable("BTN_OK", $this->lng->txt("tst_submit_results"));
        }
        $this->tpl->setVariable("BTN_BACK", $this->lng->txt("back"));
        $this->tpl->setVariable("FORMACTION", $this->ctrl->getFormAction($this, "finalSubmission"));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

detectChangesCmd()

ilTestPlayerAbstractGUI::detectChangesCmd ( )

protected

Detect changes sent in the background to the server This is called by ajax from ilTestPlayerQuestionEditControl.js It is needed by Java and Flash question and eventually plgin question vtypes.

Definition at line 609 of file class.ilTestPlayerAbstractGUI.php.

References exit, getCurrentQuestionId(), and getQuestionInstance().

    {
        $questionId = $this->getCurrentQuestionId();
        $state = $this->getQuestionInstance($questionId)->lookupForExistingSolutions(
            $this->test_session->getActiveId(),
            $this->test_session->getPass()
        );
        $result = [];
        $result['isAnswered'] = $state['authorized'];
        $result['isAnswerChanged'] = $state['intermediate'];

        echo json_encode($result);
        exit;
    }

Here is the call graph for this function:

determineInlineScoreDisplay()

ilTestPlayerAbstractGUI::determineInlineScoreDisplay ( )

protected

Definition at line 187 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\object().

Referenced by populateInstantResponseBlocks().

                                                    : bool
    {
        $show_question_inline_score = false;
        if ($this->object->getAnswerFeedbackPoints()) {
            $show_question_inline_score = true;
            return $show_question_inline_score;
        }
        return $show_question_inline_score;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

determineSolutionPassIndex()

ilTestPlayerAbstractGUI::determineSolutionPassIndex ( assQuestionGUI  $questionGui )

protected

Definition at line 1017 of file class.ilTestPlayerAbstractGUI.php.

References editSolutionCmd(), ILIAS\Repository\object(), showQuestionCmd(), and submitSolutionCmd().

Referenced by showQuestionEditable().

                                                                              : int
    {
        if ($this->object->isPreviousSolutionReuseEnabled($this->test_session->getActiveId())) {
            $currentSolutionAvailable = $questionGui->object->authorizedOrIntermediateSolutionExists(
                $this->test_session->getActiveId(),
                $this->test_session->getPass()
            );

            if (!$currentSolutionAvailable) {
                $previousPass = $questionGui->object->getSolutionMaxPass(
                    $this->test_session->getActiveId()
                );

                $previousSolutionAvailable = $questionGui->object->authorizedSolutionExists(
                    $this->test_session->getActiveId(),
                    $previousPass
                );

                if ($previousSolutionAvailable) {
                    return $previousPass;
                }

            }
        }

        return $this->test_session->getPass();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

discardSolutionCmd()

ilTestPlayerAbstractGUI::discardSolutionCmd ( )

abstractprotected

Referenced by revertChangesCmd().

Here is the caller graph for this function:

displayAccessCodeCmd()

ilTestPlayerAbstractGUI::displayAccessCodeCmd

(

)

Definition at line 490 of file class.ilTestPlayerAbstractGUI.php.

References ilTestPlayerCommands\ACCESS_CODE_CONFIRMED, ILIAS\Repository\ctrl(), getContentBlockName(), and ILIAS\Repository\lng().

    {
        $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_anonymous_code_presentation.html", "Modules/Test");
        $this->tpl->setCurrentBlock("adm_content");
        $this->tpl->setVariable("TEXT_ANONYMOUS_CODE_CREATED", $this->lng->txt("tst_access_code_created"));
        $this->tpl->setVariable("TEXT_ANONYMOUS_CODE", $this->test_session->getAccessCodeFromSession());
        $this->tpl->setVariable("FORMACTION", $this->ctrl->getFormAction($this));
        $this->tpl->setVariable("CMD_CONFIRM", ilTestPlayerCommands::ACCESS_CODE_CONFIRMED);
        $this->tpl->setVariable("TXT_CONFIRM", $this->lng->txt("continue_work"));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

editSolutionCmd()

ilTestPlayerAbstractGUI::editSolutionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

endingTimeReached()

ilTestPlayerAbstractGUI::endingTimeReached

(

)

handle endingTimeReached

Definition at line 1109 of file class.ilTestPlayerAbstractGUI.php.

References ilDatePresentation\formatDate(), IL_CAL_UNIX, ILIAS\Repository\lng(), ILIAS\Repository\object(), and redirectBackCmd().

Referenced by prepareTestPage().

    {
        $this->tpl->setOnScreenMessage('info', sprintf($this->lng->txt("detail_ending_time_reached"), ilDatePresentation::formatDate(new ilDateTime($this->object->getEndingTime(), IL_CAL_UNIX))));
        $this->test_session->increasePass();
        $this->test_session->setLastSequence(0);
        $this->test_session->saveToDb();

        $this->redirectBackCmd();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

ensureExistingTestSession()

ilTestPlayerAbstractGUI::ensureExistingTestSession ( ilTestSession  $test_session )

protected

Definition at line 96 of file class.ilTestPlayerAbstractGUI.php.

References ilTestSession\doesAccessCodeInSessionExists(), ilTestSession\getAccessCodeFromSession(), ilTestSession\getActiveId(), ilTestSession\isAnonymousUser(), ilTestSession\saveToDb(), ilTestSession\setAnonymousId(), ilTestSession\setUserId(), and ILIAS\Repository\user().

Referenced by ilTestOutputGUI\executeCommand().

                                                                             : void
    {
        if ($test_session->getActiveId()) {
            return;
        }

        $test_session->setUserId($this->user->getId());

        if ($test_session->isAnonymousUser()) {
            if (!$test_session->doesAccessCodeInSessionExists()) {
                return;
            }

            $test_session->setAnonymousId($test_session->getAccessCodeFromSession());
        }

        $test_session->saveToDb();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

finishTestCmd()

ilTestPlayerAbstractGUI::finishTestCmd

(

)

Definition at line 676 of file class.ilTestPlayerAbstractGUI.php.

References ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, buildFinishTestModal(), ilSession\clear(), ILIAS\Repository\ctrl(), ilSession\get(), ILIAS\Repository\object(), performTestPassFinishedTasks(), ilTestPlayerCommands\QUESTION_SUMMARY_INC_OBLIGATIONS, ilTestPlayerCommands\QUESTION_SUMMARY_OBLIGATIONS_ONLY, ilSession\set(), and showQuestionCmd().

    {
        $this->handleCheckTestPassValid();
        ilSession::clear("tst_next");

        $all_obligations_answered = $this->object->allObligationsAnswered();

        /*
         * The following "endgames" are possible prior to actually finishing the test:
         * - Obligations (Ability to finish the test.)
         *      If not all obligatory questions are answered, the user is presented a list
         *      showing the deficits.
         * - Examview (Will to finish the test.)
         *      With the examview, the participant can review all answers given in ILIAS or a PDF prior to
         *      commencing to the finished test.
         * - Last pass allowed (Reassuring the will to finish the test.)
         *      If passes are limited, on the last pass, an additional confirmation is to be displayed.
         */

        if ($this->object->areObligationsEnabled() && !$all_obligations_answered) {
            if ($this->object->getListOfQuestions()) {
                $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY_INC_OBLIGATIONS);
                return;
            }

            $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY_OBLIGATIONS_ONLY);
            return;
        }

        if ($this->testrequest->strVal('finalization_confirmed') !== 'confirmed') {
            $this->finish_test_modal = $this->buildFinishTestModal();
            $this->showQuestionCmd();
            return;
        }

        // Non-last try finish
        if (ilSession::get('tst_pass_finish') === null) {
            ilSession::set('tst_pass_finish', 1);
        }

        $this->performTestPassFinishedTasks();

        $this->ctrl->redirect($this, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED);
    }

Here is the call graph for this function:

getAnswerChangedParameter()

ilTestPlayerAbstractGUI::getAnswerChangedParameter ( )

protected

Get the 'answer changed' status from the current request It may be set by ilTestPlayerNavigationControl.js or by a previousRequest.

Returns

bool

Definition at line 2046 of file class.ilTestPlayerAbstractGUI.php.

Referenced by autosaveCmd(), ilTestOutputGUI\executeCommand(), handleIntermediateSubmit(), and isFollowUpQuestionLocksConfirmationPrevented().

                                                  : bool
    {
        return !empty($this->testrequest->raw('test_answer_changed'));
    }

Here is the caller graph for this function:

getContentBlockName()

ilTestPlayerAbstractGUI::getContentBlockName

(

)

Returns the name of the current content block (depends on the kiosk mode setting)

Returns

string The name of the content block

Definition at line 1441 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\object().

Referenced by confirmSubmitAnswers(), displayAccessCodeCmd(), initTestPageTemplate(), outQuestionSummaryCmd(), populateHelperGuiContent(), populateMessageContent(), prepareSummaryPage(), redirectAfterFinish(), showFinalStatementCmd(), and showListOfAnswers().

                                         : string
    {
        return "ADM_CONTENT";

        if ($this->object->getKioskMode()) {
            $this->tpl->setBodyClass("kiosk");
            $this->tpl->hideFooter();
            return "CONTENT";
        } else {
            return "ADM_CONTENT";
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getCurrentQuestionId()

ilTestPlayerAbstractGUI::getCurrentQuestionId ( )

abstractprotected

Referenced by autosaveCmd(), autosaveOnTimeLimitCmd(), detectChangesCmd(), redirectAfterFinish(), and removeIntermediateSolution().

Here is the caller graph for this function:

getCurrentSequenceElement()

ilTestPlayerAbstractGUI::getCurrentSequenceElement ( )

protected

Definition at line 1967 of file class.ilTestPlayerAbstractGUI.php.

References getSequenceElementParameter().

Referenced by ilTestOutputGUI\discardSolutionCmd(), ilTestOutputGUI\executeCommand(), ilTestOutputGUI\handleQuestionActionCmd(), markQuestionCmd(), ilTestOutputGUI\nextQuestionCmd(), ilTestOutputGUI\previousQuestionCmd(), ilTestOutputGUI\showInstantResponseCmd(), ilTestOutputGUI\showQuestionCmd(), showSideList(), ilTestOutputGUI\skipQuestionCmd(), ilTestOutputGUI\submitSolutionAndNextCmd(), ilTestOutputGUI\submitSolutionCmd(), and unmarkQuestionCmd().

                                                  : int
    {
        if ($this->getSequenceElementParameter()) {
            return $this->getSequenceElementParameter();
        }

        return $this->test_session->getLastSequence();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getFinishTestCommand()

ilTestPlayerAbstractGUI::getFinishTestCommand ( )

protected

Returns

string

Definition at line 1802 of file class.ilTestPlayerAbstractGUI.php.

References ilTestPlayerCommands\FINISH_TEST, ILIAS\Repository\object(), ilTestPlayerCommands\QUESTION_SUMMARY, and ilTestPlayerCommands\QUESTION_SUMMARY_INC_OBLIGATIONS.

Referenced by getTestNavigationToolbarGUI().

                                             : string
    {
        if (!$this->object->getListOfQuestionsEnd()) {
            return ilTestPlayerCommands::FINISH_TEST;
        }

        if ($this->object->areObligationsEnabled()
            && !$this->object->allObligationsAnswered()) {
            return ilTestPlayerCommands::QUESTION_SUMMARY_INC_OBLIGATIONS;
        }

        return ilTestPlayerCommands::QUESTION_SUMMARY;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInstantResponseParameter()

ilTestPlayerAbstractGUI::getInstantResponseParameter ( )

protected

Definition at line 1994 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\showQuestionCmd().

    {
        if ($this->testrequest->isset('instresp')) {
            return $this->testrequest->raw('instresp');
        }

        return null;
    }

Here is the caller graph for this function:

getIntroductionPageButtonLabel()

ilTestPlayerAbstractGUI::getIntroductionPageButtonLabel ( )

protected

Returns

string

Definition at line 1585 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\lng().

                                                       : string
    {
        return $this->lng->txt("save_introduction");
    }

Here is the call graph for this function:

getLockParameter()

ilTestPlayerAbstractGUI::getLockParameter

(

)

Definition at line 454 of file class.ilTestPlayerAbstractGUI.php.

References resumePlayerCmd().

Referenced by handlePasswordProtectionRedirect(), and startPlayerCmd().

    {
        if ($this->testrequest->isset('lock') && strlen($this->testrequest->raw('lock'))) {
            return $this->testrequest->raw('lock');
        }

        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getNavigationUrlParameter()

ilTestPlayerAbstractGUI::getNavigationUrlParameter ( )

protected

Definition at line 2023 of file class.ilTestPlayerAbstractGUI.php.

References ilUtil\_getHttpPath().

Referenced by ilTestOutputGUI\showInstantResponseCmd(), and ilTestOutputGUI\submitSolutionCmd().

                                                  : ?string
    {
        if (isset($_POST['test_player_navigation_url'])) {
            $navigation_url = $_POST['test_player_navigation_url'];

            $navigation_url_parts = parse_url($navigation_url);
            $ilias_url_parts = parse_url(ilUtil::_getHttpPath());

            if (!isset($navigation_url_parts['host']) || ($ilias_url_parts['host'] === $navigation_url_parts['host'])) {
                return $navigation_url;
            }
        }

        return null;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getNextCommandParameter()

ilTestPlayerAbstractGUI::getNextCommandParameter ( )

protected

Definition at line 2003 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\submitSolutionCmd().

    {
        $nextcmd = '';
        if ($this->testrequest->isset('nextcmd')) {
            $nextcmd = $this->testrequest->strVal('nextcmd');
        }

        return $nextcmd !== '' ? $nextcmd : null;
    }

Here is the caller graph for this function:

getNextSequenceParameter()

ilTestPlayerAbstractGUI::getNextSequenceParameter ( )

protected

Definition at line 2013 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\submitSolutionCmd().

                                                 : ?int
    {
        if (isset($_POST['nextseq']) && is_numeric($_POST['nextseq'])) {
            return (int) $_POST['nextseq'];
        }

        return null;
    }

Here is the caller graph for this function:

getOnLoadCodeForNavigationButtons()

ilTestPlayerAbstractGUI::getOnLoadCodeForNavigationButtons ( string  $target, string  $cmd  )

private

Definition at line 314 of file class.ilTestPlayerAbstractGUI.php.

References $id.

Referenced by buildNextButtonInstance(), and buildPreviousButtonInstance().

                                                                                   : Closure
    {
        return static function (string $id) use ($target, $cmd): string {
            return "document.getElementById('{$id}').addEventListener('click', "
                . "(e) => {il.TestPlayerQuestionEditControl.checkNavigation('{$target}', '{$cmd}', e);}"
                . "); "
                . "document.getElementById('{$id}').removeAttribute('disabled');";
        };
    }

Here is the caller graph for this function:

getPresentationModeParameter()

ilTestPlayerAbstractGUI::getPresentationModeParameter ( )

protected

Definition at line 1985 of file class.ilTestPlayerAbstractGUI.php.

    {
        if ($this->testrequest->isset('pmode')) {
            return $this->testrequest->raw('pmode');
        }

        return null;
    }

getQuestionGuiInstance()

ilTestPlayerAbstractGUI::getQuestionGuiInstance (   $question_id,   $fromCache = true  )

protected

Parameters

$questionId
$sequenceElement

Returns

object

Definition at line 2103 of file class.ilTestPlayerAbstractGUI.php.

References ilTestServiceGUI\$tpl, initTestQuestionConfig(), ILIAS\Repository\object(), and assQuestionGUI\PRESENTATION_CONTEXT_TEST.

Referenced by ilTestOutputGUI\showQuestionCmd().

                                                                              : object
    {
        $tpl = $this->tpl;

        if (!$fromCache || !isset($this->cachedQuestionGuis[$question_id])) {
            $question_gui = $this->object->createQuestionGUI("", $question_id);
            $question_gui->setTargetGui($this);
            $question_gui->setPresentationContext(assQuestionGUI::PRESENTATION_CONTEXT_TEST);
            $question_gui->object->setObligationsToBeConsidered($this->object->areObligationsEnabled());
            $question_gui->populateJavascriptFilesRequiredForWorkForm($tpl);
            $question_gui->object->setShuffler($this->shuffler->getAnswerShuffleFor(
                $question_id,
                $this->test_session->getActiveId(),
                $this->test_session->getPass()
            ));

            // hey: prevPassSolutions - determine solution pass index and configure gui accordingly
            $this->initTestQuestionConfig($question_gui->object);
            // hey.

            $this->cachedQuestionGuis[$question_id] = $question_gui;
        }

        return $this->cachedQuestionGuis[$question_id];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionInstance()

ilTestPlayerAbstractGUI::getQuestionInstance ( int  $question_id, bool  $from_cache = true  )

protected

Definition at line 2131 of file class.ilTestPlayerAbstractGUI.php.

References ilObjAssessmentFolder\_enabledAssessmentLogging(), initTestQuestionConfig(), assQuestion\instantiateQuestion(), ILIAS\Repository\object(), and ILIAS\Repository\user().

Referenced by detectChangesCmd(), ilTestOutputGUI\discardSolutionCmd(), removeIntermediateSolution(), and ilTestOutputGUI\saveQuestionSolution().

                                                                                     : assQuestion
    {
        if ($from_cache && isset($this->cachedQuestionObjects[$question_id])) {
            return $this->cachedQuestionObjects[$question_id];
        }
        $question = assQuestion::instantiateQuestion($question_id);
        $ass_settings = new ilSetting('assessment');

        $process_locker_factory = new ilAssQuestionProcessLockerFactory($ass_settings, $this->db);
        $process_locker_factory->setQuestionId($question->getId());
        $process_locker_factory->setUserId($this->user->getId());
        $process_locker_factory->setAssessmentLogEnabled(ilObjAssessmentFolder::_enabledAssessmentLogging());
        $question->setProcessLocker($process_locker_factory->getLocker());

        $question->setObligationsToBeConsidered($this->object->areObligationsEnabled());

        $this->initTestQuestionConfig($question);

        $this->cachedQuestionObjects[$question_id] = $question;
        return $question;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionsDefaultPresentationMode()

ilTestPlayerAbstractGUI::getQuestionsDefaultPresentationMode (   $isQuestionWorkedThrough )

protected

Definition at line 2404 of file class.ilTestPlayerAbstractGUI.php.

                                                                                    : string
    {
        // fau: testNav - always set default presentation mode to "edit"
        return self::PRESENTATION_MODE_EDIT;
        // fau.
    }

getRegisteredForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::getRegisteredForcedFeedbackNavUrl ( )

protected

Definition at line 2421 of file class.ilTestPlayerAbstractGUI.php.

References ilSession\get().

Referenced by isForcedFeedbackNavUrlRegistered(), and ilTestOutputGUI\showQuestionCmd().

    {
        if (ilSession::get('forced_feedback_navigation_url') == null) {
            return null;
        }
        $forced_feedback_navigation_url = ilSession::get('forced_feedback_navigation_url');
        if (!isset($forced_feedback_navigation_url[$this->test_session->getActiveId()])) {
            return null;
        }

        return $forced_feedback_navigation_url[$this->test_session->getActiveId()];
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSequenceElementParameter()

ilTestPlayerAbstractGUI::getSequenceElementParameter ( )

protected

Definition at line 1976 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\executeCommand(), and getCurrentSequenceElement().

                                                    : ?int
    {
        if ($this->testrequest->isset('sequence')) {
            return $this->testrequest->int('sequence');
        }

        return null;
    }

Here is the caller graph for this function:

getTestNavigationToolbarGUI()

ilTestPlayerAbstractGUI::getTestNavigationToolbarGUI ( )

protected

Definition at line 1680 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getFinishTestCommand(), and ILIAS\Repository\object().

Referenced by ilTestOutputGUI\showQuestionCmd().

                                                    : ilTestNavigationToolbarGUI
    {
        $navigation_toolbar = new ilTestNavigationToolbarGUI($this->ctrl, $this);
        $navigation_toolbar->setSuspendTestButtonEnabled($this->object->getShowCancel());
        $navigation_toolbar->setUserPassOverviewEnabled($this->object->getUsrPassOverviewEnabled());
        $navigation_toolbar->setFinishTestCommand($this->getFinishTestCommand());
        return $navigation_toolbar;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleFileUploadCmd()

ilTestPlayerAbstractGUI::handleFileUploadCmd ( )

protected

Definition at line 2448 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), saveQuestionSolution(), ilTestPlayerCommands\SUBMIT_SOLUTION, and updateWorkingTime().

    {
        $this->updateWorkingTime();
        $this->saveQuestionSolution(false);
        $this->ctrl->redirect($this, ilTestPlayerCommands::SUBMIT_SOLUTION);
    }

Here is the call graph for this function:

handleIntermediateSubmit()

ilTestPlayerAbstractGUI::handleIntermediateSubmit ( )

protected

Check the 'answer changed' parameter when a question form is intermediately submitted.

• save or delete the intermediate solution
• save the parameter for the next request

Definition at line 2066 of file class.ilTestPlayerAbstractGUI.php.

References getAnswerChangedParameter(), removeIntermediateSolution(), saveQuestionSolution(), and setAnswerChangedParameter().

Referenced by confirmHintRequestCmd(), markQuestionAndSaveIntermediateCmd(), showRequestedHintListCmd(), and unmarkQuestionAndSaveIntermediateCmd().

    {
        if ($this->getAnswerChangedParameter()) {
            $this->saveQuestionSolution(false);
        } else {
            $this->removeIntermediateSolution();
        }
        $this->setAnswerChangedParameter($this->getAnswerChangedParameter());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handlePasswordProtectionRedirect()

ilTestPlayerAbstractGUI::handlePasswordProtectionRedirect ( )

protected

The test password is only checked once per session to avoid errors during autosave if the password is changed during a running test. See Mantis #22536 for more details.

Definition at line 1541 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getLockParameter(), and ilTestPlayerCommands\START_TEST.

Referenced by ilTestOutputGUI\executeCommand().

    {
        if ($this->test_session->isPasswordChecked() === true) {
            return;
        }

        if ($this->ctrl->getNextClass() === 'iltestpasswordprotectiongui') {
            return;
        }

        if (!$this->passwordChecker->isPasswordProtectionPageRedirectRequired()) {
            $this->test_session->setPasswordChecked(true);
            return;
        }

        $this->ctrl->setParameterByClass(self::class, 'lock', $this->getLockParameter());

        $next_command = $this->ctrl->getCmdClass() . '::' . ilTestPlayerCommands::START_TEST;
        $this->ctrl->setParameterByClass(ilTestPasswordProtectionGUI::class, 'nextCommand', $next_command);
        $this->ctrl->redirectByClass(ilTestPasswordProtectionGUI::class, 'showPasswordForm');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleQuestionActionCmd()

ilTestPlayerAbstractGUI::handleQuestionActionCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

handleSkillTriggering()

ilTestPlayerAbstractGUI::handleSkillTriggering ( ilTestSession  $test_session )

protected

Parameters

ilTestSession

$test_session

Definition at line 1598 of file class.ilTestPlayerAbstractGUI.php.

References buildTestPassQuestionList(), ilObjAssessmentFolder\DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER, ilTestSession\getActiveId(), ilTestSession\getPass(), ilTestSession\getUserId(), ILIAS\Repository\object(), and ilTestSkillEvaluation\setUserId().

Referenced by ilTestOutputGUI\saveQuestionSolution().

    {
        $questionList = $this->buildTestPassQuestionList();
        $questionList->load();

        $testResults = $this->object->getTestResult($test_session->getActiveId(), $test_session->getPass(), true);

        $skillEvaluation = new ilTestSkillEvaluation(
            $this->db,
            $this->logging_services,
            $this->object->getTestId(),
            $this->object->getRefId(),
            $this->skills_service->profile(),
            $this->skills_service->personal()
        );

        $skillEvaluation->setUserId($test_session->getUserId());
        $skillEvaluation->setActiveId($test_session->getActiveId());
        $skillEvaluation->setPass($test_session->getPass());

        $skillEvaluation->setNumRequiredBookingsForSkillTriggering((int) $this->assSettings->get(
            'ass_skl_trig_num_answ_barrier',
            ilObjAssessmentFolder::DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER
        ));


        $skillEvaluation->init($questionList);
        $skillEvaluation->evaluate($testResults);

        $skillEvaluation->handleSkillTriggering();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleTearsAndAngerQuestionIsNull()

ilTestPlayerAbstractGUI::handleTearsAndAngerQuestionIsNull ( int  $question_id,   $sequence_element  )

protected

Definition at line 2161 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ilLogLevel\ERROR, and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by ilTestOutputGUI\showQuestionCmd().

                                                                                             : void
    {
        $this->logging_services->root()->write(
            "INV SEQ:"
            . "active={$this->test_session->getActiveId()} "
            . "qId=$question_id seq=$sequence_element "
            . serialize($this->testSequence)
        );

        $this->logging_services->root()->logStack(ilLogLevel::ERROR);

        $this->ctrl->setParameter($this, 'sequence', $this->testSequence->getFirstSequence());
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleUserSettings()

ilTestPlayerAbstractGUI::handleUserSettings

(

)

Handles some form parameters on starting and resuming a test.

Definition at line 510 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\object(), ILIAS\Repository\refinery(), and ILIAS\Repository\user().

Referenced by ilTestOutputGUI\resumePlayerCmd(), and startPlayerCmd().

    {
        if ($this->object->getNrOfTries() != 1
            && $this->object->getUsePreviousAnswers() == 1
        ) {
            $chb_use_previous_answers = 0;
            if ($this->post_wrapper->has('chb_use_previous_answers')) {
                $chb_use_previous_answers = $this->post_wrapper->retrieve(
                    'chb_use_previous_answers',
                    $this->refinery->kindlyTo()->int()
                );
            }
            $this->user->writePref("tst_use_previous_answers", (string) $chb_use_previous_answers);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initAssessmentSettings()

ilTestPlayerAbstractGUI::initAssessmentSettings ( )

protected

Definition at line 1590 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\executeCommand().

    {
        $this->assSettings = new ilSetting('assessment');
    }

Here is the caller graph for this function:

initProcessLocker()

ilTestPlayerAbstractGUI::initProcessLocker (   $activeId )

protected

Definition at line 115 of file class.ilTestPlayerAbstractGUI.php.

References ilTestServiceGUI\$db, and $ilDB.

Referenced by ilTestOutputGUI\executeCommand().

    {
        $ilDB = $this->db;
        $processLockerFactory = new ilTestProcessLockerFactory($this->assSettings, $ilDB);
        $this->processLocker = $processLockerFactory->withContextId((int) $activeId)->getLocker();
    }

Here is the caller graph for this function:

initTestCmd()

ilTestPlayerAbstractGUI::initTestCmd ( )

protected

Start a test for the first time after a redirect.

Definition at line 471 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ilTestPlayerCommands\DISPLAY_ACCESS_CODE, and ilTestPlayerCommands\START_TEST.

    {
        if ($this->test_session->isAnonymousUser()
            && !$this->test_session->doesAccessCodeInSessionExists()) {
            $accessCode = $this->test_session->createNewAccessCode();

            $this->test_session->setAccessCodeToSession($accessCode);
            $this->test_session->setAnonymousId($accessCode);
            $this->test_session->saveToDb();

            $this->ctrl->redirect($this, ilTestPlayerCommands::DISPLAY_ACCESS_CODE);
        }

        if (!$this->test_session->isAnonymousUser()) {
            $this->test_session->unsetAccessCodeInSession();
        }
        $this->ctrl->redirect($this, ilTestPlayerCommands::START_TEST);
    }

Here is the call graph for this function:

initTestPageTemplate()

ilTestPlayerAbstractGUI::initTestPageTemplate ( )

protected

Definition at line 1513 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\event(), ILIAS\Repository\form(), and getContentBlockName().

Referenced by prepareTestPage().

    {
        $onload_js = <<<JS
    let key_event = (event) => {
        if( event.key === 13  && event.target.tagName.toLowerCase() === "a" ) {
            return;
        }
        if (event.key === 13 &&
            event.target.tagName.toLowerCase() !== "textarea" &&
            (event.target.tagName.toLowerCase() !== "input" || event.target.type.toLowerCase() !== "submit")) {
            event.preventDefault();
        }
    };

    let form = document.getElementById('taForm');
    form.onkeyup = key_event;
    form.onkeydown = key_event;
    form.onkeypress = key_event;
JS;
        $this->tpl->addOnLoadCode($onload_js);
        $this->tpl->addBlockFile(
            $this->getContentBlockName(),
            'adm_content',
            'tpl.il_as_tst_output.html',
            'Modules/Test'
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initTestQuestionConfig()

ilTestPlayerAbstractGUI::initTestQuestionConfig ( assQuestion  $questionOBJ )

protected

Definition at line 2154 of file class.ilTestPlayerAbstractGUI.php.

References assQuestion\getTestPresentationConfig(), and ILIAS\Repository\object().

Referenced by getQuestionGuiInstance(), and getQuestionInstance().

    {
        $questionOBJ->getTestPresentationConfig()->setPreviousPassSolutionReuseAllowed(
            $this->object->isPreviousSolutionReuseEnabled($this->test_session->getActiveId())
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isFirstQuestionInSequence()

ilTestPlayerAbstractGUI::isFirstQuestionInSequence (   $sequenceElement )

abstractprotected

Referenced by confirmHintRequestCmd(), and populateQuestionNavigation().

Here is the caller graph for this function:

isFollowUpQuestionLocksConfirmationPrevented()

ilTestPlayerAbstractGUI::isFollowUpQuestionLocksConfirmationPrevented ( )

protected

Definition at line 2355 of file class.ilTestPlayerAbstractGUI.php.

References ilTestPlayerCommands\AUTO_SAVE, ilTestPlayerCommands\AUTO_SAVE_ON_TIME_LIMIT, ILIAS\Repository\ctrl(), ilTestPlayerCommands\DETECT_CHANGES, ilSession\get(), getAnswerChangedParameter(), isParticipantsAnswerFixed(), and ILIAS\Repository\lng().

Referenced by populateNextLocksChangedModal().

    {
        if (ilSession::get(self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM) == null) {
            return false;
        }

        return ilSession::get(self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isForcedFeedbackNavUrlRegistered()

ilTestPlayerAbstractGUI::isForcedFeedbackNavUrlRegistered ( )

protected

Definition at line 2434 of file class.ilTestPlayerAbstractGUI.php.

References getRegisteredForcedFeedbackNavUrl().

Referenced by ilTestOutputGUI\showQuestionCmd().

                                                         : bool
    {
        return !empty($this->getRegisteredForcedFeedbackNavUrl());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isLastQuestionInSequence()

ilTestPlayerAbstractGUI::isLastQuestionInSequence (   $sequenceElement )

abstractprotected

Referenced by confirmHintRequestCmd(), and populateQuestionNavigation().

Here is the caller graph for this function:

isMaxProcessingTimeReached()

ilTestPlayerAbstractGUI::isMaxProcessingTimeReached

(

)

Definition at line 176 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\canSaveResult(), isTestAccessible(), and prepareTestPage().

                                                : bool
    {
        $active_id = $this->test_session->getActiveId();
        $starting_time = $this->object->getStartingTimeOfUser($active_id);
        if ($starting_time === false) {
            return false;
        } else {
            return $this->object->isMaxProcessingTimeReached($starting_time, $active_id);
        }
    }

Here is the caller graph for this function:

isNrOfTriesReached()

ilTestPlayerAbstractGUI::isNrOfTriesReached

(

)

nr of tries exceeded

Definition at line 1099 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\canSaveResult(), isTestAccessible(), and ilTestOutputGUI\saveQuestionSolution().

                                        : bool
    {
        return $this->object->hasNrOfTriesRestriction() && $this->object->isNrOfTriesReached($this->test_session->getPass());
    }

Here is the caller graph for this function:

isOptionalQuestionAnsweringConfirmationRequired()

ilTestPlayerAbstractGUI::isOptionalQuestionAnsweringConfirmationRequired (   $sequenceElement )

abstractprotected

Referenced by prepareTestPage().

Here is the caller graph for this function:

isParticipantsAnswerFixed()

ilTestPlayerAbstractGUI::isParticipantsAnswerFixed (   $questionId )

protected

Definition at line 1569 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\object().

Referenced by autosaveCmd(), autosaveOnTimeLimitCmd(), buildReadOnlyStateQuestionNavigationGUI(), ilTestOutputGUI\handleQuestionActionCmd(), isFollowUpQuestionLocksConfirmationPrevented(), ilTestOutputGUI\saveQuestionSolution(), ilTestOutputGUI\showInstantResponseCmd(), and ilTestOutputGUI\showQuestionCmd().

                                                             : bool
    {
        if ($this->object->isInstantFeedbackAnswerFixationEnabled() && $this->testSequence->isQuestionChecked($questionId)) {
            return true;
        }

        if ($this->object->isFollowupQuestionAnswerFixationEnabled() && $this->testSequence->isNextQuestionPresented($questionId)) {
            return true;
        }

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isQuestionSummaryFinishTestButtonRequired()

ilTestPlayerAbstractGUI::isQuestionSummaryFinishTestButtonRequired ( )

abstractprotected

Referenced by outQuestionSummaryCmd(), and showSideList().

Here is the caller graph for this function:

isShowingPostponeStatusReguired()

ilTestPlayerAbstractGUI::isShowingPostponeStatusReguired (   $questionId )

abstractprotected

Referenced by populateInstantResponseModal(), prepareTestPage(), showQuestionEditable(), and showQuestionViewable().

Here is the caller graph for this function:

isTestAccessible()

ilTestPlayerAbstractGUI::isTestAccessible

(

)

test accessible returns true if the user can perform the test

Definition at line 1088 of file class.ilTestPlayerAbstractGUI.php.

References isMaxProcessingTimeReached(), and isNrOfTriesReached().

                                      : bool
    {
        return  !$this->isNrOfTriesReached()
                and !$this->isMaxProcessingTimeReached()
                and $this->object->startingTimeReached()
                and !$this->object->endingTimeReached();
    }

Here is the call graph for this function:

markQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::markQuestionAndSaveIntermediateCmd ( )

protected

Definition at line 634 of file class.ilTestPlayerAbstractGUI.php.

References handleIntermediateSubmit(), and markQuestionCmd().

                                                           : void
    {
        $this->handleIntermediateSubmit();
        $this->markQuestionCmd();
    }

Here is the call graph for this function:

markQuestionCmd()

ilTestPlayerAbstractGUI::markQuestionCmd ( )

protected

Set a question solved.

Definition at line 643 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getCurrentSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by markQuestionAndSaveIntermediateCmd().

                                        : void
    {
        $questionId = $this->testSequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );

        $this->object->setQuestionSetSolved(1, $questionId, $this->test_session->getUserId());

        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

maxProcessingTimeReached()

ilTestPlayerAbstractGUI::maxProcessingTimeReached

(

)

Outputs a message when the maximum processing time is reached.

Outputs a message when the maximum processing time is reached

public

Definition at line 1126 of file class.ilTestPlayerAbstractGUI.php.

References suspendTestCmd().

Referenced by prepareTestPage().

    {
        $this->suspendTestCmd();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

nextQuestionCmd()

ilTestPlayerAbstractGUI::nextQuestionCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

outCorrectSolution()

ilTestPlayerAbstractGUI::outCorrectSolution

(

)

Creates an output of the solution of an answer compared to the correct solution.

Definition at line 1328 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ilObjStyleSheet\getContentStylePath(), ilTestServiceGUI\getCorrectSolutionOutput(), ilUtil\getStyleSheetLocation(), ilObjStyleSheet\getSyntaxStylePath(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

                                        : void
    {
        $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_as_tst_correct_solution.html", "Modules/Test");

        $this->tpl->setCurrentBlock("ContentStyle");
        $this->tpl->setVariable("LOCATION_CONTENT_STYLESHEET", ilObjStyleSheet::getContentStylePath(0));
        $this->tpl->parseCurrentBlock();

        $this->tpl->setCurrentBlock("SyntaxStyle");
        $this->tpl->setVariable("LOCATION_SYNTAX_STYLESHEET", ilObjStyleSheet::getSyntaxStylePath());
        $this->tpl->parseCurrentBlock();

        $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print.css", "Modules/Test"), "print");
        if ($this->object->getShowSolutionAnswersOnly()) {
            $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print_hide_content.css", "Modules/Test"), "print");
        }

        $this->tpl->setCurrentBlock("adm_content");
        $solution = $this->getCorrectSolutionOutput($this->testrequest->raw("evaluation"), $this->testrequest->raw("active_id"), $this->testrequest->raw("pass"));
        $this->tpl->setVariable("OUTPUT_SOLUTION", $solution);
        $this->tpl->setVariable("TEXT_BACK", $this->lng->txt("back"));
        $this->ctrl->saveParameter($this, "pass");
        $this->ctrl->saveParameter($this, "active_id");
        $this->tpl->setVariable("URL_BACK", $this->ctrl->getLinkTarget($this, "outUserResultsOverview"));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

outObligationsOnlySummaryCmd()

ilTestPlayerAbstractGUI::outObligationsOnlySummaryCmd

(

)

Definition at line 1315 of file class.ilTestPlayerAbstractGUI.php.

References outQuestionSummaryCmd().

    {
        $this->outQuestionSummaryCmd(true, true);
    }

Here is the call graph for this function:

outProcessingTime()

ilTestPlayerAbstractGUI::outProcessingTime ( int  $active_id, bool  $verbose  )

private

Definition at line 1154 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ilTestServiceGUI\getObject(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ILIAS\Test\Presentation\WorkingTime\prepareWorkingTimeJsTemplate(), and ilTestPlayerCommands\REDIRECT_AFTER_QUESTION_LIST.

Referenced by outQuestionSummaryCmd(), and prepareTestPage().

                                                                     : void
    {
        $starting_time = $this->object->getStartingTimeOfUser($active_id);
        $working_time = new WorkingTime(
            $this->lng,
            $this->ui_factory,
            $this->ui_renderer,
            $starting_time,
            $this->object->getProcessingTimeInSeconds($active_id)
        );

        $this->tpl->setCurrentBlock('enableprocessingtime');
        $this->tpl->setVariable('USER_WORKING_TIME_MESSAGE_BOX', $working_time->getMessageBox($verbose));
        $this->tpl->parseCurrentBlock();

        $working_time_js_template = $working_time->prepareWorkingTimeJsTemplate(
            $this->getObject(),
            getdate($starting_time),
            $this->ctrl->getLinkTarget($this, 'checkWorkingTime', '', true),
            $this->ctrl->getFormAction($this, ilTestPlayerCommands::REDIRECT_AFTER_QUESTION_LIST)
        );

        $this->tpl->addOnLoadCode($working_time_js_template->get());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

outQuestionSummaryCmd()

ilTestPlayerAbstractGUI::outQuestionSummaryCmd	(	bool	$obligations_info = false,
		bool	$obligations_filter = false
	)

Output of a summary of all test questions for test participants.

Definition at line 1246 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getContentBlockName(), ilTestServiceGUI\getObject(), ILIAS\Repository\help(), isQuestionSummaryFinishTestButtonRequired(), ILIAS\Repository\lng(), ilObjTest\lookupExamId(), ILIAS\Repository\object(), outProcessingTime(), and ilTestPlayerLayoutProvider\TEST_PLAYER_VIEW_TITLE.

Referenced by outObligationsOnlySummaryCmd(), and outQuestionSummaryWithObligationsInfoCmd().

      {
        $this->help->setScreenIdComponent("tst");
        $this->help->setScreenId("assessment");
        $this->help->setSubScreenId("question_summary");

        $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_question_summary.html", "Modules/Test");

        $this->global_screen->tool()->context()->current()->getAdditionalData()->replace(
            ilTestPlayerLayoutProvider::TEST_PLAYER_VIEW_TITLE,
            $this->getObject()->getTitle() . ' - ' . $this->lng->txt('question_summary')
        );

        if ($obligations_info
            && $this->object->areObligationsEnabled()
            && !$this->object->allObligationsAnswered()) {
            $this->tpl->setOnScreenMessage('failure', $this->lng->txt('not_all_obligations_answered'));
        }

        $active_id = $this->test_session->getActiveId();
        $question_summary_data = $this->service->getQuestionSummaryData($this->testSequence, $obligations_filter);

        $this->ctrl->setParameter($this, "sequence", $this->testrequest->raw("sequence"));

        $table_gui = new ilListOfQuestionsTableGUI(
            $this,
            'showQuestion',
            $this->ui_factory,
            $this->ui_renderer
        );
        if (($this->object->getNrOfTries() - 1) === $this->test_session->getPass()) {
            $table_gui->setUserHasAttemptsLeft(false);
        }
        $table_gui->setShowPointsEnabled(!$this->object->getTitleOutput());
        $table_gui->setShowMarkerEnabled($this->object->getShowMarker());
        $table_gui->setObligationsNotAnswered(!$this->object->allObligationsAnswered());
        $table_gui->setShowObligationsEnabled($this->object->areObligationsEnabled());
        $table_gui->setObligationsFilterEnabled($obligations_filter);
        $table_gui->setFinishTestButtonEnabled($this->isQuestionSummaryFinishTestButtonRequired());

        $table_gui->init();

        $table_gui->setData($question_summary_data);

        $this->tpl->setVariable('TABLE_LIST_OF_QUESTIONS', $table_gui->getHTML());

        if ($this->object->getEnableProcessingTime()) {
            $this->outProcessingTime($active_id, true);
        }

        if ($this->object->isShowExamIdInTestPassEnabled()) {
            $this->tpl->setCurrentBlock('exam_id_footer');
            $this->tpl->setVariable('EXAM_ID_VAL', ilObjTest::lookupExamId(
                $this->test_session->getActiveId(),
                $this->test_session->getPass(),
                $this->object->getId()
            ));
            $this->tpl->setVariable('EXAM_ID_TXT', $this->lng->txt('exam_id'));
            $this->tpl->parseCurrentBlock();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

outQuestionSummaryWithObligationsInfoCmd()

ilTestPlayerAbstractGUI::outQuestionSummaryWithObligationsInfoCmd

(

)

Definition at line 1310 of file class.ilTestPlayerAbstractGUI.php.

References outQuestionSummaryCmd().

    {
        $this->outQuestionSummaryCmd(true, false);
    }

Here is the call graph for this function:

outUserResultsOverviewCmd()

ilTestPlayerAbstractGUI::outUserResultsOverviewCmd

(

)

Definition at line 1454 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl().

    {
        $this->ctrl->redirectByClass(
            ['ilRepositoryGUI', 'ilObjTestGUI', 'ilTestEvaluationGUI'],
            "outUserResultsOverview"
        );
    }

Here is the call graph for this function:

performTestPassFinishedTasks()

ilTestPlayerAbstractGUI::performTestPassFinishedTasks ( )

protected

Definition at line 721 of file class.ilTestPlayerAbstractGUI.php.

References sendNewPassFinishedNotificationEmailIfActivated().

Referenced by finishTestCmd(), and redirectAfterFinish().

                                                     : void
    {
        (new ilTestPassFinishTasks($this->test_session, $this->object))->performFinishTasks($this->processLocker);

        $this->sendNewPassFinishedNotificationEmailIfActivated(
            $this->test_session->getActiveId(),
            $this->test_session->getPass()
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateContentStyleBlock()

ilTestPlayerAbstractGUI::populateContentStyleBlock ( )

protected

Definition at line 403 of file class.ilTestPlayerAbstractGUI.php.

References ilObjStyleSheet\getContentStylePath().

Referenced by prepareTestPage().

    {
        $this->tpl->setCurrentBlock("ContentStyle");
        $this->tpl->setVariable(
            "LOCATION_CONTENT_STYLESHEET",
            ilObjStyleSheet::getContentStylePath(0)
        );
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateDiscardSolutionModal()

ilTestPlayerAbstractGUI::populateDiscardSolutionModal ( )

protected

Definition at line 2203 of file class.ilTestPlayerAbstractGUI.php.

References $id, ilTestServiceGUI\$tpl, ilGlobalTemplateInterface\get(), ilModalGUI\getInstance(), ILIAS\Repository\lng(), ilGlobalTemplateInterface\parseCurrentBlock(), ilGlobalTemplateInterface\setCurrentBlock(), ilGlobalTemplateInterface\setVariable(), and ILIAS\UI\Implementation\Component\withAdditionalOnLoadCode().

Referenced by populateModals().

    {
        $tpl = new ilTemplate('tpl.tst_player_confirmation_modal.html', true, true, 'Modules/Test');

        $tpl->setVariable('CONFIRMATION_TEXT', $this->lng->txt('discard_answer_confirmation'));

        $button = $this->ui_factory->button()->standard($this->lng->txt('discard_answer'), '#')
        ->withAdditionalOnLoadCode(
            fn($id) => "document.getElementById('$id').addEventListener(
                'click',
                 (event)=>{
                    event.target.name = 'cmd[discardSolution]';
                    event.target.form.requestSubmit(event.target);
                }
            )"
        );

        $tpl->setCurrentBlock('buttons');
        $tpl->setVariable('BUTTON', $this->ui_renderer->render($button));
        $tpl->parseCurrentBlock();

        $button = $this->ui_factory->button()->primary($this->lng->txt('cancel'), '#')
        ->withAdditionalOnLoadCode(
            fn($id) => "document.getElementById('$id').addEventListener(
                'click',
                 ()=>$('#tst_discard_solution_modal').modal('hide')
            );"
        );
        $tpl->setCurrentBlock('buttons');
        $tpl->setVariable('BUTTON', $this->ui_renderer->render($button));
        $tpl->parseCurrentBlock();

        $modal = ilModalGUI::getInstance();
        $modal->setId('tst_discard_solution_modal');
        $modal->setHeading($this->lng->txt('discard_answer'));
        $modal->setBody($tpl->get());

        $this->tpl->setCurrentBlock('discard_solution_modal');
        $this->tpl->setVariable('DISCARD_SOLUTION_MODAL', $modal->getHTML());
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateFeedbackBlockHeader()

ilTestPlayerAbstractGUI::populateFeedbackBlockHeader (   $withFocusAnchor )

protected

Definition at line 1946 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\lng().

Referenced by populateInstantResponseBlocks().

    {
        if ($withFocusAnchor) {
            $this->tpl->setCurrentBlock('inst_resp_id');
            $this->tpl->setVariable('INSTANT_RESPONSE_FOCUS_ID', 'focus');
            $this->tpl->parseCurrentBlock();
        }

        $this->tpl->setCurrentBlock('instant_response_header');
        $this->tpl->setVariable('INSTANT_RESPONSE_HEADER', $this->lng->txt('tst_feedback'));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateFeedbackBlockMessage()

ilTestPlayerAbstractGUI::populateFeedbackBlockMessage ( string  $a_message )

protected

Definition at line 1959 of file class.ilTestPlayerAbstractGUI.php.

Referenced by populateInstantResponseBlocks().

    {
        $this->tpl->setCurrentBlock('instant_response_message');
        $this->tpl->setVariable('INSTANT_RESPONSE_MESSAGE', $a_message);
        $this->tpl->parseCurrentBlock();
    }

Here is the caller graph for this function:

populateGenericFeedbackBlock()

ilTestPlayerAbstractGUI::populateGenericFeedbackBlock ( assQuestionGUI  $question_gui,   $solutionCorrect  )

protected

Returns

bool true, if there is some feedback populated

Definition at line 350 of file class.ilTestPlayerAbstractGUI.php.

References ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_CORRECT, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_WRONG, and assQuestionGUI\getGenericFeedbackOutput().

Referenced by populateInstantResponseBlocks().

                                                                                                   : bool
    {
        // fix #031263: add pass
        $feedback = $question_gui->getGenericFeedbackOutput($this->test_session->getActiveId(), $this->test_session->getPass());

        if (strlen($feedback)) {
            $cssClass = (
                $solutionCorrect ?
                ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_CORRECT : ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_WRONG
            );

            $this->tpl->setCurrentBlock("answer_feedback");
            $this->tpl->setVariable("ANSWER_FEEDBACK", $feedback);
            $this->tpl->setVariable("ILC_FB_CSS_CLASS", $cssClass);
            $this->tpl->parseCurrentBlock();
            return true;
        }
        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateHelperGuiContent()

ilTestPlayerAbstractGUI::populateHelperGuiContent (   $helperGui )

protected

Parameters

$helperGui

Definition at line 1668 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getContentBlockName(), and ILIAS\Repository\object().

Referenced by showAnswerOptionalQuestionsConfirmation().

    {
        if ($this->object->getKioskMode()) {
            //$this->tpl->setBodyClass("kiosk");
            $this->tpl->hideFooter();
            $this->tpl->addBlockfile('CONTENT', 'adm_content', "tpl.il_as_tst_kiosk_mode_content.html", "Modules/Test");
            $this->tpl->setContent($this->ctrl->getHTML($helperGui));
        } else {
            $this->tpl->setVariable($this->getContentBlockName(), $this->ctrl->getHTML($helperGui));
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateInstantResponseBlocks()

ilTestPlayerAbstractGUI::populateInstantResponseBlocks ( assQuestionGUI  $questionGui,   $authorizedSolution  )

protected

See also

ilAssQuestionPreviewGUI::handleInstantResponseRendering()

Definition at line 1869 of file class.ilTestPlayerAbstractGUI.php.

References ilObjTest\_getPass(), determineInlineScoreDisplay(), assQuestionGUI\getSolutionOutput(), assQuestionGUI\hasInlineFeedback(), ILIAS\Repository\lng(), ILIAS\Repository\object(), populateFeedbackBlockHeader(), populateFeedbackBlockMessage(), populateGenericFeedbackBlock(), populateScoreBlock(), populateSolutionBlock(), and populateSpecificFeedbackBlock().

Referenced by populateInstantResponseModal(), and ilTestOutputGUI\showQuestionCmd().

    {
        $response_available = false;
        $jump_to_response = false;

        // This controls if the solution should be shown.
        // It gets the parameter "Scoring and Results" -> "Instant Feedback" -> "Show Solutions"
        if ($this->object->getInstantFeedbackSolution()) {
            $show_question_inline_score = $this->determineInlineScoreDisplay();

            // Notation of the params prior to getting rid of this crap in favor of a class
            $solutionoutput = $questionGui->getSolutionOutput(
                $this->test_session->getActiveId(),    #active_id
                $this->test_session->getPass(),                                                #pass
                false,                                                #graphical_output
                $show_question_inline_score,                        #result_output
                true,                                                #show_question_only
                false,                                                #show_feedback
                true,                                                #show_correct_solution
                false,                                                #show_manual_scoring
                false                                                #show_question_text
            );
            $solutionoutput = str_replace('<h1 class="ilc_page_title_PageTitle"></h1>', '', $solutionoutput);
            $this->populateSolutionBlock($solutionoutput);
            $response_available = true;
            $jump_to_response = true;
        }

        $reachedPoints = $questionGui->object->getAdjustedReachedPoints(
            $this->test_session->getActiveId(),
            ilObjTest::_getPass($this->test_session->getActiveId()),
            $authorizedSolution
        );

        $maxPoints = $questionGui->object->getMaximumPoints();

        $solutionCorrect = ($reachedPoints == $maxPoints);

        // This controls if the score should be shown.
        // It gets the parameter "Scoring and Results" -> "Instant Feedback" -> "Show Results (Only Points)"
        if ($this->object->getAnswerFeedbackPoints()) {
            $this->populateScoreBlock($reachedPoints, $maxPoints);
            $response_available = true;
            $jump_to_response = true;
        }

        // This controls if the generic feedback should be shown.
        // It gets the parameter "Scoring and Results" -> "Instant Feedback" -> "Show Solutions"
        if ($this->object->getGenericAnswerFeedback()) {
            if ($this->populateGenericFeedbackBlock($questionGui, $solutionCorrect)) {
                $response_available = true;
                $jump_to_response = true;
            }
        }

        // This controls if the specific feedback should be shown.
        // It gets the parameter "Scoring and Results" -> "Instant Feedback" -> "Show Answer-Specific Feedback"
        if ($this->object->getSpecificAnswerFeedback()) {
            if ($questionGui->hasInlineFeedback()) {
                // Don't jump to the feedback below the question if some feedback is shown within the question
                $jump_to_response = false;
            } elseif ($this->populateSpecificFeedbackBlock($questionGui)) {
                $response_available = true;
                $jump_to_response = true;
            }
        }

        $this->populateFeedbackBlockHeader($jump_to_response);
        if (!$response_available) {
            if ($questionGui->hasInlineFeedback()) {
                $this->populateFeedbackBlockMessage($this->lng->txt('tst_feedback_is_given_inline'));
            } else {
                $this->populateFeedbackBlockMessage($this->lng->txt('tst_feedback_not_available_for_answer'));
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateInstantResponseModal()

ilTestPlayerAbstractGUI::populateInstantResponseModal ( assQuestionGUI  $questionGui,   $navUrl  )

protected

Definition at line 1816 of file class.ilTestPlayerAbstractGUI.php.

References ilTestServiceGUI\$tpl, ilGlobalTemplateInterface\get(), ilModalGUI\getInstance(), assQuestionGUI\getQuestionHeaderBlockBuilder(), assQuestionGUI\getSolutionOutput(), isShowingPostponeStatusReguired(), ILIAS\Repository\lng(), assQuestionGUI\outQuestionPage(), populateInstantResponseBlocks(), assQuestionGUI\setNavigationGUI(), ilGlobalTemplateInterface\setVariable(), and ilModalGUI\TYPE_LARGE.

Referenced by ilTestOutputGUI\showQuestionCmd().

    {
        $questionGui->setNavigationGUI(null);
        $questionGui->getQuestionHeaderBlockBuilder()->setQuestionAnswered(true);

        $answerFeedbackEnabled = $this->object->getSpecificAnswerFeedback();

        $solutionoutput = $questionGui->getSolutionOutput(
            $this->test_session->getActiveId(),         #active_id
            $this->test_session->getPass(),             #pass
            false,                                                              #graphical_output
            false,                                                              #result_output
            true,                                                               #show_question_only
            $answerFeedbackEnabled,                             #show_feedback
            false,                                                              #show_correct_solution
            false,                                                              #show_manual_scoring
            true                                                                #show_question_text
        );

        $pageoutput = $questionGui->outQuestionPage(
            "",
            $this->isShowingPostponeStatusReguired($questionGui->object->getId()),
            $this->test_session->getActiveId(),
            $solutionoutput
        );

        $tpl = new ilTemplate('tpl.tst_player_response_modal.html', true, true, 'Modules/Test');

        // populate the instant response blocks in the
        $saved_tpl = $this->tpl;
        $this->tpl = $tpl;
        $this->populateInstantResponseBlocks($questionGui, true);
        $this->tpl = $saved_tpl;

        $tpl->setVariable('QUESTION_OUTPUT', $pageoutput);

        $button = $this->ui_factory->button()->primary($this->lng->txt('proceed'), $navUrl);
        $tpl->setVariable('BUTTON', $this->ui_renderer->render($button));

        $modal = ilModalGUI::getInstance();
        $modal->setType(ilModalGUI::TYPE_LARGE);
        $modal->setId('tst_question_feedback_modal');
        $modal->setHeading($this->lng->txt('tst_instant_feedback'));
        $modal->setBody($tpl->get());

        $this->tpl->addOnLoadCode("$('#tst_question_feedback_modal').modal('show');");
        $this->tpl->setVariable('INSTANT_RESPONSE_MODAL', $modal->getHTML());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateLowerNextButtonBlock()

ilTestPlayerAbstractGUI::populateLowerNextButtonBlock (   $primary_next )

protected

Definition at line 240 of file class.ilTestPlayerAbstractGUI.php.

References buildNextButtonInstance().

Referenced by populateNextButtons().

                                                                  : void
    {
        $button = $this->buildNextButtonInstance($primary_next);

        $this->tpl->setCurrentBlock("next_bottom");
        $this->tpl->setVariable("BTN_NEXT_BOTTOM", $this->ui_renderer->render($button));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateLowerPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateLowerPreviousButtonBlock ( )

protected

Definition at line 258 of file class.ilTestPlayerAbstractGUI.php.

References buildPreviousButtonInstance().

Referenced by populatePreviousButtons().

    {
        $button = $this->buildPreviousButtonInstance();

        $this->tpl->setCurrentBlock("prev_bottom");
        $this->tpl->setVariable("BTN_PREV_BOTTOM", $this->ui_renderer->render($button));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateMessageContent()

ilTestPlayerAbstractGUI::populateMessageContent (   $contentHTML )

protected

Parameters

$contentHTML

Definition at line 2179 of file class.ilTestPlayerAbstractGUI.php.

References getContentBlockName(), and ILIAS\Repository\object().

    {
        if ($this->object->getKioskMode()) {
            $this->tpl->addBlockfile($this->getContentBlockName(), 'content', "tpl.il_as_tst_kiosk_mode_content.html", "Modules/Test");
            $this->tpl->setContent($contentHTML);
        } else {
            $this->tpl->setVariable($this->getContentBlockName(), $contentHTML);
        }
    }

Here is the call graph for this function:

populateModals()

ilTestPlayerAbstractGUI::populateModals ( )

protected

Definition at line 2189 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\object(), populateDiscardSolutionModal(), populateNavWhenChangedModal(), populateNextLocksChangedModal(), and populateNextLocksUnchangedModal().

Referenced by showQuestionEditable().

    {
        $this->populateDiscardSolutionModal();
        // fau: testNav - populateNavWhenChangedModal instead of populateNavWhileEditModal
        $this->populateNavWhenChangedModal();
        // fau.

        if ($this->object->isFollowupQuestionAnswerFixationEnabled()) {
            $this->populateNextLocksChangedModal();

            $this->populateNextLocksUnchangedModal();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateNavWhenChangedModal()

ilTestPlayerAbstractGUI::populateNavWhenChangedModal ( )

protected

Definition at line 2245 of file class.ilTestPlayerAbstractGUI.php.

References ilTestServiceGUI\$tpl, ilGlobalTemplateInterface\get(), ilSession\get(), ilLinkButton\getInstance(), ilModalGUI\getInstance(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ilGlobalTemplateInterface\parseCurrentBlock(), ilGlobalTemplateInterface\setCurrentBlock(), and ilGlobalTemplateInterface\setVariable().

Referenced by populateModals().

    {
        return; // usibility fix: get rid of popup

        if (ilSession::get('save_on_navigation_prevent_confirmation') == null) {
            return;
        }

        $tpl = new ilTemplate('tpl.tst_player_confirmation_modal.html', true, true, 'Modules/Test');

        if ($this->object->isInstantFeedbackAnswerFixationEnabled() && $this->object->isForceInstantFeedbackEnabled()) {
            $text = $this->lng->txt('save_on_navigation_locked_confirmation');
        } else {
            $text = $this->lng->txt('save_on_navigation_confirmation');
        }
        if ($this->object->isForceInstantFeedbackEnabled()) {
            $text .= " " . $this->lng->txt('save_on_navigation_forced_feedback_hint');
        }
        $tpl->setVariable('CONFIRMATION_TEXT', $text);

        /*
        $button = ilLinkButton::getInstance();
        $button->setId('tst_save_on_navigation_button');
        $button->setUrl('#');
        $button->setCaption('tst_save_and_proceed');
        $button->setPrimary(true);
        */
        $button = $this->ui_factory->button()->primary($this->lng->txt('tst_save_and_proceed'), '#');

        $tpl->setCurrentBlock('buttons');
        $tpl->setVariable('BUTTON', $this->ui_renderer->render($button));
        $tpl->parseCurrentBlock();

        $button = ilLinkButton::getInstance();
        $button->setId('tst_cancel_on_navigation_button');
        $button->setUrl('#');
        $button->setCaption('cancel');
        $button->setPrimary(false);
        $tpl->setCurrentBlock('buttons');
        $tpl->setVariable('BUTTON', $button->render());
        $tpl->parseCurrentBlock();

        $tpl->setCurrentBlock('checkbox');
        $tpl->setVariable('CONFIRMATION_CHECKBOX_NAME', 'save_on_navigation_prevent_confirmation');
        $tpl->setVariable('CONFIRMATION_CHECKBOX_LABEL', $this->lng->txt('tst_dont_show_msg_again_in_current_session'));
        $tpl->parseCurrentBlock();

        $modal = ilModalGUI::getInstance();
        $modal->setId('tst_save_on_navigation_modal');
        $modal->setHeading($this->lng->txt('save_on_navigation'));
        $modal->setBody($tpl->get());

        $this->tpl->setCurrentBlock('nav_while_edit_modal');
        $this->tpl->setVariable('NAV_WHILE_EDIT_MODAL', $modal->getHTML());
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateNextButtons()

ilTestPlayerAbstractGUI::populateNextButtons (   $primary_next )

protected

Definition at line 234 of file class.ilTestPlayerAbstractGUI.php.

References populateLowerNextButtonBlock(), and populateUpperNextButtonBlock().

Referenced by populateQuestionNavigation().

                                                         : void
    {
        $this->populateUpperNextButtonBlock($primary_next);
        $this->populateLowerNextButtonBlock($primary_next);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateNextLocksChangedModal()

ilTestPlayerAbstractGUI::populateNextLocksChangedModal ( )

protected

Definition at line 2322 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by populateModals().

    {
        if ($this->isFollowUpQuestionLocksConfirmationPrevented()) {
            return;
        }

        $modal = new ilTestPlayerConfirmationModal($this->ui_renderer);
        $modal->setModalId('tst_next_locks_changed_modal');

        $modal->setHeaderText($this->lng->txt('tst_nav_next_locks_current_answer_header'));
        $modal->setConfirmationText($this->lng->txt('tst_nav_next_locks_current_answer_confirm'));

        $modal->setConfirmationCheckboxName(self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM);
        $modal->setConfirmationCheckboxLabel($this->lng->txt('tst_dont_show_msg_again_in_current_session'));

        $button = $this->ui_factory->button()->primary($this->lng->txt('tst_save_and_proceed'), '#');
        $modal->addButton($button);

        $button = $this->ui_factory->button()->standard($this->lng->txt('cancel'), '#');
        $modal->addButton($button);

        $this->tpl->setCurrentBlock('next_locks_changed_modal');
        $this->tpl->setVariable('NEXT_LOCKS_CHANGED_MODAL', $modal->getHTML());
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateNextLocksUnchangedModal()

ilTestPlayerAbstractGUI::populateNextLocksUnchangedModal ( )

protected

Definition at line 2303 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\lng().

Referenced by populateModals().

    {
        $modal = new ilTestPlayerConfirmationModal($this->ui_renderer);
        $modal->setModalId('tst_next_locks_unchanged_modal');

        $modal->setHeaderText($this->lng->txt('tst_nav_next_locks_empty_answer_header'));
        $modal->setConfirmationText($this->lng->txt('tst_nav_next_locks_empty_answer_confirm'));

        $button = $this->ui_factory->button()->standard($this->lng->txt('tst_proceed'), '#');
        $modal->addButton($button);

        $button = $this->ui_factory->button()->primary($this->lng->txt('cancel'), '#');
        $modal->addButton($button);

        $this->tpl->setCurrentBlock('next_locks_unchanged_modal');
        $this->tpl->setVariable('NEXT_LOCKS_UNCHANGED_MODAL', $modal->getHTML());
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populatePreviousButtons()

ilTestPlayerAbstractGUI::populatePreviousButtons ( )

protected

Definition at line 228 of file class.ilTestPlayerAbstractGUI.php.

References populateLowerPreviousButtonBlock(), and populateUpperPreviousButtonBlock().

Referenced by populateQuestionNavigation().

                                                : void
    {
        $this->populateUpperPreviousButtonBlock();
        $this->populateLowerPreviousButtonBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateQuestionNavigation()

ilTestPlayerAbstractGUI::populateQuestionNavigation (   $sequence_element,   $primary_next  )

protected

Definition at line 217 of file class.ilTestPlayerAbstractGUI.php.

References isFirstQuestionInSequence(), isLastQuestionInSequence(), populateNextButtons(), and populatePreviousButtons().

Referenced by ilTestOutputGUI\showQuestionCmd().

                                                                                   : void
    {
        if (!$this->isFirstQuestionInSequence($sequence_element)) {
            $this->populatePreviousButtons();
        }

        if (!$this->isLastQuestionInSequence($sequence_element)) {
            $this->populateNextButtons($primary_next);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateScoreBlock()

ilTestPlayerAbstractGUI::populateScoreBlock (   $reachedPoints,   $maxPoints  )

protected

Definition at line 370 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\lng().

Referenced by populateInstantResponseBlocks().

    {
        $scoreInformation = sprintf(
            $this->lng->txt("you_received_a_of_b_points"),
            $reachedPoints,
            $maxPoints
        );

        $this->tpl->setCurrentBlock("received_points_information");
        $this->tpl->setVariable("RECEIVED_POINTS_INFORMATION", $scoreInformation);
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateSolutionBlock()

ilTestPlayerAbstractGUI::populateSolutionBlock (   $solutionoutput )

protected

Definition at line 383 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\lng().

Referenced by populateInstantResponseBlocks().

    {
        if (strlen($solutionoutput)) {
            $this->tpl->setCurrentBlock("solution_output");
            $this->tpl->setVariable("CORRECT_SOLUTION", $this->lng->txt("tst_best_solution_is"));
            $this->tpl->setVariable("QUESTION_FEEDBACK", $solutionoutput);
            $this->tpl->parseCurrentBlock();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateSpecificFeedbackBlock()

ilTestPlayerAbstractGUI::populateSpecificFeedbackBlock ( assQuestionGUI  $question_gui )

protected

Returns

bool true, if there is some feedback populated

Definition at line 327 of file class.ilTestPlayerAbstractGUI.php.

References assQuestionGUI\getSpecificFeedbackOutput().

Referenced by populateInstantResponseBlocks().

                                                                                  : bool
    {
        $solutionValues = $question_gui->object->getSolutionValues(
            $this->test_session->getActiveId(),
            null
        );

        $feedback = $question_gui->getSpecificFeedbackOutput(
            $question_gui->object->fetchIndexedValuesFromValuePairs($solutionValues)
        );

        if (!empty($feedback)) {
            $this->tpl->setCurrentBlock("specific_feedback");
            $this->tpl->setVariable("SPECIFIC_FEEDBACK", $feedback);
            $this->tpl->parseCurrentBlock();
            return true;
        }
        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateSyntaxStyleBlock()

ilTestPlayerAbstractGUI::populateSyntaxStyleBlock ( )

protected

Definition at line 393 of file class.ilTestPlayerAbstractGUI.php.

References ilObjStyleSheet\getSyntaxStylePath().

Referenced by prepareTestPage().

    {
        $this->tpl->setCurrentBlock("SyntaxStyle");
        $this->tpl->setVariable(
            "LOCATION_SYNTAX_STYLESHEET",
            ilObjStyleSheet::getSyntaxStylePath()
        );
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateTestNavigationToolbar()

ilTestPlayerAbstractGUI::populateTestNavigationToolbar ( ilTestNavigationToolbarGUI  $toolbar_gui )

protected

Definition at line 197 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\showQuestionCmd().

                                                                                             : void
    {
        $this->tpl->setCurrentBlock('test_nav_toolbar');
        $this->tpl->setVariable('TEST_NAV_TOOLBAR', $toolbar_gui->getHTML());
        $this->tpl->parseCurrentBlock();

        if ($this->finish_test_modal === null) {
            return;
        }

        $this->tpl->setCurrentBlock('finish_test_modal');
        $this->tpl->setVariable(
            'FINISH_TEST_MODAL',
            $this->ui_renderer->render(
                $this->finish_test_modal->withOnLoad($this->finish_test_modal->getShowSignal())
            )
        );
        $this->tpl->parseCurrentBlock();
    }

Here is the caller graph for this function:

populateUpperNextButtonBlock()

ilTestPlayerAbstractGUI::populateUpperNextButtonBlock (   $primaryNext )

protected

Definition at line 249 of file class.ilTestPlayerAbstractGUI.php.

References buildNextButtonInstance().

Referenced by populateNextButtons().

    {
        $button = $this->buildNextButtonInstance($primaryNext);

        $this->tpl->setCurrentBlock("next");
        $this->tpl->setVariable("BTN_NEXT", $this->ui_renderer->render($button));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateUpperPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateUpperPreviousButtonBlock ( )

protected

Definition at line 267 of file class.ilTestPlayerAbstractGUI.php.

References buildPreviousButtonInstance().

Referenced by populatePreviousButtons().

    {
        $button = $this->buildPreviousButtonInstance();

        $this->tpl->setCurrentBlock("prev");
        $this->tpl->setVariable("BTN_PREV", $this->ui_renderer->render($button));
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

prepareSummaryPage()

ilTestPlayerAbstractGUI::prepareSummaryPage ( )

protected

Definition at line 1503 of file class.ilTestPlayerAbstractGUI.php.

References getContentBlockName().

    {
        $this->tpl->addBlockFile(
            $this->getContentBlockName(),
            'adm_content',
            'tpl.il_as_tst_question_summary.html',
            'Modules/Test'
        );
    }

Here is the call graph for this function:

prepareTestPage()

ilTestPlayerAbstractGUI::prepareTestPage (   $sequenceElement,   $questionId  )

protected

Definition at line 833 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), endingTimeReached(), initTestPageTemplate(), isMaxProcessingTimeReached(), isOptionalQuestionAnsweringConfirmationRequired(), isShowingPostponeStatusReguired(), ILIAS\Repository\lng(), ilObjTest\lookupExamId(), maxProcessingTimeReached(), ILIAS\Repository\object(), outProcessingTime(), populateContentStyleBlock(), populateSyntaxStyleBlock(), ilTestPlayerCommands\RESUME_PLAYER, showAnswerOptionalQuestionsConfirmation(), showSideList(), and ILIAS\Repository\user().

Referenced by ilTestOutputGUI\showQuestionCmd().

    {
        $this->navigation_history->addItem(
            $this->test_session->getRefId(),
            $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::RESUME_PLAYER),
            'tst'
        );

        $this->initTestPageTemplate();
        $this->populateContentStyleBlock();
        $this->populateSyntaxStyleBlock();

        if ($this->isMaxProcessingTimeReached()) {
            $this->maxProcessingTimeReached();
            return;
        }

        if ($this->object->endingTimeReached()) {
            $this->endingTimeReached();
            return;
        }

        if ($this->isOptionalQuestionAnsweringConfirmationRequired($sequenceElement)) {
            $this->ctrl->setParameter($this, "sequence", $sequenceElement);
            $this->showAnswerOptionalQuestionsConfirmation();
            return;
        }

        $this->tpl->setVariable("TEST_ID", (string) $this->object->getTestId());
        $this->tpl->setVariable("LOGIN", $this->user->getLogin());

        $this->tpl->setVariable("SEQ_ID", $sequenceElement);
        $this->tpl->setVariable("QUEST_ID", $questionId);

        if ($this->object->getEnableProcessingTime()) {
            $this->outProcessingTime($this->test_session->getActiveId(), false);
        }

        $this->tpl->setVariable("PAGETITLE", "- " . $this->object->getTitle());

        if ($this->object->isShowExamIdInTestPassEnabled() && !$this->object->getKioskMode()) {
            $this->tpl->setCurrentBlock('exam_id_footer');
            $this->tpl->setVariable('EXAM_ID_VAL', ilObjTest::lookupExamId(
                $this->test_session->getActiveId(),
                $this->test_session->getPass(),
                $this->object->getId()
            ));
            $this->tpl->setVariable('EXAM_ID_TXT', $this->lng->txt('exam_id'));
            $this->tpl->parseCurrentBlock();
        }

        if ($this->object->getListOfQuestions()) {
            $this->showSideList($sequenceElement);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

previousQuestionCmd()

ilTestPlayerAbstractGUI::previousQuestionCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

redirectAfterAutosaveCmd()

ilTestPlayerAbstractGUI::redirectAfterAutosaveCmd

(

)

Redirect the user after an automatic save when the time limit is reached.

Exceptions

ilTestException

Definition at line 530 of file class.ilTestPlayerAbstractGUI.php.

References redirectAfterFinish().

                                              : void
    {
        $this->redirectAfterFinish();
    }

Here is the call graph for this function:

redirectAfterFinish()

ilTestPlayerAbstractGUI::redirectAfterFinish ( )

protected

Definition at line 540 of file class.ilTestPlayerAbstractGUI.php.

References $url, ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, ILIAS\Repository\ctrl(), getContentBlockName(), getCurrentQuestionId(), ILIAS\Repository\lng(), and performTestPassFinishedTasks().

Referenced by redirectAfterAutosaveCmd(), and redirectAfterQuestionListCmd().

                                            : void
    {
        $this->performTestPassFinishedTasks();

        $url = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED, '', false, false);

        $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_redirect_autosave.html", "Modules/Test");
        $this->tpl->setVariable("TEXT_REDIRECT", $this->lng->txt("redirectAfterSave"));
        $this->tpl->setVariable("URL", $url);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

redirectAfterQuestionListCmd()

ilTestPlayerAbstractGUI::redirectAfterQuestionListCmd

(

)

Definition at line 535 of file class.ilTestPlayerAbstractGUI.php.

References redirectAfterFinish().

                                                  : void
    {
        $this->redirectAfterFinish();
    }

Here is the call graph for this function:

redirectBackCmd()

ilTestPlayerAbstractGUI::redirectBackCmd

(

)

Definition at line 797 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ilTestScreenGUI\DEFAULT_CMD, and ilTestServiceGUI\getObjectiveOrientedContainer().

Referenced by afterTestPassFinishedCmd(), and endingTimeReached().

                                     : void
    {
        $testPassesSelector = new ilTestPassesSelector($this->db, $this->object);
        $testPassesSelector->setActiveId($this->test_session->getActiveId());
        $testPassesSelector->setLastFinishedPass($this->test_session->getLastFinishedPass());

        if (count($testPassesSelector->getReportablePasses())) {
            if ($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()) {
                $this->ctrl->redirectByClass(['ilTestResultsGUI', 'ilTestEvalObjectiveOrientedGUI']);
            }

            $this->ctrl->redirectByClass(['ilTestResultsGUI', 'ilMyTestResultsGUI', 'ilTestEvaluationGUI']);
        }

        $this->ctrl->redirectByClass(ilTestScreenGUI::class, ilTestScreenGUI::DEFAULT_CMD);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

registerForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::registerForcedFeedbackNavUrl (   $forcedFeedbackNavUrl )

protected

Definition at line 2411 of file class.ilTestPlayerAbstractGUI.php.

References ilSession\get(), and ilSession\set().

Referenced by ilTestOutputGUI\showInstantResponseCmd().

    {
        if (ilSession::get('forced_feedback_navigation_url') == null) {
            ilSession::set('forced_feedback_navigation_url', []);
        }
        $forced_feeback_navigation_url = ilSession::get('forced_feedback_navigation_url');
        $forced_feeback_navigation_url[$this->test_session->getActiveId()] = $forcedFeedbackNavUrl;
        ilSession::set('forced_feedback_navigation_url', $forced_feeback_navigation_url);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

removeIntermediateSolution()

ilTestPlayerAbstractGUI::removeIntermediateSolution

(

)

Definition at line 154 of file class.ilTestPlayerAbstractGUI.php.

References canSaveResult(), getCurrentQuestionId(), getQuestionInstance(), and saveQuestionSolution().

Referenced by handleIntermediateSubmit(), revertChangesCmd(), ilTestOutputGUI\showInstantResponseCmd(), ilTestOutputGUI\submitSolutionAndNextCmd(), and ilTestOutputGUI\submitSolutionCmd().

                                                : void
    {
        $questionId = $this->getCurrentQuestionId();

        $this->getQuestionInstance($questionId)->removeIntermediateSolution(
            $this->test_session->getActiveId(),
            $this->test_session->getPass()
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

resumePlayerCmd()

ilTestPlayerAbstractGUI::resumePlayerCmd ( )

abstractprotected

Resume a test at the last position.

Referenced by getLockParameter().

Here is the caller graph for this function:

revertChangesCmd()

ilTestPlayerAbstractGUI::revertChangesCmd ( )

protected

Definition at line 1053 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), discardSolutionCmd(), removeIntermediateSolution(), setAnswerChangedParameter(), ilTestPlayerCommands\SHOW_QUESTION, skipQuestionCmd(), and startTestCmd().

    {
        $this->removeIntermediateSolution();
        $this->setAnswerChangedParameter(false);
        $this->ctrl->saveParameter($this, 'sequence');
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

saveNavigationPreventConfirmation()

ilTestPlayerAbstractGUI::saveNavigationPreventConfirmation ( )

protected

Save the save the switch to prevent the navigation confirmation.

Definition at line 2081 of file class.ilTestPlayerAbstractGUI.php.

References ilSession\set().

Referenced by ilTestOutputGUI\showInstantResponseCmd(), and ilTestOutputGUI\submitSolutionCmd().

    {
        if (!empty($_POST['save_on_navigation_prevent_confirmation'])) {
            ilSession::set('save_on_navigation_prevent_confirmation', true);
        }

        if (!empty($_POST[self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM])) {
            ilSession::set(self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM, true);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveQuestionSolution()

ilTestPlayerAbstractGUI::saveQuestionSolution (   $authorized = true,   $force = false  )

abstract

saves the user input of a question

Referenced by autosaveCmd(), autosaveOnTimeLimitCmd(), handleFileUploadCmd(), handleIntermediateSubmit(), removeIntermediateSolution(), and submitIntermediateSolutionCmd().

Here is the caller graph for this function:

saveTagsCmd()

ilTestPlayerAbstractGUI::saveTagsCmd

(

)

Save tags for tagging gui.

Needed this function here because the test info page uses another class to send its form results

Definition at line 128 of file class.ilTestPlayerAbstractGUI.php.

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

    {
        $tagging_gui = new ilTaggingGUI();
        $tagging_gui->setObject($this->object->getId(), $this->object->getType());
        $tagging_gui->saveInput();
        $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
    }

Here is the call graph for this function:

sendNewPassFinishedNotificationEmailIfActivated()

ilTestPlayerAbstractGUI::sendNewPassFinishedNotificationEmailIfActivated ( int  $active_id, int  $pass  )

protected

Definition at line 731 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\object().

Referenced by performTestPassFinishedTasks().

    {
        $notification_type = $this->object->getMainSettings()->getFinishingSettings()->getMailNotificationContentType();

        if ($notification_type === 0
            || !$this->object->getMainSettings()->getFinishingSettings()->getAlwaysSendMailNotification()
                && $pass !== $this->object->getNrOfTries() - 1) {
            return;
        }

        switch ($this->object->getMainSettings()->getFinishingSettings()->getMailNotificationContentType()) {
            case 1:
                $this->object->sendSimpleNotification($active_id);
                break;
            case 2:
                $this->object->sendAdvancedNotification($active_id);
                break;
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setAnonymousIdCmd()

ilTestPlayerAbstractGUI::setAnonymousIdCmd

(

)

Sets a session variable with the test access code for an anonymous test user.

Sets a session variable with the test access code for an anonymous test user

Definition at line 418 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl().

    {
        if ($this->test_session->isAnonymousUser()) {
            $this->test_session->setAccessCodeToSession($_POST['anonymous_id']);
        }

        $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
    }

Here is the call graph for this function:

setAnswerChangedParameter()

ilTestPlayerAbstractGUI::setAnswerChangedParameter (   $changed = true )

protected

Set the 'answer changed' url parameter for generated links.

Parameters

bool

$changed

Definition at line 2055 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl().

Referenced by ilTestOutputGUI\executeCommand(), handleIntermediateSubmit(), ilTestOutputGUI\handleQuestionActionCmd(), revertChangesCmd(), ilTestOutputGUI\showInstantResponseCmd(), and submitIntermediateSolutionCmd().

    {
        $this->ctrl->setParameter($this, 'test_answer_changed', $changed ? '1' : '0');
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setFollowUpQuestionLocksConfirmationPrevented()

ilTestPlayerAbstractGUI::setFollowUpQuestionLocksConfirmationPrevented ( )

protected

Definition at line 2350 of file class.ilTestPlayerAbstractGUI.php.

References ilSession\set().

    {
        ilSession::set(self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM, true);
    }

Here is the call graph for this function:

showAnswerOptionalQuestionsConfirmation()

ilTestPlayerAbstractGUI::showAnswerOptionalQuestionsConfirmation ( )

protected

Definition at line 1632 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and populateHelperGuiContent().

Referenced by prepareTestPage().

    {
        $confirmation = new ilTestAnswerOptionalQuestionsConfirmationGUI($this->lng);

        $confirmation->setFormAction($this->ctrl->getFormAction($this));
        $confirmation->setCancelCmd('cancelAnswerOptionalQuestions');
        $confirmation->setConfirmCmd('confirmAnswerOptionalQuestions');

        $confirmation->build($this->object->isFixedTest());

        $this->populateHelperGuiContent($confirmation);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showFinalStatementCmd()

ilTestPlayerAbstractGUI::showFinalStatementCmd

(

)

Definition at line 817 of file class.ilTestPlayerAbstractGUI.php.

References ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, ILIAS\Repository\ctrl(), getContentBlockName(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ilTestPlayerLayoutProvider\TEST_PLAYER_VIEW_TITLE.

    {
        $this->global_screen->tool()->context()->current()->getAdditionalData()->replace(
            ilTestPlayerLayoutProvider::TEST_PLAYER_VIEW_TITLE,
            $this->object->getTitle() . ' - ' . $this->lng->txt('final_statement')
        );
        $this->content_style->gui()->addCss($this->tpl, $this->ref_id);
        $this->ctrl->setParameterByClass(ilTestPageGUI::class, 'page_type', 'concludingremarkspage');
        $template = new ilTemplate("tpl.il_as_tst_final_statement.html", true, true, "Modules/Test");
        $this->ctrl->setParameter($this, "skipfinalstatement", 1);
        $template->setVariable("FORMACTION", $this->ctrl->getFormAction($this, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED));
        $template->setVariable("FINALSTATEMENT", $this->object->getFinalStatement());
        $template->setVariable("BUTTON_CONTINUE", $this->lng->txt("btn_next"));
        $this->tpl->setVariable($this->getContentBlockName(), $template->get());
    }

Here is the call graph for this function:

showInstantResponseCmd()

ilTestPlayerAbstractGUI::showInstantResponseCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

showListOfAnswers()

ilTestPlayerAbstractGUI::showListOfAnswers	(		$active_id,
			$pass = null,
			$top_data = "",
			$bottom_data = ""
	)

Creates an output of the list of answers for a test participant during the test (only the actual pass will be shown)

Parameters

integer	$active_id	Active id of the participant
integer	$pass	Test pass of the participant
boolean	$testnavigation	Deceides wheather to show a navigation for tests or not public

Definition at line 1364 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), ilTestServiceGUI\getAdditionalUsrDataHtmlAndPopulateWindowTitle(), getContentBlockName(), ilTestServiceGUI\getObjectiveOrientedContainer(), ilTestServiceGUI\getResultsSignature(), ilUtil\getStyleSheetLocation(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ILIAS\Repository\user().

    {
        $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_finish_list_of_answers.html", "Modules/Test");

        $result_array = &$this->object->getTestResult(
            $active_id,
            $pass,
            false,
            !$this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
        );

        $counter = 1;
        // output of questions with solutions
        foreach ($result_array as $question_data) {
            $question = $question_data["qid"];
            if (is_numeric($question)) {
                $this->tpl->setCurrentBlock("printview_question");
                $question_gui = $this->object->createQuestionGUI("", $question);
                $template = new ilTemplate("tpl.il_as_qpl_question_printview.html", true, true, "Modules/TestQuestionPool");
                $template->setVariable("COUNTER_QUESTION", $counter . ". ");
                $template->setVariable("QUESTION_TITLE", $question_gui->object->getTitleForHTMLOutput());

                $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? true : false;
                $result_output = $question_gui->getSolutionOutput(
                    $active_id,
                    $pass,
                    false,
                    false,
                    $show_question_only,
                    $this->object->getShowSolutionFeedback()
                );
                $template->setVariable("SOLUTION_OUTPUT", $result_output);
                $this->tpl->setVariable("QUESTION_OUTPUT", $template->get());
                $this->tpl->parseCurrentBlock();
                $counter++;
            }
        }

        $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print.css", "Modules/Test"), "print");
        if ($this->object->getShowSolutionAnswersOnly()) {
            $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print_hide_content.css", "Modules/Test"), "print");
        }
        if (strlen($top_data)) {
            $this->tpl->setCurrentBlock("top_data");
            $this->tpl->setVariable("TOP_DATA", $top_data);
            $this->tpl->parseCurrentBlock();
        }

        if (strlen($bottom_data)) {
            $this->tpl->setCurrentBlock("bottom_data");
            $this->tpl->setVariable("FORMACTION", $this->ctrl->getFormAction($this));
            $this->tpl->setVariable("BOTTOM_DATA", $bottom_data);
            $this->tpl->parseCurrentBlock();
        }

        $this->tpl->setCurrentBlock("adm_content");
        $this->tpl->setVariable("TXT_ANSWER_SHEET", $this->lng->txt("tst_list_of_answers"));
        $user_data = $this->getAdditionalUsrDataHtmlAndPopulateWindowTitle($this->test_session, $active_id, true);
        $signature = $this->getResultsSignature();
        $this->tpl->setVariable("USER_DETAILS", $user_data);
        $this->tpl->setVariable("SIGNATURE", $signature);
        $this->tpl->setVariable("TITLE", $this->object->getTitle());
        $this->tpl->setVariable("TXT_TEST_PROLOG", $this->lng->txt("tst_your_answers"));
        $invited_user = &$this->object->getInvitedUsers($this->user->getId());
        $pagetitle = $this->object->getTitle() . " - " . $this->lng->txt("clientip") .
            ": " . $invited_user[$this->user->getId()]["clientip"] . " - " .
            $this->lng->txt("matriculation") . ": " .
            $invited_user[$this->user->getId()]["matriculation"];
        $this->tpl->setVariable("PAGETITLE", $pagetitle);
        $this->tpl->parseCurrentBlock();
    }

Here is the call graph for this function:

showQuestionCmd()

ilTestPlayerAbstractGUI::showQuestionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex(), and finishTestCmd().

Here is the caller graph for this function:

showQuestionEditable()

ilTestPlayerAbstractGUI::showQuestionEditable ( assQuestionGUI  $questionGui,   $formAction,   $isQuestionWorkedThrough,   $instantResponse  )

protected

Definition at line 942 of file class.ilTestPlayerAbstractGUI.php.

References buildEditableStateQuestionNavigationGUI(), ilSession\clear(), ILIAS\Repository\ctrl(), determineSolutionPassIndex(), ilSession\get(), assQuestionGUI\getQuestionHeaderBlockBuilder(), isShowingPostponeStatusReguired(), ILIAS\Repository\object(), assQuestionGUI\outQuestionForTest(), populateModals(), assQuestionGUI\setNavigationGUI(), and ilTestPlayerCommands\SKIP_QUESTION.

Referenced by ilTestOutputGUI\showQuestionCmd().

    {
        $questionNavigationGUI = $this->buildEditableStateQuestionNavigationGUI($questionGui->object->getId());
        if ($isQuestionWorkedThrough) {
            $questionNavigationGUI->setDiscardSolutionButtonEnabled(true);
            // fau: testNav - set answere status in question header
            $questionGui->getQuestionHeaderBlockBuilder()->setQuestionAnswered(true);
            // fau.
        } elseif ($this->object->isPostponingEnabled()) {
            $questionNavigationGUI->setSkipQuestionLinkTarget(
                $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::SKIP_QUESTION)
            );
        }
        $questionGui->setNavigationGUI($questionNavigationGUI);

        $isPostponed = $this->isShowingPostponeStatusReguired($questionGui->object->getId());

        $answerFeedbackEnabled = (
            $instantResponse && $this->object->getSpecificAnswerFeedback()
        );

        if ($this->testrequest->isset('save_error') && $this->testrequest->raw('save_error') == 1 && ilSession::get('previouspost') != null) {
            $userPostSolution = ilSession::get('previouspost');
            ilSession::clear('previouspost');
        } else {
            $userPostSolution = false;
        }

        // fau: testNav - add special checkbox for mc question
        // moved to another patch block
        // fau.

        // hey: prevPassSolutions - determine solution pass index and configure gui accordingly
        $qstConfig = $questionGui->object->getTestPresentationConfig();

        if ($questionGui instanceof assMultipleChoiceGUI) {
            $qstConfig->setWorkedThrough($isQuestionWorkedThrough);
        }

        if ($qstConfig->isPreviousPassSolutionReuseAllowed()) {
            $passIndex = $this->determineSolutionPassIndex($questionGui); // last pass having solution stored
            if ($passIndex < $this->test_session->getPass()) { // it's the previous pass if current pass is higher
                $qstConfig->setSolutionInitiallyPrefilled(true);
            }
        } else {
            $passIndex = $this->test_session->getPass();
        }
        // hey.

        // Answer specific feedback is rendered into the display of the test question with in the concrete question types outQuestionForTest-method.
        // Notation of the params prior to getting rid of this crap in favor of a class
        $questionGui->outQuestionForTest(
            $formAction,                                                        #form_action
            $this->test_session->getActiveId(),         #active_id
            // hey: prevPassSolutions - prepared pass index having no, current or previous solution
            $passIndex,                                                         #pass
            // hey.
            $isPostponed,                                                       #is_postponed
            $userPostSolution,                                          #user_post_solution
            $answerFeedbackEnabled                                      #answer_feedback == inline_specific_feedback
        );
        // The display of specific inline feedback and specific feedback in an own block is to honor questions, which
        // have the possibility to embed the specific feedback into their output while maintaining compatibility to
        // questions, which do not have such facilities. E.g. there can be no "specific inline feedback" for essay
        // questions, while the multiple-choice questions do well.


        $this->populateModals();

        // fau: testNav - pouplate the new question edit control instead of the deprecated intermediate solution saver
        $this->populateQuestionEditControl($questionGui);
        // fau.
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showQuestionViewable()

ilTestPlayerAbstractGUI::showQuestionViewable ( assQuestionGUI  $questionGui,   $formAction,   $isQuestionWorkedThrough,   $instantResponse  )

protected

Definition at line 893 of file class.ilTestPlayerAbstractGUI.php.

References buildReadOnlyStateQuestionNavigationGUI(), assQuestionGUI\getFormEncodingType(), assQuestionGUI\getQuestionHeaderBlockBuilder(), assQuestionGUI\getSolutionOutput(), isShowingPostponeStatusReguired(), ILIAS\Repository\lng(), assQuestionGUI\outQuestionPage(), and assQuestionGUI\setNavigationGUI().

Referenced by ilTestOutputGUI\showQuestionCmd().

    {
        $questionNavigationGUI = $this->buildReadOnlyStateQuestionNavigationGUI($questionGui->object->getId());
        $questionNavigationGUI->setQuestionWorkedThrough($isQuestionWorkedThrough);
        $questionGui->setNavigationGUI($questionNavigationGUI);

        // fau: testNav - set answere status in question header
        $questionGui->getQuestionHeaderBlockBuilder()->setQuestionAnswered($isQuestionWorkedThrough);
        // fau.

        $answerFeedbackEnabled = (
            $instantResponse && $this->object->getSpecificAnswerFeedback()
        );

        $solutionoutput = $questionGui->getSolutionOutput(
            $this->test_session->getActiveId(),         #active_id
            $this->test_session->getPass(),             #pass
            false,                                                              #graphical_output
            false,                                                              #result_output
            true,                                                               #show_question_only
            $answerFeedbackEnabled,                             #show_feedback
            false,                                                              #show_correct_solution
            false,                                                              #show_manual_scoring
            true                                                                #show_question_text
        );

        $pageoutput = $questionGui->outQuestionPage(
            "",
            $this->isShowingPostponeStatusReguired($questionGui->object->getId()),
            $this->test_session->getActiveId(),
            $solutionoutput
        );

        $this->tpl->setVariable(
            'LOCKSTATE_INFOBOX',
            $this->ui_renderer->render(
                $this->ui_factory->messageBox()->info($this->lng->txt("tst_player_answer_saved_and_locked"))
            )
        );
        $this->tpl->parseCurrentBlock();

        $this->tpl->setVariable('QUESTION_OUTPUT', $pageoutput);

        $this->tpl->setVariable("FORMACTION", $formAction);
        $this->tpl->setVariable("ENCTYPE", 'enctype="' . $questionGui->getFormEncodingType() . '"');
        $this->tpl->setVariable("FORM_TIMESTAMP", time());
        $this->populateQuestionEditControl($questionGui);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showRequestedHintListCmd()

ilTestPlayerAbstractGUI::showRequestedHintListCmd ( )

protected

Go to requested hint list.

Definition at line 1465 of file class.ilTestPlayerAbstractGUI.php.

References ilAssQuestionHintRequestGUI\CMD_SHOW_LIST, ILIAS\Repository\ctrl(), and handleIntermediateSubmit().

    {
        // fau: testNav - handle intermediate submit for viewing requested hints
        $this->handleIntermediateSubmit();
        // fau.

        $this->ctrl->setParameter($this, 'pmode', self::PRESENTATION_MODE_EDIT);

        $this->ctrl->redirectByClass('ilAssQuestionHintRequestGUI', ilAssQuestionHintRequestGUI::CMD_SHOW_LIST);
    }

Here is the call graph for this function:

showSideList()

ilTestPlayerAbstractGUI::showSideList (   $current_sequence_element )

protected

Definition at line 1193 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getCurrentSequenceElement(), ILIAS\UI\Component\Listing\Workflow\Step\IN_PROGRESS, isQuestionSummaryFinishTestButtonRequired(), ILIAS\Repository\lng(), ILIAS\UI\Component\Listing\Workflow\Step\NOT_STARTED, PRESENTATION_MODE_VIEW, ilTestPlayerCommands\SHOW_QUESTION, and ilTestPlayerLayoutProvider\TEST_PLAYER_QUESTIONLIST.

Referenced by prepareTestPage().

                                                              : void
    {
        $question_summary_data = $this->service->getQuestionSummaryData($this->testSequence, false);
        $questions = [];
        $active = 0;

        foreach ($question_summary_data as $idx => $row) {
            $title = htmlspecialchars($row['title'], ENT_QUOTES, null, false);
            $description = '';
            if ($row['description'] !== '') {
                $description = htmlspecialchars($row['description'], ENT_QUOTES, null, false);
            }

            if (!$row['disabled']) {
                $this->ctrl->setParameter($this, 'pmode', '');
                $this->ctrl->setParameter($this, 'sequence', $row['sequence']);
                $action = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::SHOW_QUESTION);
                $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);
                $this->ctrl->setParameter($this, 'sequence', $this->getCurrentSequenceElement($current_sequence_element));
            }

            $status = ILIAS\UI\Component\Listing\Workflow\Step::NOT_STARTED;

            if (
                ($row['worked_through'] || $row['isAnswered'])
                && $row['has_authorized_answer']
            ) {
                $status = ILIAS\UI\Component\Listing\Workflow\Step::IN_PROGRESS;
            }

            $questions[] = $this->ui_factory->listing()->workflow()
                ->step($title, $description, $action)
                ->withStatus($status);
            $active = $row['sequence'] == $current_sequence_element ? $idx : $active;
        }

        $question_listing = $this->ui_factory->listing()->workflow()->linear(
            $this->lng->txt('mainbar_button_label_questionlist'),
            $questions
        )->withActive($active);


        $this->global_screen->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_QUESTIONLIST,
            $question_listing
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

skipQuestionCmd()

ilTestPlayerAbstractGUI::skipQuestionCmd ( )

abstractprotected

Referenced by revertChangesCmd().

Here is the caller graph for this function:

startPlayerCmd()

ilTestPlayerAbstractGUI::startPlayerCmd ( )

protected

Start a test for the first time.

Start a test for the first time. This method contains a lock to prevent multiple submissions by the start test button

Definition at line 433 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getLockParameter(), handleUserSettings(), and ilTestPlayerCommands\INIT_TEST.

    {
        $testStartLock = $this->getLockParameter();
        $isFirstTestStartRequest = false;

        $this->processLocker->executeTestStartLockOperation(function () use ($testStartLock, &$isFirstTestStartRequest) {
            if ($this->test_session->lookupTestStartLock() !== $testStartLock) {
                $this->test_session->persistTestStartLock($testStartLock);
                $isFirstTestStartRequest = true;
            }
        });

        if ($isFirstTestStartRequest) {
            $this->handleUserSettings();
            $this->ctrl->redirect($this, ilTestPlayerCommands::INIT_TEST);
        }

        $this->ctrl->setParameterByClass('ilObjTestGUI', 'lock', $testStartLock);
        $this->ctrl->redirectByClass("ilobjtestgui", "redirectToInfoScreen");
    }

Here is the call graph for this function:

startTestCmd()

ilTestPlayerAbstractGUI::startTestCmd ( )

abstractprotected

Referenced by revertChangesCmd().

Here is the caller graph for this function:

submitIntermediateSolutionCmd()

ilTestPlayerAbstractGUI::submitIntermediateSolutionCmd ( )

protected

Definition at line 625 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), saveQuestionSolution(), setAnswerChangedParameter(), and ilTestPlayerCommands\SHOW_QUESTION.

    {
        $this->saveQuestionSolution(false, true);
        // fau: testNav - set the 'answer changed' parameter when an intermediate solution is submitted
        $this->setAnswerChangedParameter(true);
        // fau.
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

submitSolutionCmd()

ilTestPlayerAbstractGUI::submitSolutionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

suspendTestCmd()

ilTestPlayerAbstractGUI::suspendTestCmd

(

)

Definition at line 171 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), and ilTestScreenGUI\DEFAULT_CMD.

Referenced by maxProcessingTimeReached().

    {
        $this->ctrl->redirectByClass(ilTestScreenGUI::class, ilTestScreenGUI::DEFAULT_CMD);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

unmarkQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::unmarkQuestionAndSaveIntermediateCmd ( )

protected

Definition at line 654 of file class.ilTestPlayerAbstractGUI.php.

References handleIntermediateSubmit(), and unmarkQuestionCmd().

    {
        // fau: testNav - handle intermediate submit when unmarking the question
        $this->handleIntermediateSubmit();
        // fau.
        $this->unmarkQuestionCmd();
    }

Here is the call graph for this function:

unmarkQuestionCmd()

ilTestPlayerAbstractGUI::unmarkQuestionCmd ( )

protected

Set a question unsolved.

Definition at line 665 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getCurrentSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by unmarkQuestionAndSaveIntermediateCmd().

    {
        $questionId = $this->testSequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );

        $this->object->setQuestionSetSolved(0, $questionId, $this->test_session->getUserId());

        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

unregisterForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::unregisterForcedFeedbackNavUrl ( )

protected

Definition at line 2439 of file class.ilTestPlayerAbstractGUI.php.

References ilSession\get(), and ilSession\set().

Referenced by ilTestOutputGUI\showQuestionCmd().

    {
        $forced_feedback_navigation_url = ilSession::get('forced_feedback_navigation_url');
        if (isset($forced_feedback_navigation_url[$this->test_session->getActiveId()])) {
            unset($forced_feedback_navigation_url[$this->test_session->getActiveId()]);
            ilSession::set('forced_feedback_navigation_url', $forced_feedback_navigation_url);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updateWorkingTime()

ilTestPlayerAbstractGUI::updateWorkingTime

(

)

updates working time and stores state saveresult to see if question has to be stored or not

Definition at line 139 of file class.ilTestPlayerAbstractGUI.php.

References ilSession\get(), ILIAS\Repository\object(), and ilSession\set().

Referenced by handleFileUploadCmd(), ilTestOutputGUI\handleQuestionActionCmd(), and ilTestOutputGUI\saveQuestionSolution().

    {
        if (ilSession::get("active_time_id") != null) {
            $this->object->updateWorkingTime(ilSession::get("active_time_id"));
        }

        ilSession::set(
            "active_time_id",
            $this->object->startWorkingTime(
                $this->test_session->getActiveId(),
                $this->test_session->getPass()
            )
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$assSettings

ilSetting ilTestPlayerAbstractGUI::$assSettings = null

protected

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

Referenced by ilTestOutputGUI\adoptUserSolutionsFromPreviousPass().

$cachedQuestionGuis

ilTestPlayerAbstractGUI::$cachedQuestionGuis = []

private

Definition at line 2096 of file class.ilTestPlayerAbstractGUI.php.

$cachedQuestionObjects

ilTestPlayerAbstractGUI::$cachedQuestionObjects = []

private

Definition at line 2129 of file class.ilTestPlayerAbstractGUI.php.

$endingTimeReached

bool ilTestPlayerAbstractGUI::$endingTimeReached

Definition at line 48 of file class.ilTestPlayerAbstractGUI.php.

$finish_test_modal

InterruptiveModal ilTestPlayerAbstractGUI::$finish_test_modal = null

protected

Definition at line 57 of file class.ilTestPlayerAbstractGUI.php.

$maxProcessingTimeReached

bool ilTestPlayerAbstractGUI::$maxProcessingTimeReached

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

$passwordChecker

ilTestPasswordChecker ilTestPlayerAbstractGUI::$passwordChecker

protected

Definition at line 51 of file class.ilTestPlayerAbstractGUI.php.

$processLocker

ilTestProcessLocker ilTestPlayerAbstractGUI::$processLocker

protected

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

$ref_id

int ilTestPlayerAbstractGUI::$ref_id

Definition at line 49 of file class.ilTestPlayerAbstractGUI.php.

$test_session

ilTestSession ilTestPlayerAbstractGUI::$test_session = null

protected

Definition at line 53 of file class.ilTestPlayerAbstractGUI.php.

$testSequence

ilTestSequence ilTestPlayerAbstractGUI::$testSequence = null

protected

Definition at line 55 of file class.ilTestPlayerAbstractGUI.php.

FIXED_SHUFFLER_SEED_MIN_LENGTH

const ilTestPlayerAbstractGUI::FIXED_SHUFFLER_SEED_MIN_LENGTH = 8

Definition at line 45 of file class.ilTestPlayerAbstractGUI.php.

FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM

const ilTestPlayerAbstractGUI::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM = 'followup_qst_locks_prevent_confirmation'

Definition at line 2348 of file class.ilTestPlayerAbstractGUI.php.

PRESENTATION_MODE_EDIT

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT = 'edit'

Definition at line 43 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\editSolutionCmd(), and ilTestOutputGUI\showQuestionCmd().

PRESENTATION_MODE_VIEW

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW = 'view'

Definition at line 42 of file class.ilTestPlayerAbstractGUI.php.

Referenced by ilTestOutputGUI\discardSolutionCmd(), ilTestOutputGUI\showQuestionCmd(), showSideList(), and ilTestOutputGUI\submitSolutionCmd().

---

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

• Modules/Test/classes/class.ilTestPlayerAbstractGUI.php