ilTestPlayerAbstractGUI Class Reference

Output class for assessment test execution. More...

Inheritance diagram for ilTestPlayerAbstractGUI:

Collaboration diagram for ilTestPlayerAbstractGUI:

Public Member Functions
	__construct ($a_object)
	ilTestOutputGUI constructor 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 ()
	remove an auto-saved solution of the current question More...
	saveQuestionSolution ($authorized=true, $force=false)
	saves the user input of a question More...
	suspendTestCmd ()
	isMaxProcessingTimeReached ()
	Checks wheather the maximum processing time is reached or not. More...
	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 ()
	autosaveCmd ()
	toggleSideListCmd ()
	Toggle side list. More...
	finishTestCmd ($requires_confirmation=true)
	redirectBackCmd ()
	showFinalStatementCmd ()
	getKioskHead ()
	checkOnlineTestAccess ()
	check access restrictions like client ip, partipating user etc. More...
	isTestAccessible ()
	test accessible returns true if the user can perform the test More...
	isNrOfTriesReached ()
	nr of tries exceeded More...
	maxProcessingTimeReached ()
	Outputs a message when the maximum processing time is reached. More...
	confirmSubmitAnswers ()
	confirm submit results if confirm then results are submitted and the screen will be redirected to the startpage of the test @access public More...
	outProcessingTime ($active_id)
	outQuestionSummaryCmd ($fullpage=true, $contextFinishTest=false, $obligationsNotAnswered=false, $obligationsFilter=false)
	Output of a summary of all test questions for test participants. More...
	outQuestionSummaryWithObligationsInfoCmd ()
	outObligationsOnlySummaryCmd ()
	showMaximumAllowedUsersReachedMessage ()
	backFromFinishingCmd ()
	outCorrectSolution ()
	Creates an output of the solution of an answer compared to the correct solution. More...
	showListOfAnswers ($active_id, $pass=NULL, $top_data="", $bottom_data="")
	Creates an output of the list of answers for a test participant during the test (only the actual pass will be shown) More...
	getContentBlockName ()
	Returns the name of the current content block (depends on the kiosk mode setting) More...
	outUserResultsOverviewCmd ()
Public Member Functions inherited from ilTestServiceGUI
	isContextResultPresentation ()
	setContextResultPresentation ($contextResultPresentation)
	__construct (ilObjTest $a_object)
	The constructor takes the test object reference as parameter. More...
	setParticipantData ($participantData)
	getParticipantData ()
	getPassOverviewTableData (ilTestSession $testSession, $passes, $withResults)
	setObjectiveOrientedContainer (ilTestObjectiveOrientedContainer $objectiveOrientedContainer)
	getObjectiveOrientedContainer ()
	executeCommand ()
	execute command More...
	getCommand ($cmd)
	Retrieves the ilCtrl command. More...
	buildPassOverviewTableGUI ($targetGUI, $targetCmd='')
	getPassListOfAnswers (&$result_array, $active_id, $pass, $show_solutions=FALSE, $only_answered_questions=FALSE, $show_question_only=FALSE, $show_reached_points=FALSE, $anchorNav=false, ilTestQuestionRelatedObjectivesList $objectivesList=null, ilTestResultHeaderLabelBuilder $testResultHeaderLabelBuilder=null)
	Returns the list of answers of a users test pass. More...
	getPassListOfAnswersWithScoring (&$result_array, $active_id, $pass, $show_solutions=FALSE)
	Returns the list of answers of a users test pass and offers a scoring option. More...
	getResultsSignature ()
	Returns HTML code for a signature field. More...
	getAdditionalUsrDataHtmlAndPopulateWindowTitle ($testSession, $active_id, $overwrite_anonymity=FALSE)
	Returns the user data for a test results output. More...
	getCorrectSolutionOutput ($question_id, $active_id, $pass, ilTestQuestionRelatedObjectivesList $objectivesList=null)
	Returns an output of the solution to an answer compared to the correct solution. More...
	getResultsOfUserOutput ($testSession, $active_id, $pass, $targetGUI, $show_pass_details=TRUE, $show_answers=TRUE, $show_question_only=FALSE, $show_reached_points=FALSE)
	Output of the pass overview for a test called by a test participant. More...
	getResultsHeadUserAndPass ($active_id, $pass)
	Returns the user and pass data for a test results output. More...
	getQuestionResultForTestUsers ($question_id, $test_id)
	Creates a HTML representation for the results of a given question in a test. More...
	populatePassFinishDate ($tpl, $passFinishDate)

Data Fields
const	PRESENTATION_MODE_VIEW = 'view'
const	PRESENTATION_MODE_EDIT = 'edit'
const	FIXED_SHUFFLER_SEED_MIN_LENGTH = 8
	$ref_id
	$saveResult
	$sequence
	$cmdCtrl
	$maxProcessingTimeReached
	$endingTimeReached
Data Fields inherited from ilTestServiceGUI
	$object = null
	$service = null
	$lng
	$tpl
	$ctrl
	$ilias
	$tree
	$ref_id

Protected Member Functions
	checkReadAccess ()
	checkTestExecutable ()
	checkTestSessionUser (ilTestSession $testSession)
	ensureExistingTestSession (ilTestSession $testSession)
	initProcessLocker ($activeId)
	canSaveResult ()
	determineInlineScoreDisplay ()
	populateTestNavigationToolbar (ilTestNavigationToolbarGUI $toolbarGUI)
	populateQuestionNavigation ($sequenceElement, $disabled, $primaryNext)
	populatePreviousButtons ($disabled)
	populateNextButtons ($disabled, $primaryNext)
	populateLowerNextButtonBlock ($disabled, $primaryNext)
	populateUpperNextButtonBlock ($disabled, $primaryNext)
	populateLowerPreviousButtonBlock ($disabled)
	populateUpperPreviousButtonBlock ($disabled)
	populateSpecificFeedbackBlock ($question_gui)
	populateGenericFeedbackBlock (assQuestionGUI $question_gui, $solutionCorrect)
	populateScoreBlock ($reachedPoints, $maxPoints)
	populateSolutionBlock ($solutionoutput)
	populateSyntaxStyleBlock ()
	populateContentStyleBlock ()
	startPlayerCmd ()
	Start a test for the first time. More...
	resumePlayerCmd ()
	Resume a test at the last position. More...
	initTestCmd ()
	Start a test for the first time after a redirect. More...
	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...
	confirmFinishCmd ()
	The final submission of a test was confirmed. More...
	performTestPassFinishedTasks ($finishedPass)
	afterTestPassFinishedCmd ()
	isTestSignRedirectRequired ($activeId, $lastFinishedPass)
	archiveParticipantSubmission ( $active, $pass)
	backToInfoScreenCmd ()
	prepareTestPage ($presentationMode, $sequenceElement, $questionId)
	isOptionalQuestionAnsweringConfirmationRequired ($sequenceElement)
	isShowingPostponeStatusReguired ($questionId)
	showQuestionViewable (assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)
	showQuestionEditable (assQuestionGUI $questionGui, $formAction, $isQuestionWorkedThrough, $instantResponse)
	determineSolutionPassIndex (assQuestionGUI $questionGui)
	showQuestionCmd ()
	editSolutionCmd ()
	submitSolutionCmd ()
	revertChangesCmd ()
	discardSolutionCmd ()
	skipQuestionCmd ()
	startTestCmd ()
	showSideList ($presentationMode, $currentSequenceElement)
	isQuestionSummaryFinishTestButtonRequired ()
	showRequestedHintListCmd ()
	Go to requested hint list. More...
	confirmHintRequestCmd ()
	Go to hint request confirmation. More...
	isFirstQuestionInSequence ($sequenceElement)
	isLastQuestionInSequence ($sequenceElement)
	handleQuestionActionCmd ()
	showInstantResponseCmd ()
	nextQuestionCmd ()
	previousQuestionCmd ()
	prepareSummaryPage ()
	initTestPageTemplate ()
	populateKioskHead ()
	handlePasswordProtectionRedirect ()
	isParticipantsAnswerFixed ($questionId)
	getIntroductionPageButtonLabel ()
	initAssessmentSettings ()
	handleSkillTriggering (ilTestSession $testSession)
	buildTestPassQuestionList ()
	showAnswerOptionalQuestionsConfirmation ()
	confirmAnswerOptionalQuestionsCmd ()
	cancelAnswerOptionalQuestionsCmd ()
	populateHelperGuiContent ($helperGui)
	populateCharSelectorIfRequired ()
	getTestNavigationToolbarGUI ()
	buildReadOnlyStateQuestionNavigationGUI ($questionId)
	buildEditableStateQuestionNavigationGUI ($questionId, $charSelectorAvailable)
	getFinishTestCommand ()
	populateInstantResponseModal (assQuestionGUI $questionGui, $navUrl)
	populateInstantResponseBlocks (assQuestionGUI $questionGui, $authorizedSolution)
	getCurrentSequenceElement ()
	resetSequenceElementParameter ()
	getSequenceElementParameter ()
	getPresentationModeParameter ()
	getInstantResponseParameter ()
	getNextCommandParameter ()
	getNextSequenceParameter ()
	getNavigationUrlParameter ()
	getAnswerChangedParameter ()
	Get the 'answer changed' status from the current request It may be set by ilTestPlayerNavigationControl.js or by a previousRequest. More...
	setAnswerChangedParameter ($changed=true)
	Set the 'answer changed' url parameter for generated links. More...
	handleIntermediateSubmit ()
	Check the 'answer changed' parameter when a question form is intermediately submitted. More...
	saveNavigationPreventConfirmation ()
	Save the save the switch to prevent the navigation confirmation. More...
	getQuestionGuiInstance ($questionId, $fromCache=true)
	getQuestionInstance ($questionId, $fromCache=true)
	initTestQuestionConfig (assQuestion $questionOBJ)
	buildQuestionAnswerShuffler ($questionId)
	handleTearsAndAngerQuestionIsNull ($questionId, $sequenceElement)
	populateMessageContent ($contentHTML)
	populateModals ()
	populateDiscardSolutionModal ()
	populateNavWhenChangedModal ()
	getQuestionsDefaultPresentationMode ($isQuestionWorkedThrough)
	buildFixedShufflerSeed ($questionId)
	registerForcedFeedbackNavUrl ($forcedFeedbackNavUrl)
	getRegisteredForcedFeedbackNavUrl ()
	isForcedFeedbackNavUrlRegistered ()
	unregisterForcedFeedbackNavUrl ()
Protected Member Functions inherited from ilTestServiceGUI
	handleTabs ($activeTabId)
	isPdfDeliveryRequest ()
	getPassDetailsOverviewTableGUI ($result_array, $active_id, $pass, $targetGUI, $targetCMD, $questionDetailsCMD, $questionAnchorNav, ilTestQuestionRelatedObjectivesList $objectivesList=null, $multipleObjectivesInvolved=true)
	buildPassDetailsOverviewTableGUI ($targetGUI, $targetCMD)
	isGradingMessageRequired ()
	getGradingMessageBuilder ($activeId)
	buildQuestionRelatedObjectivesList (ilLOTestQuestionAdapter $objectivesAdapter, ilTestQuestionSequence $testSequence)
	getFilteredTestResult ($active_id, $pass, $considerHiddenQuestions, $considerOptionalQuestions)
	populateContent ($content)
	buildUserTestResultsToolbarGUI ()
	outCorrectSolutionCmd ()
	outCorrectSolution ()
	Creates an output of the solution of an answer compared to the correct solution. More...

Protected Attributes
	$passwordChecker
	$processLocker
	$testSession
	$assSettings
	$testSequence = null
Protected Attributes inherited from ilTestServiceGUI
	$db
	$tabs
	$objCache
	$testSessionFactory = null
	$testSequenceFactory = null
	$participantData

Private Member Functions
	buildNextButtonInstance ($disabled, $primaryNext)
	buildPreviousButtonInstance ($disabled)
	endingTimeReached ()
	handle endingTimeReached More...

Private Attributes
	$cachedQuestionGuis = array()
	$cachedQuestionObjects = array()

Detailed Description

Output class for assessment test execution.

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

Author

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

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

Version

$Id$

@inGroup ModulesTest

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

Constructor & Destructor Documentation

__construct()

ilTestPlayerAbstractGUI::__construct

(

$a_object

)

ilTestOutputGUI constructor

Parameters

ilObjTest

$a_object

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

        {
                parent::__construct($a_object);
                $this->ref_id = $_GET["ref_id"];
                
                global $rbacsystem, $ilUser, $lng;
                require_once 'Modules/Test/classes/class.ilTestPasswordChecker.php';
                $this->passwordChecker = new ilTestPasswordChecker($rbacsystem, $ilUser, $this->object, $lng);
                
                $this->processLocker = null;
                $this->testSession = null;
                $this->assSettings = null;
        }

References $_GET, $ilUser, and ilTestServiceGUI\$lng.

Member Function Documentation

accessCodeConfirmedCmd()

ilTestPlayerAbstractGUI::accessCodeConfirmedCmd

(

)

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

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

References ilTestPlayerCommands\START_TEST.

afterTestPassFinishedCmd()

ilTestPlayerAbstractGUI::afterTestPassFinishedCmd ( )

protected

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

        {
                $activeId = $this->testSession->getActiveId();
                $lastFinishedPass = $this->testSession->getLastFinishedPass();
 
                // handle test signature
                if ( $this->isTestSignRedirectRequired($activeId, $lastFinishedPass) )
                {
                        $this->ctrl->redirectByClass('ilTestSignatureGUI', 'invokeSignaturePlugin');
                }
 
                // show final statement
                if(!$_GET['skipfinalstatement'])
                {
                        if ($this->object->getShowFinalStatement())
                        {
                                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_FINAL_STATMENT);
                        }
                }
 
                // redirect after test
                $redirection_mode = $this->object->getRedirectionMode();
                $redirection_url  = $this->object->getRedirectionUrl();
                if( $redirection_url && $redirection_mode && !$this->object->canViewResults() )
                {
                        if( $redirection_mode == REDIRECT_KIOSK )
                        {
                                if( $this->object->getKioskMode() )
                                {
                                        ilUtil::redirect($redirection_url);
                                }
                        }
                        else
                        {
                                ilUtil::redirect($redirection_url);
                        }
                }
 
                // default redirect (pass overview when enabled, otherwise infoscreen)
                $this->redirectBackCmd();
        }

References $_GET, isTestSignRedirectRequired(), ilUtil\redirect(), REDIRECT_KIOSK, redirectBackCmd(), and ilTestPlayerCommands\SHOW_FINAL_STATMENT.

Here is the call graph for this function:

archiveParticipantSubmission()

ilTestPlayerAbstractGUI::archiveParticipantSubmission (   $active,   $pass  )

protected

Parameters

$active

Returns

