ilTestPlayerAbstractGUI Class Reference

Inheritance diagram for ilTestPlayerAbstractGUI:

Collaboration diagram for ilTestPlayerAbstractGUI:

Public Member Functions
	__construct (ilObjTest $object)
	executeCommand ()
	execute command More...
	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 @access 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...
	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 (int $active_id, bool $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)
	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)
	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_result_repository
ilTestParticipantAccessFilterFactory	$participant_access_filter

Private Member Functions
	checkAndUpdateSaveAllowedByFormTimestamp (bool $force)
	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 38 of file class.ilTestPlayerAbstractGUI.php.

Constructor & Destructor Documentation

__construct()

ilTestPlayerAbstractGUI::__construct

(

ilObjTest

$object

)

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

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

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

Here is the call graph for this function:

Member Function Documentation

accessCodeConfirmedCmd()

ilTestPlayerAbstractGUI::accessCodeConfirmedCmd

(

)

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

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

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

Here is the call graph for this function:

adoptUserSolutionsFromPreviousPass()

ilTestPlayerAbstractGUI::adoptUserSolutionsFromPreviousPass ( )

protected

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

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

References ILIAS\Repository\user().

Here is the call graph for this function:

afterTestPassFinishedCmd()

ilTestPlayerAbstractGUI::afterTestPassFinishedCmd ( )

protected

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

                                                 : void
    {
        // show final statement
        if (!$this->testrequest->isset('skipfinalstatement')
            && $this->object->getMainSettings()->getFinishingSettings()->getConcludingRemarksEnabled()) {
            $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_FINAL_STATMENT);
        }
 
        if ($this->object->canShowTestResults($this->test_session)) {
            $this->redirectBackCmd();
        }
 
        // redirect after test
        $redirection_mode = $this->object->getMainSettings()->getFinishingSettings()->getRedirectionMode();
        if ($redirection_mode === RedirectionModes::ALWAYS_TO_LOGOUT) {
            $this->ctrl->redirectToURL(ilStartUpGUI::logoutUrl());
        }
 
        $redirection_url = $this->object->getMainSettings()->getFinishingSettings()->getRedirectionUrl();
        if (empty($redirection_url)
            || $redirection_mode === RedirectionModes::NONE
            || $redirection_mode === RedirectionModes::IF_KIOSK_ACTIVATED
                && !$this->object->getKioskMode()) {
            $this->redirectBackCmd();
        }
 
        $this->ctrl->redirectToURL($redirection_url);
    }

References ILIAS\Test\Settings\MainSettings\ALWAYS_TO_LOGOUT, ILIAS\Repository\ctrl(), ilStartUpGUI\logoutUrl(), ILIAS\Repository\object(), and ilTestPlayerCommands\SHOW_FINAL_STATMENT.

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

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

References ILIAS\Repository\access(), exit, and ILIAS\Repository\lng().

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

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

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

Here is the call graph for this function:

backFromFinishingCmd()

ilTestPlayerAbstractGUI::backFromFinishingCmd

(

)

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

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

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

Here is the call graph for this function:

buildEditableStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildEditableStateQuestionNavigationGUI (   $question_id )

protected

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

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

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

Here is the call graph for this function:

buildFinishTestModal()

ilTestPlayerAbstractGUI::buildFinishTestModal

(

)

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

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

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

Here is the call graph for this function:

buildNextButtonInstance()

ilTestPlayerAbstractGUI::buildNextButtonInstance (   $primaryNext )

private

Parameters

bool

$primaryNext

Returns

\ILIAS\UI\Component\Button\Primary

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

    {
        $target = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::NEXT_QUESTION);
        if ($primaryNext) {
            $button = $this->ui_factory->button()->primary(
                $this->lng->txt('next_question') . $this->ui_renderer->render($this->ui_factory->symbol()->glyph()->next()),
                ''
            )->withUnavailableAction(true)
             ->withOnLoadCode($this->getOnLoadCodeForNavigationButtons($target, ilTestPlayerCommands::NEXT_QUESTION));
        } else {
            $button = $this->ui_factory->button()->standard(
                $this->lng->txt('next_question') . $this->ui_renderer->render($this->ui_factory->symbol()->glyph()->next()),
                ''
            )->withUnavailableAction(true)
             ->withOnLoadCode($this->getOnLoadCodeForNavigationButtons($target, ilTestPlayerCommands::NEXT_QUESTION));
        }
        return $button;
    }

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

Here is the call graph for this function:

buildPreviousButtonInstance()

