ilTestPlayerAbstractGUI Class Reference

Inheritance diagram for ilTestPlayerAbstractGUI:

Collaboration diagram for ilTestPlayerAbstractGUI:

Public Member Functions
	__construct (ilObjTest $object)
	executeCommand ()
	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 (bool $authorized=true, bool $force=false)
	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 ()
	isTestAccessible ()
	test accessible returns true if the user can perform the test More...
	isNrOfTriesReached ()
	nr of tries exceeded More...
	endingTimeReached ()
	handle endingTimeReached More...
	max_processing_time_reached ()
	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 ()
	Output of a summary of all test questions for test participants. More...
	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 $test_session, array $passes, bool $with_results)
	setObjectiveOrientedContainer (ilTestObjectiveOrientedContainer $objective_oriented_container)
	getObjectiveOrientedContainer ()
	executeCommand ()
	execute 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, ResultsTitlesBuilder $testResultHeaderLabelBuilder=null)
	Returns the list of answers of a users test pass. 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...
	getObject ()

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

Protected Member Functions
	buildTestPassQuestionList ()
	populateQuestionOptionalMessage ()
	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 ()
	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 (StatusOfAttempt $status_of_attempt)
	sendNewPassFinishedNotificationEmailIfActivated (int $active_id, int $pass)
	afterTestPassFinishedCmd ()
	prepareTestPage ($presentationMode, $sequenceElement, $question_id)
	isOptionalQuestionAnsweringConfirmationRequired (int $sequence_key)
	isShowingPostponeStatusReguired (int $question_id)
	showQuestionViewable (assQuestionGUI $question_gui, string $form_action, bool $is_question_worked_through, bool $instant_response)
	showQuestionEditable (assQuestionGUI $question_gui, string $form_action, bool $is_question_worked_through, bool $instant_response)
	determineSolutionPassIndex (assQuestionGUI $question_gui)
	showQuestionCmd ()
	editSolutionCmd ()
	submitSolutionCmd ()
	revertChangesCmd ()
	discardSolutionCmd ()
	skipQuestionCmd ()
	startTestCmd ()
	showSideList ($current_sequence_element)
	showRequestedHintListCmd ()
	Go to requested hint list. More...
	confirmHintRequestCmd ()
	Go to hint request confirmation. More...
	isFirstQuestionInSequence ($sequence_element)
	isLastQuestionInSequence ($sequence_element)
	handleQuestionActionCmd ()
	showInstantResponseCmd ()
	nextQuestionCmd ()
	previousQuestionCmd ()
	prepareSummaryPage ()
	initTestPageTemplate ()
	handlePasswordProtectionRedirect ()
	isParticipantsAnswerFixed ($question_id)
	getIntroductionPageButtonLabel ()
	initAssessmentSettings ()
	handleSkillTriggering (ilTestSession $test_session)
	showAnswerOptionalQuestionsConfirmation ()
	confirmAnswerOptionalQuestionsCmd ()
	cancelAnswerOptionalQuestionsCmd ()
	populateHelperGuiContent ($helperGui)
	getTestNavigationToolbarGUI ()
	buildReadOnlyStateQuestionNavigationGUI ($question_id)
	buildEditableStateQuestionNavigationGUI ($question_id)
	getFinishTestCommand ()
	populateInstantResponseModal (assQuestionGUI $question_gui, $nav_url)
	populateInstantResponseBlocks (assQuestionGUI $question_gui, $authorizedSolution)
	populateFeedbackBlockHeader ($withFocusAnchor)
	populateFeedbackBlockMessage (string $a_message)
	getCurrentSequenceElement ()
	getSequenceElementParameter ()
	getPresentationModeParameter ()
	getInstantResponseParameter ()
	getNextCommandParameter ()
	getNextSequenceParameter ()
	getNavigationUrlParameter ()
	getAnswerChangedParameter ()
	setAnswerChangedParameter (bool $changed=true)
	handleIntermediateSubmit ()
	saveNavigationPreventConfirmation ()
	getQuestionGuiInstance (int $question_id, bool $from_cache=true)
	getQuestionInstance (int $question_id, bool $from_cache=true)
	initTestQuestionConfig (assQuestion $question_obj)
	handleTearsAndAngerQuestionIsNull (int $question_id, $sequence_element)
	populateMessageContent (string $content_html)
	populateModals ()
	populateDiscardSolutionModal ()
	populateNextLocksUnchangedModal ()
	populateNextLocksChangedModal ()
	setFollowUpQuestionLocksConfirmationPrevented ()
	isFollowUpQuestionLocksConfirmationPrevented ()
	populateQuestionEditControl (assQuestionGUI $question_gui)
	getQuestionsDefaultPresentationMode ()
	registerForcedFeedbackNavUrl (string $forced_feedback_nav_url)
	getRegisteredForcedFeedbackNavUrl ()
	isForcedFeedbackNavUrlRegistered ()
	unregisterForcedFeedbackNavUrl ()
	handleFileUploadCmd ()
	updateLearningProgressOnTestStart ()
	submitSolutionAndNextCmd ()
	handleQuestionPostponing (int $question_id)
	handleCheckTestPassValid (bool $with_redirect=false)
	performTearsAndAngerBrokenConfessionChecks ()
	generateRandomTestPassForActiveUser ()
	adoptUserSolutionsFromPreviousPass ()
	handleTearsAndAngerNoObjectiveOrientedQuestion ()
	handlePrimaryButton (ilTestNavigationToolbarGUI $navigation_toolbar_gui, int $current_question_id)
	getTestPlayerTitle ()
Protected Member Functions inherited from ilTestServiceGUI
	getPassDetailsOverviewTableGUI (array $result_array, int $active_id, int $pass, ilTestServiceGUI $target_gui, string $target_cmd, ilTestQuestionRelatedObjectivesList $objectives_list=null, bool $multiple_objectives_involved=true)
	buildPassDetailsOverviewTableGUI (ilTestServiceGUI $target_gui, string $target_cmd)
	isGradingMessageRequired ()
	getGradingMessageBuilder (int $active_id)
	buildQuestionRelatedObjectivesList (ilLOTestQuestionAdapter $objectives_adapter, ilTestQuestionSequence $test_sequence)
	populateContent (string $content)
	outCorrectSolutionCmd ()
	outCorrectSolution ()
	populatePassFinishDate (ilTemplate $tpl, ?int $pass_finish_date)
	populateExamId (ilTemplate $tpl, int $active_id, int $pass)

Protected Attributes
const	FINISH_TEST_CMD = 'finishTest'
ilTestPasswordChecker	$password_checker
ilTestProcessLocker	$process_locker
ilTestSession	$test_session = null
ilSetting	$ass_settings = null
ilTestSequence	$test_sequence = null
ilTestQuestionRelatedObjectivesList	$question_related_objectives_list
InterruptiveModal	$finish_test_modal = null
const	DISCARD_MODAL = "discard_modal"
const	LOCKS_CHANGED_MODAL = "locks_changed_modal"
const	LOCKS_UNCHANGED_MODAL = "locks_unchanged_modal"
array	$modal_signals = []
Protected Attributes inherited from ilTestServiceGUI
readonly RequestDataCollector	$testrequest
readonly GeneralQuestionPropertiesRepository	$questionrepository
readonly TestQuestionsRepository	$testquestionsrepository
ilTestService	$service = null
readonly ilDBInterface	$db
readonly ilLanguage	$lng
readonly TestLogger	$logger
readonly ilHelpGUI	$help
readonly ilRbacSystem	$rbac_system
ilGlobalTemplateInterface ilTemplate	$tpl
	sk 2023-08-01: We need this union type, even if it is wrong! To change this More...
readonly ContentStyle	$content_style
readonly ilErrorHandling	$error
ilAccess	$access
readonly HTTPServices	$http
readonly ilCtrlInterface	$ctrl
readonly ilToolbarGUI	$toolbar
readonly ilTabsGUI	$tabs
readonly ilObjectDataCache	$obj_cache
readonly ilComponentRepository	$component_repository
readonly ilObjUser	$user
readonly ArrayBasedRequestWrapper	$post_wrapper
readonly ilNavigationHistory	$navigation_history
readonly Refinery	$refinery
readonly UIFactory	$ui_factory
readonly UIRenderer	$ui_renderer
readonly SkillService	$skills_service
readonly ilTestShuffler	$shuffler
readonly ResultsDataFactory	$results_data_factory
readonly ResultsPresentationFactory	$results_presentation_factory
readonly ILIAS	$ilias
readonly ilSetting	$settings
readonly GlobalScreenServices	$global_screen
readonly ilTree	$tree
int	$ref_id
ilTestSessionFactory	$test_session_factory = null
ilTestSequenceFactory	$test_sequence_factory = null
ilTestParticipantData	$participantData = null
TestResultRepository	$test_pass_result_repository
ilTestParticipantAccessFilterFactory	$participant_access_filter

Private Member Functions
	buildQuestionObject ()
	save (assQuestion $question_obj, bool $authorized)
	buildNextButtonInstance ($primaryNext)
	buildPreviousButtonInstance ()
	getOnLoadCodeForNavigationButtons (string $target, string $cmd)
	outProcessingTime (int $active_id, bool $verbose)
	getQuestionFeedbackModalHtml (ilTemplate $tpl, string $nav_url)
	isValidSequenceElement ($sequence_element)

Private Attributes
array	$cached_question_guis = []
array	$cached_question_objects = []

Detailed Description

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

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

Constructor & Destructor Documentation

__construct()

ilTestPlayerAbstractGUI::__construct

(

ilObjTest

$object

)

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