void

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

        {
                global $ilObjDataCache;
 
                require_once 'Modules/Test/classes/class.ilTestResultHeaderLabelBuilder.php';
                $testResultHeaderLabelBuilder = new ilTestResultHeaderLabelBuilder($this->lng, $ilObjDataCache);
 
                $objectivesList = null;
 
                if( $this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired() )
                {
                        $testSequence = $this->testSequenceFactory->getSequenceByActiveIdAndPass($this->testSession->getActiveId(), $this->testSession->getPass());
                        $testSequence->loadFromDb();
                        $testSequence->loadQuestions();
 
                        require_once 'Modules/Course/classes/Objectives/class.ilLOTestQuestionAdapter.php';
                        $objectivesAdapter = ilLOTestQuestionAdapter::getInstance($this->testSession);
 
                        $objectivesList = $this->buildQuestionRelatedObjectivesList($objectivesAdapter, $testSequence);
                        $objectivesList->loadObjectivesTitles();
 
                        $testResultHeaderLabelBuilder->setObjectiveOrientedContainerId($this->testSession->getObjectiveOrientedContainerId());
                        $testResultHeaderLabelBuilder->setUserId($this->testSession->getUserId());
                        $testResultHeaderLabelBuilder->setTestObjId($this->object->getId());
                        $testResultHeaderLabelBuilder->setTestRefId($this->object->getRefId());
                        $testResultHeaderLabelBuilder->initObjectiveOrientedMode();
                }
 
                $results = $this->object->getTestResult(
                        $active, $pass, false, !$this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
                );
 
                require_once 'class.ilTestEvaluationGUI.php';
                $testevaluationgui = new ilTestEvaluationGUI($this->object);
                $results_output = $testevaluationgui->getPassListOfAnswers(
                        $results, $active, $pass, false, false, false, false, false, $objectivesList, $testResultHeaderLabelBuilder
                );
 
                require_once './Modules/Test/classes/class.ilTestArchiver.php';
                global $ilSetting;
                $inst_id = $ilSetting->get('inst_id', null);
                $archiver = new ilTestArchiver($this->object->getId());
 
                $path =  ilUtil::getWebspaceDir() . '/assessment/'. $this->object->getId() . '/exam_pdf';
                if (!is_dir($path))
                {
                        ilUtil::makeDirParents($path);
                }
                $filename = realpath($path) . '/exam_N' . $inst_id . '-' . $this->object->getId()
                                        . '-' . $active . '-' . $pass . '.pdf';
 
                require_once 'class.ilTestPDFGenerator.php';
                ilTestPDFGenerator::generatePDF($results_output, ilTestPDFGenerator::PDF_OUTPUT_FILE, $filename);
                //$template->setVariable("PDF_FILE_LOCATION", $filename);
                // Participant submission
                $archiver->handInParticipantSubmission( $active, $pass, $filename, $results_output );
                //$archiver->handInParticipantMisc( $active, $pass, 'signature_gedoens.sig', $filename );
                //$archiver->handInParticipantQuestionMaterial( $active, $pass, 123, 'file_upload.pdf', $filename );
 
                global $ilias;
                $questions = $this->object->getQuestions();
                foreach ($questions as $question_id)
                {
                        $question_object = $this->object->getQuestionDataset( $question_id );
                        if ($question_object->type_tag == 'assFileUpload')
                        {
                                // Pfad: /data/default/assessment/tst_2/14/21/files/file_14_4_1370417414.png
                                // /data/ - klar
                                // /assessment/ - Konvention
                                // /tst_2/ = /tst_<test_id> (ilObjTest)
                                // /14/ = /<active_fi>/
                                // /21/ = /<question_id>/ (question_object)
                                // /files/ - Konvention
                                // file_14_4_1370417414.png = file_<active_fi>_<pass>_<some timestamp>.<ext>
 
                                $candidate_path =
                                        $ilias->ini_ilias->readVariable( 'server', 'absolute_path' ) . ilTestArchiver::DIR_SEP
                                                . $ilias->ini_ilias->readVariable( 'clients', 'path' ) . ilTestArchiver::DIR_SEP
                                                . $ilias->client_id . ilTestArchiver::DIR_SEP
                                                . 'assessment' . ilTestArchiver::DIR_SEP
                                                . 'tst_' . $this->object->test_id . ilTestArchiver::DIR_SEP
                                                . $active . ilTestArchiver::DIR_SEP
                                                . $question_id . ilTestArchiver::DIR_SEP
                                                . 'files' . ilTestArchiver::DIR_SEP;
                                $handle = opendir( $candidate_path );
                                while ($handle !== false && ($file = readdir( $handle )) !== false)
                                {
                                        if ($file != null)
                                        {
                                                $filename_start = 'file_' . $active . '_' . $pass . '_';
 
                                                if (strpos( $file, $filename_start ) === 0)
                                                {
                                                        $archiver->handInParticipantQuestionMaterial( $active, $pass, $question_id, $file, $file );
                                                }
                                        }
                                }
                        }
                }
                $passdata = $this->object->getTestResult(
                        $active, $pass, false, !$this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
                );
                $overview = $testevaluationgui->getPassListOfAnswers(
                        $passdata, $active, $pass, true, false, false, true, false, $objectivesList, $testResultHeaderLabelBuilder
                );
                $filename = realpath(ilUtil::getWebspaceDir()) . '/assessment/scores-'.$this->object->getId() . '-' . $active . '-' . $pass . '.pdf';
                ilTestPDFGenerator::generatePDF($overview, ilTestPDFGenerator::PDF_OUTPUT_FILE, $filename);
                $archiver->handInTestResult($active, $pass, $filename);
                unlink($filename);
                
                return;
        }

References $file, $filename, ilTestServiceGUI\$ilias, $ilSetting, $pass, $path, $results, $testSequence, ilTestServiceGUI\buildQuestionRelatedObjectivesList(), ilTestArchiver\DIR_SEP, ilTestPDFGenerator\generatePDF(), ilLOTestQuestionAdapter\getInstance(), ilTestServiceGUI\getObjectiveOrientedContainer(), ilUtil\getWebspaceDir(), ilUtil\makeDirParents(), and ilTestPDFGenerator\PDF_OUTPUT_FILE.

Here is the call graph for this function:

autosaveCmd()

ilTestPlayerAbstractGUI::autosaveCmd

(

)

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

        {
                $canSaveResult = $this->canSaveResult();
                $authorizedSolution = !$canSaveResult;
                
                $result = "";
                if (is_array($_POST) && count($_POST) > 0)
                {
                        if( $this->isParticipantsAnswerFixed($this->getCurrentQuestionId()) )
                        {
                                $result = '-IGNORE-';
                        }
                        else
                        {
// fau: testNav - delete intermediate solution if answer is unchanged
                                // answer is changed, so save the change as intermediate solution
                                if ($this->getAnswerChangedParameter())
                                {
                                $res = $this->saveQuestionSolution($authorizedSolution, true);
                                }
                                // answer is not changed, so delete an intermediate solution
                                else
                                {
                                        $db_res = $this->removeIntermediateSolution();
                                        $res = is_int($db_res);
                                }
// fau.
                                if ($res)
                                {
                                        $result = $this->lng->txt("autosave_success");
                                }
                                else
                                {
                                        $result = $this->lng->txt("autosave_failed");
                                }
                        }
                }
// fau: testNav - simplify the redirection if time is reached
                if (!$canSaveResult && !$this->ctrl->isAsynch())
                {
                        // this was the last action in the test, saving is no longer allowed
                        // form was directly submitted in saveOnTimeReached()
                        // instead of ajax with autoSave()
                        $this->ctrl->redirect($this, ilTestPlayerCommands::REDIRECT_ON_TIME_LIMIT);
                }
// fau.
                echo $result;
                exit;
        }

References $_POST, $res, $result, canSaveResult(), exit, getAnswerChangedParameter(), getCurrentQuestionId(), isParticipantsAnswerFixed(), ilTestPlayerCommands\REDIRECT_ON_TIME_LIMIT, removeIntermediateSolution(), and saveQuestionSolution().

Here is the call graph for this function:

backFromFinishingCmd()

ilTestPlayerAbstractGUI::backFromFinishingCmd

(

)

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

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

References ilTestPlayerCommands\SHOW_QUESTION.

backToInfoScreenCmd()

ilTestPlayerAbstractGUI::backToInfoScreenCmd ( )

protected

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

        {
                $this->ctrl->redirectByClass('ilObjTestGUI', 'redirectToInfoScreen');
        }

Referenced by ilTestOutputGUI\handleTearsAndAngerNoObjectiveOrientedQuestion(), and redirectBackCmd().

Here is the caller graph for this function:

buildEditableStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildEditableStateQuestionNavigationGUI (   $questionId,   $charSelectorAvailable  )

protected

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

        {
                require_once 'Modules/Test/classes/class.ilTestQuestionNavigationGUI.php';
                $navigationGUI = new ilTestQuestionNavigationGUI($this->lng);
                
                if( $this->object->isForceInstantFeedbackEnabled() )
                {
                        $navigationGUI->setSubmitSolutionCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
                }
                else
                {
// fau: testNav - use simple "submitSolution" button instead of "submitSolutionAndNext"
                        $navigationGUI->setSubmitSolutionCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
// fau.
                }
                
// fau: testNav - add a 'revert changes' link for editable question
                $navigationGUI->setRevertChangesLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::REVERT_CHANGES));
// fau.
 
 
                // feedback
                switch( 1 )
                {
                        case $this->object->getSpecificAnswerFeedback():
                        case $this->object->getGenericAnswerFeedback():
                        case $this->object->getAnswerFeedbackPoints():
                        case $this->object->getInstantFeedbackSolution():
 
                                $navigationGUI->setAnswerFreezingEnabled($this->object->isInstantFeedbackAnswerFixationEnabled());
                                
                                if( $this->object->isForceInstantFeedbackEnabled() )
                                {
                                        $navigationGUI->setForceInstantResponseEnabled(true);
                                        $navigationGUI->setInstantFeedbackCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
                                }
                                else
                                {
                                        $navigationGUI->setInstantFeedbackCommand(ilTestPlayerCommands::SHOW_INSTANT_RESPONSE);
                                }
                }
 
                // hints
                if( $this->object->isOfferingQuestionHintsEnabled() )
                {
                        $activeId = $this->testSession->getActiveId();
                        $pass = $this->testSession->getPass();
 
                        require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintTracking.php';
                        $questionHintTracking = new ilAssQuestionHintTracking($questionId, $activeId, $pass);
 
                        if( $questionHintTracking->requestsPossible() )
                        {
                                $navigationGUI->setRequestHintCommand(ilTestPlayerCommands::CONFIRM_HINT_REQUEST);
                        }
 
                        if( $questionHintTracking->requestsExist() )
                        {
                                $navigationGUI->setShowHintsCommand(ilTestPlayerCommands::SHOW_REQUESTED_HINTS_LIST);
                        }
                }
 
                $navigationGUI->setCharSelectorEnabled($charSelectorAvailable);
 
                if($this->object->getShowMarker())
                {
                        include_once "./Modules/Test/classes/class.ilObjTest.php";
                        $solved_array = ilObjTest::_getSolvedQuestions($this->testSession->getActiveId(), $questionId);
                        $solved = 0;
 
                        if(count($solved_array) > 0)
                        {
                                $solved = array_pop($solved_array);
                                $solved = $solved["solved"];
                        }
 
// fau: testNav - change question mark command to link target
                        if($solved == 1)
                        {
                                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::UNMARK_QUESTION_SAVE));
                                $navigationGUI->setQuestionMarked(true);
                        }
                        else
                        {
                                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::MARK_QUESTION_SAVE));
                                $navigationGUI->setQuestionMarked(false);
                        }
                }
// fau.
                return $navigationGUI;
        }

References $pass, ilObjTest\_getSolvedQuestions(), ilTestPlayerCommands\CONFIRM_HINT_REQUEST, ilTestPlayerCommands\MARK_QUESTION_SAVE, ilTestPlayerCommands\REVERT_CHANGES, ilTestPlayerCommands\SHOW_INSTANT_RESPONSE, ilTestPlayerCommands\SHOW_REQUESTED_HINTS_LIST, ilTestPlayerCommands\SUBMIT_SOLUTION, and ilTestPlayerCommands\UNMARK_QUESTION_SAVE.

Referenced by showQuestionEditable().

Here is the call graph for this function:

Here is the caller graph for this function:

buildFixedShufflerSeed()

ilTestPlayerAbstractGUI::buildFixedShufflerSeed (   $questionId )

protected

Parameters

$questionId

Returns

string

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

        {
                $fixedSeed = $questionId . $this->testSession->getActiveId() . $this->testSession->getPass();
                
                if( strlen($fixedSeed < ilTestPlayerAbstractGUI::FIXED_SHUFFLER_SEED_MIN_LENGTH) )
                {
                        $fixedSeed *= (
                                10 * (ilTestPlayerAbstractGUI::FIXED_SHUFFLER_SEED_MIN_LENGTH - strlen($fixedSeed))
                        );
                }
                
                return $fixedSeed;
        }

References FIXED_SHUFFLER_SEED_MIN_LENGTH.

Referenced by buildQuestionAnswerShuffler().

Here is the caller graph for this function:

buildNextButtonInstance()

ilTestPlayerAbstractGUI::buildNextButtonInstance (   $disabled,   $primaryNext  )

private

Parameters

bool	$disabled
bool	$primaryNext

Returns

ilButtonBase|ilLinkButton|ilTestPlayerNavButton

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

        {
                $button = ilTestPlayerNavButton::getInstance();
// fau: testNav - set glyphicon and primary
                $button->setPrimary($primaryNext);
                $button->setRightGlyph('glyphicon glyphicon-arrow-right');
// fau.
                $button->setNextCommand(ilTestPlayerCommands::NEXT_QUESTION);
                $button->setUrl($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::NEXT_QUESTION));
                $button->setCaption('next_question');
                $button->addCSSClass('ilTstNavElem');
                //$button->setDisabled($disabled);
                return $button;
        }

References ilTestPlayerNavButton\getInstance(), and ilTestPlayerCommands\NEXT_QUESTION.

Referenced by populateLowerNextButtonBlock(), and populateUpperNextButtonBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

buildPreviousButtonInstance()

ilTestPlayerAbstractGUI::buildPreviousButtonInstance (   $disabled )

private

Parameters

$disabled

Returns

ilTestPlayerNavButton

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

        {
                $button = ilTestPlayerNavButton::getInstance();
// fau: testNav - set glyphicon and primary
                $button->setLeftGlyph('glyphicon glyphicon-arrow-left');
// fau.
                $button->setNextCommand(ilTestPlayerCommands::PREVIOUS_QUESTION);
                $button->setUrl($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::PREVIOUS_QUESTION));
                $button->setCaption('previous_question');
                $button->addCSSClass('ilTstNavElem');
                //$button->setDisabled($disabled);
                return $button;
        }

References ilTestPlayerNavButton\getInstance(), and ilTestPlayerCommands\PREVIOUS_QUESTION.

Referenced by populateLowerPreviousButtonBlock(), and populateUpperPreviousButtonBlock().

Here is the call graph for this function:

Here is the caller graph for this function:

buildQuestionAnswerShuffler()

ilTestPlayerAbstractGUI::buildQuestionAnswerShuffler (   $questionId )

protected

Parameters

$questionId

Returns

ilArrayElementShuffler

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

        {
                require_once 'Services/Randomization/classes/class.ilArrayElementShuffler.php';
                $shuffler = new ilArrayElementShuffler();
                
                $fixedSeed = $this->buildFixedShufflerSeed($questionId);
                $shuffler->setSeed($fixedSeed);
                
                return $shuffler;
        }

References buildFixedShufflerSeed().

Referenced by getQuestionGuiInstance().

Here is the call graph for this function:

Here is the caller graph for this function:

buildReadOnlyStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildReadOnlyStateQuestionNavigationGUI (   $questionId )