ilTestPlayerAbstractGUI::buildPreviousButtonInstance ( )

private

Parameters

$disabled

Returns

\ILIAS\UI\Component\Button\Primary

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

    {
        $target = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::PREVIOUS_QUESTION);
        $button = $this->ui_factory->button()->standard(
            $this->ui_renderer->render($this->ui_factory->symbol()->glyph()->back()) . $this->lng->txt('previous_question'),
            ''
        )->withUnavailableAction(true)
         ->withOnLoadCode($this->getOnLoadCodeForNavigationButtons($target, ilTestPlayerCommands::PREVIOUS_QUESTION));
        return $button;
    }

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

Here is the call graph for this function:

buildQuestionObject()

ilTestPlayerAbstractGUI::buildQuestionObject ( )

private

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

                                          : ?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
            $this->tpl->setOnScreenMessage(ilGlobalTemplateInterface::MESSAGE_TYPE_FAILURE, $this->lng->txt('tst_player_answer_saved_and_locked'), true);
            $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
        }
 
        if ($q_id === null) {
            return null;
        }
 
        return $this->getQuestionInstance($q_id);
    }

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ILIAS\UICore\GlobalTemplate\MESSAGE_TYPE_FAILURE, and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

buildReadOnlyStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildReadOnlyStateQuestionNavigationGUI (   $question_id )

protected

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

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

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

Here is the call graph for this function:

buildTestPassQuestionList()

ilTestPlayerAbstractGUI::buildTestPassQuestionList ( )

abstractprotected

Reimplemented in ilTestPlayerFixedQuestionSetGUI, and ilTestPlayerRandomQuestionSetGUI.

cancelAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::cancelAnswerOptionalQuestionsCmd ( )

protected

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

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

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

Here is the call graph for this function:

canSaveResult()

ilTestPlayerAbstractGUI::canSaveResult ( )

protected

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

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

checkAndUpdateSaveAllowedByFormTimestamp()

ilTestPlayerAbstractGUI::checkAndUpdateSaveAllowedByFormTimestamp ( bool  $force )

private

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

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

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

Here is the call graph for this function:

checkReadAccess()

ilTestPlayerAbstractGUI::checkReadAccess ( )

protected

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

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

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

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

checkTestExecutable()

ilTestPlayerAbstractGUI::checkTestExecutable ( )

protected

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

    {
        $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]);
        }
    }

References ILIAS\Repository\ctrl().

Referenced by executeCommand().

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

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

References $test_session, and ilTestSession\getUserId().

Referenced by executeCommand().

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

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

References exit.

confirmAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::confirmAnswerOptionalQuestionsCmd ( )

protected

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

    {
        $this->test_sequence->setAnsweringOptionalQuestionsConfirmed(true);
        $this->test_sequence->saveToDb();
 
        $this->ctrl->setParameter($this, 'activecommand', 'gotoquestion');
        $this->ctrl->redirect($this, 'redirectQuestion');
    }

References ILIAS\Repository\ctrl().

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 @access public

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

    {
        $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();
    }

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

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

    {
        $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;
    }

References exit.

determineInlineScoreDisplay()

ilTestPlayerAbstractGUI::determineInlineScoreDisplay ( )

protected

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

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

References ILIAS\Repository\object().

Here is the call graph for this function:

determineSolutionPassIndex()

ilTestPlayerAbstractGUI::determineSolutionPassIndex ( assQuestionGUI  $question_gui )

protected

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

                                                                               : int
    {
        if ($this->object->isPreviousSolutionReuseEnabled()) {
            $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();
    }

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

Here is the call graph for this function:

discardSolutionCmd()

ilTestPlayerAbstractGUI::discardSolutionCmd ( )

protected

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

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

References $_SERVER, ILIAS\Repository\ctrl(), ILIAS\Repository\logger(), ILIAS\Repository\object(), PRESENTATION_MODE_VIEW, and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

displayAccessCodeCmd()

ilTestPlayerAbstractGUI::displayAccessCodeCmd

(

)

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

    {
        $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();
    }

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

Here is the call graph for this function:

editSolutionCmd()

ilTestPlayerAbstractGUI::editSolutionCmd ( )

protected

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

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

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

Here is the call graph for this function:

endingTimeReached()

ilTestPlayerAbstractGUI::endingTimeReached

(

)

handle endingTimeReached

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

    {
        $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();
    }

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

Here is the call graph for this function:

ensureExistingTestSession()

ilTestPlayerAbstractGUI::ensureExistingTestSession ( ilTestSession  $test_session )

protected

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

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

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

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

executeCommand()

ilTestPlayerAbstractGUI::executeCommand

(

)

execute command

Reimplemented from ilTestServiceGUI.

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

    {
        $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);
                $page_gui->setFileDownloadLink(
                    $this->ctrl->getLinkTargetByClass(ilObjTestGUI::class, 'downloadFile')
                );
                $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 '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;
    }