References ILIAS\GlobalScreen\Provider\__construct(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

    {
        parent::__construct($object);
        $this->ref_id = $this->testrequest->getRefId();
        $this->password_checker = 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 835 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:

adoptUserSolutionsFromPreviousPass()

ilTestPlayerAbstractGUI::adoptUserSolutionsFromPreviousPass ( )

protected

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

References ILIAS\Repository\user().

Referenced by startTestCmd().

                                                           : void
    {
        $ass_settings = new ilSetting('assessment');

        $userSolutionAdopter = new ilAssQuestionUserSolutionAdopter($this->db, $ass_settings);
        $userSolutionAdopter->setUserId($this->user->getId());
        $userSolutionAdopter->setActiveId($this->test_session->getActiveId());
        $userSolutionAdopter->setTargetPass($this->test_sequence->getPass());
        $userSolutionAdopter->setQuestionIds($this->test_sequence->getOptionalQuestions());

        $userSolutionAdopter->perform();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

afterTestPassFinishedCmd()

ilTestPlayerAbstractGUI::afterTestPassFinishedCmd ( )

protected

Definition at line 1080 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 895 of file class.ilTestPlayerAbstractGUI.php.

References 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 ($this->testrequest->getPostKeys() === []) {
            echo '';
            exit;
        }

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

        if ($this->saveQuestionSolution(!$this->getAnswerChangedParameter(), true)) {
            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 929 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 1968 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 (   $question_id )

protected

Definition at line 2468 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
    {
        $navigation_gui = new ilTestQuestionNavigationGUI(
            $this->lng,
            $this->ui_factory,
            $this->ui_renderer
        );

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

        if ($this->object->getSpecificAnswerFeedback()
            || $this->object->getGenericAnswerFeedback()
            || $this->object->getAnswerFeedbackPoints()
            || $this->object->getInstantFeedbackSolution()) {
            $navigation_gui->setAnswerFreezingEnabled($this->object->isInstantFeedbackAnswerFixationEnabled());

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

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

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

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

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

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

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

            if ($solved === 1) {
                $navigation_gui->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::UNMARK_QUESTION_SAVE));
                $navigation_gui->setQuestionMarked(true);
            } else {
                $navigation_gui->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::MARK_QUESTION_SAVE));
                $navigation_gui->setQuestionMarked(false);
            }
        }
        return $navigation_gui;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildFinishTestModal()

ilTestPlayerAbstractGUI::buildFinishTestModal

(

)

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

References 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 573 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 596 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:

buildQuestionObject()

ilTestPlayerAbstractGUI::buildQuestionObject ( )

private

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

References getQuestionInstance(), and isParticipantsAnswerFixed().

Referenced by saveQuestionSolution().

                                          : ?assQuestion
    {
        $q_id = $this->test_sequence->getQuestionForSequence($this->testrequest->int('sequence'));

        if ($this->isParticipantsAnswerFixed($q_id)) {
            // should only be reached by firebugging the disabled form in ui
            throw new ilTestException('not allowed request');
        }

        if ($q_id === null) {
            return null;
        }

        return $this->getQuestionInstance($q_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

buildReadOnlyStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildReadOnlyStateQuestionNavigationGUI (   $question_id )

protected

Definition at line 2434 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($question_id)) {
            $navigationGUI->setEditSolutionCommand(ilTestPlayerCommands::EDIT_SOLUTION);
        }

        if ($this->object->getShowMarker()) {
            $solved_array = ilObjTest::_getSolvedQuestions($this->test_session->getActiveId(), $question_id);
            $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 executeCommand(), and handleSkillTriggering().

Here is the caller graph for this function:

cancelAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::cancelAnswerOptionalQuestionsCmd ( )

protected

Definition at line 2406 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 ( )

protected

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

References isMaxProcessingTimeReached(), and isNrOfTriesReached().

Referenced by autosaveCmd(), and saveQuestionSolution().

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

Here is the call graph for this function:

Here is the caller graph for this function:

checkReadAccess()

ilTestPlayerAbstractGUI::checkReadAccess ( )

protected

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

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

Referenced by executeCommand().

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

        $participant_access = (new ilTestAccess($this->object->getRefId()))->isParticipantAllowed(
            $this->object->getId(),
            $this->user->getId()
        );
        if ($participant_access !== ParticipantAccess::ALLOWED) {
            return $participant_access->getAccessForbiddenMessage($this->lng);
        }

        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 277 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl().

Referenced by 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([ilRepositoryGUI::class, ilObjTestGUI::class, TestScreenGUI::class]);
        }
    }

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 287 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by 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 1857 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 2397 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl().

    {
        $this->test_sequence->setAnsweringOptionalQuestionsConfirmed(true);
        $this->test_sequence->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 2127 of file class.ilTestPlayerAbstractGUI.php.

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

    {
        // 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 1807 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", "components/ILIAS/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 944 of file class.ilTestPlayerAbstractGUI.php.

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

    {
        $question_id = $this->getCurrentQuestionId();
        $state = $this->getQuestionInstance($question_id)->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 480 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  $question_gui )

protected

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

References assQuestionGUI\getObject(), and ILIAS\Repository\object().

Referenced by showQuestionEditable().

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

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

                $previousSolutionAvailable = $question_gui->getObject()->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 ( )

protected

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

References $_SERVER, ILIAS\Repository\ctrl(), getCurrentSequenceElement(), ilTestServiceGUI\getObject(), getQuestionInstance(), ILIAS\Repository\logger(), ILIAS\Repository\object(), PRESENTATION_MODE_VIEW, ilTestPlayerCommands\SHOW_QUESTION, and ILIAS\Repository\user().

    {
        $current_sequence_element = $this->getCurrentSequenceElement();

        $current_question_obj = $this->getQuestionInstance(
            $this->test_sequence->getQuestionForSequence($current_sequence_element)
        );
        $current_question_obj->setTestId($this->object->getId());

        $current_question_obj->resetUsersAnswer(
            $this->test_session->getActiveId(),
            $this->test_session->getPass()
        );

        if ($this->logger->isLoggingEnabled()
            && !$this->getObject()->getAnonymity()) {
            $this->logger->logParticipantInteraction(
                $this->logger->getInteractionFactory()->buildParticipantInteraction(
                    $this->object->getRefId(),
                    $this->test_sequence->getQuestionForSequence($current_sequence_element),
                    $this->user->getId(),
                    $this->logger->isIPLoggingEnabled() ? $_SERVER['REMOTE_ADDR'] : '',
                    TestParticipantInteractionTypes::ANSWER_DELETED,
                    []
                )
            );
        }

        $this->ctrl->saveParameter($this, 'sequence');

        $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);

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

Here is the call graph for this function:

displayAccessCodeCmd()

ilTestPlayerAbstractGUI::displayAccessCodeCmd

(

)

Definition at line 823 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", "components/ILIAS/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 ( )

protected

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

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

    {
        $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT);
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

endingTimeReached()

ilTestPlayerAbstractGUI::endingTimeReached

(

)

handle endingTimeReached

Definition at line 1780 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 294 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 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:

executeCommand()

ilTestPlayerAbstractGUI::executeCommand

(

)

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

References $id, ilTestServiceGUI\$test_sequence_factory, buildTestPassQuestionList(), checkReadAccess(), checkTestExecutable(), checkTestSessionUser(), ILIAS\Repository\ctrl(), ensureExistingTestSession(), exit, getAnswerChangedParameter(), getCurrentSequenceElement(), ilTestServiceGUI\getObjectiveOrientedContainer(), getTestPlayerTitle(), handleCheckTestPassValid(), handlePasswordProtectionRedirect(), initAssessmentSettings(), iljQueryUtil\initjQuery(), initProcessLocker(), ilTestPlayerCommands\isTestExecutionCommand(), ILIAS\Repository\lng(), ILIAS\Repository\object(), populateQuestionOptionalMessage(), setAnswerChangedParameter(), ILIAS\Repository\settings(), ilTestPlayerCommands\SHOW_QUESTION, ILIAS\Repository\tabs(), ilTestPlayerLayoutProvider\TEST_PLAYER_KIOSK_MODE_ENABLED, ilTestPlayerLayoutProvider\TEST_PLAYER_SHORT_TITLE, ilTestPlayerLayoutProvider\TEST_PLAYER_TITLE, ilTestPlayerLayoutProvider\TEST_PLAYER_VIEW_TITLE, and ILIAS\Repository\user().

    {
        $this->tabs->clearTargets();

        $cmd = $this->ctrl->getCmd();
        $next_class = $this->ctrl->getNextClass($this);

        if (($read_access = $this->checkReadAccess()) !== true) {
            if ($cmd === 'autosave') {
                echo $this->lng->txt('autosave_failed') . ': ' . $read_access;
                exit;
            }
            $this->tpl->setOnScreenMessage('failure', $read_access, true);
            $this->ctrl->redirectByClass([ilRepositoryGUI::class, ilObjTestGUI::class, TestScreenGUI::class]);
        }

        $this->ctrl->saveParameter($this, "sequence");
        $this->ctrl->saveParameter($this, "pmode");
        $this->ctrl->saveParameter($this, "active_id");

        $this->initAssessmentSettings();

        $testSessionFactory = new ilTestSessionFactory($this->object, $this->db, $this->user);
        $this->test_session = $testSessionFactory->getSession($this->testrequest->int('active_id'));

        $this->ensureExistingTestSession($this->test_session);
        $this->checkTestSessionUser($this->test_session);

        $this->initProcessLocker($this->test_session->getActiveId());

        $test_sequence_factory = new ilTestSequenceFactory($this->object, $this->db, $this->questionrepository);
        $this->test_sequence = $test_sequence_factory->getSequenceByTestSession($this->test_session);
        $this->test_sequence->loadFromDb();
        $this->test_sequence->loadQuestions();

        $this->question_related_objectives_list = new ilTestQuestionRelatedObjectivesList();

        iljQueryUtil::initjQuery();

        $this->handlePasswordProtectionRedirect();

        $instance_name = $this->settings->get('short_inst_name') ?? '';
        if (trim($instance_name) === '') {
            $instance_name = 'ILIAS';
        }
        $this->global_screen->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_SHORT_TITLE,
            $instance_name
        );
        $this->global_screen->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_KIOSK_MODE_ENABLED,
            $this->object->getKioskMode()
        );
        $this->global_screen->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_VIEW_TITLE,
            $this->object->getTitle()
        );
        $this->global_screen->tool()->context()->current()->addAdditionalData(
            ilTestPlayerLayoutProvider::TEST_PLAYER_TITLE,
            $this->getTestPlayerTitle()
        );

        switch ($next_class) {
            case 'ilassquestionpagegui':
                $this->checkTestExecutable();

                $question_id = $this->test_sequence->getQuestionForSequence($this->getCurrentSequenceElement());

                $page_gui = new ilAssQuestionPageGUI($question_id);
                $ret = $this->ctrl->forwardCommand($page_gui);
                break;

            case 'iltestsubmissionreviewgui':
                $this->checkTestExecutable();
                $this->handleCheckTestPassValid(true);

                $gui = new ilTestSubmissionReviewGUI($this, $this->object, $this->test_session);
                $gui->setObjectiveOrientedContainer($this->getObjectiveOrientedContainer());
                $ret = $this->ctrl->forwardCommand($gui);
                break;

            case 'ilassquestionhintrequestgui':
                $this->checkTestExecutable();

                $question_gui = $this->object->createQuestionGUI(
                    "",
                    $this->test_sequence->getQuestionForSequence($this->getCurrentSequenceElement())
                );

                $questionHintTracking = new ilAssQuestionHintTracking(
                    $question_gui->getObject()->getId(),
                    $this->test_session->getActiveId(),
                    $this->test_session->getPass()
                );

                $gui = new ilAssQuestionHintRequestGUI(
                    $this,
                    ilTestPlayerCommands::SHOW_QUESTION,
                    $question_gui,
                    $questionHintTracking,
                    $this->ctrl,
                    $this->lng,
                    $this->tpl,
                    $this->tabs,
                    $this->global_screen
                );

                // fau: testNav - save the 'answer changed' status for viewing hint requests
                $this->setAnswerChangedParameter($this->getAnswerChangedParameter());
                // fau.
                $ret = $this->ctrl->forwardCommand($gui);

                break;

            case 'ilassspecfeedbackpagegui':
            case 'ilassgenfeedbackpagegui':
                $id = $this->testrequest->int('pg_id');
                if ($this->ctrl->getCmd() !== 'displayMediaFullscreen'
                    || $id === 0) {
                    break;
                }

                (new ilPageObjectGUI(
                    $next_class === 'ilassgenfeedbackpagegui' ? 'qfbg' : 'qfbs',
                    $id
                ))->displayMediaFullscreen();
                break;

            case 'iltestpasswordprotectiongui':
                $this->checkTestExecutable();

                $gui = new ilTestPasswordProtectionGUI(
                    $this->ctrl,
                    $this->tpl,
                    $this->lng,
                    $this,
                    $this->password_checker,
                    $this->testrequest,
                    $this->global_screen
                );
                $ret = $this->ctrl->forwardCommand($gui);
                break;

            default:
                if ($cmd !== 'autosave' && ilTestPlayerCommands::isTestExecutionCommand($cmd)) {
                    $this->checkTestExecutable();
                }

                if ($cmd === 'outQuestionSummary'
                    || $cmd === 'submitSolution') {
                    $this->handleCheckTestPassValid(true);
                }

                if ($cmd === 'showQuestion') {
                    $testPassesSelector = new ilTestPassesSelector($this->db, $this->object);
                    $testPassesSelector->setActiveId($this->test_session->getActiveId());
                    $testPassesSelector->setLastFinishedPass($this->test_session->getLastFinishedPass());

                    if (!$testPassesSelector->openPassExists()) {
                        $this->tpl->setOnScreenMessage('info', $this->lng->txt('tst_pass_finished'), true);
                        $this->ctrl->redirectByClass([ilRepositoryGUI::class, ilObjTestGUI::class, TestScreenGUI::class]);
                    }
                }

                $cmd .= 'Cmd';
                $ret = $this->$cmd();
                break;
        }
        return $ret;
    }