protected

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

        {
                require_once 'Modules/Test/classes/class.ilTestQuestionNavigationGUI.php';
                $navigationGUI = new ilTestQuestionNavigationGUI($this->lng);
                
                if( !$this->isParticipantsAnswerFixed($questionId) )
                {
                        $navigationGUI->setEditSolutionCommand(ilTestPlayerCommands::EDIT_SOLUTION);
                }
 
                if($this->object->getShowMarker())
                {
                        include_once "./Modules/Test/classes/class.ilObjTest.php";
                        $solved_array = ilObjTest::_getSolvedQuestions($this->testSession->getActiveId(), $questionId);
                        $solved = 0;
 
                        if(count($solved_array) > 0)
                        {
                                $solved = array_pop($solved_array);
                                $solved = $solved["solved"];
                        }
// fau: testNav - change question mark command to link target
                        if($solved == 1)
                        {
                                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::UNMARK_QUESTION));
                                $navigationGUI->setQuestionMarked(true);
                        }
                        else
                        {
                                $navigationGUI->setQuestionMarkLinkTarget($this->ctrl->getLinkTarget($this, ilTestPlayerCommands::MARK_QUESTION));
                                $navigationGUI->setQuestionMarked(false);
                        }
                }
// fau.
 
                return $navigationGUI;
        }

References ilObjTest\_getSolvedQuestions(), ilTestPlayerCommands\EDIT_SOLUTION, isParticipantsAnswerFixed(), ilTestPlayerCommands\MARK_QUESTION, and ilTestPlayerCommands\UNMARK_QUESTION.

Referenced by showQuestionViewable().

Here is the call graph for this function:

Here is the caller graph for this function:

buildTestPassQuestionList()

ilTestPlayerAbstractGUI::buildTestPassQuestionList ( )

abstractprotected

Reimplemented in ilTestPlayerDynamicQuestionSetGUI, ilTestPlayerFixedQuestionSetGUI, and ilTestPlayerRandomQuestionSetGUI.

Referenced by handleSkillTriggering().

Here is the caller graph for this function:

cancelAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::cancelAnswerOptionalQuestionsCmd ( )

protected

Definition at line 1968 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');
        }

canSaveResult()

ilTestPlayerAbstractGUI::canSaveResult ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

Referenced by autosaveCmd().

Here is the caller graph for this function:

checkOnlineTestAccess()

ilTestPlayerAbstractGUI::checkOnlineTestAccess

(

)

check access restrictions like client ip, partipating user etc.

check access restrictions like client ip, partipating user etc.

@access public

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

        {
                global $ilUser;
                
                // check if user is invited to participate
                $user = $this->object->getInvitedUsers($ilUser->getId());
                if (!is_array ($user) || count($user)!=1)
                {
                                ilUtil::sendInfo($this->lng->txt("user_not_invited"), true);
                                $this->ctrl->redirectByClass("ilobjtestgui", "backToRepository");
                }
                        
                $user = array_pop($user);
                // check if client ip is set and if current remote addr is equal to stored client-ip                    
                if (strcmp($user["clientip"],"")!=0 && strcmp($user["clientip"],$_SERVER["REMOTE_ADDR"])!=0)
                {
                        ilUtil::sendInfo($this->lng->txt("user_wrong_clientip"), true);
                        $this->ctrl->redirectByClass("ilobjtestgui", "backToRepository");
                }               
        }       

References $_SERVER, $ilUser, and ilUtil\sendInfo().

Here is the call graph for this function:

checkReadAccess()

ilTestPlayerAbstractGUI::checkReadAccess ( )

protected

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

        {
                global $rbacsystem;
 
                if(!$rbacsystem->checkAccess("read", $this->object->getRefId()))
                {
                        // only with read access it is possible to run the test
                        $this->ilias->raiseError($this->lng->txt("cannot_execute_test"), $this->ilias->error_obj->MESSAGE);
                }
        }

Referenced by ilTestOutputGUI\executeCommand().

Here is the caller graph for this function:

checkTestExecutable()

ilTestPlayerAbstractGUI::checkTestExecutable ( )

protected

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

        {
                $executable = $this->object->isExecutable($this->testSession, $this->testSession->getUserId());
                
                if( !$executable['executable'] )
                {
                        ilUtil::sendInfo($executable['errormessage'], true);
                        $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
                }
        }

References ilUtil\sendInfo().

Referenced by ilTestOutputGUI\executeCommand().

Here is the call graph for this function:

Here is the caller graph for this function:

checkTestSessionUser()

ilTestPlayerAbstractGUI::checkTestSessionUser ( ilTestSession  $testSession )

protected

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

        {
                global $DIC; /* @var ILIAS\DI\Container $DIC */
                
                if( $testSession->getUserId() != $DIC->user()->getId() )
                {
                        throw new ilTestException('active id given does not relate to current user!');
                }
        }

References $DIC, and $testSession.

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

Here is the caller graph for this function:

confirmAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::confirmAnswerOptionalQuestionsCmd ( )

protected

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

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

confirmFinishCmd()

ilTestPlayerAbstractGUI::confirmFinishCmd ( )

protected

The final submission of a test was confirmed.

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

        {
                $this->finishTestCmd(false);
        }

References finishTestCmd().

Here is the call graph for this function:

confirmHintRequestCmd()

ilTestPlayerAbstractGUI::confirmHintRequestCmd ( )

protected

Go to hint request confirmation.

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

        {
// fau: testNav - handle intermediate submit for confirming hint requests
                $this->handleIntermediateSubmit();
// fau.
 
                $this->ctrl->setParameter($this, 'pmode', self::PRESENTATION_MODE_EDIT);
 
                require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintRequestGUI.php';
                $this->ctrl->redirectByClass('ilAssQuestionHintRequestGUI', ilAssQuestionHintRequestGUI::CMD_CONFIRM_REQUEST);
        }