References $id, ilTestServiceGUI\$test_sequence_factory, checkReadAccess(), checkTestExecutable(), checkTestSessionUser(), ILIAS\Repository\ctrl(), ensureExistingTestSession(), exit, getCurrentSequenceElement(), ilTestServiceGUI\getObjectiveOrientedContainer(), ilTestSequenceFactory\getSequenceByTestSession(), getTestPlayerTitle(), handleCheckTestPassValid(), handlePasswordProtectionRedirect(), initAssessmentSettings(), iljQueryUtil\initjQuery(), initProcessLocker(), ilTestPlayerCommands\isTestExecutionCommand(), ILIAS\Repository\lng(), ILIAS\Repository\object(), ILIAS\Repository\settings(), 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().

Here is the call graph for this function:

finishTestCmd()

ilTestPlayerAbstractGUI::finishTestCmd

(

)

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

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

References $_SERVER, ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, ilSession\clear(), ILIAS\Repository\ctrl(), ilSession\get(), ILIAS\Repository\logger(), ilSession\set(), and ILIAS\Test\Logging\TEST_RUN_FINISHED.

Here is the call graph for this function:

generateRandomTestPassForActiveUser()

ilTestPlayerAbstractGUI::generateRandomTestPassForActiveUser ( )

protected

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

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

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

Here is the call graph for this function:

getAnswerChangedParameter()

ilTestPlayerAbstractGUI::getAnswerChangedParameter ( )

protected

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

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

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

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

References ILIAS\Repository\object().

Here is the call graph for this function:

getCurrentQuestionId()

ilTestPlayerAbstractGUI::getCurrentQuestionId ( )

protected

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

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

Referenced by removeIntermediateSolution().

Here is the caller graph for this function:

getCurrentSequenceElement()

ilTestPlayerAbstractGUI::getCurrentSequenceElement ( )

protected

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

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

Referenced by executeCommand().

Here is the caller graph for this function:

getFinishTestCommand()

ilTestPlayerAbstractGUI::getFinishTestCommand ( )

protected

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

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

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

Here is the call graph for this function:

getInstantResponseParameter()

ilTestPlayerAbstractGUI::getInstantResponseParameter ( )

protected

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

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

getIntroductionPageButtonLabel()

ilTestPlayerAbstractGUI::getIntroductionPageButtonLabel ( )

protected

Returns

string

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

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

References ILIAS\Repository\lng().

Here is the call graph for this function:

getLockParameter()

ilTestPlayerAbstractGUI::getLockParameter

(

)

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

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

getNavigationUrlParameter()

ilTestPlayerAbstractGUI::getNavigationUrlParameter ( )

protected

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

                                                  : 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 '';
    }

References ilUtil\_getHttpPath().

Here is the call graph for this function:

getNextCommandParameter()

ilTestPlayerAbstractGUI::getNextCommandParameter ( )

protected

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

    {
        $nextcmd = '';
        if ($this->testrequest->isset('nextcmd')) {
            $nextcmd = $this->testrequest->strVal('nextcmd');
        }
 
        return $nextcmd !== '' ? $nextcmd : null;
    }

getNextSequenceParameter()

ilTestPlayerAbstractGUI::getNextSequenceParameter ( )

protected

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

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

getOnLoadCodeForNavigationButtons()

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

private

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

                                                                                   : 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');";
        };
    }

References $id.

getPresentationModeParameter()

ilTestPlayerAbstractGUI::getPresentationModeParameter ( )

protected

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

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

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

Here is the call graph for this function:

getQuestionGuiInstance()

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

protected

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

                                                                                        : 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];
    }

References assQuestionGUI\getObject(), assQuestionGUI\populateJavascriptFilesRequiredForWorkForm(), assQuestionGUI\PRESENTATION_CONTEXT_TEST, assQuestionGUI\setObject(), assQuestionGUI\setPresentationContext(), and assQuestionGUI\setTargetGui().

Here is the call graph for this function:

getQuestionInstance()

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

protected

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

                                                                                     : 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, ilLoggerFactory::getLogger('tst'));
        $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;
    }

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