Here is the call graph for this function:

finishTestCmd()

ilTestPlayerAbstractGUI::finishTestCmd

(

)

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

References $_SERVER, ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, buildFinishTestModal(), ilSession\clear(), ILIAS\Repository\ctrl(), ilSession\get(), ilTestServiceGUI\getObject(), handleCheckTestPassValid(), ILIAS\Repository\logger(), performTestPassFinishedTasks(), ilSession\set(), showQuestionCmd(), ILIAS\Test\Logging\TEST_RUN_FINISHED, and ILIAS\Repository\user().

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

        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(StatusOfAttempt::FINISHED_BY_PARTICIPANT);

        if ($this->logger->isLoggingEnabled()
            && !$this->getObject()->getAnonymity()
            && ($interaction = $this->logger->getInteractionFactory()->buildParticipantInteraction(
                $this->ref_id,
                null,
                $this->user->getId(),
                $this->logger->isIPLoggingEnabled() ? $_SERVER['REMOTE_ADDR'] : '',
                TestParticipantInteractionTypes::TEST_RUN_FINISHED,
                []
            )) !== null) {
            $this->logger->logParticipantInteraction($interaction);
        }

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

Here is the call graph for this function:

generateRandomTestPassForActiveUser()

ilTestPlayerAbstractGUI::generateRandomTestPassForActiveUser ( )

protected

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

References ilTestRandomQuestionSetBuilder\getInstance(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), and performTearsAndAngerBrokenConfessionChecks().