References ilAssQuestionHintRequestGUI\CMD_CONFIRM_REQUEST, and handleIntermediateSubmit().

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

        {
                $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_submit_answers_confirm.html", "Modules/Test");
                $this->tpl->setCurrentBlock("adm_content");
                if ($this->object->isTestFinished($this->testSession->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 getContentBlockName().

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

        {
                $questionId = $this->getCurrentQuestionId();
                $state = $this->getQuestionInstance($questionId)->lookupForExistingSolutions(
                        $this->testSession->getActiveId(),
                        $this->testSession->getPass()
                );
                $result = array();
                $result['isAnswered'] = $state['authorized'];
                $result['isAnswerChanged'] = $state['intermediate'];
 
                echo json_encode($result);
                exit;
        }

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

Here is the call graph for this function:

determineInlineScoreDisplay()

ilTestPlayerAbstractGUI::determineInlineScoreDisplay ( )

protected

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

        {
                $show_question_inline_score = FALSE;
                if ($this->object->getAnswerFeedbackPoints())
                {
                        $show_question_inline_score = TRUE;
                        return $show_question_inline_score;
                }
                return $show_question_inline_score;
        }

Referenced by populateInstantResponseBlocks().

Here is the caller graph for this function:

determineSolutionPassIndex()

ilTestPlayerAbstractGUI::determineSolutionPassIndex ( assQuestionGUI  $questionGui )

protected

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

        {
                require_once './Modules/Test/classes/class.ilObjTest.php';
                
                if( ilObjTest::_getUsePreviousAnswers($this->testSession->getActiveId(), true) )
                {
                        $currentSolutionAvailable = $questionGui->object->authorizedOrIntermediateSolutionExists(
                                $this->testSession->getActiveId(), $this->testSession->getPass()
                        );
                        
                        if( !$currentSolutionAvailable )
                        {
                                $previousPass = $questionGui->object->getSolutionMaxPass(
                                        $this->testSession->getActiveId()
                                );
                                
                                $previousSolutionAvailable = $questionGui->object->authorizedSolutionExists(
                                        $this->testSession->getActiveId(), $previousPass
                                );
                                
                                if( $previousSolutionAvailable )
                                {
                                        return $previousPass;
                                }
                        }
                }
                
                return $this->testSession->getPass();
        }

References ilObjTest\_getUsePreviousAnswers().

Referenced by showQuestionEditable().

Here is the call graph for this function:

Here is the caller graph for this function:

discardSolutionCmd()

ilTestPlayerAbstractGUI::discardSolutionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

displayAccessCodeCmd()

ilTestPlayerAbstractGUI::displayAccessCodeCmd

(

)

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

        {
                $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_anonymous_code_presentation.html", "Modules/Test");
                $this->tpl->setCurrentBlock("adm_content");
                $this->tpl->setVariable("TEXT_ANONYMOUS_CODE_CREATED", $this->lng->txt("tst_access_code_created"));
                $this->tpl->setVariable("TEXT_ANONYMOUS_CODE", $this->testSession->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, and getContentBlockName().

Here is the call graph for this function:

editSolutionCmd()

ilTestPlayerAbstractGUI::editSolutionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

endingTimeReached()

ilTestPlayerAbstractGUI::endingTimeReached ( )

private

handle endingTimeReached

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

        {
                ilUtil::sendInfo(sprintf($this->lng->txt("detail_ending_time_reached"), ilDatePresentation::formatDate(new ilDateTime($this->object->getEndingTime(), IL_CAL_UNIX))));
                $this->testSession->increasePass();
                $this->testSession->setLastSequence(0);
                $this->testSession->saveToDb();
 
                $this->redirectBackCmd();
        }

References ilDatePresentation\formatDate(), IL_CAL_UNIX, redirectBackCmd(), ilUtil\sendInfo(), and sprintf.

Referenced by prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

ensureExistingTestSession()

ilTestPlayerAbstractGUI::ensureExistingTestSession ( ilTestSession  $testSession )

protected

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

        {
                if( $testSession->getActiveId() )
                {
                        return;
                }
 
                global $ilUser;
                
                $testSession->setUserId($ilUser->getId());
 
                if( $testSession->isAnonymousUser() )
                {
                        if( !$testSession->doesAccessCodeInSessionExists() )
                        {
                                return;
                        }
 
                        $testSession->setAnonymousId($testSession->getAccessCodeFromSession());
                }
                
                $testSession->saveToDb();
        }

References $ilUser, and $testSession.

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

Here is the caller graph for this function:

finishTestCmd()

ilTestPlayerAbstractGUI::finishTestCmd

(

$requires_confirmation = true

)

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

        {
                global $ilAuth;
 
                unset($_SESSION["tst_next"]);
 
                $active_id = $this->testSession->getActiveId();
                $actualpass = ilObjTest::_getPass($active_id);
 
                $allObligationsAnswered = ilObjTest::allObligationsAnswered($this->testSession->getTestId(), $active_id, $actualpass);
 
                /*
                 * The following "endgames" are possible prior to actually finishing the test:
                 * - Obligations (Ability to finish the test.)
                 *      If not all obligatory questions are answered, the user is presented a list
                 *      showing the deficits.
                 * - Examview (Will to finish the test.)
                 *      With the examview, the participant can review all answers given in ILIAS or a PDF prior to
                 *      commencing to the finished test.
                 * - Last pass allowed (Reassuring the will to finish the test.)
                 *      If passes are limited, on the last pass, an additional confirmation is to be displayed.
                 */
 
                
                if( $this->object->areObligationsEnabled() && !$allObligationsAnswered )
                {
                        if( $this->object->getListOfQuestions() )
                        {
                                $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY_INC_OBLIGATIONS);
                        }
                        else
                        {
                                $this->ctrl->redirect($this, ilTestPlayerCommands::QUESTION_SUMMARY_OBLIGATIONS_ONLY);
                        }
 
                        return;
                }
 
                // Examview enabled & !reviewed & requires_confirmation? test_submission_overview (review gui)
                if ($this->object->getEnableExamview() && !isset($_GET['reviewed']) && $requires_confirmation)
                {
                        $this->ctrl->redirectByClass('ilTestSubmissionReviewGUI', "show");
                        return;
                }
 
                // Last try in limited tries & !confirmed
                if (($requires_confirmation) && ($actualpass == $this->object->getNrOfTries() - 1))
                {
                        // show confirmation page
                        return $this->confirmFinishTestCmd();
                }
 
                // Last try in limited tries & confirmed?
                if(($actualpass == $this->object->getNrOfTries() - 1) && (!$requires_confirmation))
                {
                        // @todo: php7 ask mister test
                        #$ilAuth->setIdle(ilSession::getIdleValue(), false);
                        #$ilAuth->setExpire(0);
                        switch($this->object->getMailNotification())
                        {
                                case 1:
                                        $this->object->sendSimpleNotification($active_id);
                                        break;
                                case 2:
                                        $this->object->sendAdvancedNotification($active_id);
                                        break;
                        }
                }
 
                // Non-last try finish
                if(!$_SESSION['tst_pass_finish'])
                {
                        if(!$_SESSION['tst_pass_finish']) $_SESSION['tst_pass_finish'] = 1;
                        if($this->object->getMailNotificationType() == 1)
                        {
                                switch($this->object->getMailNotification())
                                {
                                        case 1:
                                                $this->object->sendSimpleNotification($active_id);
                                                break;
                                        case 2:
                                                $this->object->sendAdvancedNotification($active_id);
                                                break;
                                }
                        }
                }
                
                // no redirect request loops after test pass finished tasks has been performed
                
                $this->performTestPassFinishedTasks($actualpass);
 
                $this->ctrl->redirect($this, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED);
        }

References $_GET, $_SESSION, ilObjTest\_getPass(), ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, ilObjTest\allObligationsAnswered(), performTestPassFinishedTasks(), ilTestPlayerCommands\QUESTION_SUMMARY_INC_OBLIGATIONS, and ilTestPlayerCommands\QUESTION_SUMMARY_OBLIGATIONS_ONLY.

Referenced by confirmFinishCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

getAnswerChangedParameter()

ilTestPlayerAbstractGUI::getAnswerChangedParameter ( )

protected

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

Returns

bool

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

        {
                return !empty($_GET['test_answer_changed']);
        }

References $_GET.

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

Here is the caller graph for this function:

getContentBlockName()

ilTestPlayerAbstractGUI::getContentBlockName

(

)

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

Returns

string The name of the content block

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

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

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

Here is the caller graph for this function:

getCurrentQuestionId()

ilTestPlayerAbstractGUI::getCurrentQuestionId ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

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

Here is the caller graph for this function:

getCurrentSequenceElement()

ilTestPlayerAbstractGUI::getCurrentSequenceElement ( )

protected

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

        {
                if( $this->getSequenceElementParameter() )
                {
                        return $this->getSequenceElementParameter();
                }
 
                return $this->testSession->getLastSequence();
        }

References getSequenceElementParameter().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getFinishTestCommand()

ilTestPlayerAbstractGUI::getFinishTestCommand ( )

protected

Returns

string

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

        {
                if( !$this->object->getListOfQuestionsEnd() )
                {
                        return 'finishTest';
                }
                
                if( $this->object->areObligationsEnabled() )
                {
                        $allObligationsAnswered = ilObjTest::allObligationsAnswered(
                                $this->testSession->getTestId(), $this->testSession->getActiveId(), $this->testSession->getPass()
                        );
                        
                        if( !$allObligationsAnswered )
                        {
                                return 'outQuestionSummaryWithObligationsInfo';
                        }
                }
 
                return 'outQuestionSummary';
        }

References ilObjTest\allObligationsAnswered().

Referenced by getTestNavigationToolbarGUI().

Here is the call graph for this function:

Here is the caller graph for this function:

getInstantResponseParameter()

ilTestPlayerAbstractGUI::getInstantResponseParameter ( )

protected

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

        {
                if( isset($_GET['instresp']) )
                {
                        return $_GET['instresp'];
                }
 
                return null;
        }

References $_GET.

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

Here is the caller graph for this function:

getIntroductionPageButtonLabel()

ilTestPlayerAbstractGUI::getIntroductionPageButtonLabel ( )

protected

Returns

string

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

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

getKioskHead()

ilTestPlayerAbstractGUI::getKioskHead

(

)

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

        {
                global $ilUser;
                
                $template = new ilTemplate('tpl.il_as_tst_kiosk_head.html', true, true, 'Modules/Test');
                if ($this->object->getShowKioskModeTitle())
                {
                        $template->setCurrentBlock("kiosk_show_title");
                        $template->setVariable("TEST_TITLE", $this->object->getTitle());
                        $template->parseCurrentBlock();
                }
                if ($this->object->getShowKioskModeParticipant())
                {
                        $template->setCurrentBlock("kiosk_show_participant");
                        $template->setVariable("PARTICIPANT_NAME_TXT", $this->lng->txt("login_as"));
                        $template->setVariable("PARTICIPANT_NAME", $ilUser->getFullname());
                        $template->setVariable("PARTICIPANT_LOGIN", $ilUser->getLogin());
                        $template->setVariable("PARTICIPANT_MATRICULATION", $ilUser->getMatriculation());
                        $template->setVariable("PARTICIPANT_EMAIL", $ilUser->getEmail());
                        $template->parseCurrentBlock();
                }
                if ($this->object->isShowExamIdInTestPassEnabled())
                {
                        $exam_id = ilObjTest::buildExamId(
                                $this->testSession->getActiveId() , $this->testSession->getPass(), $this->object->getId()
                        );
                        
                        $template->setCurrentBlock("kiosk_show_exam_id");
                        $template->setVariable("EXAM_ID_TXT", $this->lng->txt("exam_id"));
                        $template->setVariable( "EXAM_ID", $exam_id);
                        $template->parseCurrentBlock();                 
                }
                return $template->get();
        }

References $ilUser, and ilObjTest\buildExamId().

Referenced by outQuestionSummaryCmd(), and populateKioskHead().

Here is the call graph for this function:

Here is the caller graph for this function:

getLockParameter()

ilTestPlayerAbstractGUI::getLockParameter

(

)

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

        {
                if( isset($_POST['lock']) && strlen($_POST['lock']) )
                {
                        return $_POST['lock'];
                }
                elseif( isset($_GET['lock']) && strlen($_GET['lock']) )
                {
                        return $_GET['lock'];
                }
 
                return null;
        }

References $_GET, and $_POST.

Referenced by handlePasswordProtectionRedirect(), and startPlayerCmd().

Here is the caller graph for this function:

getNavigationUrlParameter()

ilTestPlayerAbstractGUI::getNavigationUrlParameter ( )

protected

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

        {
                if (isset($_POST['test_player_navigation_url'])) {
                        return $_POST['test_player_navigation_url'];
                }
                return null;
        }

References $_POST.

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

Here is the caller graph for this function:

getNextCommandParameter()

ilTestPlayerAbstractGUI::getNextCommandParameter ( )

protected

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

        {
                if( isset($_POST['nextcmd']) && strlen($_POST['nextcmd']) )
                {
                        return $_POST['nextcmd'];
                }
 
                return null;
        }

References $_POST.

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

Here is the caller graph for this function:

getNextSequenceParameter()

ilTestPlayerAbstractGUI::getNextSequenceParameter ( )

protected

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

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

References $_POST.

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

Here is the caller graph for this function:

getPresentationModeParameter()

ilTestPlayerAbstractGUI::getPresentationModeParameter ( )

protected

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

        {
                if( isset($_GET['pmode']) )
                {
                        return $_GET['pmode'];
                }
 
                return null;
        }

References $_GET.

getQuestionGuiInstance()

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

protected

Parameters

$questionId
$sequenceElement

Returns

object

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

        {
                global $tpl;
                
                if( !$fromCache || !isset($this->cachedQuestionGuis[$questionId]) )
                {
                        $questionGui = $this->object->createQuestionGUI("", $questionId);
                        $questionGui->setTargetGui($this);
                        $questionGui->setPresentationContext(assQuestionGUI::PRESENTATION_CONTEXT_TEST);
                        $questionGui->object->setObligationsToBeConsidered($this->object->areObligationsEnabled());
                        $questionGui->populateJavascriptFilesRequiredForWorkForm($tpl);
                        $questionGui->object->setOutputType(OUTPUT_JAVASCRIPT);
                        $questionGui->object->setShuffler($this->buildQuestionAnswerShuffler($questionId));
                        
                        // hey: prevPassSolutions - determine solution pass index and configure gui accordingly
                        $this->initTestQuestionConfig($questionGui->object);
                        // hey.
                        
                        $this->cachedQuestionGuis[$questionId] = $questionGui;
                }
                
                return $this->cachedQuestionGuis[$questionId];
        }

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionInstance()

ilTestPlayerAbstractGUI::getQuestionInstance (   $questionId,   $fromCache = true  )

protected

Parameters

$questionId

Returns

assQuestion

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

        {
                global $ilDB, $ilUser;
                
                if( !$fromCache || !isset($this->cachedQuestionObjects[$questionId]) )
                {
                        $questionOBJ = assQuestion::_instantiateQuestion($questionId);
 
                        $assSettings = new ilSetting('assessment');
                        require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionProcessLockerFactory.php';
                        $processLockerFactory = new ilAssQuestionProcessLockerFactory($assSettings, $ilDB);
                        $processLockerFactory->setQuestionId($questionOBJ->getId());
                        $processLockerFactory->setUserId($ilUser->getId());
                        include_once ("./Modules/Test/classes/class.ilObjAssessmentFolder.php");
                        $processLockerFactory->setAssessmentLogEnabled(ilObjAssessmentFolder::_enabledAssessmentLogging());
                        $questionOBJ->setProcessLocker($processLockerFactory->getLocker());
 
                        $questionOBJ->setObligationsToBeConsidered($this->object->areObligationsEnabled());
                        $questionOBJ->setOutputType(OUTPUT_JAVASCRIPT);
 
                        // hey: prevPassSolutions - determine solution pass index and configure gui accordingly
                        $this->initTestQuestionConfig($questionOBJ);
                        // hey.
                        
                        $this->cachedQuestionObjects[$questionId] = $questionOBJ;
                }
                
                return $this->cachedQuestionObjects[$questionId];
        }

References $assSettings, $ilDB, $ilUser, ilObjAssessmentFolder\_enabledAssessmentLogging(), assQuestion\_instantiateQuestion(), initTestQuestionConfig(), and OUTPUT_JAVASCRIPT.

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

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionsDefaultPresentationMode()

ilTestPlayerAbstractGUI::getQuestionsDefaultPresentationMode (   $isQuestionWorkedThrough )

protected

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

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

References PRESENTATION_MODE_EDIT.

getRegisteredForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::getRegisteredForcedFeedbackNavUrl ( )

protected

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

        {
                if( !isset($_SESSION['forced_feedback_navigation_url']) )
                {
                        return null;
                }
                
                if( !isset($_SESSION['forced_feedback_navigation_url'][$this->testSession->getActiveId()]) )
                {
                        return null;
                }
                
                return $_SESSION['forced_feedback_navigation_url'][$this->testSession->getActiveId()];
        }

References $_SESSION.

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

Here is the caller graph for this function:

getSequenceElementParameter()

ilTestPlayerAbstractGUI::getSequenceElementParameter ( )

protected

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

        {
                if( isset($_GET['sequence']) )
                {
                        return $_GET['sequence'];
                }
 
                return null;
        }

References $_GET.

Referenced by getCurrentSequenceElement(), and ilTestPlayerDynamicQuestionSetGUI\getQuestionIdParameter().

Here is the caller graph for this function:

getTestNavigationToolbarGUI()

ilTestPlayerAbstractGUI::getTestNavigationToolbarGUI ( )

protected

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

        {
                global $ilUser;
                
                require_once 'Modules/Test/classes/class.ilTestNavigationToolbarGUI.php';
                $navigationToolbarGUI = new ilTestNavigationToolbarGUI($this->ctrl, $this->lng, $this);
                
                $navigationToolbarGUI->setSuspendTestButtonEnabled($this->object->getShowCancel());
                $navigationToolbarGUI->setQuestionTreeButtonEnabled($this->object->getListOfQuestions());
                $navigationToolbarGUI->setQuestionTreeVisible($ilUser->getPref('side_list_of_questions'));
                $navigationToolbarGUI->setQuestionListButtonEnabled($this->object->getListOfQuestions());
                $navigationToolbarGUI->setFinishTestCommand($this->getFinishTestCommand());
                
                return $navigationToolbarGUI;
        }

References $ilUser, and getFinishTestCommand().

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

Here is the call graph for this function:

Here is the caller graph for this function:

handleIntermediateSubmit()

ilTestPlayerAbstractGUI::handleIntermediateSubmit ( )

protected

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

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

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

handlePasswordProtectionRedirect()

ilTestPlayerAbstractGUI::handlePasswordProtectionRedirect ( )

protected

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

        {
                if( $this->ctrl->getNextClass() == 'iltestpasswordprotectiongui' )
                {
                        return;
                }
                
                if( !$this->passwordChecker->isPasswordProtectionPageRedirectRequired() )
                {
                        return;
                }
                
                $this->ctrl->setParameter($this, 'lock', $this->getLockParameter());
                
                $nextCommand = $this->ctrl->getCmdClass().'::'.$this->ctrl->getCmd();
                $this->ctrl->setParameterByClass('ilTestPasswordProtectionGUI', 'nextCommand', $nextCommand);
                $this->ctrl->redirectByClass('ilTestPasswordProtectionGUI', 'showPasswordForm');
        }

References getLockParameter().

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

Here is the call graph for this function:

Here is the caller graph for this function:

handleQuestionActionCmd()

ilTestPlayerAbstractGUI::handleQuestionActionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

handleSkillTriggering()

ilTestPlayerAbstractGUI::handleSkillTriggering ( ilTestSession  $testSession )

protected

Parameters

ilTestSession

$testSession

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

        {
                $questionList = $this->buildTestPassQuestionList();
                $questionList->load();
 
                $testResults = $this->object->getTestResult($testSession->getActiveId(), $testSession->getPass(), true);
                
                require_once 'Modules/Test/classes/class.ilTestSkillEvaluation.php';
                $skillEvaluation = new ilTestSkillEvaluation($this->db, $this->object->getTestId(), $this->object->getRefId());
 
                $skillEvaluation->setUserId($testSession->getUserId());
                $skillEvaluation->setActiveId($testSession->getActiveId());
                $skillEvaluation->setPass($testSession->getPass());
                
                $skillEvaluation->setNumRequiredBookingsForSkillTriggering($this->assSettings->get(
                        'ass_skl_trig_num_answ_barrier', ilObjAssessmentFolder::DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER
                ));
 
 
                $skillEvaluation->init($questionList);
                $skillEvaluation->evaluate($testResults);
                
                $skillEvaluation->handleSkillTriggering();
        }

References $testSession, buildTestPassQuestionList(), ilObjAssessmentFolder\DEFAULT_SKL_TRIG_NUM_ANSWERS_BARRIER, and ilTestSession\getActiveId().

Referenced by ilTestOutputGUI\saveQuestionSolution(), and ilTestPlayerDynamicQuestionSetGUI\saveQuestionSolution().

Here is the call graph for this function:

Here is the caller graph for this function:

handleTearsAndAngerQuestionIsNull()

ilTestPlayerAbstractGUI::handleTearsAndAngerQuestionIsNull (   $questionId,   $sequenceElement  )

protected

Parameters

$sequence
$questionId
$ilLog

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

        {
                global $ilLog;
 
                $ilLog->write("INV SEQ:"
                        ."active={$this->testSession->getActiveId()} "
                        ."qId=$questionId seq=$sequenceElement "
                        . serialize($this->testSequence)
                );
 
                $ilLog->logStack('INV SEQ');
 
                $this->ctrl->setParameter($this, 'sequence', $this->testSequence->getFirstSequence());
                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
        }

References $ilLog, and ilTestPlayerCommands\SHOW_QUESTION.

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

Here is the caller graph for this function:

handleUserSettings()

ilTestPlayerAbstractGUI::handleUserSettings

(

)

Handles some form parameters on starting and resuming a test.

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

        {
                global $ilUser;
 
                if ($_POST["chb_javascript"])
                {
                        $ilUser->writePref("tst_javascript", 1);
                }
                else
                {
                        $ilUser->writePref("tst_javascript", 0);
                }
                
                // hide previous results
                if ($this->object->getNrOfTries() != 1)
                {
                        if ($this->object->getUsePreviousAnswers() == 1)
                        {
                                if ($_POST["chb_use_previous_answers"])
                                {
                                        $ilUser->writePref("tst_use_previous_answers", 1);
                                }
                                else
                                { 
                                        $ilUser->writePref("tst_use_previous_answers", 0);
                                }
                        }
                }
        }

References $_POST, and $ilUser.

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

Here is the caller graph for this function:

initAssessmentSettings()

ilTestPlayerAbstractGUI::initAssessmentSettings ( )

protected

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

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

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

Here is the caller graph for this function:

initProcessLocker()

ilTestPlayerAbstractGUI::initProcessLocker (   $activeId )

protected

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

        {
                global $ilDB;
                
                require_once 'Modules/Test/classes/class.ilTestProcessLockerFactory.php';
                $processLockerFactory = new ilTestProcessLockerFactory($this->assSettings, $ilDB);
 
                $processLockerFactory->setActiveId($activeId);
                
                $this->processLocker = $processLockerFactory->getLocker();
        }

References $ilDB.

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

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

        {
                if ($this->object->checkMaximumAllowedUsers() == FALSE)
                {
                        return $this->showMaximumAllowedUsersReachedMessage();
                }
 
                if( $this->testSession->isAnonymousUser() && !$this->testSession->getActiveId() )
                {
                        $accessCode = $this->testSession->createNewAccessCode();
                        
                        $this->testSession->setAccessCodeToSession($accessCode);
                        $this->testSession->setAnonymousId($accessCode);
                        $this->testSession->saveToDb();
                        
                        $this->ctrl->redirect($this, ilTestPlayerCommands::DISPLAY_ACCESS_CODE);
                }
 
                $this->testSession->unsetAccessCodeInSession();
                $this->ctrl->redirect($this, ilTestPlayerCommands::START_TEST);
        }

References ilTestPlayerCommands\DISPLAY_ACCESS_CODE, showMaximumAllowedUsersReachedMessage(), and ilTestPlayerCommands\START_TEST.

Here is the call graph for this function:

initTestPageTemplate()

ilTestPlayerAbstractGUI::initTestPageTemplate ( )

protected

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

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

References getContentBlockName().

Referenced by prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

initTestQuestionConfig()

ilTestPlayerAbstractGUI::initTestQuestionConfig ( assQuestion  $questionOBJ )

protected

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

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

References assQuestion\getTestPresentationConfig().

Referenced by getQuestionGuiInstance(), and getQuestionInstance().

Here is the call graph for this function:

Here is the caller graph for this function:

isFirstQuestionInSequence()

ilTestPlayerAbstractGUI::isFirstQuestionInSequence (   $sequenceElement )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

Referenced by populateQuestionNavigation().

Here is the caller graph for this function:

isForcedFeedbackNavUrlRegistered()

ilTestPlayerAbstractGUI::isForcedFeedbackNavUrlRegistered ( )

protected

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

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

References getRegisteredForcedFeedbackNavUrl().

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

Here is the call graph for this function:

Here is the caller graph for this function:

isLastQuestionInSequence()

ilTestPlayerAbstractGUI::isLastQuestionInSequence (   $sequenceElement )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

Referenced by populateQuestionNavigation().

Here is the caller graph for this function:

isMaxProcessingTimeReached()

ilTestPlayerAbstractGUI::isMaxProcessingTimeReached

(

)

Checks wheather the maximum processing time is reached or not.

Checks wheather the maximum processing time is reached or not

Returns

bool TRUE if the maximum processing time is reached, FALSE otherwise

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

        {
                global $ilUser;
                $active_id = $this->testSession->getActiveId();
                $starting_time = $this->object->getStartingTimeOfUser($active_id);
                if ($starting_time === FALSE)
                {
                        return FALSE;
                }
                else
                {
                        return $this->object->isMaxProcessingTimeReached($starting_time, $active_id);
                }
        }

References $ilUser.

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

Here is the caller graph for this function:

isNrOfTriesReached()

ilTestPlayerAbstractGUI::isNrOfTriesReached

(

)

nr of tries exceeded

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

        {
                return $this->object->hasNrOfTriesRestriction() && $this->object->isNrOfTriesReached($this->testSession->getPass());    
        }

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

Here is the caller graph for this function:

isOptionalQuestionAnsweringConfirmationRequired()

ilTestPlayerAbstractGUI::isOptionalQuestionAnsweringConfirmationRequired (   $sequenceElement )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

Referenced by prepareTestPage().

Here is the caller graph for this function:

isParticipantsAnswerFixed()

ilTestPlayerAbstractGUI::isParticipantsAnswerFixed (   $questionId )

protected

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

        {
                if( !$this->object->isInstantFeedbackAnswerFixationEnabled() )
                {
                        return false;
                }
 
                if( !$this->testSequence->isQuestionChecked($questionId) )
                {
                        return false;
                }
 
                return true;
        }

Referenced by autosaveCmd(), buildReadOnlyStateQuestionNavigationGUI(), ilTestOutputGUI\handleQuestionActionCmd(), ilTestPlayerDynamicQuestionSetGUI\handleQuestionActionCmd(), ilTestOutputGUI\showInstantResponseCmd(), ilTestPlayerDynamicQuestionSetGUI\showInstantResponseCmd(), ilTestOutputGUI\showQuestionCmd(), and ilTestPlayerDynamicQuestionSetGUI\showQuestionCmd().

Here is the caller graph for this function:

isQuestionSummaryFinishTestButtonRequired()

ilTestPlayerAbstractGUI::isQuestionSummaryFinishTestButtonRequired ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

Referenced by outQuestionSummaryCmd().

Here is the caller graph for this function:

isShowingPostponeStatusReguired()

ilTestPlayerAbstractGUI::isShowingPostponeStatusReguired (   $questionId )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

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

Here is the caller graph for this function:

isTestAccessible()

ilTestPlayerAbstractGUI::isTestAccessible

(

)

test accessible returns true if the user can perform the test

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

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

References isMaxProcessingTimeReached(), and isNrOfTriesReached().

Here is the call graph for this function:

isTestSignRedirectRequired()

ilTestPlayerAbstractGUI::isTestSignRedirectRequired (   $activeId,   $lastFinishedPass  )

protected

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

        {
                if( !$this->object->getSignSubmission() )
                {
                        return false;
                }
 
                if( !is_null(ilSession::get("signed_{$activeId}_{$lastFinishedPass}")) )
                {
                        return false;
                }
 
                global $ilPluginAdmin;
 
                $activePlugins = $ilPluginAdmin->getActivePluginsForSlot(IL_COMP_MODULE, 'Test', 'tsig');
 
                if( !count($activePlugins) )
                {
                        return false;
                }
                
                return true;
        }

References ilSession\get(), and IL_COMP_MODULE.

Referenced by afterTestPassFinishedCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

markQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::markQuestionAndSaveIntermediateCmd ( )

protected

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

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

References handleIntermediateSubmit(), and markQuestionCmd().

Here is the call graph for this function:

markQuestionCmd()

ilTestPlayerAbstractGUI::markQuestionCmd ( )

protected

Set a question solved.

Reimplemented in ilTestPlayerDynamicQuestionSetGUI.

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

        {
                $questionId  = $this->testSequence->getQuestionForSequence(
                        $this->getCurrentSequenceElement()
                );
                
                $this->object->setQuestionSetSolved(1, $questionId, $this->testSession->getUserId());
                
                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
        }

References getCurrentSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by markQuestionAndSaveIntermediateCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

maxProcessingTimeReached()

ilTestPlayerAbstractGUI::maxProcessingTimeReached

(

)

Outputs a message when the maximum processing time is reached.

Outputs a message when the maximum processing time is reached

@access public

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

        {
                $this->suspendTestCmd();
        }               

References suspendTestCmd().

Referenced by prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

nextQuestionCmd()

ilTestPlayerAbstractGUI::nextQuestionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

outCorrectSolution()

ilTestPlayerAbstractGUI::outCorrectSolution

(

)

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

@access public

Reimplemented from ilTestServiceGUI.

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

        {
                $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_as_tst_correct_solution.html", "Modules/Test");
 
                include_once("./Services/Style/Content/classes/class.ilObjStyleSheet.php");
                $this->tpl->setCurrentBlock("ContentStyle");
                $this->tpl->setVariable("LOCATION_CONTENT_STYLESHEET", ilObjStyleSheet::getContentStylePath(0));
                $this->tpl->parseCurrentBlock();
 
                $this->tpl->setCurrentBlock("SyntaxStyle");
                $this->tpl->setVariable("LOCATION_SYNTAX_STYLESHEET", ilObjStyleSheet::getSyntaxStylePath());
                $this->tpl->parseCurrentBlock();
 
                $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print.css", "Modules/Test"), "print");
                if ($this->object->getShowSolutionAnswersOnly())
                {
                        $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print_hide_content.css", "Modules/Test"), "print");
                }
 
                $this->tpl->setCurrentBlock("adm_content");
                $solution = $this->getCorrectSolutionOutput($_GET["evaluation"], $_GET["active_id"], $_GET["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 $_GET, ilObjStyleSheet\getContentStylePath(), ilTestServiceGUI\getCorrectSolutionOutput(), ilUtil\getStyleSheetLocation(), and ilObjStyleSheet\getSyntaxStylePath().

Here is the call graph for this function:

outObligationsOnlySummaryCmd()

ilTestPlayerAbstractGUI::outObligationsOnlySummaryCmd

(

)

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

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

References outQuestionSummaryCmd().

Here is the call graph for this function:

outProcessingTime()

ilTestPlayerAbstractGUI::outProcessingTime

(

$active_id

)

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

        {
                global $ilUser;
 
                $starting_time = $this->object->getStartingTimeOfUser($active_id);
                $processing_time = $this->object->getProcessingTimeInSeconds($active_id);
                $processing_time_minutes = floor($processing_time / 60);
                $processing_time_seconds = $processing_time - $processing_time_minutes * 60;
                $str_processing_time = "";
                if ($processing_time_minutes > 0)
                {
                        $str_processing_time = $processing_time_minutes . " " . ($processing_time_minutes == 1 ? $this->lng->txt("minute") : $this->lng->txt("minutes"));
                }
                if ($processing_time_seconds > 0)
                {
                        if (strlen($str_processing_time) > 0) $str_processing_time .= " " . $this->lng->txt("and") . " ";
                        $str_processing_time .= $processing_time_seconds . " " . ($processing_time_seconds == 1 ? $this->lng->txt("second") : $this->lng->txt("seconds"));
                }
                $time_left = $starting_time + $processing_time - time();
                $time_left_minutes = floor($time_left / 60);
                $time_left_seconds = $time_left - $time_left_minutes * 60;
                $str_time_left = "";
                if ($time_left_minutes > 0)
                {
                        $str_time_left = $time_left_minutes . " " . ($time_left_minutes == 1 ? $this->lng->txt("minute") : $this->lng->txt("minutes"));
                }
                if ($time_left < 300)
                {
                        if ($time_left_seconds > 0)
                        {
                                if (strlen($str_time_left) > 0) $str_time_left .= " " . $this->lng->txt("and") . " ";
                                $str_time_left .= $time_left_seconds . " " .  ($time_left_seconds == 1 ? $this->lng->txt("second") : $this->lng->txt("seconds"));
                        }
                }
                $date = getdate($starting_time);
                $formattedStartingTime = ilDatePresentation::formatDate(new ilDateTime($date,IL_CAL_FKT_GETDATE));              
                $datenow = getdate();
                $this->tpl->setCurrentBlock("enableprocessingtime");
                $this->tpl->setVariable("USER_WORKING_TIME", 
                        sprintf(
                                $this->lng->txt("tst_time_already_spent"),
                                $formattedStartingTime,
                                $str_processing_time
                        )
                );
                $this->tpl->setVariable("USER_REMAINING_TIME", sprintf($this->lng->txt("tst_time_already_spent_left"), $str_time_left));
                $this->tpl->parseCurrentBlock();
                $template = new ilTemplate("tpl.workingtime.js.html", TRUE, TRUE, 'Modules/Test');
                $template->setVariable("STRING_MINUTE", $this->lng->txt("minute"));
                $template->setVariable("STRING_MINUTES", $this->lng->txt("minutes"));
                $template->setVariable("STRING_SECOND", $this->lng->txt("second"));
                $template->setVariable("STRING_SECONDS", $this->lng->txt("seconds"));
                $template->setVariable("STRING_TIMELEFT", $this->lng->txt("tst_time_already_spent_left"));
                $template->setVariable("AND", strtolower($this->lng->txt("and")));
                $template->setVariable("YEAR", $date["year"]);
                $template->setVariable("MONTH", $date["mon"]-1);
                $template->setVariable("DAY", $date["mday"]);
                $template->setVariable("HOUR", $date["hours"]);
                $template->setVariable("MINUTE", $date["minutes"]);
                $template->setVariable("SECOND", $date["seconds"]);
                if ($this->object->isEndingTimeEnabled() )
                {
                        $date_time = new ilDateTime($this->object->getEndingTime(), IL_CAL_UNIX);
                        preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $date_time->get(IL_CAL_TIMESTAMP), $matches);
                        $template->setVariable("ENDYEAR", $matches[1]);
                        $template->setVariable("ENDMONTH", $matches[2]-1);
                        $template->setVariable("ENDDAY", $matches[3]);
                        $template->setVariable("ENDHOUR", $matches[4]);
                        $template->setVariable("ENDMINUTE", $matches[5]);
                        $template->setVariable("ENDSECOND", $matches[6]);
                }
                $template->setVariable("YEARNOW", $datenow["year"]);
                $template->setVariable("MONTHNOW", $datenow["mon"]-1);
                $template->setVariable("DAYNOW", $datenow["mday"]);
                $template->setVariable("HOURNOW", $datenow["hours"]);
                $template->setVariable("MINUTENOW", $datenow["minutes"]);
                $template->setVariable("SECONDNOW", $datenow["seconds"]);
                $template->setVariable("PTIME_M", $processing_time_minutes);
                $template->setVariable("PTIME_S", $processing_time_seconds);
                
                $this->tpl->setCurrentBlock("HeadContent");
                $this->tpl->setVariable("CONTENT_BLOCK", $template->get());
                $this->tpl->parseCurrentBlock();
        }

References $ilUser, ilDatePresentation\formatDate(), IL_CAL_FKT_GETDATE, IL_CAL_TIMESTAMP, IL_CAL_UNIX, and sprintf.

Referenced by outQuestionSummaryCmd(), prepareTestPage(), and ilTestPlayerDynamicQuestionSetGUI\showQuestionSelectionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

outQuestionSummaryCmd()

ilTestPlayerAbstractGUI::outQuestionSummaryCmd	(		$fullpage = true,
			$contextFinishTest = false,
			$obligationsNotAnswered = false,
			$obligationsFilter = false
	)

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

Reimplemented in ilTestPlayerDynamicQuestionSetGUI.

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

        {
                if( $fullpage )
                {
                        $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_question_summary.html", "Modules/Test");
                }
                
                if( $obligationsNotAnswered )
                {
                        ilUtil::sendFailure($this->lng->txt('not_all_obligations_answered'));
                }
                
                if( $this->object->getKioskMode() && $fullpage )
                {
                        $head = $this->getKioskHead();
                        if( strlen($head) )
                        {
                                $this->tpl->setCurrentBlock("kiosk_options");
                                $this->tpl->setVariable("KIOSK_HEAD", $head);
                                $this->tpl->parseCurrentBlock();
                        }
                }
 
 
                $active_id = $this->testSession->getActiveId();
                $questionSummaryData = $this->service->getQuestionSummaryData($this->testSequence, $obligationsFilter);
                
                $this->ctrl->setParameter($this, "sequence", $_GET["sequence"]);
                
                if( $fullpage )
                {
                        include_once "./Modules/Test/classes/tables/class.ilListOfQuestionsTableGUI.php";
                        $table_gui = new ilListOfQuestionsTableGUI($this, 'showQuestion');
                        
                        $table_gui->setShowPointsEnabled( !$this->object->getTitleOutput() );
                        $table_gui->setShowMarkerEnabled( $this->object->getShowMarker() );
                        $table_gui->setObligationsNotAnswered( $obligationsNotAnswered );
                        $table_gui->setShowObligationsEnabled( $this->object->areObligationsEnabled() );
                        $table_gui->setObligationsFilterEnabled( $obligationsFilter );
                        $table_gui->setFinishTestButtonEnabled($this->isQuestionSummaryFinishTestButtonRequired());
 
                        $table_gui->init();
                                
                        $table_gui->setData($questionSummaryData);
 
                        $this->tpl->setVariable('TABLE_LIST_OF_QUESTIONS', $table_gui->getHTML());      
                        
                        if( $this->object->getEnableProcessingTime() )
                        {
                                $this->outProcessingTime($active_id);
                        }
                }
        }

References $_GET, getContentBlockName(), getKioskHead(), isQuestionSummaryFinishTestButtonRequired(), outProcessingTime(), and ilUtil\sendFailure().

Referenced by outObligationsOnlySummaryCmd(), and outQuestionSummaryWithObligationsInfoCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

outQuestionSummaryWithObligationsInfoCmd()

ilTestPlayerAbstractGUI::outQuestionSummaryWithObligationsInfoCmd

(

)

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

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

References outQuestionSummaryCmd().

Here is the call graph for this function:

outUserResultsOverviewCmd()

ilTestPlayerAbstractGUI::outUserResultsOverviewCmd

(

)

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

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

performTestPassFinishedTasks()

ilTestPlayerAbstractGUI::performTestPassFinishedTasks (   $finishedPass )

protected

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

        {
                require_once 'Modules/Test/classes/class.ilTestPassFinishTasks.php';
 
                $finishTasks = new ilTestPassFinishTasks($this->testSession->getActiveId(), $this->object->getId());
                $finishTasks->performFinishTasks($this->processLocker);
        }

Referenced by finishTestCmd(), and redirectAfterAutosaveCmd().

Here is the caller graph for this function:

populateCharSelectorIfRequired()

ilTestPlayerAbstractGUI::populateCharSelectorIfRequired ( )

protected

Returns

bool $charSelectorAvailable

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

        {
                global $ilSetting;
                
                if ($ilSetting->get('char_selector_availability') > 0)
                {
                        require_once 'Services/UIComponent/CharSelector/classes/class.ilCharSelectorGUI.php';
                        $char_selector = ilCharSelectorGUI::_getCurrentGUI($this->object);
                        if ($char_selector->getConfig()->getAvailability() == ilCharSelectorConfig::ENABLED)
                        {
                                $char_selector->addToPage();
                                $this->tpl->setCurrentBlock('char_selector');
                                $this->tpl->setVariable("CHAR_SELECTOR_TEMPLATE", $char_selector->getSelectorHtml());
                                $this->tpl->parseCurrentBlock();
                                
                                return true;
                        }
                }
                
                return false;
        }

References $ilSetting, ilCharSelectorGUI\_getCurrentGUI(), and ilCharSelectorConfig\ENABLED.

Here is the call graph for this function:

populateContentStyleBlock()

ilTestPlayerAbstractGUI::populateContentStyleBlock ( )

protected

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

        {
                include_once("./Services/Style/Content/classes/class.ilObjStyleSheet.php");
                $this->tpl->setCurrentBlock( "ContentStyle" );
                $this->tpl->setVariable( "LOCATION_CONTENT_STYLESHEET",
                                                                 ilObjStyleSheet::getContentStylePath( 0 )
                );
                $this->tpl->parseCurrentBlock();
        }

References ilObjStyleSheet\getContentStylePath().

Referenced by prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

populateDiscardSolutionModal()

ilTestPlayerAbstractGUI::populateDiscardSolutionModal ( )

protected

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

        {
                $tpl = new ilTemplate('tpl.tst_player_confirmation_modal.html', true, true, 'Modules/Test');
                
                $tpl->setVariable('CONFIRMATION_TEXT', $this->lng->txt('discard_answer_confirmation'));
 
                $button = ilSubmitButton::getInstance();
                $button->setCommand(ilTestPlayerCommands::DISCARD_SOLUTION);
                $button->setCaption('discard_answer');
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();
 
                $button = ilLinkButton::getInstance();
                $button->setId('tst_cancel_discard_button');
                $button->setCaption('cancel');
                $button->setPrimary(true);
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();
                
                $modal = ilModalGUI::getInstance();
                $modal->setId('tst_discard_solution_modal');
                $modal->setHeading($this->lng->txt('discard_answer'));
                $modal->setBody($tpl->get());
                
                $this->tpl->setCurrentBlock('discard_solution_modal');
                $this->tpl->setVariable('DISCARD_SOLUTION_MODAL', $modal->getHTML());
                $this->tpl->parseCurrentBlock();
                
// fau: testNav - the discard solution modal is now handled by ilTestPlayerNavigationControl.js
//              $this->tpl->addJavaScript('Modules/Test/js/ilTestPlayerDiscardSolutionModal.js', true);
// fau.
        }

References ilTestServiceGUI\$tpl, ilTestPlayerCommands\DISCARD_SOLUTION, ilLinkButton\getInstance(), ilSubmitButton\getInstance(), and ilModalGUI\getInstance().

Referenced by populateModals().

Here is the call graph for this function:

Here is the caller graph for this function:

populateGenericFeedbackBlock()

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

protected

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

        {
                $feedback = $question_gui->getGenericFeedbackOutput( $this->testSession->getActiveId(),NULL);
                
                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();
                }
        }

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

Referenced by populateInstantResponseBlocks().

Here is the call graph for this function:

Here is the caller graph for this function:

populateHelperGuiContent()

ilTestPlayerAbstractGUI::populateHelperGuiContent (   $helperGui )

protected

Parameters

$helperGui

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

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

References getContentBlockName().

Referenced by showAnswerOptionalQuestionsConfirmation().

Here is the call graph for this function:

Here is the caller graph for this function:

populateInstantResponseBlocks()

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

protected

Parameters

assQuestionGUI

$questionGui

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

        {
                // This controls if the solution should be shown.
                // It gets the parameter "Scoring and Results" -> "Instant Feedback" -> "Show Solutions"                        
                if($this->object->getInstantFeedbackSolution())
                {
                        $show_question_inline_score = $this->determineInlineScoreDisplay();
 
                        // Notation of the params prior to getting rid of this crap in favor of a class
                        $solutionoutput = $questionGui->getSolutionOutput($this->testSession->getActiveId(),    #active_id
                                NULL,                                                #pass
                                FALSE,                                                #graphical_output
                                $show_question_inline_score,                        #result_output
                                FALSE,                                                #show_question_only
                                FALSE,                                                #show_feedback
                                TRUE,                                                #show_correct_solution
                                FALSE,                                                #show_manual_scoring
                                FALSE                                                #show_question_text
                        );
                        $this->populateSolutionBlock($solutionoutput);
                }
                
                $reachedPoints = $questionGui->object->getAdjustedReachedPoints(
                        $this->testSession->getActiveId(), NULL, $authorizedSolution
                );
                
                $maxPoints = $questionGui->object->getMaximumPoints();
                
                $solutionCorrect = ($reachedPoints == $maxPoints);
                
                // This controls if the score should be shown.
                // It gets the parameter "Scoring and Results" -> "Instant Feedback" -> "Show Results (Only Points)"                            
                if($this->object->getAnswerFeedbackPoints())
                {
                        $this->populateScoreBlock($reachedPoints, $maxPoints);
                }
 
                // This controls if the generic feedback should be shown.
                // It gets the parameter "Scoring and Results" -> "Instant Feedback" -> "Show Solutions"                                
                if($this->object->getGenericAnswerFeedback())
                {
                        $this->populateGenericFeedbackBlock($questionGui, $solutionCorrect);
                }
 
                // 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())
                {
                        $this->populateSpecificFeedbackBlock($questionGui);
                }
        }

References determineInlineScoreDisplay(), assQuestionGUI\getSolutionOutput(), populateGenericFeedbackBlock(), populateScoreBlock(), populateSolutionBlock(), and populateSpecificFeedbackBlock().

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateInstantResponseModal()

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

protected

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

        {
                $questionGui->setNavigationGUI(null);
                $questionGui->getQuestionHeaderBlockBuilder()->setQuestionAnswered(true);
 
                $answerFeedbackEnabled = $this->object->getSpecificAnswerFeedback();
 
                $solutionoutput = $questionGui->getSolutionOutput(
                        $this->testSession->getActiveId(),      #active_id
                        $this->testSession->getPass(),          #pass
                        false,                                                          #graphical_output
                        false,                                                          #result_output
                        true,                                                           #show_question_only
                        $answerFeedbackEnabled,                         #show_feedback
                        false,                                                          #show_correct_solution
                        false,                                                          #show_manual_scoring
                        true                                                            #show_question_text
                );
 
                $pageoutput = $questionGui->outQuestionPage(
                        "",
                        $this->isShowingPostponeStatusReguired($questionGui->object->getId()),
                        $this->testSession->getActiveId(),
                        $solutionoutput
                );
 
                $tpl = new ilTemplate('tpl.tst_player_response_modal.html', true, true, 'Modules/Test');
 
                // populate the instant response blocks in the
                $saved_tpl = $this->tpl;
                $this->tpl = $tpl;
                $this->populateInstantResponseBlocks($questionGui, true);
                $this->tpl = $saved_tpl;
 
                $tpl->setVariable('QUESTION_OUTPUT', $pageoutput);
 
                $button = ilLinkButton::getInstance();
                $button->setId('tst_confirm_feedback');
                $button->setUrl($navUrl);
                $button->setCaption('proceed');
                $button->setPrimary(true);
                $tpl->setVariable('BUTTON', $button->render());
 
 
                require_once('Services/UIComponent/Modal/classes/class.ilModalGUI.php');
                $modal = ilModalGUI::getInstance();
                $modal->setType(ilModalGUI::TYPE_LARGE);
                $modal->setId('tst_question_feedback_modal');
                $modal->setHeading($this->lng->txt('tst_instant_feedback'));
                $modal->setBody($tpl->get());
 
                $this->tpl->addOnLoadCode("$('#tst_question_feedback_modal').modal('show');");
                $this->tpl->setVariable('INSTANT_RESPONSE_MODAL', $modal->getHTML());
        }

References ilTestServiceGUI\$tpl, ilLinkButton\getInstance(), ilModalGUI\getInstance(), assQuestionGUI\getQuestionHeaderBlockBuilder(), assQuestionGUI\getSolutionOutput(), isShowingPostponeStatusReguired(), assQuestionGUI\outQuestionPage(), populateInstantResponseBlocks(), assQuestionGUI\setNavigationGUI(), and ilModalGUI\TYPE_LARGE.

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateKioskHead()

ilTestPlayerAbstractGUI::populateKioskHead ( )

protected

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

        {
                ilUtil::sendInfo(); // ???
                
                $head = $this->getKioskHead();
                
                if (strlen($head))
                {
                        $this->tpl->setCurrentBlock("kiosk_options");
                        $this->tpl->setVariable("KIOSK_HEAD", $head);
                        $this->tpl->parseCurrentBlock();
                }
        }

References getKioskHead(), and ilUtil\sendInfo().

Referenced by prepareSummaryPage(), and prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

populateLowerNextButtonBlock()

ilTestPlayerAbstractGUI::populateLowerNextButtonBlock (   $disabled,   $primaryNext  )

protected

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

        {
                $button = $this->buildNextButtonInstance($disabled, $primaryNext);
                $button->setId('bottomnextbutton');
 
                $this->tpl->setCurrentBlock( "next_bottom" );
                $this->tpl->setVariable( "BTN_NEXT", $button->render());
                $this->tpl->parseCurrentBlock();
        }

References buildNextButtonInstance().

Referenced by populateNextButtons().

Here is the call graph for this function:

Here is the caller graph for this function:

populateLowerPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateLowerPreviousButtonBlock (   $disabled )

protected

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

        {
                $button = $this->buildPreviousButtonInstance($disabled);
                $button->setId('bottomprevbutton');
 
                $this->tpl->setCurrentBlock( "prev_bottom" );
                $this->tpl->setVariable("BTN_PREV", $button->render());
                $this->tpl->parseCurrentBlock();
        }

References buildPreviousButtonInstance().

Referenced by populatePreviousButtons().

Here is the call graph for this function:

Here is the caller graph for this function:

populateMessageContent()

ilTestPlayerAbstractGUI::populateMessageContent (   $contentHTML )

protected

Parameters

$contentHTML

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

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

References getContentBlockName().

Referenced by ilTestPlayerDynamicQuestionSetGUI\showCheckedQuestionResettingConfirmation().

Here is the call graph for this function:

Here is the caller graph for this function:

populateModals()

ilTestPlayerAbstractGUI::populateModals ( )

protected

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

        {
                require_once 'Services/UIComponent/Button/classes/class.ilSubmitButton.php';
                require_once 'Services/UIComponent/Button/classes/class.ilLinkButton.php';
                require_once 'Services/UIComponent/Modal/classes/class.ilModalGUI.php';
 
                $this->populateDiscardSolutionModal();
// fau: testNav - populateNavWhenChangedModal instead of populateNavWhileEditModal
                $this->populateNavWhenChangedModal();
// fau.
 
                if( $this->object->getKioskMode() )
                {
                        $this->tpl->addJavaScript('Services/UICore/lib/bootstrap-3.2.0/dist/js/bootstrap.min.js', true);
                }
        }

References populateDiscardSolutionModal(), and populateNavWhenChangedModal().

Referenced by showQuestionEditable().

Here is the call graph for this function:

Here is the caller graph for this function:

populateNavWhenChangedModal()

ilTestPlayerAbstractGUI::populateNavWhenChangedModal ( )

protected

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

        {
                if (!empty($_SESSION['save_on_navigation_prevent_confirmation']))
                {
                        return;
                }
 
                $tpl = new ilTemplate('tpl.tst_player_confirmation_modal.html', true, true, 'Modules/Test');
 
                if ($this->object->isInstantFeedbackAnswerFixationEnabled() && $this->object->isForceInstantFeedbackEnabled())
                {
                        $text =  $this->lng->txt('save_on_navigation_locked_confirmation');
                }
                else
                {
                        $text =  $this->lng->txt('save_on_navigation_confirmation');
                }
                if ($this->object->isForceInstantFeedbackEnabled())
                {
                        $text .= " ". $this->lng->txt('save_on_navigation_forced_feedback_hint');
                }
                $tpl->setVariable('CONFIRMATION_TEXT', $text);
 
 
                $button = ilLinkButton::getInstance();
                $button->setId('tst_save_on_navigation_button');
                $button->setUrl('#');
                $button->setCaption('tst_save_and_proceed');
                $button->setPrimary(true);
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();
 
                $button = ilLinkButton::getInstance();
                $button->setId('tst_cancel_on_navigation_button');
                $button->setUrl('#');
                $button->setCaption('cancel');
                $button->setPrimary(false);
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();
 
                $tpl->setCurrentBlock('checkbox');
                $tpl->setVariable('CONFIRMATION_CHECKBOX_NAME','save_on_navigation_prevent_confirmation');
                $tpl->setVariable('CONFIRMATION_CHECKBOX_LABEL',$this->lng->txt('save_on_navigation_prevent_confirmation'));
                $tpl->parseCurrentBlock();
 
                $modal = ilModalGUI::getInstance();
                $modal->setId('tst_save_on_navigation_modal');
                $modal->setHeading($this->lng->txt('save_on_navigation'));
                $modal->setBody($tpl->get());
 
                $this->tpl->setCurrentBlock('nav_while_edit_modal');
                $this->tpl->setVariable('NAV_WHILE_EDIT_MODAL', $modal->getHTML());
                $this->tpl->parseCurrentBlock();
        }

References $_SESSION, $text, ilTestServiceGUI\$tpl, ilLinkButton\getInstance(), and ilModalGUI\getInstance().

Referenced by populateModals().

Here is the call graph for this function:

Here is the caller graph for this function:

populateNextButtons()

ilTestPlayerAbstractGUI::populateNextButtons (   $disabled,   $primaryNext  )

protected

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

        {
                $this->populateUpperNextButtonBlock($disabled, $primaryNext);
                $this->populateLowerNextButtonBlock($disabled, $primaryNext);
        }

References populateLowerNextButtonBlock(), and populateUpperNextButtonBlock().

Referenced by populateQuestionNavigation(), and ilTestPlayerDynamicQuestionSetGUI\populateQuestionNavigation().

Here is the call graph for this function:

Here is the caller graph for this function:

populatePreviousButtons()

ilTestPlayerAbstractGUI::populatePreviousButtons (   $disabled )

protected

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

        {
                $this->populateUpperPreviousButtonBlock($disabled);
                $this->populateLowerPreviousButtonBlock($disabled);
        }

References populateLowerPreviousButtonBlock(), and populateUpperPreviousButtonBlock().

Referenced by populateQuestionNavigation().

Here is the call graph for this function:

Here is the caller graph for this function:

populateQuestionNavigation()

ilTestPlayerAbstractGUI::populateQuestionNavigation (   $sequenceElement,   $disabled,   $primaryNext  )

protected

Reimplemented in ilTestPlayerDynamicQuestionSetGUI.

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

        {
                if( !$this->isFirstQuestionInSequence($sequenceElement) )
                {
                        $this->populatePreviousButtons($disabled);
                }
 
                if( !$this->isLastQuestionInSequence($sequenceElement) )
                {
                        $this->populateNextButtons($disabled, $primaryNext);
                }
        }

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

Referenced by ilTestOutputGUI\showQuestionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

populateScoreBlock()

ilTestPlayerAbstractGUI::populateScoreBlock (   $reachedPoints,   $maxPoints  )

protected

Definition at line 380 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 sprintf.

Referenced by populateInstantResponseBlocks().

Here is the caller graph for this function:

populateSolutionBlock()

ilTestPlayerAbstractGUI::populateSolutionBlock (   $solutionoutput )

protected

Definition at line 391 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();
                }
        }

Referenced by populateInstantResponseBlocks().

Here is the caller graph for this function:

populateSpecificFeedbackBlock()

ilTestPlayerAbstractGUI::populateSpecificFeedbackBlock (   $question_gui )

protected

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

        {
                $this->tpl->setCurrentBlock( "specific_feedback" );
                $this->tpl->setVariable( "SPECIFIC_FEEDBACK",
                                                                 $question_gui->getSpecificFeedbackOutput(
                                                                         $this->testSession->getActiveId(),
                                                                         NULL
                                                                 )
                );
                $this->tpl->parseCurrentBlock();
        }

Referenced by populateInstantResponseBlocks().

Here is the caller graph for this function:

populateSyntaxStyleBlock()

ilTestPlayerAbstractGUI::populateSyntaxStyleBlock ( )

protected

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

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

References ilObjStyleSheet\getSyntaxStylePath().

Referenced by prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

populateTestNavigationToolbar()

ilTestPlayerAbstractGUI::populateTestNavigationToolbar ( ilTestNavigationToolbarGUI  $toolbarGUI )

protected

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

        {
                $this->tpl->setCurrentBlock('test_nav_toolbar');
                $this->tpl->setVariable('TEST_NAV_TOOLBAR', $toolbarGUI->getHTML());
                $this->tpl->parseCurrentBlock();
        }

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

Here is the caller graph for this function:

populateUpperNextButtonBlock()

ilTestPlayerAbstractGUI::populateUpperNextButtonBlock (   $disabled,   $primaryNext  )

protected

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

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

References buildNextButtonInstance().

Referenced by populateNextButtons().

Here is the call graph for this function:

Here is the caller graph for this function:

populateUpperPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateUpperPreviousButtonBlock (   $disabled )

protected

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

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

References buildPreviousButtonInstance().

Referenced by populatePreviousButtons().

Here is the call graph for this function:

Here is the caller graph for this function:

prepareSummaryPage()

ilTestPlayerAbstractGUI::prepareSummaryPage ( )

protected

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

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

References getContentBlockName(), and populateKioskHead().

Referenced by ilTestPlayerDynamicQuestionSetGUI\showQuestionSelectionCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

prepareTestPage()

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

protected

Returns

string $formAction

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

        {
                global $ilUser, $ilNavigationHistory;
 
                $ilNavigationHistory->addItem($this->testSession->getRefId(),
                        $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::RESUME_PLAYER), 'tst'
                );
 
                $this->initTestPageTemplate();
                $this->populateContentStyleBlock();
                $this->populateSyntaxStyleBlock();
 
                if ($this->isMaxProcessingTimeReached())
                {
                        $this->maxProcessingTimeReached();
                        return;
                }
                
                if ($this->object->endingTimeReached())
                {
                        $this->endingTimeReached();
                        return;
                }
 
                if( $this->isOptionalQuestionAnsweringConfirmationRequired($sequenceElement) )
                {
                        $this->ctrl->setParameter($this, "sequence", $sequenceElement);
                        $this->showAnswerOptionalQuestionsConfirmation();
                        return;
                }
                        
                if ($this->object->getKioskMode())
                {
                        $this->populateKioskHead();
                }
                
                $this->tpl->setVariable("TEST_ID", $this->object->getTestId());
                $this->tpl->setVariable("LOGIN", $ilUser->getLogin());
                $this->tpl->setVariable("SEQ_ID", $sequenceElement);
                $this->tpl->setVariable("QUEST_ID", $questionId);
                                
                if ($this->object->getEnableProcessingTime())
                {
                        $this->outProcessingTime($this->testSession->getActiveId());
                }
                
                $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->testSession->getActiveId(), $this->testSession->getPass(), $this->object->getId()
                        ));
                        $this->tpl->setVariable('EXAM_ID_TXT', $this->lng->txt('exam_id'));
                        $this->tpl->parseCurrentBlock();
                }
 
                if ($this->object->getListOfQuestions())
                {
                        $this->showSideList($presentationMode, $sequenceElement);
                }
        }