Referenced by removeIntermediateSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionsDefaultPresentationMode()

ilTestPlayerAbstractGUI::getQuestionsDefaultPresentationMode ( )

protected

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

                                                            : string
    {
        return self::PRESENTATION_MODE_EDIT;
    }

getRegisteredForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::getRegisteredForcedFeedbackNavUrl ( )

protected

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

                                                          : ?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()];
    }

References ilSession\get().

Here is the call graph for this function:

getSequenceElementParameter()

ilTestPlayerAbstractGUI::getSequenceElementParameter ( )

protected

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

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

getTestNavigationToolbarGUI()

ilTestPlayerAbstractGUI::getTestNavigationToolbarGUI ( )

protected

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

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

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

Here is the call graph for this function:

getTestPlayerTitle()

ilTestPlayerAbstractGUI::getTestPlayerTitle ( )

protected

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

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

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

Referenced by executeCommand().

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

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

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

Referenced by executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

handleFileUploadCmd()

ilTestPlayerAbstractGUI::handleFileUploadCmd ( )

protected

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

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

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

Here is the call graph for this function:

handleIntermediateSubmit()

ilTestPlayerAbstractGUI::handleIntermediateSubmit ( )

protected

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

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

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

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

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

Referenced by executeCommand().

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

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

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

Here is the call graph for this function:

handleQuestionActionCmd()

ilTestPlayerAbstractGUI::handleQuestionActionCmd ( )

protected

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

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

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

Here is the call graph for this function:

handleQuestionPostponing()

ilTestPlayerAbstractGUI::handleQuestionPostponing ( int  $question_id )

protected

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

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

handleSkillTriggering()

ilTestPlayerAbstractGUI::handleSkillTriggering ( ilTestSession  $test_session )

protected

Parameters

ilTestSession

$test_session

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

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

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

Here is the call graph for this function:

handleTearsAndAngerNoObjectiveOrientedQuestion()

ilTestPlayerAbstractGUI::handleTearsAndAngerNoObjectiveOrientedQuestion ( )

protected

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

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

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

Here is the call graph for this function:

handleTearsAndAngerQuestionIsNull()

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

protected

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

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

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

Here is the call graph for this function:

handleUserSettings()

ilTestPlayerAbstractGUI::handleUserSettings

(

)

Handles some form parameters on starting and resuming a test.

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

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

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

Here is the call graph for this function:

initAssessmentSettings()

ilTestPlayerAbstractGUI::initAssessmentSettings ( )

protected

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

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

Referenced by executeCommand().

Here is the caller graph for this function:

initProcessLocker()

ilTestPlayerAbstractGUI::initProcessLocker (   $activeId )

protected

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

    {
        $ilDB = $this->db;
        $process_lockerFactory = new ilTestProcessLockerFactory($this->ass_settings, $ilDB, $this->logger);
        $this->process_locker = $process_lockerFactory->withContextId((int) $activeId)->getLocker();
    }

References ilTestServiceGUI\$db, $ilDB, and ILIAS\Repository\logger().

Referenced by executeCommand().

Here is the call graph for this function:

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

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

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

Here is the call graph for this function:

initTestPageTemplate()

ilTestPlayerAbstractGUI::initTestPageTemplate ( )

protected

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

    {
        $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'
        );
    }

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

Here is the call graph for this function:

initTestQuestionConfig()

ilTestPlayerAbstractGUI::initTestQuestionConfig ( assQuestion  $question_obj )

protected

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

    {
        $question_obj->getTestPresentationConfig()->setPreviousPassSolutionReuseAllowed(
            $this->object->isPreviousSolutionReuseEnabled()
        );
    }

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

Here is the call graph for this function:

isFirstQuestionInSequence()

ilTestPlayerAbstractGUI::isFirstQuestionInSequence (   $sequence_element )

protected

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

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

isFollowUpQuestionLocksConfirmationPrevented()

ilTestPlayerAbstractGUI::isFollowUpQuestionLocksConfirmationPrevented ( )

protected

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

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

References ilSession\get().

Here is the call graph for this function:

isForcedFeedbackNavUrlRegistered()

ilTestPlayerAbstractGUI::isForcedFeedbackNavUrlRegistered ( )

protected

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

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

isLastQuestionInSequence()

ilTestPlayerAbstractGUI::isLastQuestionInSequence (   $sequence_element )

protected

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

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

isMaxProcessingTimeReached()

ilTestPlayerAbstractGUI::isMaxProcessingTimeReached

(

)

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

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

isNrOfTriesReached()

