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 ()
	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 ilComponentFactory	$component_factory
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 806 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 3001 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 1026 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 866 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 900 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 1919 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 2311 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 1055 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 $message, 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 544 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\Scripts\PHPStan\$target, 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 567 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\Scripts\PHPStan\$target, ILIAS\Repository\ctrl(), and ilTestPlayerCommands\PREVIOUS_QUESTION.

Here is the call graph for this function:

buildQuestionObject()

ilTestPlayerAbstractGUI::buildQuestionObject ( )

private

Definition at line 377 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 2277 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 2249 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 430 of file class.ilTestPlayerAbstractGUI.php.

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

checkAndUpdateSaveAllowedByFormTimestamp()

ilTestPlayerAbstractGUI::checkAndUpdateSaveAllowedByFormTimestamp ( bool  $force )

private

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

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 1808 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 2240 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 1755 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 915 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 451 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 1295 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 1539 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 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 794 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 1479 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 1728 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 258 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->test_session->checkAccess($this->object);
 
        $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(), 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 982 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 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 2964 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 2581 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 1959 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 857 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 2520 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 2356 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 2547 of file class.ilTestPlayerAbstractGUI.php.

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

getIntroductionPageButtonLabel()

ilTestPlayerAbstractGUI::getIntroductionPageButtonLabel ( )

protected

Returns

string

Definition at line 2181 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 718 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 2567 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 2552 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 2562 of file class.ilTestPlayerAbstractGUI.php.

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

getOnLoadCodeForNavigationButtons()

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

private

Definition at line 578 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, and ILIAS\Scripts\PHPStan\$target.

getPresentationModeParameter()

ilTestPlayerAbstractGUI::getPresentationModeParameter ( )

protected

Definition at line 2538 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 2403 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 ILIAS\News\Common\Table\$tpl, ILIAS\UICore\GlobalTemplate\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 2612 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 ILIAS\News\Common\Table\$tpl, 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 2639 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 2813 of file class.ilTestPlayerAbstractGUI.php.

                                                            : string
    {
        return self::PRESENTATION_MODE_EDIT;
    }

getRegisteredForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::getRegisteredForcedFeedbackNavUrl ( )

protected

Definition at line 2828 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 2529 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 2268 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 3048 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 = $this->ui_factory->legacy()->content(
                sprintf(
                    "<span class='il-test-kiosk-head__participant-name'>%s</span>",
                    $this->refinery->encode()->htmlSpecialCharsAsEntities()->transform($this->user->getFullname())
                )
            );
            $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\refinery().

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 2921 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 2855 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 2591 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 2137 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 3020 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 1991 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 2914 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 2194 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 3014 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 2665 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 814 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 2186 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 277 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 775 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 2109 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 2658 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 1981 of file class.ilTestPlayerAbstractGUI.php.

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

isFollowUpQuestionLocksConfirmationPrevented()

ilTestPlayerAbstractGUI::isFollowUpQuestionLocksConfirmationPrevented ( )

protected

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

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

isLastQuestionInSequence()

ilTestPlayerAbstractGUI::isLastQuestionInSequence (   $sequence_element )

protected

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

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

isMaxProcessingTimeReached()

ilTestPlayerAbstractGUI::isMaxProcessingTimeReached

(

)

Definition at line 440 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 1718 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 1174 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 2165 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 1189 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 1707 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 2867 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 940 of file class.ilTestPlayerAbstractGUI.php.

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

markQuestionCmd()

ilTestPlayerAbstractGUI::markQuestionCmd ( )

protected

Set a question solved.

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

    {
        $this->suspendTestCmd();
    }

nextQuestionCmd()

ilTestPlayerAbstractGUI::nextQuestionCmd ( )

protected

Definition at line 2039 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 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 1927 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 1773 of file class.ilTestPlayerAbstractGUI.php.

                                                                     : void
    {
        $starting_time = $this->object->getStartingTimeOfUser($active_id);
        $working_time = new WorkingTime(
            $this->lng,
            $starting_time,
            $this->object->getProcessingTimeInSeconds($active_id)
        );
 
        $this->tpl->setCurrentBlock('enableprocessingtime');
        $this->tpl->setVariable(
            'USER_WORKING_TIME_MESSAGE_BOX',
            $this->ui_renderer->render(
                $working_time->getMessageBox($this->ui_factory, $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 1866 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 1972 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 2940 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 1016 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 667 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 2703 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 2499 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 2512 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 614 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 2263 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 2422 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 2365 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 ILIAS\News\Common\Table\$tpl, assQuestionGUI\getObject(), assQuestionGUI\getQuestionHeaderBlockBuilder(), assQuestionGUI\getSolutionOutput(), assQuestionGUI\outQuestionPage(), assQuestionGUI\setNavigationGUI(), and ILIAS\UICore\GlobalTemplate\setVariable().

Here is the call graph for this function:

populateLowerNextButtonBlock()

ilTestPlayerAbstractGUI::populateLowerNextButtonBlock (   $primary_next )

protected

Definition at line 504 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 522 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 2678 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 2691 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 498 of file class.ilTestPlayerAbstractGUI.php.

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

populateNextLocksChangedModal()

ilTestPlayerAbstractGUI::populateNextLocksChangedModal ( )

protected

Definition at line 2731 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 2717 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 492 of file class.ilTestPlayerAbstractGUI.php.

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

populateQuestionEditControl()

ilTestPlayerAbstractGUI::populateQuestionEditControl ( assQuestionGUI  $question_gui )

protected

Definition at line 2774 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 481 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 634 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 647 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 591 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 657 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 461 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 513 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 531 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 2099 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 1118 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 2081 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 834 of file class.ilTestPlayerAbstractGUI.php.

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

redirectAfterFinish()

ilTestPlayerAbstractGUI::redirectAfterFinish ( )

protected

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

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

redirectBackCmd()

ilTestPlayerAbstractGUI::redirectBackCmd

(

)

Definition at line 1074 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 2818 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 316 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 727 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 1530 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 394 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 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 2601 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 326 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 290 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 682 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 2586 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 2760 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 2227 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 1094 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 2008 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 1323 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()->getTitle());
        $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 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 1238 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 1194 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 1815 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('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 1574 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 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 697 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 1608 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 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 931 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 2884 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 1485 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 435 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 960 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 971 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 2846 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 2862 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 301 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 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 2758 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