References $ilUser, endingTimeReached(), initTestPageTemplate(), isMaxProcessingTimeReached(), isOptionalQuestionAnsweringConfirmationRequired(), ilObjTest\lookupExamId(), maxProcessingTimeReached(), outProcessingTime(), populateContentStyleBlock(), populateKioskHead(), populateSyntaxStyleBlock(), ilTestPlayerCommands\RESUME_PLAYER, showAnswerOptionalQuestionsConfirmation(), and showSideList().

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

Here is the call graph for this function:

Here is the caller graph for this function:

previousQuestionCmd()

ilTestPlayerAbstractGUI::previousQuestionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

redirectAfterAutosaveCmd()

ilTestPlayerAbstractGUI::redirectAfterAutosaveCmd

(

)

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

        {
                $active_id = $this->testSession->getActiveId();
                $actualpass = ilObjTest::_getPass($active_id);
                
                $this->performTestPassFinishedTasks($actualpass);
 
                $this->testSession->setLastFinishedPass($this->testSession->getPass());
                $this->testSession->increaseTestPass();
                
                $url = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED);
 
                $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_redirect_autosave.html", "Modules/Test");  
                $this->tpl->setVariable("TEXT_REDIRECT", $this->lng->txt("redirectAfterSave"));
                $this->tpl->setCurrentBlock("HeadContent");
                $this->tpl->setVariable("CONTENT_BLOCK", "<meta http-equiv=\"refresh\" content=\"5; url=" . $url . "\">");
                $this->tpl->parseCurrentBlock();
        }