ilTestPlayerAbstractGUI::isNrOfTriesReached

(

)

nr of tries exceeded

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

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

isOptionalQuestionAnsweringConfirmationRequired()

ilTestPlayerAbstractGUI::isOptionalQuestionAnsweringConfirmationRequired ( int  $sequence_key )

protected

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

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

isParticipantsAnswerFixed()

ilTestPlayerAbstractGUI::isParticipantsAnswerFixed (   $question_id )

protected

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

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

References ILIAS\Repository\object().

Here is the call graph for this function:

isShowingPostponeStatusReguired()

ilTestPlayerAbstractGUI::isShowingPostponeStatusReguired ( int  $question_id )

protected

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

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

isTestAccessible()

ilTestPlayerAbstractGUI::isTestAccessible

(

)

test accessible returns true if the user can perform the test

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

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

isValidSequenceElement()

ilTestPlayerAbstractGUI::isValidSequenceElement (   $sequence_element )

private

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

                                                              : bool
    {
        if ($sequence_element === false) {
            return false;
        }
 
        if ($sequence_element < 1) {
            return false;
        }
 
        if (!$this->test_sequence->getPositionOfSequence($sequence_element)) {
            return false;
        }
 
        return true;
    }

markQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::markQuestionAndSaveIntermediateCmd ( )

protected

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

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

markQuestionCmd()

ilTestPlayerAbstractGUI::markQuestionCmd ( )

protected

Set a question solved.

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

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

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

Here is the call 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

@access public

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

    {
        $this->suspendTestCmd();
    }

nextQuestionCmd()

ilTestPlayerAbstractGUI::nextQuestionCmd ( )

protected

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

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

References $_SERVER, ILIAS\Repository\ctrl(), ILIAS\Repository\logger(), ILIAS\Repository\object(), and 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.

Reimplemented from ilTestServiceGUI.

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

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

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

Here is the call graph for this function:

outProcessingTime()

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

private

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

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

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

Here is the call graph for this function:

outQuestionSummaryCmd()

ilTestPlayerAbstractGUI::outQuestionSummaryCmd

(

)

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

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

    {
        $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();
        }
    }

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

Here is the call graph for this function:

outUserResultsOverviewCmd()

ilTestPlayerAbstractGUI::outUserResultsOverviewCmd

(

)

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

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

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

performTearsAndAngerBrokenConfessionChecks()

ilTestPlayerAbstractGUI::performTearsAndAngerBrokenConfessionChecks ( )

protected

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

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

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

Here is the call graph for this function:

performTestPassFinishedTasks()

ilTestPlayerAbstractGUI::performTestPassFinishedTasks ( StatusOfAttempt  $status_of_attempt )

protected

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

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

populateContentStyleBlock()

ilTestPlayerAbstractGUI::populateContentStyleBlock ( )

protected

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

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

References ilObjStyleSheet\getContentStylePath().

Here is the call graph for this function:

populateDiscardSolutionModal()

ilTestPlayerAbstractGUI::populateDiscardSolutionModal ( )

protected

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

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

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

Here is the call graph for this function:

populateFeedbackBlockHeader()

ilTestPlayerAbstractGUI::populateFeedbackBlockHeader (   $withFocusAnchor )

protected

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

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

References ILIAS\Repository\lng().

Here is the call graph for this function:

populateFeedbackBlockMessage()

ilTestPlayerAbstractGUI::populateFeedbackBlockMessage ( string  $a_message )

protected

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

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

populateGenericFeedbackBlock()

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

protected

Returns

bool true, if there is some feedback populated

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

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

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

Here is the call graph for this function:

populateHelperGuiContent()

ilTestPlayerAbstractGUI::populateHelperGuiContent (   $helperGui )

protected

Parameters

$helperGui

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

    {
        $this->tpl->setVariable($this->getContentBlockName(), $this->ctrl->getHTML($helperGui));
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

populateInstantResponseBlocks()

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

protected

See also

ilAssQuestionPreviewGUI::handleInstantResponseRendering()

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

    {
        $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'));
            }
        }
    }