Referenced by resumePlayerCmd(), and startTestCmd().

                                                            : void
    {
        $questionSetConfig = new ilTestRandomQuestionSetConfig(
            $this->tree,
            $this->db,
            $this->lng,
            $this->logger,
            $this->component_repository,
            $this->object,
            $this->questionrepository
        );
        $questionSetConfig->loadFromDb();

        $sourcePoolDefinitionFactory = new ilTestRandomQuestionSetSourcePoolDefinitionFactory($this->db, $this->object);

        $sourcePoolDefinitionList = new ilTestRandomQuestionSetSourcePoolDefinitionList($this->db, $this->object, $sourcePoolDefinitionFactory);
        $sourcePoolDefinitionList->loadDefinitions();

        $this->process_locker->executeRandomPassBuildOperation(function () use ($questionSetConfig, $sourcePoolDefinitionList) {
            if (!$this->performTearsAndAngerBrokenConfessionChecks()) {
                $stagingPoolQuestionList = new ilTestRandomQuestionSetStagingPoolQuestionList($this->db, $this->component_repository);

                $questionSetBuilder = ilTestRandomQuestionSetBuilder::getInstance(
                    $this->db,
                    $this->lng,
                    $this->logger,
                    $this->object,
                    $questionSetConfig,
                    $sourcePoolDefinitionList,
                    $stagingPoolQuestionList
                );

                $questionSetBuilder->performBuild($this->test_session);
            }
        }, $sourcePoolDefinitionList->hasTaxonomyFilters());
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getAnswerChangedParameter()

ilTestPlayerAbstractGUI::getAnswerChangedParameter ( )

protected

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

Referenced by autosaveCmd(), executeCommand(), handleIntermediateSubmit(), and populateQuestionEditControl().

                                                  : 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 2089 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 ( )

protected

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

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

                                             : int
    {
        return $this->test_sequence->getQuestionForSequence($this->testrequest->int('sequence'));
    }

Here is the caller graph for this function:

getCurrentSequenceElement()

ilTestPlayerAbstractGUI::getCurrentSequenceElement ( )

protected

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

References getSequenceElementParameter().

Referenced by discardSolutionCmd(), executeCommand(), handleQuestionActionCmd(), markQuestionCmd(), nextQuestionCmd(), previousQuestionCmd(), showInstantResponseCmd(), showQuestionCmd(), showSideList(), skipQuestionCmd(), submitSolutionAndNextCmd(), 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

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

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

Referenced by getTestNavigationToolbarGUI().

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

        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 2720 of file class.ilTestPlayerAbstractGUI.php.

Referenced by showQuestionCmd().

                                                    : bool
    {
        return $this->testrequest->isInstanceResponseRequested();
    }

Here is the caller graph for this function:

getIntroductionPageButtonLabel()

ilTestPlayerAbstractGUI::getIntroductionPageButtonLabel ( )

protected

Returns

string

Definition at line 2338 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 747 of file class.ilTestPlayerAbstractGUI.php.

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 caller graph for this function:

getNavigationUrlParameter()

ilTestPlayerAbstractGUI::getNavigationUrlParameter ( )

protected

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

References ilUtil\_getHttpPath().

Referenced by showInstantResponseCmd(), and submitSolutionCmd().

                                                  : string
    {
        $navigation_url = $this->testrequest->strVal('test_player_navigation_url');
        if ($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 '';
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getNextCommandParameter()

ilTestPlayerAbstractGUI::getNextCommandParameter ( )

protected

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

Referenced by 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 2735 of file class.ilTestPlayerAbstractGUI.php.

Referenced by submitSolutionCmd().

                                                 : int
    {
        return $this->testrequest->int('nextseq');
    }

Here is the caller graph for this function:

getOnLoadCodeForNavigationButtons()

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

private

Definition at line 607 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 2711 of file class.ilTestPlayerAbstractGUI.php.

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

        return null;
    }

getQuestionFeedbackModalHtml()

ilTestPlayerAbstractGUI::getQuestionFeedbackModalHtml ( ilTemplate  $tpl, string  $nav_url  )

private

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

References ilTemplate\get(), and ILIAS\Repository\lng().

Referenced by populateInstantResponseModal().

                                                                                   : string
    {
        $modal = $this->ui_factory->modal()->roundtrip(
            $this->lng->txt('tst_instant_feedback'),
            $this->ui_factory->legacy($tpl->get()),
            []
        )->withActionButtons([
            $this->ui_factory->button()->standard($this->lng->txt('proceed'), $nav_url)
        ]);

        return $this->ui_renderer->render([
            $modal->withOnLoad($modal->getShowSignal())
        ]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionGuiInstance()

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

protected

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

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

Referenced by showQuestionCmd().

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

        if (!$from_cache || !isset($this->cached_question_guis[$question_id])) {
            $question_gui = $this->object->createQuestionGUI("", $question_id);
            $question_gui->setTargetGui($this);
            $question_gui->setPresentationContext(assQuestionGUI::PRESENTATION_CONTEXT_TEST);
            $question = $question_gui->getObject();
            $question->setShuffler($this->shuffler->getAnswerShuffleFor(
                $question_id,
                $this->test_session->getActiveId(),
                $this->test_session->getPass()
            ));
            $question_gui->setObject($question);
            $question_gui->populateJavascriptFilesRequiredForWorkForm($tpl);

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

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

        return $this->cached_question_guis[$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 2812 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by buildQuestionObject(), detectChangesCmd(), discardSolutionCmd(), and removeIntermediateSolution().

                                                                                     : assQuestion
    {
        if ($from_cache && isset($this->cached_question_objects[$question_id])) {
            return $this->cached_question_objects[$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());
        $question->setProcessLocker($process_locker_factory->getLocker());

        $this->initTestQuestionConfig($question);

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

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionsDefaultPresentationMode()

ilTestPlayerAbstractGUI::getQuestionsDefaultPresentationMode ( )

protected

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

                                                            : string
    {
        return self::PRESENTATION_MODE_EDIT;
    }

getRegisteredForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::getRegisteredForcedFeedbackNavUrl ( )

protected

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

References ilSession\get().

Referenced by isForcedFeedbackNavUrlRegistered(), and showQuestionCmd().

                                                          : ?string
    {
        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 2702 of file class.ilTestPlayerAbstractGUI.php.

Referenced by 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 2425 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by 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:

getTestPlayerTitle()

ilTestPlayerAbstractGUI::getTestPlayerTitle ( )

protected

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

References ilObjTest\buildExamId(), ILIAS\Repository\lng(), ILIAS\Repository\object(), and ILIAS\Repository\user().

Referenced by executeCommand().

                                           : string
    {
        $title_content = $this->ui_factory->listing()->property();

        if ($this->object->getShowKioskModeParticipant()) {
            $pax_name_label = $this->lng->txt("conf_user_name");
            // this is a placeholder solution with inline html tags to differentiate the different elements
            // should be removed when a title component with grouping and visual weighting is available
            // see:  https://github.com/ILIAS-eLearning/ILIAS/pull/7311
            $pax_name_value = "<span class='il-test-kiosk-head__participant-name'>"
                . $this->user->getFullname() . "</span>";
            $title_content = $title_content->withProperty($pax_name_label, $pax_name_value, false);
        }

        if ($this->object->isShowExamIdInTestPassEnabled()) {
            $exam_id_label = $this->lng->txt("exam_id_label");
            $exam_id_value = ilObjTest::buildExamId(
                $this->test_session->getActiveId(),
                $this->test_session->getPass(),
                $this->object->getId()
            );
            $title_content = $title_content->withProperty($exam_id_label, $exam_id_value);
        }

        if ($this->object->getShowKioskModeTitle()) {
            $test_title_label = $this->lng->txt("test");
            $test_title_value = $this->object->getTitle();
            $title_content = $title_content->withProperty($test_title_label, $test_title_value, false);
        }

        return $this->ui_renderer->render($title_content);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleCheckTestPassValid()

ilTestPlayerAbstractGUI::handleCheckTestPassValid ( bool  $with_redirect = false )

protected

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

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

Referenced by executeCommand(), finishTestCmd(), nextQuestionCmd(), and previousQuestionCmd().

                                                                            : void
    {
        $testObj = new ilObjTest($this->ref_id, true);

        $participants = $testObj->getActiveParticipantList();
        $participant = $participants->getParticipantByActiveId($this->testrequest->getActiveId());
        if ($participant && $participant->hasUnfinishedPasses()) {
            return;
        }
        $this->tpl->setOnScreenMessage('failure', $this->lng->txt('tst_current_run_no_longer_valid'), true);
        if ($with_redirect) {
            $this->ctrl->redirectByClass([
                ilRepositoryGUI::class,
                ilObjTestGUI::class,
                TestScreenGUI::class
            ]);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleFileUploadCmd()

ilTestPlayerAbstractGUI::handleFileUploadCmd ( )

protected

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

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

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

Here is the call graph for this function:

handleIntermediateSubmit()

ilTestPlayerAbstractGUI::handleIntermediateSubmit ( )

protected

Definition at line 2764 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 2294 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by executeCommand().

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

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

        if (!$this->password_checker->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:

handlePrimaryButton()

ilTestPlayerAbstractGUI::handlePrimaryButton ( ilTestNavigationToolbarGUI  $navigation_toolbar_gui, int  $current_question_id  )

protected

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

References ILIAS\Repository\object(), and ilTestNavigationToolbarGUI\setFinishTestButtonPrimary().

Referenced by showQuestionCmd().

                                                                                                                        : bool
    {
        $is_next_primary = true;

        if ($this->object->isForceInstantFeedbackEnabled()) {
            $is_next_primary = false;
        }

        $questions_missing_result = $this->questionrepository->getQuestionsMissingResultRecord(
            $this->test_session->getActiveId(),
            $this->test_session->getPass(),
            $this->test_sequence->getOrderedSequenceQuestions()
        );

        if ($questions_missing_result === []) {
            $navigation_toolbar_gui->setFinishTestButtonPrimary(true);
            return false;
        }

        if (count($questions_missing_result) === 1
            && $current_question_id === current($questions_missing_result)) {
            $navigation_toolbar_gui->setFinishTestButtonPrimary(true);
            return false;
        }

        return $is_next_primary;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleQuestionActionCmd()

ilTestPlayerAbstractGUI::handleQuestionActionCmd ( )

protected

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

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

    {
        $question_id = $this->test_sequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );

        if (!$this->isParticipantsAnswerFixed($question_id)) {
            $this->updateWorkingTime();
            $this->saveQuestionSolution(false);
            // fau: testNav - add changed status of the question
            $this->setAnswerChangedParameter(true);
            // fau.
        }

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

Here is the call graph for this function:

handleQuestionPostponing()

ilTestPlayerAbstractGUI::handleQuestionPostponing ( int  $question_id )

protected

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

Referenced by nextQuestionCmd().

     : void {
        $this->test_sequence->postponeQuestion($question_id);
        $this->test_sequence->saveToDb();
    }

Here is the caller graph for this function:

handleSkillTriggering()

ilTestPlayerAbstractGUI::handleSkillTriggering ( ilTestSession  $test_session )

protected

Parameters

ilTestSession

$test_session

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

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

Referenced by save().

                                                                         : void
    {
        $skill_evaluation = new ilTestSkillEvaluation(
            $this->db,
            $this->logger,
            $this->object->getTestId(),
            $this->object->getRefId(),
            $this->skills_service->profile(),
            $this->skills_service->personal()
        );

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

        $skill_evaluation->setNumRequiredBookingsForSkillTriggering(
            $this->object->getGlobalSettings()->getSkillTriggeringNumberOfAnswers()
        );

        $question_list = $this->buildTestPassQuestionList();
        $question_list->load();
        $skill_evaluation->init($question_list);
        $skill_evaluation->evaluate(
            $this->object->getTestResult(
                $test_session->getActiveId(),
                $test_session->getPass(),
                true
            )
        );

        $skill_evaluation->handleSkillTriggering();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleTearsAndAngerNoObjectiveOrientedQuestion()

ilTestPlayerAbstractGUI::handleTearsAndAngerNoObjectiveOrientedQuestion ( )

protected

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

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

Referenced by showQuestionCmd().

                                                                       : void
    {
        $this->tpl->setOnScreenMessage('failure', sprintf($this->lng->txt('tst_objective_oriented_test_pass_without_questions'), $this->object->getTitle()), true);
        $this->ctrl->redirectByClass(ilObjTestGUI::class);
    }

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 2838 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by showQuestionCmd().

                                                                                             : void
    {
        $this->logger->error(
            "INV SEQ:"
            . "active={$this->test_session->getActiveId()} "
            . "qId=$question_id seq=$sequence_element "
            . serialize($this->test_sequence)
        );

        $this->ctrl->setParameter($this, 'sequence', $this->test_sequence->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 843 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by 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 2343 of file class.ilTestPlayerAbstractGUI.php.

Referenced by executeCommand().

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

Here is the caller graph for this function:

initProcessLocker()

ilTestPlayerAbstractGUI::initProcessLocker (   $activeId )

protected

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

References ilTestServiceGUI\$db, and $ilDB.

Referenced by executeCommand().

    {
        $ilDB = $this->db;
        $process_lockerFactory = new ilTestProcessLockerFactory($this->ass_settings, $ilDB);
        $this->process_locker = $process_lockerFactory->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 804 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()) {
            $access_code = $this->test_session->createNewAccessCode();

            $this->test_session->setAccessCodeToSession($access_code);
            $this->test_session->setAnonymousId($access_code);
            $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 2266 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',
            'components/ILIAS/Test'
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

initTestQuestionConfig()

ilTestPlayerAbstractGUI::initTestQuestionConfig ( assQuestion  $question_obj )

protected

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

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

Referenced by getQuestionGuiInstance(), and getQuestionInstance().

    {
        $question_obj->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 (   $sequence_element )

protected

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

Referenced by populateQuestionNavigation().

                                                                   : bool
    {
        return $sequence_element == $this->test_sequence->getFirstSequence();
    }

Here is the caller graph for this function:

isFollowUpQuestionLocksConfirmationPrevented()

ilTestPlayerAbstractGUI::isFollowUpQuestionLocksConfirmationPrevented ( )

protected

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

References ilSession\get().

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 3014 of file class.ilTestPlayerAbstractGUI.php.

References getRegisteredForcedFeedbackNavUrl().

Referenced by isParticipantsAnswerFixed(), and showQuestionCmd().

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

Here is the call graph for this function:

Here is the caller graph for this function:

isLastQuestionInSequence()

ilTestPlayerAbstractGUI::isLastQuestionInSequence (   $sequence_element )

protected

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

Referenced by populateQuestionNavigation().

                                                                  : bool
    {
        return $sequence_element == $this->test_sequence->getLastSequence();
    }

Here is the caller graph for this function:

isMaxProcessingTimeReached()

ilTestPlayerAbstractGUI::isMaxProcessingTimeReached

(

)

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

Referenced by 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 1770 of file class.ilTestPlayerAbstractGUI.php.

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

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

Here is the caller graph for this function:

isOptionalQuestionAnsweringConfirmationRequired()

ilTestPlayerAbstractGUI::isOptionalQuestionAnsweringConfirmationRequired ( int  $sequence_key )

protected

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

Referenced by prepareTestPage().

                                                                                         : bool
    {
        if ($this->test_sequence->isAnsweringOptionalQuestionsConfirmed()) {
            return false;
        }

        $question_id = $this->test_sequence->getQuestionForSequence($sequence_key);

        if (!$this->test_sequence->isQuestionOptional($question_id)) {
            return false;
        }

        return true;
    }

Here is the caller graph for this function:

isParticipantsAnswerFixed()

ilTestPlayerAbstractGUI::isParticipantsAnswerFixed (   $question_id )

protected

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

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

Referenced by autosaveCmd(), autosaveOnTimeLimitCmd(), buildQuestionObject(), buildReadOnlyStateQuestionNavigationGUI(), handleQuestionActionCmd(), populateQuestionEditControl(), showInstantResponseCmd(), and showQuestionCmd().

                                                              : bool
    {
        if ($this->object->isInstantFeedbackAnswerFixationEnabled()) {
            return $this->test_sequence->isQuestionChecked($question_id);
        }

        if ($this->object->isFollowupQuestionAnswerFixationEnabled()) {
            return $this->isForcedFeedbackNavUrlRegistered() || $this->test_sequence->isNextQuestionPresented($question_id);
        }

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isShowingPostponeStatusReguired()

ilTestPlayerAbstractGUI::isShowingPostponeStatusReguired ( int  $question_id )

protected

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

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

                                                                        : bool
    {
        return $this->test_sequence->isPostponedQuestion($question_id);
    }

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 1759 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:

isValidSequenceElement()

ilTestPlayerAbstractGUI::isValidSequenceElement (   $sequence_element )

private

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

Referenced by nextQuestionCmd(), previousQuestionCmd(), showQuestionCmd(), skipQuestionCmd(), and submitSolutionAndNextCmd().

                                                              : bool
    {
        if ($sequence_element === false) {
            return false;
        }

        if ($sequence_element < 1) {
            return false;
        }

        if (!$this->test_sequence->getPositionOfSequence($sequence_element)) {
            return false;
        }

        return true;
    }

Here is the caller graph for this function:

markQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::markQuestionAndSaveIntermediateCmd ( )

protected

Definition at line 969 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 978 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by markQuestionAndSaveIntermediateCmd().

                                        : void
    {
        $question_id = $this->test_sequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );

        $this->object->setQuestionSetSolved(1, $question_id, $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:

max_processing_time_reached()

ilTestPlayerAbstractGUI::max_processing_time_reached

(

)

Outputs a message when the maximum processing time is reached.

Outputs a message when the maximum processing time is reached

public

Definition at line 1797 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 ( )

protected

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

References $_SERVER, ILIAS\Repository\ctrl(), getCurrentSequenceElement(), ilTestServiceGUI\getObject(), handleCheckTestPassValid(), handleQuestionPostponing(), isValidSequenceElement(), ILIAS\Repository\logger(), ILIAS\Repository\object(), ilTestPlayerCommands\SHOW_QUESTION, and ILIAS\Repository\user().

    {
        $this->handleCheckTestPassValid();
        $last_sequence_element = $this->getCurrentSequenceElement();
        $next_sequence_element = $this->test_sequence->getNextSequence($last_sequence_element);

        $question_id = $this->test_sequence->getQuestionForSequence($last_sequence_element);
        $is_worked_through = $this->questionrepository->lookupResultRecordExist(
            $this->test_session->getActiveId(),
            $question_id,
            $this->test_session->getPass()
        );

        if (!$is_worked_through) {
            if ($this->logger->isLoggingEnabled()
                && !$this->getObject()->getAnonymity()) {
                $this->logger->logParticipantInteraction(
                    $this->logger->getInteractionFactory()->buildParticipantInteraction(
                        $this->object->getRefId(),
                        $question_id,
                        $this->user->getId(),
                        $this->logger->isIPLoggingEnabled() ? $_SERVER['REMOTE_ADDR'] : '',
                        TestParticipantInteractionTypes::QUESTION_SKIPPED,
                        []
                    )
                );
            }
            if ($this->object->isPostponingEnabled()) {
                $this->handleQuestionPostponing($question_id);
            }
        }

        if (!$this->isValidSequenceElement($next_sequence_element)) {
            $next_sequence_element = $this->test_sequence->getFirstSequence();
        }

        $this->ctrl->setParameter($this, 'sequence', $next_sequence_element);
        $this->ctrl->setParameter($this, 'pmode', '');

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

Here is the call graph for this function:

outCorrectSolution()

ilTestPlayerAbstractGUI::outCorrectSolution

(

)

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

Definition at line 1976 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", "components/ILIAS/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"), "print");
        if ($this->object->getShowSolutionAnswersOnly()) {
            $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print_hide_content.css"), "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:

outProcessingTime()

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

private

Definition at line 1825 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

(

)

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

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

References ILIAS\Repository\ctrl(), getContentBlockName(), ilTestServiceGUI\getObject(), ILIAS\GlobalScreen\Scope\Footer\Factory\getTitle(), ILIAS\Repository\help(), ILIAS\FileDelivery\http(), ILIAS\Repository\lng(), ilObjTest\lookupExamId(), ILIAS\Repository\object(), outProcessingTime(), and ilTestPlayerLayoutProvider\TEST_PLAYER_VIEW_TITLE.

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

        $is_first_page = $this->testrequest->strVal('first') === '1';

        $this->tpl->addBlockFile(
            $this->getContentBlockName(),
            'adm_content',
            'tpl.il_as_tst_question_summary.html',
            'components/ILIAS/Test'
        );

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

        $active_id = $this->test_session->getActiveId();
        $question_summary_data = $this->service->getQuestionSummaryData($this->test_sequence);

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

        $table = new QuestionsOfAttemptTable(
            $this->lng,
            $this->ctrl,
            $this->ui_factory,
            new DataFactory(),
            $this->http,
            $this,
            $this->object,
            $question_summary_data
        );
        $this->tpl->setVariable('TABLE_LIST_OF_QUESTIONS', $this->ui_renderer->render($table->buildComponents($is_first_page)));

        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:

outUserResultsOverviewCmd()

ilTestPlayerAbstractGUI::outUserResultsOverviewCmd

(

)

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

References ILIAS\Repository\ctrl().

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

Here is the call graph for this function:

performTearsAndAngerBrokenConfessionChecks()

ilTestPlayerAbstractGUI::performTearsAndAngerBrokenConfessionChecks ( )

protected

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

References ILIAS\Repository\lng(), ILIAS\Repository\logger(), and ILIAS\Repository\user().

Referenced by generateRandomTestPassForActiveUser().

                                                                   : bool
    {
        if ($this->test_session->getActiveId() > 0) {
            if ($this->test_sequence->hasRandomQuestionsForPass($this->test_session->getActiveId(), $this->test_session->getPass()) > 0) {
                $this->logger->info(
                    __METHOD__ . ' Random Questions allready exists for user ' .
                    $this->user->getId() . ' in test ' . $this->object->getTestId()
                );

                return true;
            }
        } else {
            $this->logger->info(__METHOD__ . ' ' . sprintf(
                $this->lng->txt("error_random_question_generation"),
                $this->user->getId(),
                $this->object->getTestId()
            ));

            return true;
        };

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

performTestPassFinishedTasks()

ilTestPlayerAbstractGUI::performTestPassFinishedTasks ( StatusOfAttempt  $status_of_attempt )

protected

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

References sendNewPassFinishedNotificationEmailIfActivated().

Referenced by finishTestCmd(), redirectAfterAutosaveCmd(), and redirectAfterQuestionListCmd().

                                                                                       : void
    {
        (new ilTestPassFinishTasks(
            $this->test_session,
            $this->object,
            $this->test_pass_result_repository
        ))->performFinishTasks($this->process_locker, $status_of_attempt);
        $this->object->updateTestResultCache($this->test_session->getActiveId(), null);

        $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 696 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 2876 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by populateModals().

                                                     : Signal
    {
        $modal = $this->ui_factory->modal()->interruptive(
            $this->lng->txt('discard_answer'),
            $this->lng->txt('discard_answer_confirmation'),
            $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::DISCARD_SOLUTION)
        )->withActionButtonLabel($this->lng->txt('discard_answer'));

        $this->tpl->setCurrentBlock('discard_solution_modal');
        $this->tpl->setVariable('DISCARD_SOLUTION_MODAL', $this->ui_renderer->render($modal));
        $this->tpl->parseCurrentBlock();
        return $modal->getShowSignal();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateFeedbackBlockHeader()

ilTestPlayerAbstractGUI::populateFeedbackBlockHeader (   $withFocusAnchor )

protected

Definition at line 2672 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 2685 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 643 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 2420 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by showAnswerOptionalQuestionsConfirmation().

    {
        $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  $question_gui,   $authorizedSolution  )

protected

See also

ilAssQuestionPreviewGUI::handleInstantResponseRendering()

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

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

Referenced by populateInstantResponseModal(), and 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 = $question_gui->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 = $question_gui->getObject()->getAdjustedReachedPoints(
            $this->test_session->getActiveId(),
            ilObjTest::_getPass($this->test_session->getActiveId()),
            $authorizedSolution
        );

        $maxPoints = $question_gui->getObject()->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($question_gui, $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 ($question_gui->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($question_gui)) {
                $response_available = true;
                $jump_to_response = true;
            }
        }

        $this->populateFeedbackBlockHeader($jump_to_response);
        if (!$response_available) {
            if ($question_gui->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  $question_gui,   $nav_url  )

protected

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

References ilTestServiceGUI\$tpl, assQuestionGUI\getObject(), getQuestionFeedbackModalHtml(), assQuestionGUI\getQuestionHeaderBlockBuilder(), assQuestionGUI\getSolutionOutput(), isShowingPostponeStatusReguired(), assQuestionGUI\outQuestionPage(), populateInstantResponseBlocks(), assQuestionGUI\setNavigationGUI(), and ilGlobalTemplateInterface\setVariable().

Referenced by showQuestionCmd().

                                                                                           : void
    {
        $question_gui->setNavigationGUI(null);
        $question_gui->getQuestionHeaderBlockBuilder()->setQuestionAnswered(true);

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

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

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

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

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

        $tpl->setVariable('QUESTION_OUTPUT', $pageoutput);
        $this->tpl->setVariable('INSTANT_RESPONSE_MODAL', $this->getQuestionFeedbackModalHtml($tpl, $nav_url));
    }

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 533 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 551 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 ( string  $content_html )

protected

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

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

                                                                   : void
    {
        if ($this->object->getKioskMode()) {
            $this->tpl->addBlockfile($this->getContentBlockName(), 'content', "tpl.il_as_tst_kiosk_mode_content.html", "components/ILIAS/Test");
            $this->tpl->setContent($content_html);
            return;
        }
        $this->tpl->setVariable($this->getContentBlockName(), $content_html);
    }

Here is the call graph for this function:

populateModals()

ilTestPlayerAbstractGUI::populateModals ( )

protected

Returns

array<self::DISCARD_MODAL|self::LOCKS_CHANGED_MODAL|self::LOCKS_UNCHANGED_MODAL, Signal>

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

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

Referenced by showQuestionEditable().

                                       : array
    {
        $signals = [self::DISCARD_MODAL => $this->populateDiscardSolutionModal()];

        if ($this->object->isFollowupQuestionAnswerFixationEnabled()) {
            $signals[self::LOCKS_CHANGED_MODAL] = $this->populateNextLocksChangedModal();
            $signals[self::LOCKS_UNCHANGED_MODAL] = $this->populateNextLocksUnchangedModal();
        }

        return $signals;
    }

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 527 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 2904 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by populateModals().

                                                      : Signal
    {
        $empty_signal = new \ILIAS\UI\Implementation\Component\Signal('');
        if ($this->isFollowUpQuestionLocksConfirmationPrevented()) {
            return $empty_signal;
        }

        $modal_message = $this->ui_factory->messageBox()->confirmation(
            $this->lng->txt('tst_nav_next_locks_current_answer_confirm')
        );
        $modal_checkbox = $this->ui_factory->input()->field()->checkbox(
            $this->lng->txt('tst_dont_show_msg_again_in_current_session')
        )->withDedicatedName(self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM);

        $modal = $this->ui_factory->modal()->roundtrip(
            $this->lng->txt('tst_nav_next_locks_current_answer_header'),
            $modal_message,
            [ $modal_checkbox ],
            'javascript:il.TestPlayerQuestionEditControl.confirmNextLocksChanged()'
        )->withSubmitLabel($this->lng->txt('tst_proceed'));

        $this->tpl->setCurrentBlock('next_locks_changed_modal');
        $this->tpl->setVariable('NEXT_LOCKS_CHANGED_MODAL', $this->ui_renderer->render($modal));
        $this->tpl->parseCurrentBlock();
        return $modal->getShowSignal();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populateNextLocksUnchangedModal()

ilTestPlayerAbstractGUI::populateNextLocksUnchangedModal ( )

protected

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

References ILIAS\Repository\lng().

Referenced by populateModals().

                                                        : Signal
    {
        $modal = $this->ui_factory->modal()->interruptive(
            $this->lng->txt('tst_nav_next_locks_empty_answer_header'),
            $this->lng->txt('tst_nav_next_locks_empty_answer_confirm'),
            'javascript:il.TestPlayerQuestionEditControl.confirmNextLocksUnchanged()'
        )->withActionButtonLabel($this->lng->txt('tst_proceed'));

        $this->tpl->setCurrentBlock('next_locks_unchanged_modal');
        $this->tpl->setVariable('NEXT_LOCKS_UNCHANGED_MODAL', $this->ui_renderer->render($modal));
        $this->tpl->parseCurrentBlock();
        return $modal->getShowSignal();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

populatePreviousButtons()

ilTestPlayerAbstractGUI::populatePreviousButtons ( )

protected

Definition at line 521 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:

populateQuestionEditControl()

ilTestPlayerAbstractGUI::populateQuestionEditControl ( assQuestionGUI  $question_gui )

protected

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

References $modal_signals, ilTestPlayerCommands\AUTO_SAVE, ilTestPlayerCommands\AUTO_SAVE_ON_TIME_LIMIT, ILIAS\Repository\ctrl(), ilTestPlayerCommands\DETECT_CHANGES, getAnswerChangedParameter(), ILIAS\UI\Component\Signal\getId(), assQuestionGUI\getObject(), isParticipantsAnswerFixed(), and ILIAS\Repository\lng().

Referenced by showQuestionEditable(), and showQuestionViewable().

                                                                                : void
    {
        $config = [];
        $state = $question_gui->getObject()->lookupForExistingSolutions($this->test_session->getActiveId(), $this->test_session->getPass());
        $config['isAnswered'] = $state['authorized'];
        $config['isAnswerChanged'] = $state['intermediate'] || $this->getAnswerChangedParameter();
        $config['isAnswerFixed'] = $this->isParticipantsAnswerFixed($question_gui->getObject()->getId());
        $config['saveOnTimeReachedUrl'] = str_replace('&', '&', $this->ctrl->getFormAction($this, ilTestPlayerCommands::AUTO_SAVE_ON_TIME_LIMIT));

        $config['autosaveUrl'] = '';
        $config['autosaveInterval'] = 0;
        if ($question_gui->getObject() instanceof QuestionAutosaveable && $this->object->getAutosave()) {
            $config['autosaveUrl'] = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::AUTO_SAVE, '', true);
            $config['autosaveInterval'] = $this->object->getMainSettings()->getQuestionBehaviourSettings()->getAutosaveInterval();
        }

        $question_config = $question_gui->getObject()->getTestPresentationConfig();

        $config['withFormChangeDetection'] = $question_config->isFormChangeDetectionEnabled();

        // Flash and Java questions: changes are directly sent to ilias and have to be polled from there
        $config['withBackgroundChangeDetection'] = $question_config->isBackgroundChangeDetectionEnabled();
        $config['backgroundDetectorUrl'] = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::DETECT_CHANGES, '', true);

        // Forced feedback will change the navigation saving command
        $config['forcedInstantFeedback'] = $this->object->isForceInstantFeedbackEnabled();
        $config['questionLocked'] = $this->isParticipantsAnswerFixed($question_gui->getObject()->getId());
        $config['nextQuestionLocks'] = $this->object->isFollowupQuestionAnswerFixationEnabled();
        $config['autosaveFailureMessage'] = $this->lng->txt('autosave_failed');

        // Add the modal signals and parameter name for the follow-up question locks confirmation
        $config['modalSignals'] = array_map(fn(Signal $signal) => $signal->getId(), $this->modal_signals);
        $config['preventConfirmationParam'] = self::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM;

        $this->tpl->addJavascript('assets/js/ilTestPlayerQuestionEditControl.js');
        $this->tpl->addOnLoadCode('il.TestPlayerQuestionEditControl.init(' . json_encode($config) . ')');
    }

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 510 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by 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:

populateQuestionOptionalMessage()

ilTestPlayerAbstractGUI::populateQuestionOptionalMessage ( )

abstractprotected

Referenced by executeCommand(), and showQuestionCmd().

Here is the caller graph for this function:

populateScoreBlock()

ilTestPlayerAbstractGUI::populateScoreBlock (   $reachedPoints,   $maxPoints  )

protected

Definition at line 663 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 676 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 620 of file class.ilTestPlayerAbstractGUI.php.

References assQuestionGUI\getObject(), and assQuestionGUI\getSpecificFeedbackOutput().

Referenced by populateInstantResponseBlocks().

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

        $feedback = $question_gui->getSpecificFeedbackOutput(
            $question_gui->getObject()->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 686 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 490 of file class.ilTestPlayerAbstractGUI.php.

Referenced by 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 542 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 560 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 2256 of file class.ilTestPlayerAbstractGUI.php.

References getContentBlockName().

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

Here is the call graph for this function:

prepareTestPage()

ilTestPlayerAbstractGUI::prepareTestPage (   $presentationMode,   $sequenceElement,   $question_id  )

protected

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

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

Referenced by 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->max_processing_time_reached();
            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", $question_id);

        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 ( )

protected

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

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

    {
        $this->handleCheckTestPassValid();

        $sequence_element = $this->test_sequence->getPreviousSequence(
            $this->getCurrentSequenceElement()
        );

        if (!$this->isValidSequenceElement($sequence_element)) {
            $sequence_element = $this->test_sequence->getLastSequence();
        }

        $this->ctrl->setParameter($this, 'sequence', $sequence_element);
        $this->ctrl->setParameter($this, 'pmode', '');

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

Here is the call 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 863 of file class.ilTestPlayerAbstractGUI.php.

References performTestPassFinishedTasks(), and redirectAfterFinish().

                                              : void
    {
        $this->performTestPassFinishedTasks(StatusOfAttempt::FINISHED_BY_DURATION);

        $this->redirectAfterFinish();
    }

Here is the call graph for this function:

redirectAfterFinish()

ilTestPlayerAbstractGUI::redirectAfterFinish ( )

protected

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

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

Referenced by redirectAfterAutosaveCmd(), and redirectAfterQuestionListCmd().

                                            : void
    {
        $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", "components/ILIAS/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 870 of file class.ilTestPlayerAbstractGUI.php.

References performTestPassFinishedTasks(), and redirectAfterFinish().

                                                  : void
    {
        $this->performTestPassFinishedTasks(StatusOfAttempt::FINISHED_BY_DURATION);

        $this->redirectAfterFinish();
    }

Here is the call graph for this function:

redirectBackCmd()

ilTestPlayerAbstractGUI::redirectBackCmd

(

)

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

References ILIAS\Repository\ctrl(), 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::class, ilMyTestResultsGUI::class, ilTestEvaluationGUI::class]);
        }

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

Here is the call graph for this function:

Here is the caller graph for this function:

registerForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::registerForcedFeedbackNavUrl ( string  $forced_feedback_nav_url )

protected

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

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

Referenced by showInstantResponseCmd().

                                                                                    : void
    {
        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()] = $forced_feedback_nav_url;
        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 352 of file class.ilTestPlayerAbstractGUI.php.

References getCurrentQuestionId(), and getQuestionInstance().

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

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

        $this->getQuestionInstance($question_id)->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 ( )

protected

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

References ILIAS\Repository\ctrl(), generateRandomTestPassForActiveUser(), handleUserSettings(), ILIAS\Repository\object(), ilTestPlayerCommands\QUESTION_SUMMARY, ilSession\set(), and ilTestPlayerCommands\SHOW_QUESTION.

    {
        $this->handleUserSettings();

        $active_id = $this->test_session->getActiveId();
        $this->ctrl->setParameter($this, "active_id", $active_id);

        $active_time_id = $this->object->startWorkingTime($active_id, $this->test_session->getPass());
        ilSession::set("active_time_id", $active_time_id);
        ilSession::set('tst_pass_finish', 0);

        if ($this->object->isRandomTest()) {
            if (!$this->test_sequence->hasRandomQuestionsForPass($active_id, $this->test_session->getPass())) {
                // create a new set of random questions
                $this->generateRandomTestPassForActiveUser();
            }
        }

        $shuffle = $this->object->getShuffleQuestions();
        if ($this->object->isRandomTest()) {
            $shuffle = false;
        }

        $this->object->updateTestPassResults(
            $active_id,
            $this->test_session->getPass(),
            null,
            $this->object->getId()
        );

        // ensure existing test sequence
        if (!$this->test_sequence->hasSequence()) {
            $this->test_sequence->createNewSequence($this->object->getQuestionCount(), $shuffle);
            $this->test_sequence->saveToDb();
        }

        if ($this->object->getListOfQuestionsStart()) {
            $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY);
        }

        $this->ctrl->setParameter($this, 'sequence', $this->test_session->getLastSequence());
        $this->ctrl->setParameter($this, 'pmode', '');
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

revertChangesCmd()

ilTestPlayerAbstractGUI::revertChangesCmd ( )

protected

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

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

    {
        $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:

save()

ilTestPlayerAbstractGUI::save ( assQuestion  $question_obj, bool  $authorized  )

private

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

References $_SERVER, ilObjTest\_getPass(), assQuestion\answerToParticipantInteraction(), ilLOTestQuestionAdapter\getInstance(), ilTestServiceGUI\getObject(), handleSkillTriggering(), ILIAS\Repository\logger(), ILIAS\Repository\object(), and assQuestion\persistWorkingState().

Referenced by saveQuestionSolution().

                                                                      : bool
    {
        $active_id = $this->test_session->getActiveId();
        $pass = ilObjTest::_getPass($active_id);
        if (!$question_obj->persistWorkingState(
            $active_id,
            $pass,
            $authorized
        )) {
            return false;
        }

        if ($authorized && $this->test_session->isObjectiveOriented()) {
            $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->test_session);
            $objectivesAdapter->updateQuestionResult($this->test_session, $question_obj);
        }

        if ($authorized && $this->object->isSkillServiceToBeConsidered()) {
            $this->handleSkillTriggering($this->test_session);
        }

        if ($authorized && $this->logger->isLoggingEnabled()
            && !$this->getObject()->getAnonymity()
            && ($interaction = $question_obj->answerToParticipantInteraction(
                $this->logger->getAdditionalInformationGenerator(),
                $this->getObject()->getRefId(),
                $active_id,
                $pass,
                $this->logger->isIPLoggingEnabled() ? $_SERVER['REMOTE_ADDR'] : '',
                TestParticipantInteractionTypes::ANSWER_SUBMITTED
            )) !== null) {
            $this->logger->logParticipantInteraction($interaction);
        }
        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveNavigationPreventConfirmation()

ilTestPlayerAbstractGUI::saveNavigationPreventConfirmation ( )

protected

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

References ilSession\set().

Referenced by showInstantResponseCmd(), and submitSolutionCmd().

                                                          : void
    {
        if ($this->testrequest->retrieveBoolFromPost('save_on_navigation_prevent_confirmation')) {
            ilSession::set('save_on_navigation_prevent_confirmation', true);
        }

        if ($this->testrequest->retrieveBoolFromPost(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	(	bool	$authorized = true,
		bool	$force = false
	)

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

References buildQuestionObject(), canSaveResult(), ILIAS\Repository\ctrl(), ilSession\get(), isNrOfTriesReached(), save(), ilSession\set(), updateWorkingTime(), and ILIAS\TestQuestionPool\Questions\Question\validateSolutionSubmit().

Referenced by autosaveCmd(), autosaveOnTimeLimitCmd(), handleFileUploadCmd(), handleIntermediateSubmit(), handleQuestionActionCmd(), showInstantResponseCmd(), submitIntermediateSolutionCmd(), submitSolutionAndNextCmd(), and submitSolutionCmd().

     : bool {
        $this->updateWorkingTime();

        $formtimestamp = $this->testrequest->int('formtimestamp');
        if (!$force
            && ilSession::get('formtimestamp') !== null
            && $formtimestamp === ilSession::get('formtimestamp')) {
            return false;
        }

        ilSession::set('formtimestamp', $formtimestamp);

        /*
            #21097 - exceed maximum passes
            this is a battle of conditions; e.g. ilTestPlayerAbstractGUI::autosaveOnTimeLimitCmd forces saving of results.
            However, if an admin has finished the pass in the meantime, a new pass should not be created.
        */
        if ($force && $this->isNrOfTriesReached()) {
            $force = false;
        }

        $question_obj = $this->buildQuestionObject();

        if ($question_obj === null) {
            return false;
        }

        if ($this->canSaveResult() || $force) {
            $saved = $this->save($question_obj, $authorized);
        }

        if (!$saved
            || ($question_obj instanceof QuestionPartiallySaveable
                && !$question_obj->validateSolutionSubmit())) {

            $this->ctrl->setParameter($this, 'save_error', '1');
            ilSession::set('previouspost', $this->testrequest->getParsedBody());
        }

        return $saved;
    }

Here is the call graph for this function:

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 326 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([ilRepositoryGUI::class, ilObjTestGUI::class, ilInfoScreenGUI::class]);
    }

Here is the call graph for this function:

sendNewPassFinishedNotificationEmailIfActivated()

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

protected

Definition at line 1060 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 711 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl().

                                       : void
    {
        if ($this->test_session->isAnonymousUser()) {
            $this->test_session->setAccessCodeToSession($this->testrequest->strVal('anonymous_id'));
        }

        $this->ctrl->redirectByClass([ilRepositoryGUI::class, ilObjTestGUI::class, ilInfoScreenGUI::class]);
    }

Here is the call graph for this function:

setAnswerChangedParameter()

ilTestPlayerAbstractGUI::setAnswerChangedParameter ( bool  $changed = true )

protected

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

References ILIAS\Repository\ctrl().

Referenced by executeCommand(), handleIntermediateSubmit(), handleQuestionActionCmd(), revertChangesCmd(), 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 2933 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 2384 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 1146 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');
        $this->ctrl->setParameterByClass(static::class, 'skipfinalstatement', 1);
        $this->tpl->setVariable(
            $this->getContentBlockName(),
            $this->ui_renderer->render([
                $this->ui_factory->legacy(
                    $this->object->getFinalStatement()
                ),
                $this->ui_factory->button()->standard(
                    $this->lng->txt('btn_next'),
                    $this->ctrl->getLinkTargetByClass(static::class, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED)
                )
            ])
        );
    }

Here is the call graph for this function:

showInstantResponseCmd()

ilTestPlayerAbstractGUI::showInstantResponseCmd ( )

protected

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

References ILIAS\Repository\ctrl(), getCurrentSequenceElement(), getNavigationUrlParameter(), isParticipantsAnswerFixed(), ILIAS\Repository\object(), registerForcedFeedbackNavUrl(), removeIntermediateSolution(), saveNavigationPreventConfirmation(), saveQuestionSolution(), setAnswerChangedParameter(), and ilTestPlayerCommands\SHOW_QUESTION.

    {
        $question_id = $this->test_sequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );

        if (!$this->isParticipantsAnswerFixed($question_id)) {
            if ($this->saveQuestionSolution(true)) {
                $this->removeIntermediateSolution();
                $this->setAnswerChangedParameter(false);
            } else {
                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
            }
            $this->test_sequence->setQuestionChecked($question_id);
            $this->test_sequence->saveToDb();
        } elseif ($this->object->isForceInstantFeedbackEnabled()) {
            $this->test_sequence->setQuestionChecked($question_id);
            $this->test_sequence->saveToDb();
        }

        $this->ctrl->setParameter($this, 'instresp', 1);

        // fau: testNav - handle navigation after feedback
        if ($this->getNavigationUrlParameter()) {
            $this->saveNavigationPreventConfirmation();
            $this->registerForcedFeedbackNavUrl($this->getNavigationUrlParameter());
        }
        // fau.
        $this->ctrl->redirectByClass(static::class, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call 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 2012 of file class.ilTestPlayerAbstractGUI.php.

References $_SERVER, 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", "components/ILIAS/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, "components/ILIAS/TestQuestionPool");
                $template->setVariable("COUNTER_QUESTION", $counter . ". ");
                $template->setVariable("QUESTION_TITLE", $question_gui->getObject()->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"), "print");
        if ($this->object->getShowSolutionAnswersOnly()) {
            $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print_hide_content.css"), "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') .
            ': ' . $_SERVER['REMOTE_ADDR'] . ' - ' .
            $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 ( )

protected

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

References $_SERVER, ILIAS\Repository\ctrl(), getCurrentSequenceElement(), ilLOTestQuestionAdapter\getInstance(), getInstantResponseParameter(), ilTestServiceGUI\getObject(), getQuestionGuiInstance(), getRegisteredForcedFeedbackNavUrl(), getTestNavigationToolbarGUI(), handlePrimaryButton(), handleTearsAndAngerNoObjectiveOrientedQuestion(), handleTearsAndAngerQuestionIsNull(), ILIAS\Repository\help(), isForcedFeedbackNavUrlRegistered(), isParticipantsAnswerFixed(), isValidSequenceElement(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), ILIAS\Repository\object(), populateInstantResponseBlocks(), populateInstantResponseModal(), populateQuestionNavigation(), populateQuestionOptionalMessage(), populateTestNavigationToolbar(), prepareTestPage(), PRESENTATION_MODE_EDIT, PRESENTATION_MODE_VIEW, ilSession\set(), showQuestionEditable(), showQuestionViewable(), ilTestPlayerCommands\SUBMIT_INTERMEDIATE_SOLUTION, unregisterForcedFeedbackNavUrl(), and ILIAS\Repository\user().

Referenced by finishTestCmd().

                                        : void
    {
        ilSession::set('tst_pass_finish', 0);

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

        $this->help->setScreenIdComponent('tst');
        $this->help->setScreenId('assessment');
        $this->help->setSubScreenId('question');

        $sequence_element = $this->getCurrentSequenceElement();

        if (!$this->isValidSequenceElement($sequence_element)) {
            $sequence_element = $this->test_sequence->getFirstSequence();
        }

        $this->test_session->setLastSequence($sequence_element ?? 0);
        $this->test_session->saveToDb();

        $question_id = $this->test_sequence->getQuestionForSequence($sequence_element ?? 0);
        if ($question_id === null && $this->test_session->isObjectiveOriented()) {
            $this->handleTearsAndAngerNoObjectiveOrientedQuestion();
        }

        if ($question_id !== null && !$this->test_sequence->isQuestionPresented($question_id)) {
            $this->test_sequence->setQuestionPresented($question_id);
            $this->test_sequence->saveToDb();
        }

        $question_worked_through = $this->questionrepository->lookupResultRecordExist(
            $this->test_session->getActiveId(),
            $question_id,
            $this->test_session->getPass()
        );

        $instant_response = false;
        if ($this->isParticipantsAnswerFixed($question_id)) {
            $presentation_mode = ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW;
            $s = $this->object->getMainSettings()->getQuestionBehaviourSettings();
            if ($s->getInstantFeedbackGenericEnabled()
                || $s->getInstantFeedbackPointsEnabled()
                || $s->getInstantFeedbackSolutionEnabled()
                || $s->getInstantFeedbackSpecificEnabled()) {
                $instant_response = true;
            }
        } else {
            $presentation_mode = ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT;
            if (!$this->object->isInstantFeedbackAnswerFixationEnabled()) {
                $instant_response = $this->getInstantResponseParameter();
            }
        }

        $question_gui = $this->getQuestionGuiInstance($question_id);

        if (!($question_gui instanceof assQuestionGUI)) {
            $this->handleTearsAndAngerQuestionIsNull($question_id, $sequence_element);
        }

        $question_gui->setSequenceNumber($this->test_sequence->getPositionOfSequence($sequence_element));
        $question_gui->setQuestionCount($this->test_sequence->getUserQuestionCount());

        $header_block_builder = new ilTestQuestionHeaderBlockBuilder($this->lng);
        $header_block_builder->setHeaderMode($this->object->getTitleOutput());
        $header_block_builder->setQuestionTitle($question_gui->getObject()->getTitleForHTMLOutput());
        $header_block_builder->setQuestionPoints($question_gui->getObject()->getPoints());
        $header_block_builder->setQuestionPosition($this->test_sequence->getPositionOfSequence($sequence_element));
        $header_block_builder->setQuestionCount($this->test_sequence->getUserQuestionCount());
        $header_block_builder->setQuestionPostponed($this->test_sequence->isPostponedQuestion($question_id));
        if ($this->test_session->isObjectiveOriented()) {
            $objectives_adapter = ilLOTestQuestionAdapter::getInstance($this->test_session);
            $objectives_adapter->buildQuestionRelatedObjectiveList($this->test_sequence, $this->question_related_objectives_list);
            $this->question_related_objectives_list->loadObjectivesTitles();

            $header_block_builder->setQuestionRelatedObjectives(
                $this->question_related_objectives_list->getQuestionRelatedObjectiveTitles($question_id)
            );
        }
        $question_gui->setQuestionHeaderBlockBuilder($header_block_builder);

        $this->prepareTestPage($presentation_mode, $sequence_element, $question_id);

        $navigation_toolbar_gui = $this->getTestNavigationToolbarGUI();
        $navigation_toolbar_gui->setFinishTestButtonEnabled(true);

        $is_next_primary = $this->handlePrimaryButton($navigation_toolbar_gui, $question_id);

        $this->ctrl->setParameter($this, 'sequence', $sequence_element);
        $this->ctrl->setParameter($this, 'pmode', $presentation_mode);
        $form_action = $this->ctrl->getFormAction($this, ilTestPlayerCommands::SUBMIT_INTERMEDIATE_SOLUTION);

        switch ($presentation_mode) {
            case ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT:
                $navigation_toolbar_gui->setDisabledStateEnabled(false);
                $this->showQuestionEditable(
                    $question_gui,
                    $form_action,
                    $question_worked_through,
                    $instant_response
                );

                if ($this->ctrl->getCmd() !== self::FINISH_TEST_CMD
                    && $this->logger->isLoggingEnabled()
                    && !$this->getObject()->getAnonymity()) {
                    $this->logger->logParticipantInteraction(
                        $this->logger->getInteractionFactory()->buildParticipantInteraction(
                            $this->object->getRefId(),
                            $question_id,
                            $this->user->getId(),
                            $this->logger->isIPLoggingEnabled() ? $_SERVER['REMOTE_ADDR'] : '',
                            TestParticipantInteractionTypes::QUESTION_SHOWN,
                            []
                        )
                    );
                }
                break;

            case ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW:
                if ($this->test_sequence->isQuestionOptional($question_gui->getObject()->getId())) {
                    $this->populateQuestionOptionalMessage();
                }

                $this->showQuestionViewable(
                    $question_gui,
                    $form_action,
                    $question_worked_through,
                    $instant_response
                );
                break;

            default:
                throw new ilTestException('no presentation mode given');
        }

        $navigation_toolbar_gui->build();
        $this->populateTestNavigationToolbar($navigation_toolbar_gui);
        $this->populateQuestionNavigation($sequence_element, $is_next_primary);

        if ($instant_response) {
            $this->populateInstantResponseBlocks(
                $question_gui,
                true
            );
        }

        if ($this->isForcedFeedbackNavUrlRegistered()) {
            $this->populateInstantResponseModal($question_gui, $this->getRegisteredForcedFeedbackNavUrl());
            $this->unregisterForcedFeedbackNavUrl();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showQuestionEditable()

ilTestPlayerAbstractGUI::showQuestionEditable ( assQuestionGUI  $question_gui, string  $form_action, bool  $is_question_worked_through, bool  $instant_response  )

protected

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

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

Referenced by showQuestionCmd().

     : void {
        $question_navigation_gui = $this->buildEditableStateQuestionNavigationGUI($question_gui->getObject()->getId());
        $question_navigation_gui->setQuestionWorkedThrough($is_question_worked_through);
        if ($is_question_worked_through) {
            $question_navigation_gui->setDiscardSolutionButtonEnabled(true);
            $question_gui->getQuestionHeaderBlockBuilder()->setQuestionAnswered(true);
        } elseif ($this->object->isPostponingEnabled()) {
            $question_navigation_gui->setSkipQuestionLinkTarget(
                $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::SKIP_QUESTION)
            );
        }
        $question_gui->setNavigationGUI($question_navigation_gui);

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

        $question_config = $question_gui->getObject()->getTestPresentationConfig();

        if ($question_gui instanceof assMultipleChoiceGUI) {
            $question_config->setWorkedThrough($is_question_worked_through);
        }

        if ($question_config->isPreviousPassSolutionReuseAllowed()) {
            $pass_index = $this->determineSolutionPassIndex($question_gui);
            if ($pass_index < $this->test_session->getPass()) {
                $question_config->setSolutionInitiallyPrefilled(true);
            }
        } else {
            $pass_index = $this->test_session->getPass();
        }


        $this->modal_signals = $this->populateModals();
        $question_navigation_gui->setShowDiscardModalSignal($this->modal_signals[self::DISCARD_MODAL]);

        $question_gui->outQuestionForTest(
            $form_action,
            $this->test_session->getActiveId(),
            $pass_index,
            $this->isShowingPostponeStatusReguired($question_gui->getObject()->getId()),
            $user_post_solution,
            $instant_response && $this->object->getSpecificAnswerFeedback()
        );

        $this->populateQuestionEditControl($question_gui);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showQuestionViewable()

ilTestPlayerAbstractGUI::showQuestionViewable ( assQuestionGUI  $question_gui, string  $form_action, bool  $is_question_worked_through, bool  $instant_response  )

protected

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

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

Referenced by showQuestionCmd().

     : void {
        $question_navigation_gui = $this->buildReadOnlyStateQuestionNavigationGUI($question_gui->getObject()->getId());
        $question_navigation_gui->setQuestionWorkedThrough($is_question_worked_through);
        $question_gui->setNavigationGUI($question_navigation_gui);
        $question_gui->getQuestionHeaderBlockBuilder()->setQuestionAnswered($is_question_worked_through);

        $solutionoutput = $question_gui->getSolutionOutput(
            $this->test_session->getActiveId(),
            $this->test_session->getPass(),
            false,
            false,
            true,
            $instant_response && $this->object->getSpecificAnswerFeedback(),
            false,
            false,
            true
        );

        $pageoutput = $question_gui->outQuestionPage(
            '',
            $this->isShowingPostponeStatusReguired($question_gui->getObject()->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', $form_action);
        $this->tpl->setVariable('ENCTYPE', 'enctype="' . $question_gui->getFormEncodingType() . '"');
        $this->tpl->setVariable('FORM_TIMESTAMP', time());
        $this->populateQuestionEditControl($question_gui);
    }

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 2113 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 1864 of file class.ilTestPlayerAbstractGUI.php.

References ILIAS\Repository\ctrl(), getCurrentSequenceElement(), ILIAS\UI\Component\Listing\Workflow\Step\IN_PROGRESS, 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->test_sequence);
        $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 ( )

protected

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

References $_SERVER, ILIAS\Repository\ctrl(), getCurrentSequenceElement(), ilTestServiceGUI\getObject(), isValidSequenceElement(), ILIAS\Repository\logger(), ILIAS\Repository\object(), ilTestPlayerCommands\SHOW_QUESTION, and ILIAS\Repository\user().

    {
        $current_sequence_element = $this->getCurrentSequenceElement();
        $next_sequence_element = $this->test_sequence->getNextSequence($current_sequence_element);

        if (!$this->isValidSequenceElement($next_sequence_element)) {
            $next_sequence_element = $this->test_sequence->getFirstSequence();
        }

        if ($this->object->isPostponingEnabled()) {
            $this->test_sequence->postponeSequence($current_sequence_element);
            $this->test_sequence->saveToDb();
        }

        if ($this->logger->isLoggingEnabled()
            && !$this->getObject()->getAnonymity()) {
            $this->logger->logParticipantInteraction(
                $this->logger->getInteractionFactory()->buildParticipantInteraction(
                    $this->object->getRefId(),
                    $this->test_sequence->getQuestionForSequence($current_sequence_element),
                    $this->user->getId(),
                    $this->logger->isIPLoggingEnabled() ? $_SERVER['REMOTE_ADDR'] : '',
                    TestParticipantInteractionTypes::QUESTION_SKIPPED,
                    []
                )
            );
        }

        $this->ctrl->setParameter($this, 'sequence', $next_sequence_element);
        $this->ctrl->setParameter($this, 'pmode', '');

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

Here is the call 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 726 of file class.ilTestPlayerAbstractGUI.php.

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

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

        $this->process_locker->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([ilRepositoryGUI::class, ilObjTestGUI::class, ilInfoScreenGUI::class]);
    }

Here is the call graph for this function:

startTestCmd()

ilTestPlayerAbstractGUI::startTestCmd ( )

protected

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

References $_SERVER, adoptUserSolutionsFromPreviousPass(), ILIAS\Repository\ctrl(), generateRandomTestPassForActiveUser(), ilSession\get(), ilLOTestQuestionAdapter\getInstance(), ilTestServiceGUI\getObject(), ilTestServiceGUI\getObjectiveOrientedContainer(), ILIAS\Repository\logger(), ILIAS\Repository\object(), ilTestPlayerCommands\QUESTION_SUMMARY, ilSession\set(), ilTestPlayerCommands\SHOW_QUESTION, updateLearningProgressOnTestStart(), and ILIAS\Repository\user().

    {
        ilSession::set('tst_pass_finish', 0);

        // ensure existing test session
        $this->test_session->setUserId($this->user->getId());
        $access_code = ilSession::get('tst_access_code');
        if ($access_code != null && isset($access_code[$this->object->getTestId()])) {
            $this->test_session->setAnonymousId($access_code[$this->object->getTestId()]);
        }
        if ($this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()) {
            $this->test_session->setObjectiveOrientedContainerId($this->getObjectiveOrientedContainer()->getObjId());
        }
        $this->test_session->saveToDb();

        $active_id = $this->test_session->getActiveId();
        $this->ctrl->setParameter($this, "active_id", $active_id);

        $shuffle = $this->object->getShuffleQuestions();
        if ($this->object->isRandomTest()) {
            $this->generateRandomTestPassForActiveUser();

            $this->object->loadQuestions();
            $shuffle = false; // shuffle is already done during the creation of the random questions
        }

        $this->object->updateTestPassResults(
            $active_id,
            $this->test_session->getPass(),
            null,
            $this->object->getId()
        );

        // ensure existing test sequence
        if (!$this->test_sequence->hasSequence()) {
            $this->test_sequence->createNewSequence($this->object->getQuestionCount(), $shuffle);
            $this->test_sequence->saveToDb();
        }

        $this->test_sequence->loadFromDb();
        $this->test_sequence->loadQuestions();

        if ($this->test_session->isObjectiveOriented()) {
            $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->test_session);

            $objectivesAdapter->notifyTestStart($this->test_session, $this->object->getId());
            $objectivesAdapter->prepareTestPass($this->test_session, $this->test_sequence);

            $objectivesAdapter->buildQuestionRelatedObjectiveList(
                $this->test_sequence,
                $this->question_related_objectives_list
            );

            if ($this->test_sequence->hasOptionalQuestions()) {
                $this->adoptUserSolutionsFromPreviousPass();

                $this->test_sequence->reorderOptionalQuestionsToSequenceEnd();
                $this->test_sequence->saveToDb();
            }
        }

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

        $this->updateLearningProgressOnTestStart();

        $sequence_element = $this->test_sequence->getFirstSequence();

        $this->ctrl->setParameter($this, 'sequence', $sequence_element);
        $this->ctrl->setParameter($this, 'pmode', '');

        if ($this->logger->isLoggingEnabled()
            && !$this->getObject()->getAnonymity()) {
            $this->logger->logParticipantInteraction(
                $this->logger->getInteractionFactory()->buildParticipantInteraction(
                    $this->object->getRefId(),
                    null,
                    $this->user->getId(),
                    $this->logger->isIPLoggingEnabled() ? $_SERVER['REMOTE_ADDR'] : '',
                    TestParticipantInteractionTypes::TEST_RUN_STARTED,
                    []
                )
            );
        }

        if ($this->object->getListOfQuestionsStart()) {
            $this->ctrl->setParameterByClass(static::class, 'first', '1');
            $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY);
        }

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

Here is the call graph for this function:

submitIntermediateSolutionCmd()

ilTestPlayerAbstractGUI::submitIntermediateSolutionCmd ( )

protected

Definition at line 960 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:

submitSolutionAndNextCmd()

ilTestPlayerAbstractGUI::submitSolutionAndNextCmd ( )

protected

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

References ILIAS\Repository\ctrl(), getCurrentSequenceElement(), isValidSequenceElement(), ILIAS\Repository\object(), removeIntermediateSolution(), saveQuestionSolution(), ilTestPlayerCommands\SHOW_QUESTION, and submitSolutionCmd().

                                                 : void
    {
        if ($this->object->isForceInstantFeedbackEnabled()) {
            $this->submitSolutionCmd();
            return;
        }

        if ($this->saveQuestionSolution(true, false)) {
            $this->test_sequence->getQuestionForSequence(
                $this->getCurrentSequenceElement()
            );

            $this->removeIntermediateSolution();

            $next_sequence_element = $this->test_sequence->getNextSequence($this->getCurrentSequenceElement());

            if (!$this->isValidSequenceElement($next_sequence_element)) {
                $next_sequence_element = $this->test_sequence->getFirstSequence();
            }

            $this->test_session->setLastSequence($next_sequence_element ?? 0);
            $this->test_session->saveToDb();

            $this->ctrl->setParameter($this, 'sequence', $next_sequence_element);
            $this->ctrl->setParameter($this, 'pmode', '');
        }

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

Here is the call graph for this function:

submitSolutionCmd()

ilTestPlayerAbstractGUI::submitSolutionCmd ( )

protected

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

References ILIAS\Repository\ctrl(), getCurrentSequenceElement(), getNavigationUrlParameter(), getNextCommandParameter(), getNextSequenceParameter(), ILIAS\Repository\object(), PRESENTATION_MODE_VIEW, ilUtil\redirect(), removeIntermediateSolution(), saveNavigationPreventConfirmation(), saveQuestionSolution(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by submitSolutionAndNextCmd().

    {
        if ($this->saveQuestionSolution(true, false)) {
            $question_id = $this->test_sequence->getQuestionForSequence(
                $this->getCurrentSequenceElement()
            );

            $this->removeIntermediateSolution();

            if ($this->object->isForceInstantFeedbackEnabled()) {
                $this->ctrl->setParameter($this, 'instresp', 1);

                $this->test_sequence->setQuestionChecked($question_id);
                $this->test_sequence->saveToDb();
            }

            if ($this->getNextCommandParameter()) {
                if ($this->getNextSequenceParameter()) {
                    $this->ctrl->setParameter($this, 'sequence', $this->getNextSequenceParameter());
                    $this->ctrl->setParameter($this, 'pmode', '');
                }

                $this->ctrl->redirect($this, $this->getNextCommandParameter());
            }

            $this->ctrl->setParameter($this, 'pmode', ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);
        } else {
            $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
        }

        // fau: testNav - remember to prevent the navigation confirmation
        $this->saveNavigationPreventConfirmation();
        // fau.

        // fau: testNav - handle navigation after saving
        if ($this->getNavigationUrlParameter()) {
            ilUtil::redirect($this->getNavigationUrlParameter());
        } else {
            $this->ctrl->saveParameter($this, 'sequence');
        }
        // fau.
        $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

suspendTestCmd()

ilTestPlayerAbstractGUI::suspendTestCmd

(

)

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

References ILIAS\Repository\ctrl().

Referenced by max_processing_time_reached().

    {
        $this->ctrl->redirectByClass(TestScreenGUI::class, TestScreenGUI::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 989 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 1000 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by unmarkQuestionAndSaveIntermediateCmd().

    {
        $question_id = $this->test_sequence->getQuestionForSequence(
            $this->getCurrentSequenceElement()
        );

        $this->object->setQuestionSetSolved(0, $question_id, $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 3019 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by showQuestionCmd().

                                                       : void
    {
        $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:

updateLearningProgressOnTestStart()

ilTestPlayerAbstractGUI::updateLearningProgressOnTestStart ( )

protected

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

References ilLPStatusWrapper\_updateStatus(), ILIAS\Repository\object(), and ILIAS\Repository\user().

Referenced by startTestCmd().

                                                          : void
    {
        ilLPStatusWrapper::_updateStatus($this->object->getId(), $this->user->getId());
    }

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 337 of file class.ilTestPlayerAbstractGUI.php.

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

Referenced by handleFileUploadCmd(), handleQuestionActionCmd(), and 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

$ass_settings

ilSetting ilTestPlayerAbstractGUI::$ass_settings = null

protected

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

$cached_question_guis

array ilTestPlayerAbstractGUI::$cached_question_guis = []

private

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

$cached_question_objects

array ilTestPlayerAbstractGUI::$cached_question_objects = []

private

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

$ending_time_reached

bool ilTestPlayerAbstractGUI::$ending_time_reached

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

$finish_test_modal

InterruptiveModal ilTestPlayerAbstractGUI::$finish_test_modal = null

protected

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

$max_processing_time_reached

bool ilTestPlayerAbstractGUI::$max_processing_time_reached

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

$modal_signals

array ilTestPlayerAbstractGUI::$modal_signals = []

protected

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

Referenced by populateQuestionEditControl().

$password_checker

ilTestPasswordChecker ilTestPlayerAbstractGUI::$password_checker

protected

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

$process_locker

ilTestProcessLocker ilTestPlayerAbstractGUI::$process_locker

protected

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

$question_related_objectives_list

ilTestQuestionRelatedObjectivesList ilTestPlayerAbstractGUI::$question_related_objectives_list

protected

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

$ref_id

int ilTestPlayerAbstractGUI::$ref_id

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

$test_sequence

ilTestSequence ilTestPlayerAbstractGUI::$test_sequence = null

protected

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

$test_session

ilTestSession ilTestPlayerAbstractGUI::$test_session = null

protected

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

DISCARD_MODAL

const ilTestPlayerAbstractGUI::DISCARD_MODAL = "discard_modal"

protected

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

FINISH_TEST_CMD

const ilTestPlayerAbstractGUI::FINISH_TEST_CMD = 'finishTest'

protected

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

FIXED_SHUFFLER_SEED_MIN_LENGTH

const ilTestPlayerAbstractGUI::FIXED_SHUFFLER_SEED_MIN_LENGTH = 8

Definition at line 44 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 2931 of file class.ilTestPlayerAbstractGUI.php.

LOCKS_CHANGED_MODAL

const ilTestPlayerAbstractGUI::LOCKS_CHANGED_MODAL = "locks_changed_modal"

protected

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

LOCKS_UNCHANGED_MODAL

const ilTestPlayerAbstractGUI::LOCKS_UNCHANGED_MODAL = "locks_unchanged_modal"

protected

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

PRESENTATION_MODE_EDIT

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT = 'edit'

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

Referenced by editSolutionCmd(), and showQuestionCmd().

PRESENTATION_MODE_VIEW

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW = 'view'

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

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

---

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

• components/ILIAS/Test/classes/class.ilTestPlayerAbstractGUI.php