References $url, ilObjTest\_getPass(), ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, getContentBlockName(), and performTestPassFinishedTasks().

Here is the call graph for this function:

redirectBackCmd()

ilTestPlayerAbstractGUI::redirectBackCmd

(

)

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

        {
                require_once 'Modules/Test/classes/class.ilTestPassesSelector.php';
                $testPassesSelector = new ilTestPassesSelector($GLOBALS['ilDB'], $this->object);
                $testPassesSelector->setActiveId($this->testSession->getActiveId());
                $testPassesSelector->setLastFinishedPass($this->testSession->getLastFinishedPass());
 
                if( count($testPassesSelector->getReportablePasses()) )
                {
                        $this->ctrl->redirectByClass("ilTestEvaluationGUI", "outUserResultsOverview");
                }
 
                $this->backToInfoScreenCmd();
        }

References $GLOBALS, and backToInfoScreenCmd().

Referenced by afterTestPassFinishedCmd(), and endingTimeReached().

Here is the call graph for this function:

Here is the caller graph for this function:

registerForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::registerForcedFeedbackNavUrl (   $forcedFeedbackNavUrl )

protected

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

        {
                if( !isset($_SESSION['forced_feedback_navigation_url']) )
                {
                        $_SESSION['forced_feedback_navigation_url'] = array();
                }
                
                $_SESSION['forced_feedback_navigation_url'][$this->testSession->getActiveId()] = $forcedFeedbackNavUrl;
        }