References ilObjTest\_getPass(), assQuestionGUI\getObject(), assQuestionGUI\getSolutionOutput(), assQuestionGUI\hasInlineFeedback(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

Here is the call graph for this function:

populateInstantResponseModal()

ilTestPlayerAbstractGUI::populateInstantResponseModal ( assQuestionGUI  $question_gui,   $nav_url  )

protected

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

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

References assQuestionGUI\getObject(), assQuestionGUI\getQuestionHeaderBlockBuilder(), assQuestionGUI\getSolutionOutput(), assQuestionGUI\outQuestionPage(), and assQuestionGUI\setNavigationGUI().

Here is the call graph for this function:

populateLowerNextButtonBlock()

ilTestPlayerAbstractGUI::populateLowerNextButtonBlock (   $primary_next )

protected

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

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

populateLowerPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateLowerPreviousButtonBlock ( )

protected

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

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

populateMessageContent()

ilTestPlayerAbstractGUI::populateMessageContent ( string  $content_html )

protected

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

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

References ILIAS\Repository\object().

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

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

References ILIAS\Repository\object().

Here is the call graph for this function:

populateNextButtons()

ilTestPlayerAbstractGUI::populateNextButtons (   $primary_next )

protected

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

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

populateNextLocksChangedModal()

ilTestPlayerAbstractGUI::populateNextLocksChangedModal ( )

protected

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

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

References ILIAS\Repository\lng().

Here is the call graph for this function:

populateNextLocksUnchangedModal()

ilTestPlayerAbstractGUI::populateNextLocksUnchangedModal ( )

protected

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

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

References ILIAS\Repository\lng().

Here is the call graph for this function:

populatePreviousButtons()

ilTestPlayerAbstractGUI::populatePreviousButtons ( )

protected

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

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

populateQuestionEditControl()

ilTestPlayerAbstractGUI::populateQuestionEditControl ( assQuestionGUI  $question_gui )

protected

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

                                                                                : 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) . ')');
    }

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

Here is the call graph for this function:

populateQuestionNavigation()

ilTestPlayerAbstractGUI::populateQuestionNavigation (   $sequence_element,   $primary_next  )

protected

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

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

populateQuestionOptionalMessage()

ilTestPlayerAbstractGUI::populateQuestionOptionalMessage ( )

abstractprotected

Reimplemented in ilTestPlayerFixedQuestionSetGUI, and ilTestPlayerRandomQuestionSetGUI.

populateScoreBlock()

ilTestPlayerAbstractGUI::populateScoreBlock (   $reachedPoints,   $maxPoints  )

protected

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

    {
        $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();
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

populateSolutionBlock()

ilTestPlayerAbstractGUI::populateSolutionBlock (   $solutionoutput )

protected

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

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

References ILIAS\Repository\lng().

Here is the call graph for this function:

populateSpecificFeedbackBlock()

ilTestPlayerAbstractGUI::populateSpecificFeedbackBlock ( assQuestionGUI  $question_gui )

protected

Returns

bool true, if there is some feedback populated

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

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

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

Here is the call graph for this function:

populateSyntaxStyleBlock()

ilTestPlayerAbstractGUI::populateSyntaxStyleBlock ( )

protected

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

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

References ilObjStyleSheet\getSyntaxStylePath().

Here is the call graph for this function:

populateTestNavigationToolbar()

ilTestPlayerAbstractGUI::populateTestNavigationToolbar ( ilTestNavigationToolbarGUI  $toolbar_gui )

protected

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

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

populateUpperNextButtonBlock()

ilTestPlayerAbstractGUI::populateUpperNextButtonBlock (   $primaryNext )

protected

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

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

populateUpperPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateUpperPreviousButtonBlock ( )

protected

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

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

prepareSummaryPage()

ilTestPlayerAbstractGUI::prepareSummaryPage ( )

protected

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

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

prepareTestPage()

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

protected

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

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

References ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), ilObjTest\lookupExamId(), ILIAS\Repository\object(), ilTestPlayerCommands\RESUME_PLAYER, and ILIAS\Repository\user().

Here is the call graph for this function:

previousQuestionCmd()

ilTestPlayerAbstractGUI::previousQuestionCmd ( )

protected

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

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

References ILIAS\Repository\ctrl(), and 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 841 of file class.ilTestPlayerAbstractGUI.php.

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

redirectAfterFinish()

ilTestPlayerAbstractGUI::redirectAfterFinish ( )

protected

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

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

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

Here is the call graph for this function:

redirectAfterQuestionListCmd()

ilTestPlayerAbstractGUI::redirectAfterQuestionListCmd

(

)

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

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

redirectBackCmd()

ilTestPlayerAbstractGUI::redirectBackCmd

(

)

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

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

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

registerForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::registerForcedFeedbackNavUrl ( string  $forced_feedback_nav_url )

protected

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

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

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

Here is the call graph for this function:

removeIntermediateSolution()

ilTestPlayerAbstractGUI::removeIntermediateSolution

(

)

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

                                                : void
    {
        $question_id = $this->getCurrentQuestionId();
 
        $this->getQuestionInstance($question_id)->removeIntermediateSolution(
            $this->test_session->getActiveId(),
            $this->test_session->getPass()
        );
    }

References getCurrentQuestionId(), and getQuestionInstance().

Here is the call graph for this function:

resumePlayerCmd()

ilTestPlayerAbstractGUI::resumePlayerCmd ( )

protected

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

    {
        $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->test_result_repository->updateTestAttemptResult(
            $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);
    }

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

Here is the call graph for this function:

revertChangesCmd()

ilTestPlayerAbstractGUI::revertChangesCmd ( )

protected

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

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

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

Here is the call graph for this function:

save()

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

private

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

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

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

Here is the call graph for this function:

saveNavigationPreventConfirmation()

ilTestPlayerAbstractGUI::saveNavigationPreventConfirmation ( )

protected

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

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

References ilSession\set().

Here is the call graph for this function:

saveQuestionSolution()

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

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

     : bool {
        $this->updateWorkingTime();
 
        if (!$this->checkAndUpdateSaveAllowedByFormTimestamp($force)) {
            return false;
        }
 
        /*
            #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;
        }
 
        $saved = ($force || $this->canSaveResult()) && $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;
    }

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

    {
        $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]);
    }

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

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

                                       : void
    {
        if ($this->test_session->isAnonymousUser()) {
            $this->test_session->setAccessCodeToSession($this->testrequest->strVal('anonymous_id'));
        }
 
        $this->ctrl->redirectByClass([ilRepositoryGUI::class, ilObjTestGUI::class, ilInfoScreenGUI::class]);
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

setAnswerChangedParameter()

ilTestPlayerAbstractGUI::setAnswerChangedParameter ( bool  $changed = true )

protected

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

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

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

setFollowUpQuestionLocksConfirmationPrevented()

ilTestPlayerAbstractGUI::setFollowUpQuestionLocksConfirmationPrevented ( )

protected

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

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

References ilSession\set().

Here is the call graph for this function:

showAnswerOptionalQuestionsConfirmation()

ilTestPlayerAbstractGUI::showAnswerOptionalQuestionsConfirmation ( )

protected

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

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

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

Here is the call graph for this function:

showFinalStatementCmd()

ilTestPlayerAbstractGUI::showFinalStatementCmd

(

)

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

    {
        $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()->content(
                    $this->object->prepareTextareaOutput($this->object->getFinalStatement(), true)
                ),
                $this->ui_factory->button()->standard(
                    $this->lng->txt('btn_next'),
                    $this->ctrl->getLinkTargetByClass(static::class, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED)
                )
            ])
        );
    }

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

Here is the call graph for this function:

showInstantResponseCmd()

ilTestPlayerAbstractGUI::showInstantResponseCmd ( )

protected

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

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

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

Here is the call graph for this function:

showQuestionCmd()

ilTestPlayerAbstractGUI::showQuestionCmd ( )

protected

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

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

References $_SERVER, ILIAS\Repository\ctrl(), ilLOTestQuestionAdapter\getInstance(), assQuestionGUI\getObject(), ILIAS\Repository\help(), ILIAS\Repository\lng(), ILIAS\Repository\logger(), ILIAS\Repository\object(), PRESENTATION_MODE_EDIT, PRESENTATION_MODE_VIEW, ilSession\set(), assQuestionGUI\setQuestionCount(), assQuestionGUI\setQuestionHeaderBlockBuilder(), assQuestionGUI\setSequenceNumber(), and ilTestPlayerCommands\SUBMIT_INTERMEDIATE_SOLUTION.

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

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

References assQuestionGUI\getQuestionHeaderBlockBuilder().

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

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

showSideList()

ilTestPlayerAbstractGUI::showSideList (   $current_sequence_element )

protected

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

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

References ILIAS\Repository\ctrl(), 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.

Here is the call graph for this function:

skipQuestionCmd()

ilTestPlayerAbstractGUI::skipQuestionCmd ( )

protected

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

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

References $_SERVER, ILIAS\Repository\ctrl(), ILIAS\Repository\logger(), ILIAS\Repository\object(), and 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 704 of file class.ilTestPlayerAbstractGUI.php.

    {
        $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]);
    }

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

Here is the call graph for this function:

startTestCmd()

ilTestPlayerAbstractGUI::startTestCmd ( )

protected

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

    {
        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->test_result_repository->updateTestAttemptResult(
            $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);
    }

References $_SERVER, ILIAS\Repository\ctrl(), ilSession\get(), ilLOTestQuestionAdapter\getInstance(), ILIAS\Repository\logger(), ILIAS\Repository\object(), ilTestPlayerCommands\QUESTION_SUMMARY, ilSession\set(), ilTestPlayerCommands\SHOW_QUESTION, and ILIAS\Repository\user().

Here is the call graph for this function:

submitIntermediateSolutionCmd()

ilTestPlayerAbstractGUI::submitIntermediateSolutionCmd ( )

protected

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

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

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

Here is the call graph for this function:

submitSolutionAndNextCmd()

ilTestPlayerAbstractGUI::submitSolutionAndNextCmd ( )

protected

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

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

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

Here is the call graph for this function:

submitSolutionCmd()

ilTestPlayerAbstractGUI::submitSolutionCmd ( )

protected

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

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

References ILIAS\Repository\ctrl(), ILIAS\Repository\object(), PRESENTATION_MODE_VIEW, ilUtil\redirect(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

suspendTestCmd()

ilTestPlayerAbstractGUI::suspendTestCmd

(

)

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

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

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

unmarkQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::unmarkQuestionAndSaveIntermediateCmd ( )

protected

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

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

unmarkQuestionCmd()

ilTestPlayerAbstractGUI::unmarkQuestionCmd ( )

protected

Set a question unsolved.

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

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

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

Here is the call graph for this function:

unregisterForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::unregisterForcedFeedbackNavUrl ( )

protected

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

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

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

Here is the call graph for this function:

updateLearningProgressOnTestStart()

ilTestPlayerAbstractGUI::updateLearningProgressOnTestStart ( )

protected

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

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

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

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

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

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

Here is the call graph for this function:

Field Documentation

$ass_settings

ilSetting ilTestPlayerAbstractGUI::$ass_settings = null

protected

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

$cached_question_guis

array ilTestPlayerAbstractGUI::$cached_question_guis = []

private

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

$cached_question_objects

array ilTestPlayerAbstractGUI::$cached_question_objects = []

private

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

$ending_time_reached

bool ilTestPlayerAbstractGUI::$ending_time_reached

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

$finish_test_modal

InterruptiveModal ilTestPlayerAbstractGUI::$finish_test_modal = null

protected

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

$max_processing_time_reached

bool ilTestPlayerAbstractGUI::$max_processing_time_reached

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

$modal_signals

array ilTestPlayerAbstractGUI::$modal_signals = []

protected

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

$password_checker

ilTestPasswordChecker ilTestPlayerAbstractGUI::$password_checker

protected

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

$process_locker

ilTestProcessLocker ilTestPlayerAbstractGUI::$process_locker

protected

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

$question_related_objectives_list

ilTestQuestionRelatedObjectivesList ilTestPlayerAbstractGUI::$question_related_objectives_list

protected

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

$ref_id

int ilTestPlayerAbstractGUI::$ref_id

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

$test_sequence

ilTestSequence ilTestPlayerAbstractGUI::$test_sequence = null

protected

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

$test_session

ilTestSession ilTestPlayerAbstractGUI::$test_session = null

protected

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

Referenced by checkTestSessionUser(), and ensureExistingTestSession().

DISCARD_MODAL

const ilTestPlayerAbstractGUI::DISCARD_MODAL = "discard_modal"

protected

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

FINISH_TEST_CMD

const ilTestPlayerAbstractGUI::FINISH_TEST_CMD = 'finishTest'

protected

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

FIXED_SHUFFLER_SEED_MIN_LENGTH

const ilTestPlayerAbstractGUI::FIXED_SHUFFLER_SEED_MIN_LENGTH = 8

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

FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM

const ilTestPlayerAbstractGUI::FOLLOWUP_QST_LOCKS_PREVENT_CONFIRMATION_PARAM = 'followup_qst_locks_prevent_confirmation'

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

LOCKS_CHANGED_MODAL

const ilTestPlayerAbstractGUI::LOCKS_CHANGED_MODAL = "locks_changed_modal"

protected

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

LOCKS_UNCHANGED_MODAL

const ilTestPlayerAbstractGUI::LOCKS_UNCHANGED_MODAL = "locks_unchanged_modal"

protected

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

PRESENTATION_MODE_EDIT

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT = 'edit'

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

Referenced by editSolutionCmd(), and showQuestionCmd().

PRESENTATION_MODE_VIEW

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW = 'view'

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