References $_SESSION.

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

Here is the caller graph for this function:

removeIntermediateSolution()

ilTestPlayerAbstractGUI::removeIntermediateSolution

(

)

remove an auto-saved solution of the current question

Returns

mixed number of rows or db error

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

        {
                $questionId = $this->getCurrentQuestionId();
                
                $this->getQuestionInstance($questionId)->removeIntermediateSolution(
                        $this->testSession->getActiveId(), $this->testSession->getPass()
                );
        }

References getCurrentQuestionId(), and getQuestionInstance().

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

Here is the call graph for this function:

Here is the caller graph for this function:

resetSequenceElementParameter()

ilTestPlayerAbstractGUI::resetSequenceElementParameter ( )

protected

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

        {
                unset($_GET['sequence']);
                $this->ctrl->setParameter($this, 'sequence', null);
        }

References $_GET.

Referenced by ilTestPlayerDynamicQuestionSetGUI\resetQuestionIdParameter().

Here is the caller graph for this function:

resumePlayerCmd()

ilTestPlayerAbstractGUI::resumePlayerCmd ( )

abstractprotected

Resume a test at the last position.

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

revertChangesCmd()

ilTestPlayerAbstractGUI::revertChangesCmd ( )

protected

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

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

References removeIntermediateSolution(), setAnswerChangedParameter(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

saveNavigationPreventConfirmation()

ilTestPlayerAbstractGUI::saveNavigationPreventConfirmation ( )

protected

Save the save the switch to prevent the navigation confirmation.

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

        {
                if (!empty($_POST['save_on_navigation_prevent_confirmation']))
                {
                        $_SESSION['save_on_navigation_prevent_confirmation'] = true;
                }
        }

References $_POST, and $_SESSION.

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

Here is the caller graph for this function:

saveQuestionSolution()

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

abstract

saves the user input of a question

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

Referenced by autosaveCmd(), handleIntermediateSubmit(), and submitIntermediateSolutionCmd().

Here is the caller graph for this function:

saveTagsCmd()

ilTestPlayerAbstractGUI::saveTagsCmd

(

)

Save tags for tagging gui.

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

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

        {
                include_once("./Services/Tagging/classes/class.ilTaggingGUI.php");
                $tagging_gui = new ilTaggingGUI();
                $tagging_gui->setObject($this->object->getId(), $this->object->getType());
                $tagging_gui->saveInput();
                $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
        }

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

        {
                if( $this->testSession->isAnonymousUser() )
                {
                        $this->testSession->setAccessCodeToSession($_POST['anonymous_id']);
                }
                
                $this->ctrl->redirectByClass("ilobjtestgui", "infoScreen");
        }

References $_POST.

setAnswerChangedParameter()

ilTestPlayerAbstractGUI::setAnswerChangedParameter (   $changed = true )

protected

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

Parameters

bool

$changed

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

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

References $changed.

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

Here is the caller graph for this function:

showAnswerOptionalQuestionsConfirmation()

ilTestPlayerAbstractGUI::showAnswerOptionalQuestionsConfirmation ( )

protected

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

        {
                require_once 'Modules/Test/classes/confirmations/class.ilTestAnswerOptionalQuestionsConfirmationGUI.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 populateHelperGuiContent().

Referenced by prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

showFinalStatementCmd()

ilTestPlayerAbstractGUI::showFinalStatementCmd

(

)

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

        {
                $template = new ilTemplate("tpl.il_as_tst_final_statement.html", TRUE, TRUE, "Modules/Test");
                $this->ctrl->setParameter($this, "skipfinalstatement", 1);
                $template->setVariable("FORMACTION", $this->ctrl->getFormAction($this, ilTestPlayerCommands::AFTER_TEST_PASS_FINISHED));
                $template->setVariable("FINALSTATEMENT", $this->object->prepareTextareaOutput($this->object->getFinalStatement(), true));
                $template->setVariable("BUTTON_CONTINUE", $this->lng->txt("btn_next"));
                $this->tpl->setVariable($this->getContentBlockName(), $template->get());
        }

References ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, and getContentBlockName().

Here is the call graph for this function:

showInstantResponseCmd()

ilTestPlayerAbstractGUI::showInstantResponseCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

showListOfAnswers()

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

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

Parameters

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

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

        {
                global $ilUser;
 
                $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_finish_list_of_answers.html", "Modules/Test");
 
                $result_array =& $this->object->getTestResult(
                        $active_id, $pass, false, !$this->getObjectiveOrientedContainer()->isObjectiveOrientedPresentationRequired()
                );
 
                $counter = 1;
                // output of questions with solutions
                foreach ($result_array as $question_data)
                {
                        $question = $question_data["qid"];
                        if (is_numeric($question))
                        {
                                $this->tpl->setCurrentBlock("printview_question");
                                $question_gui = $this->object->createQuestionGUI("", $question);
                                $template = new ilTemplate("tpl.il_as_qpl_question_printview.html", TRUE, TRUE, "Modules/TestQuestionPool");
                                $template->setVariable("COUNTER_QUESTION", $counter.". ");
                                $template->setVariable("QUESTION_TITLE", $question_gui->object->getTitle());
                                
                                $show_question_only = ($this->object->getShowSolutionAnswersOnly()) ? TRUE : FALSE;
                                $result_output = $question_gui->getSolutionOutput($active_id, $pass, FALSE, FALSE, $show_question_only, $this->object->getShowSolutionFeedback());                              
                                $template->setVariable("SOLUTION_OUTPUT", $result_output);
                                $this->tpl->setVariable("QUESTION_OUTPUT", $template->get());
                                $this->tpl->parseCurrentBlock();
                                $counter ++;
                        }
                }
 
                $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print.css", "Modules/Test"), "print");
                if ($this->object->getShowSolutionAnswersOnly())
                {
                        $this->tpl->addCss(ilUtil::getStyleSheetLocation("output", "test_print_hide_content.css", "Modules/Test"), "print");
                }
                if (strlen($top_data))
                {
                        $this->tpl->setCurrentBlock("top_data");
                        $this->tpl->setVariable("TOP_DATA", $top_data);
                        $this->tpl->parseCurrentBlock();
                }
                
                if (strlen($bottom_data))
                {
                        $this->tpl->setCurrentBlock("bottom_data");
                        $this->tpl->setVariable("FORMACTION", $this->ctrl->getFormAction($this));
                        $this->tpl->setVariable("BOTTOM_DATA", $bottom_data);
                        $this->tpl->parseCurrentBlock();
                }
                
                $this->tpl->setCurrentBlock("adm_content");
                $this->tpl->setVariable("TXT_ANSWER_SHEET", $this->lng->txt("tst_list_of_answers"));
                $user_data = $this->getAdditionalUsrDataHtmlAndPopulateWindowTitle($this->testSession, $active_id, TRUE);
                $signature = $this->getResultsSignature();
                $this->tpl->setVariable("USER_DETAILS", $user_data);
                $this->tpl->setVariable("SIGNATURE", $signature);
                $this->tpl->setVariable("TITLE", $this->object->getTitle());
                $this->tpl->setVariable("TXT_TEST_PROLOG", $this->lng->txt("tst_your_answers"));
                $invited_user =& $this->object->getInvitedUsers($ilUser->getId());
                $pagetitle = $this->object->getTitle() . " - " . $this->lng->txt("clientip") . 
                        ": " . $invited_user[$ilUser->getId()]["clientip"] . " - " . 
                        $this->lng->txt("matriculation") . ": " . 
                        $invited_user[$ilUser->getId()]["matriculation"];
                $this->tpl->setVariable("PAGETITLE", $pagetitle);
                $this->tpl->parseCurrentBlock();
        }

References $counter, $ilUser, $pass, ilTestServiceGUI\getAdditionalUsrDataHtmlAndPopulateWindowTitle(), getContentBlockName(), ilTestServiceGUI\getObjectiveOrientedContainer(), ilTestServiceGUI\getResultsSignature(), and ilUtil\getStyleSheetLocation().

Here is the call graph for this function:

showMaximumAllowedUsersReachedMessage()

ilTestPlayerAbstractGUI::showMaximumAllowedUsersReachedMessage

(

)

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

        {
                $this->tpl->addBlockFile($this->getContentBlockName(), "adm_content", "tpl.il_as_tst_max_allowed_users_reached.html", "Modules/Test");
                $this->tpl->setCurrentBlock("adm_content");
                $this->tpl->setVariable("MAX_ALLOWED_USERS_MESSAGE", sprintf($this->lng->txt("tst_max_allowed_users_message"), $this->object->getAllowedUsersTimeGap()));
                $this->tpl->setVariable("MAX_ALLOWED_USERS_HEADING", sprintf($this->lng->txt("tst_max_allowed_users_heading"), $this->object->getAllowedUsersTimeGap()));
                $this->tpl->setVariable("CMD_BACK_TO_INFOSCREEN", ilTestPlayerCommands::BACK_TO_INFO_SCREEN);
                $this->tpl->setVariable("TXT_BACK_TO_INFOSCREEN", $this->lng->txt("tst_results_back_introduction"));
                $this->tpl->setVariable("FORMACTION", $this->ctrl->getFormAction($this));
                $this->tpl->parseCurrentBlock();
        }

References ilTestPlayerCommands\BACK_TO_INFO_SCREEN, getContentBlockName(), and sprintf.

Referenced by initTestCmd(), and ilTestPlayerDynamicQuestionSetGUI\resumePlayerCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

showQuestionCmd()

ilTestPlayerAbstractGUI::showQuestionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

showQuestionEditable()

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

protected

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

        {
                $questionNavigationGUI = $this->buildEditableStateQuestionNavigationGUI(
                        $questionGui->object->getId(), $this->populateCharSelectorIfRequired()
                );
                if( $isQuestionWorkedThrough )
                {
                        $questionNavigationGUI->setDiscardSolutionButtonEnabled(true);
// fau: testNav - set answere status in question header
                        $questionGui->getQuestionHeaderBlockBuilder()->setQuestionAnswered(true);
// fau.
                }
                elseif( $this->object->isPostponingEnabled() )
                {
                        $questionNavigationGUI->setSkipQuestionLinkTarget(
                                $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::SKIP_QUESTION)
                        );
                }
                $questionGui->setNavigationGUI($questionNavigationGUI);
 
                $isPostponed = $this->isShowingPostponeStatusReguired($questionGui->object->getId());
                
                $answerFeedbackEnabled = (
                        $instantResponse && $this->object->getSpecificAnswerFeedback()
                );
 
                if( isset($_GET['save_error']) && $_GET['save_error'] == 1 && isset($_SESSION['previouspost']) )
                {
                        $userPostSolution = $_SESSION['previouspost'];
                        unset($_SESSION['previouspost']);
                }
                else
                {
                        $userPostSolution = false;
                }
 
// fau: testNav - add special checkbox for mc question
                if ($questionGui instanceof assMultipleChoiceGUI)
                {
                        $questionGui->setWithNoneAbove($this->object->getMCScoring());
                        $questionGui->setIsAnswered($isQuestionWorkedThrough);
                }
// fau.
                
                // hey: prevPassSolutions - determine solution pass index and configure gui accordingly
                $qstConfig = $questionGui->object->getTestPresentationConfig();
                if( $qstConfig->isPreviousPassSolutionReuseAllowed() )
                {
                        $passIndex = $this->determineSolutionPassIndex($questionGui); // last pass having solution stored
                        if( $passIndex < $this->testSession->getPass() ) // it's the previous pass if current pass is higher
                        {
                                $qstConfig->setSolutionInitiallyPrefilled(true);
                        }
                }
                else
                {
                        $passIndex = $this->testSession->getPass();
                }
                // hey.
                
                // Answer specific feedback is rendered into the display of the test question with in the concrete question types outQuestionForTest-method.
                // Notation of the params prior to getting rid of this crap in favor of a class
                $questionGui->outQuestionForTest(
                        $formAction,                                                    #form_action
                        $this->testSession->getActiveId(),              #active_id
                        // hey: prevPassSolutions - prepared pass index having no, current or previous solution
                        $passIndex,                                                     #pass
                        // hey.
                        $isPostponed,                                                   #is_postponed
                        $userPostSolution,                                              #user_post_solution
                        $answerFeedbackEnabled                                  #answer_feedback == inline_specific_feedback
                );
                // The display of specific inline feedback and specific feedback in an own block is to honor questions, which
                // have the possibility to embed the specific feedback into their output while maintaining compatibility to
                // questions, which do not have such facilities. E.g. there can be no "specific inline feedback" for essay
                // questions, while the multiple-choice questions do well.
 
 
                $this->populateModals();
 
// fau: testNav - pouplate the new question edit control instead of the deprecated intermediate solution saver
                $this->populateQuestionEditControl($questionGui);
// fau.
        }

References $_GET, $_SESSION, buildEditableStateQuestionNavigationGUI(), determineSolutionPassIndex(), assQuestionGUI\getQuestionHeaderBlockBuilder(), isShowingPostponeStatusReguired(), assQuestionGUI\outQuestionForTest(), populateModals(), assQuestionGUI\setNavigationGUI(), and ilTestPlayerCommands\SKIP_QUESTION.

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

Here is the call graph for this function:

Here is the caller graph for this function:

showQuestionViewable()

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

protected

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

        {
                $questionNavigationGUI = $this->buildReadOnlyStateQuestionNavigationGUI($questionGui->object->getId());
                $questionNavigationGUI->setQuestionWorkedThrough($isQuestionWorkedThrough);
                $questionGui->setNavigationGUI($questionNavigationGUI);
                
// fau: testNav - set answere status in question header
                $questionGui->getQuestionHeaderBlockBuilder()->setQuestionAnswered($isQuestionWorkedThrough);
// fau.
 
                $answerFeedbackEnabled = (
                        $instantResponse && $this->object->getSpecificAnswerFeedback()
                );
 
                $solutionoutput = $questionGui->getSolutionOutput(
                        $this->testSession->getActiveId(),      #active_id
                        $this->testSession->getPass(),          #pass
                        false,                                                          #graphical_output
                        false,                                                          #result_output
                        true,                                                           #show_question_only
                        $answerFeedbackEnabled,                         #show_feedback
                        false,                                                          #show_correct_solution
                        false,                                                          #show_manual_scoring
                        true                                                            #show_question_text
                );
 
                $pageoutput = $questionGui->outQuestionPage(
                        "",
                        $this->isShowingPostponeStatusReguired($questionGui->object->getId()),
                        $this->testSession->getActiveId(),
                        $solutionoutput
                );
                
                $this->tpl->setCurrentBlock('readonly_css_class');
                $this->tpl->touchBlock('readonly_css_class');
                $this->tpl->parseCurrentBlock();
 
                $this->tpl->setVariable('QUESTION_OUTPUT', $pageoutput);
 
                $this->tpl->setVariable("FORMACTION", $formAction);
                $this->tpl->setVariable("ENCTYPE", 'enctype="'.$questionGui->getFormEncodingType().'"');
                $this->tpl->setVariable("FORM_TIMESTAMP", time());
        }

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

showRequestedHintListCmd()

ilTestPlayerAbstractGUI::showRequestedHintListCmd ( )

protected

Go to requested hint list.

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

        {
// fau: testNav - handle intermediate submit for viewing requested hints
                $this->handleIntermediateSubmit();
// fau.
 
                $this->ctrl->setParameter($this, 'pmode', self::PRESENTATION_MODE_EDIT);
                
                require_once 'Modules/TestQuestionPool/classes/class.ilAssQuestionHintRequestGUI.php';
                $this->ctrl->redirectByClass('ilAssQuestionHintRequestGUI', ilAssQuestionHintRequestGUI::CMD_SHOW_LIST);
        }

References ilAssQuestionHintRequestGUI\CMD_SHOW_LIST, and handleIntermediateSubmit().

Here is the call graph for this function:

showSideList()

ilTestPlayerAbstractGUI::showSideList (   $presentationMode,   $currentSequenceElement  )

protected

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

        {
                global $ilUser;
 
                $sideListActive = $ilUser->getPref('side_list_of_questions');
 
                if($sideListActive)
                {
                        $this->tpl->addCss(
                                ilUtil::getStyleSheetLocation("output", "ta_split.css", "Modules/Test"), "screen"
                        );
 
                        $questionSummaryData = $this->service->getQuestionSummaryData($this->testSequence, false);
 
                        require_once 'Modules/Test/classes/class.ilTestQuestionSideListGUI.php';
                        $questionSideListGUI = new ilTestQuestionSideListGUI($this->ctrl, $this->lng);
                        $questionSideListGUI->setTargetGUI($this);
                        $questionSideListGUI->setQuestionSummaryData($questionSummaryData);
                        $questionSideListGUI->setCurrentSequenceElement($currentSequenceElement);
// fau: testNav - set side list presentation mode to "view" to allow navigation when question is in edit mode
                        $questionSideListGUI->setCurrentPresentationMode(ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW);
                        $questionSideListGUI->setDisabled(false);
//                      $questionSideListGUI->setCurrentPresentationMode($presentationMode);
//                      $questionSideListGUI->setDisabled($presentationMode == self::PRESENTATION_MODE_EDIT);
// fau.
                        $this->tpl->setVariable('LIST_OF_QUESTIONS', $questionSideListGUI->getHTML());
                }
        }

References $ilUser, ilUtil\getStyleSheetLocation(), and PRESENTATION_MODE_VIEW.

Referenced by prepareTestPage().

Here is the call graph for this function:

Here is the caller graph for this function:

skipQuestionCmd()

ilTestPlayerAbstractGUI::skipQuestionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

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

        {
                $testStartLock = $this->getLockParameter();
                $isFirstTestStartRequest = false;
 
                $this->processLocker->executeTestStartLockOperation(function() use ($testStartLock, &$isFirstTestStartRequest) {
 
                        if($this->testSession->lookupTestStartLock() != $testStartLock)
                        {
                                $this->testSession->persistTestStartLock($testStartLock);
                                $isFirstTestStartRequest = true;
                        }
 
                });
 
                if( $isFirstTestStartRequest )
                {
                        $this->handleUserSettings();
                        $this->ctrl->redirect($this, ilTestPlayerCommands::INIT_TEST);
                }
                
                $this->ctrl->setParameterByClass('ilObjTestGUI', 'lock', $testStartLock);
                $this->ctrl->redirectByClass("ilobjtestgui", "redirectToInfoScreen");
        }

References getLockParameter(), handleUserSettings(), and ilTestPlayerCommands\INIT_TEST.

Here is the call graph for this function:

startTestCmd()

ilTestPlayerAbstractGUI::startTestCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

submitIntermediateSolutionCmd()

ilTestPlayerAbstractGUI::submitIntermediateSolutionCmd ( )

protected

Definition at line 654 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 saveQuestionSolution(), setAnswerChangedParameter(), and ilTestPlayerCommands\SHOW_QUESTION.

Here is the call graph for this function:

submitSolutionCmd()

ilTestPlayerAbstractGUI::submitSolutionCmd ( )

abstractprotected

Reimplemented in ilTestOutputGUI, and ilTestPlayerDynamicQuestionSetGUI.

suspendTestCmd()

ilTestPlayerAbstractGUI::suspendTestCmd

(

)

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

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

Referenced by maxProcessingTimeReached().

Here is the caller graph for this function:

toggleSideListCmd()

ilTestPlayerAbstractGUI::toggleSideListCmd

(

)

Toggle side list.

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

        {
                global $ilUser;
 
                $show_side_list = $ilUser->getPref('side_list_of_questions');
                $ilUser->writePref('side_list_of_questions', !$show_side_list);
                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
        }

References $ilUser, and ilTestPlayerCommands\SHOW_QUESTION.

unmarkQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::unmarkQuestionAndSaveIntermediateCmd ( )

protected

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

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

References handleIntermediateSubmit(), and unmarkQuestionCmd().

Here is the call graph for this function:

unmarkQuestionCmd()

ilTestPlayerAbstractGUI::unmarkQuestionCmd ( )

protected

Set a question unsolved.

Reimplemented in ilTestPlayerDynamicQuestionSetGUI.

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

        {
                $questionId  = $this->testSequence->getQuestionForSequence(
                        $this->getCurrentSequenceElement()
                );
 
                $this->object->setQuestionSetSolved(0, $questionId, $this->testSession->getUserId());
 
                $this->ctrl->redirect($this, ilTestPlayerCommands::SHOW_QUESTION);
        }

References getCurrentSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by unmarkQuestionAndSaveIntermediateCmd().

Here is the call graph for this function:

Here is the caller graph for this function:

unregisterForcedFeedbackNavUrl()

ilTestPlayerAbstractGUI::unregisterForcedFeedbackNavUrl ( )

protected

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

        {
                if( isset($_SESSION['forced_feedback_navigation_url'][$this->testSession->getActiveId()]) )
                {
                        unset($_SESSION['forced_feedback_navigation_url'][$this->testSession->getActiveId()]);
                }
        }

References $_SESSION.

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

Here is the caller graph for this function:

updateWorkingTime()

ilTestPlayerAbstractGUI::updateWorkingTime

(

)

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

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

        {
                if ($_SESSION["active_time_id"])
                {
                        $this->object->updateWorkingTime($_SESSION["active_time_id"]);
                }
                
                $_SESSION["active_time_id"] = $this->object->startWorkingTime(
                        $this->testSession->getActiveId(), $this->testSession->getPass()
                );
        }

References $_SESSION.

Referenced by ilTestOutputGUI\handleQuestionActionCmd(), ilTestOutputGUI\saveQuestionSolution(), and ilTestPlayerDynamicQuestionSetGUI\showQuestionCmd().

Here is the caller graph for this function:

Field Documentation

$assSettings

ilTestPlayerAbstractGUI::$assSettings

protected

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

Referenced by ilTestOutputGUI\adoptUserSolutionsFromPreviousPass(), and getQuestionInstance().

$cachedQuestionGuis

ilTestPlayerAbstractGUI::$cachedQuestionGuis = array()

private

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

$cachedQuestionObjects

ilTestPlayerAbstractGUI::$cachedQuestionObjects = array()

private

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

$cmdCtrl

ilTestPlayerAbstractGUI::$cmdCtrl

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

$endingTimeReached

ilTestPlayerAbstractGUI::$endingTimeReached

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

$maxProcessingTimeReached

ilTestPlayerAbstractGUI::$maxProcessingTimeReached

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

$passwordChecker

ilTestPlayerAbstractGUI::$passwordChecker

protected

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

$processLocker

ilTestPlayerAbstractGUI::$processLocker

protected

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

$ref_id

ilTestPlayerAbstractGUI::$ref_id

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

$saveResult

ilTestPlayerAbstractGUI::$saveResult

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

Referenced by ilTestOutputGUI\saveQuestionSolution(), and ilTestPlayerDynamicQuestionSetGUI\saveQuestionSolution().

$sequence

ilTestPlayerAbstractGUI::$sequence

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

$testSequence

ilTestPlayerAbstractGUI::$testSequence = null

protected

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

Referenced by archiveParticipantSubmission().

$testSession

ilTestPlayerAbstractGUI::$testSession

protected

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

Referenced by checkTestSessionUser(), ensureExistingTestSession(), and handleSkillTriggering().

FIXED_SHUFFLER_SEED_MIN_LENGTH

const ilTestPlayerAbstractGUI::FIXED_SHUFFLER_SEED_MIN_LENGTH = 8

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

Referenced by buildFixedShufflerSeed().

PRESENTATION_MODE_EDIT

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT = 'edit'

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

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

PRESENTATION_MODE_VIEW

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_VIEW = 'view'

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

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

---

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

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