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...
	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 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)
	ilTestServiceGUI (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'
	$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 ()
	ensureExistingTestSession (ilTestSession $testSession)
	initProcessLocker ($activeId)
	canSaveResult ()
	determineInlineScoreDisplay ()
	populateTestNavigationToolbar (ilTestNavigationToolbarGUI $toolbarGUI)
	populateQuestionNavigation ($sequenceElement, $disabled)
	populatePreviousButtons ($disabled)
	populateNextButtons ($disabled)
	populateLowerNextButtonBlock ($disabled)
	populateUpperNextButtonBlock ($disabled)
	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 ()
	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 ()
	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 ()
	populateIntermediateSolutionSaver (assQuestionGUI $questionGui)
	populateInstantResponseBlocks (assQuestionGUI $questionGui, $authorizedSolution)
	getCurrentSequenceElement ()
	getSequenceElementParameter ()
	getPresentationModeParameter ()
	getInstantResponseParameter ()
	getNextCommandParameter ()
	getNextSequenceParameter ()
	getQuestionGuiInstance ($questionId, $fromCache=true)
	getQuestionInstance ($questionId, $fromCache=true)
	buildQuestionAnswerShuffler ($questionId)
	handleTearsAndAngerQuestionIsNull ($questionId, $sequenceElement)
	populateMessageContent ($contentHTML)
	populateModals ()
	populateDiscardSolutionModal ()
	populateNavWhileEditModal ()
	getQuestionsDefaultPresentationMode ($isQuestionWorkedThrough)
Protected Member Functions inherited from ilTestServiceGUI
	handleTabs ($activeTabId)
	isPdfDeliveryRequest ()
	getPassDetailsOverviewTableGUI ($result_array, $active_id, $pass, $targetGUI, $targetCMD, $questionDetailsCMD, $questionAnchorNav, ilTestQuestionRelatedObjectivesList $objectivesList=null)
	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)
	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$

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

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

        {
                parent::ilTestServiceGUI($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;
        }

Member Function Documentation

accessCodeConfirmedCmd()

ilTestPlayerAbstractGUI::accessCodeConfirmedCmd

(

)

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

References ilTestPlayerCommands\START_TEST.

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

afterTestPassFinishedCmd()

ilTestPlayerAbstractGUI::afterTestPassFinishedCmd ( )

protected

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

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

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

Here is the call graph for this function:

archiveParticipantSubmission()

ilTestPlayerAbstractGUI::archiveParticipantSubmission (   $active,   $pass  )

protected

Parameters

$active

Returns

void

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

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.

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

Here is the call graph for this function:

autosaveCmd()

ilTestPlayerAbstractGUI::autosaveCmd

(

)

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

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

        {
                $canSaveResult = $this->canSaveResult();
                $authorizedSolution = !$canSaveResult;
                
                $result = "";
                if (is_array($_POST) && count($_POST) > 0)
                {
                        if( $this->isParticipantsAnswerFixed($this->getCurrentQuestionId()) )
                        {
                                $result = '-IGNORE-';
                        }
                        else
                        {
                                $res = $this->saveQuestionSolution($authorizedSolution, true);
                                if ($res)
                                {
                                        $result = $this->lng->txt("autosave_success");
                                }
                                else
                                {
                                        $result = $this->lng->txt("autosave_failed");
                                }
                        }
                }
                if (!$canSaveResult)
                {
                        // this was the last action in the test, saving is no longer allowed
                        $result = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::REDIRECT_ON_TIME_LIMIT, "", true);
                }
                echo $result;
                exit;
        }

Here is the call graph for this function:

backFromFinishingCmd()

ilTestPlayerAbstractGUI::backFromFinishingCmd

(

)

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

References ilTestPlayerCommands\SHOW_QUESTION.

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

backToInfoScreenCmd()

ilTestPlayerAbstractGUI::backToInfoScreenCmd ( )

protected

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

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

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

Here is the caller graph for this function:

buildEditableStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildEditableStateQuestionNavigationGUI (   $questionId,   $charSelectorAvailable  )

protected

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

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

Referenced by showQuestionEditable().

        {
                require_once 'Modules/Test/classes/class.ilTestQuestionNavigationGUI.php';
                $navigationGUI = new ilTestQuestionNavigationGUI($this->lng);
                
                if( $this->object->isForceInstantFeedbackEnabled() )
                {
                        $navigationGUI->setSubmitSolutionCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
                }
                else
                {
                        $navigationGUI->setSubmitSolutionCommand(ilTestPlayerCommands::SUBMIT_SOLUTION_AND_NEXT);
                }
                
                
                // 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"];
                        }

                        if($solved == 1)
                        {
                                $navigationGUI->setQuestionMarkCommand(ilTestPlayerCommands::UNMARK_QUESTION_SAVE);
                                $navigationGUI->setQuestionMarked(true);
                        }
                        else
                        {
                                $navigationGUI->setQuestionMarkCommand(ilTestPlayerCommands::MARK_QUESTION_SAVE);
                                $navigationGUI->setQuestionMarked(false);
                        }
                }

                return $navigationGUI;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

buildNextButtonInstance()

ilTestPlayerAbstractGUI::buildNextButtonInstance (   $disabled )

private

Parameters

$disabled

Returns

ilTestPlayerNavButton

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

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

Referenced by populateLowerNextButtonBlock(), and populateUpperNextButtonBlock().

        {
                $button = ilTestPlayerNavButton::getInstance();
                $button->setPrimary(false);
                $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;
        }

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

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

Referenced by populateLowerPreviousButtonBlock(), and populateUpperPreviousButtonBlock().

        {
                $button = ilTestPlayerNavButton::getInstance();
                $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;
        }

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

Referenced by getQuestionGuiInstance().

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

Here is the caller graph for this function:

buildReadOnlyStateQuestionNavigationGUI()

ilTestPlayerAbstractGUI::buildReadOnlyStateQuestionNavigationGUI (   $questionId )

protected

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

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

Referenced by showQuestionViewable().

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

                        if($solved == 1)
                        {
                                $navigationGUI->setQuestionMarkCommand(ilTestPlayerCommands::UNMARK_QUESTION);
                                $navigationGUI->setQuestionMarked(true);
                        }
                        else
                        {
                                $navigationGUI->setQuestionMarkCommand(ilTestPlayerCommands::MARK_QUESTION);
                                $navigationGUI->setQuestionMarked(false);
                        }
                }

                return $navigationGUI;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

buildTestPassQuestionList()

ilTestPlayerAbstractGUI::buildTestPassQuestionList ( )

abstractprotected

Referenced by handleSkillTriggering().

Here is the caller graph for this function:

cancelAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::cancelAnswerOptionalQuestionsCmd ( )

protected

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

Referenced by autosaveCmd(), and updateWorkingTime().

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.

public

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

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

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

Here is the call graph for this function:

checkReadAccess()

ilTestPlayerAbstractGUI::checkReadAccess ( )

protected

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

Referenced by ilTestOutputGUI\executeCommand().

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

Here is the caller graph for this function:

checkTestExecutable()

ilTestPlayerAbstractGUI::checkTestExecutable ( )

protected

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

References ilUtil\sendInfo().

Referenced by ilTestOutputGUI\executeCommand().

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

Here is the call graph for this function:

Here is the caller graph for this function:

confirmAnswerOptionalQuestionsCmd()

ilTestPlayerAbstractGUI::confirmAnswerOptionalQuestionsCmd ( )

protected

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

References $ilUser, ilTestPlayerCommands\BACK_FROM_FINISHING, finishTestCmd(), and populateHelperGuiContent().

        {
                $this->finishTestCmd(false);
        }

Here is the call graph for this function:

confirmHintRequestCmd()

ilTestPlayerAbstractGUI::confirmHintRequestCmd ( )

protected

Go to hint request confirmation.

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

References ilAssQuestionHintRequestGUI\CMD_CONFIRM_REQUEST, handleQuestionActionCmd(), isFirstQuestionInSequence(), isLastQuestionInSequence(), nextQuestionCmd(), previousQuestionCmd(), saveQuestionSolution(), and showInstantResponseCmd().

        {
                $this->saveQuestionSolution(false);

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

Here is the call graph for this function:

confirmSubmitAnswers()

ilTestPlayerAbstractGUI::confirmSubmitAnswers

(

)

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

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

References getContentBlockName().

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

Here is the call graph for this function:

determineInlineScoreDisplay()

ilTestPlayerAbstractGUI::determineInlineScoreDisplay ( )

protected

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

Referenced by populateInstantResponseBlocks().

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

Here is the caller graph for this function:

determineSolutionPassIndex()

ilTestPlayerAbstractGUI::determineSolutionPassIndex ( assQuestionGUI  $questionGui )

protected

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

References ilObjTest\_getUsePreviousAnswers(), discardSolutionCmd(), editSolutionCmd(), showQuestionCmd(), skipQuestionCmd(), startTestCmd(), and submitSolutionCmd().

Referenced by showQuestionEditable().

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

Here is the call graph for this function:

Here is the caller graph for this function:

discardSolutionCmd()

ilTestPlayerAbstractGUI::discardSolutionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

displayAccessCodeCmd()

ilTestPlayerAbstractGUI::displayAccessCodeCmd

(

)

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

References ilTestPlayerCommands\ACCESS_CODE_CONFIRMED, and getContentBlockName().

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

Here is the call graph for this function:

editSolutionCmd()

ilTestPlayerAbstractGUI::editSolutionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

endingTimeReached()

ilTestPlayerAbstractGUI::endingTimeReached ( )

private

handle endingTimeReached

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

References ilFormat\ftimestamp2datetimeDB(), redirectBackCmd(), and ilUtil\sendInfo().

Referenced by prepareTestPage().

        {
                ilUtil::sendInfo(sprintf($this->lng->txt("detail_ending_time_reached"), ilFormat::ftimestamp2datetimeDB($this->object->getEndingTime())));
                $this->testSession->increasePass();
                $this->testSession->setLastSequence(0);
                $this->testSession->saveToDb();

                $this->redirectBackCmd();
        }

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

References $ilUser, ilTestSession\doesAccessCodeInSessionExists(), ilTestSession\getAccessCodeFromSession(), ilTestSession\getActiveId(), ilTestSession\isAnonymousUser(), ilTestSession\saveToDb(), ilTestSession\setAnonymousId(), and ilTestSession\setUserId().

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

        {
                if( $testSession->getActiveId() )
                {
                        return;
                }

                global $ilUser;
                
                $testSession->setUserId($ilUser->getId());

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

                        $testSession->setAnonymousId($testSession->getAccessCodeFromSession());
                }
                
                $testSession->saveToDb();
        }

Here is the call graph for this function:

Here is the caller graph for this function:

finishTestCmd()

ilTestPlayerAbstractGUI::finishTestCmd

(

$requires_confirmation = true

)

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

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

Referenced by confirmFinishCmd().

        {
                global $ilAuth;

                unset($_SESSION["tst_next"]);

                $active_id = $this->testSession->getActiveId();
                $actualpass = $this->object->_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))
                {
                        $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->testSession->setLastFinishedPass($this->testSession->getPass());
                $this->testSession->increaseTestPass();

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

Here is the call graph for this function:

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

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

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

Here is the caller graph for this function:

getCurrentQuestionId()

ilTestPlayerAbstractGUI::getCurrentQuestionId ( )

abstractprotected

Referenced by autosaveCmd(), and redirectAfterAutosaveCmd().

Here is the caller graph for this function:

getCurrentSequenceElement()

ilTestPlayerAbstractGUI::getCurrentSequenceElement ( )

protected

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

getFinishTestCommand()

ilTestPlayerAbstractGUI::getFinishTestCommand ( )

protected

Returns

string

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

References ilObjTest\allObligationsAnswered().

Referenced by getTestNavigationToolbarGUI().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getInstantResponseParameter()

ilTestPlayerAbstractGUI::getInstantResponseParameter ( )

protected

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

References $_GET.

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

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

                return null;
        }

Here is the caller graph for this function:

getIntroductionPageButtonLabel()

ilTestPlayerAbstractGUI::getIntroductionPageButtonLabel ( )

protected

Returns

string

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

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

getKioskHead()

ilTestPlayerAbstractGUI::getKioskHead

(

)

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

References $ilUser, and ilObjTest\buildExamId().

Referenced by outQuestionSummaryCmd(), and populateKioskHead().

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

Here is the call graph for this function:

Here is the caller graph for this function:

getLockParameter()

ilTestPlayerAbstractGUI::getLockParameter

(

)

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

References $_GET, $_POST, and resumePlayerCmd().

Referenced by handlePasswordProtectionRedirect(), and startPlayerCmd().

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

                return null;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getNextCommandParameter()

ilTestPlayerAbstractGUI::getNextCommandParameter ( )

protected

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

References $_POST.

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

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

                return null;
        }

Here is the caller graph for this function:

getNextSequenceParameter()

ilTestPlayerAbstractGUI::getNextSequenceParameter ( )

protected

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

References $_POST.

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

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

                return null;
        }

Here is the caller graph for this function:

getPresentationModeParameter()

ilTestPlayerAbstractGUI::getPresentationModeParameter ( )

protected

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

References $_GET.

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

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

                return null;
        }

Here is the caller graph for this function:

getQuestionGuiInstance()

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

protected

Parameters

$questionId
$sequenceElement

Returns

object

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

References buildQuestionAnswerShuffler(), OUTPUT_JAVASCRIPT, and assQuestionGUI\PRESENTATION_CONTEXT_TEST.

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

        {
                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->object->setOutputType(OUTPUT_JAVASCRIPT);
                        $questionGui->object->setShuffler($this->buildQuestionAnswerShuffler($questionId));

                        $this->cachedQuestionGuis[$questionId] = $questionGui;
                }
                
                return $this->cachedQuestionGuis[$questionId];
        }

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

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

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

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

                        $this->cachedQuestionObjects[$questionId] = $questionOBJ;
                }
                
                return $this->cachedQuestionObjects[$questionId];
        }

Here is the call graph for this function:

Here is the caller graph for this function:

getQuestionsDefaultPresentationMode()

ilTestPlayerAbstractGUI::getQuestionsDefaultPresentationMode (   $isQuestionWorkedThrough )

protected

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

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

        {
                if( $isQuestionWorkedThrough )
                {
                        return self::PRESENTATION_MODE_VIEW;
                }

                return self::PRESENTATION_MODE_EDIT;
        }

Here is the caller graph for this function:

getSequenceElementParameter()

ilTestPlayerAbstractGUI::getSequenceElementParameter ( )

protected

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

References $_GET.

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

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

                return null;
        }

Here is the caller graph for this function:

getTestNavigationToolbarGUI()

ilTestPlayerAbstractGUI::getTestNavigationToolbarGUI ( )

protected

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

References $ilUser, and getFinishTestCommand().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

handlePasswordProtectionRedirect()

ilTestPlayerAbstractGUI::handlePasswordProtectionRedirect ( )

protected

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

References getLockParameter().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

handleQuestionActionCmd()

ilTestPlayerAbstractGUI::handleQuestionActionCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

handleSkillTriggering()

ilTestPlayerAbstractGUI::handleSkillTriggering ( ilTestSession  $testSession )

protected

Parameters

ilTestSession

$testSession

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

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

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

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

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

References $ilLog, and ilTestPlayerCommands\SHOW_QUESTION.

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

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

Here is the caller graph for this function:

handleUserSettings()

ilTestPlayerAbstractGUI::handleUserSettings

(

)

Handles some form parameters on starting and resuming a test.

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

References $_POST, and $ilUser.

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

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

Here is the caller graph for this function:

initAssessmentSettings()

ilTestPlayerAbstractGUI::initAssessmentSettings ( )

protected

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

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

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

Here is the caller graph for this function:

initProcessLocker()

ilTestPlayerAbstractGUI::initProcessLocker (   $activeId )

protected

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

References $ilDB.

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

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

                $processLockerFactory->setActiveId($activeId);
                
                $this->processLocker = $processLockerFactory->getLocker();
        }

Here is the caller graph for this function:

initTestCmd()

ilTestPlayerAbstractGUI::initTestCmd ( )

protected

Start a test for the first time after a redirect.

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

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

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

Here is the call graph for this function:

initTestPageTemplate()

ilTestPlayerAbstractGUI::initTestPageTemplate ( )

protected

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

References getContentBlockName().

Referenced by prepareTestPage().

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

Here is the call graph for this function:

Here is the caller graph for this function:

isFirstQuestionInSequence()

ilTestPlayerAbstractGUI::isFirstQuestionInSequence (   $sequenceElement )

abstractprotected

Referenced by confirmHintRequestCmd(), and populateQuestionNavigation().

Here is the caller graph for this function:

isLastQuestionInSequence()

ilTestPlayerAbstractGUI::isLastQuestionInSequence (   $sequenceElement )

abstractprotected

Referenced by confirmHintRequestCmd(), and populateQuestionNavigation().

Here is the caller graph for this function:

isMaxProcessingTimeReached()

ilTestPlayerAbstractGUI::isMaxProcessingTimeReached

(

)

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

References $ilUser.

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

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

Here is the caller graph for this function:

isNrOfTriesReached()

ilTestPlayerAbstractGUI::isNrOfTriesReached

(

)

nr of tries exceeded

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

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

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

Here is the caller graph for this function:

isOptionalQuestionAnsweringConfirmationRequired()

ilTestPlayerAbstractGUI::isOptionalQuestionAnsweringConfirmationRequired (   $sequenceElement )

abstractprotected

Referenced by prepareTestPage().

Here is the caller graph for this function:

isParticipantsAnswerFixed()

ilTestPlayerAbstractGUI::isParticipantsAnswerFixed (   $questionId )

protected

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

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

        {
                if( !$this->object->isInstantFeedbackAnswerFixationEnabled() )
                {
                        return false;
                }

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

                return true;
        }

Here is the caller graph for this function:

isQuestionSummaryFinishTestButtonRequired()

ilTestPlayerAbstractGUI::isQuestionSummaryFinishTestButtonRequired ( )

abstractprotected

Referenced by outQuestionSummaryCmd(), and showSideList().

Here is the caller graph for this function:

isShowingPostponeStatusReguired()

ilTestPlayerAbstractGUI::isShowingPostponeStatusReguired (   $questionId )

abstractprotected

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

Here is the caller graph for this function:

isTestAccessible()

ilTestPlayerAbstractGUI::isTestAccessible

(

)

test accessible returns true if the user can perform the test

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

References isMaxProcessingTimeReached(), and isNrOfTriesReached().

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

Here is the call graph for this function:

isTestSignRedirectRequired()

ilTestPlayerAbstractGUI::isTestSignRedirectRequired (   $activeId,   $lastFinishedPass  )

protected

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

References ilSession\get(), and IL_COMP_MODULE.

Referenced by afterTestPassFinishedCmd().

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

Here is the call graph for this function:

Here is the caller graph for this function:

markQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::markQuestionAndSaveIntermediateCmd ( )

protected

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

References markQuestionCmd(), and saveQuestionSolution().

        {
                $this->saveQuestionSolution(false);
                $this->markQuestionCmd();
        }

Here is the call graph for this function:

markQuestionCmd()

ilTestPlayerAbstractGUI::markQuestionCmd ( )

protected

Set a question solved.

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

References getCurrentSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by markQuestionAndSaveIntermediateCmd().

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

Here is the call graph for this function:

Here is the caller graph for this function:

maxProcessingTimeReached()

ilTestPlayerAbstractGUI::maxProcessingTimeReached

(

)

Outputs a message when the maximum processing time is reached.

Outputs a message when the maximum processing time is reached

public

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

References suspendTestCmd().

Referenced by prepareTestPage().

        {
                $this->suspendTestCmd();
        }               

Here is the call graph for this function:

Here is the caller graph for this function:

nextQuestionCmd()

ilTestPlayerAbstractGUI::nextQuestionCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

outCorrectSolution()

ilTestPlayerAbstractGUI::outCorrectSolution

(

)

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

public

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

References $_GET, ilObjStyleSheet\getContentStylePath(), ilTestServiceGUI\getCorrectSolutionOutput(), ilUtil\getStyleSheetLocation(), and ilObjStyleSheet\getSyntaxStylePath().

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

                include_once("./Services/Style/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();
        }

Here is the call graph for this function:

outObligationsOnlySummaryCmd()

ilTestPlayerAbstractGUI::outObligationsOnlySummaryCmd

(

)

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

References outQuestionSummaryCmd().

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

Here is the call graph for this function:

outProcessingTime()

ilTestPlayerAbstractGUI::outProcessingTime

(

$active_id

)

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

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

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

        {
                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 - mktime();
                $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));
                /*
                $formattedStartingTime = ilFormat::formatDate(
                        $date["year"]."-".
                        sprintf("%02d", $date["mon"])."-".
                        sprintf("%02d", $date["mday"])." ".
                        sprintf("%02d", $date["hours"]).":".
                        sprintf("%02d", $date["minutes"]).":".
                        sprintf("%02d", $date["seconds"])
                );
                */
                $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() && preg_match("/(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})/", $this->object->getEndingTime(), $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();
        }

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.

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

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

Referenced by outObligationsOnlySummaryCmd(), and outQuestionSummaryWithObligationsInfoCmd().

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

Here is the call graph for this function:

Here is the caller graph for this function:

outQuestionSummaryWithObligationsInfoCmd()

ilTestPlayerAbstractGUI::outQuestionSummaryWithObligationsInfoCmd

(

)

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

References outQuestionSummaryCmd().

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

Here is the call graph for this function:

outUserResultsOverviewCmd()

ilTestPlayerAbstractGUI::outUserResultsOverviewCmd

(

)

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

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

performTestPassFinishedTasks()

ilTestPlayerAbstractGUI::performTestPassFinishedTasks (   $finishedPass )

protected

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

Referenced by finishTestCmd(), and redirectAfterAutosaveCmd().

        {
                if( !$this->testSession->isSubmitted() )
                {
                        $this->testSession->setSubmitted(1);
                        $this->testSession->setSubmittedTimestamp(date('Y-m-d H:i:s'));
                        $this->testSession->saveToDb();
                }
        }

Here is the caller graph for this function:

populateCharSelectorIfRequired()

ilTestPlayerAbstractGUI::populateCharSelectorIfRequired ( )

protected

Returns

bool $charSelectorAvailable

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

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

Referenced by showQuestionEditable().

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateContentStyleBlock()

ilTestPlayerAbstractGUI::populateContentStyleBlock ( )

protected

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

References ilObjStyleSheet\getContentStylePath().

Referenced by prepareTestPage().

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateDiscardSolutionModal()

ilTestPlayerAbstractGUI::populateDiscardSolutionModal ( )

protected

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

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

Referenced by populateModals().

        {
                $tpl = new ilTemplate('tpl.tst_player_confirmation_modal.html', true, true, 'Modules/Test');
                
                $tpl->setVariable('CONFIRMATION_TEXT', $this->lng->txt('discard_answer_confirmation'));

                $button = ilSubmitButton::getInstance();
                $button->setCommand(ilTestPlayerCommands::DISCARD_SOLUTION);
                $button->setCaption('yes');
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();

                $button = ilLinkButton::getInstance();
                $button->setId('tst_cancel_discard_button');
                $button->setCaption('no');
                $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();
                
                $this->tpl->addJavaScript('Modules/Test/js/ilTestPlayerDiscardSolutionModal.js', true);
        }

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

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

Referenced by populateInstantResponseBlocks().

        {
                $feedback = $question_gui->getGenericFeedbackOutput(
                        $this->testSession->getActiveId(),$this->testSequence->getPass()
                );
                
                if( strlen($feedback) )
                {
                        $cssClass = ( $solutionCorrect ?
                                ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_CORRECT : ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_WRONG 
                        );
                        
                        $this->tpl->setCurrentBlock( "answer_feedback" );
                        $this->tpl->setVariable( "ANSWER_FEEDBACK", $feedback);
                        $this->tpl->setVariable( "ILC_FB_CSS_CLASS", $cssClass);
                        $this->tpl->parseCurrentBlock();
                }
        }

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

References getContentBlockName().

Referenced by confirmFinishCmd(), and showAnswerOptionalQuestionsConfirmation().

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

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

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

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

        {
                // 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
                                $this->testSession->getPass(),                                                      #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);
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

populateIntermediateSolutionSaver()

ilTestPlayerAbstractGUI::populateIntermediateSolutionSaver ( assQuestionGUI  $questionGui )

protected

Parameters

assQuestionGUI

$questionGui

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

References ilTestPlayerCommands\AUTO_SAVE, ilUtil\getJSLocation(), and assQuestionGUI\isAutosaveable().

Referenced by showQuestionEditable().

        {
                $this->tpl->addJavaScript(ilUtil::getJSLocation("autosave.js", "Modules/Test"));

                $this->tpl->setVariable("AUTOSAVE_URL", $this->ctrl->getFormAction(
                        $this, ilTestPlayerCommands::AUTO_SAVE, "", true
                ));

                if( $questionGui->isAutosaveable() && $this->object->getAutosave() )
                {
                        $formAction = $this->ctrl->getLinkTarget($this, ilTestPlayerCommands::AUTO_SAVE, '', false, false);
                        
                        $this->tpl->touchBlock('autosave');
                        $this->tpl->setVariable("AUTOSAVEFORMACTION", $formAction);
                        $this->tpl->setVariable("AUTOSAVEINTERVAL", $this->object->getAutosaveIval());
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

populateKioskHead()

ilTestPlayerAbstractGUI::populateKioskHead ( )

protected

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

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

Referenced by prepareSummaryPage(), and prepareTestPage().

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateLowerNextButtonBlock()

ilTestPlayerAbstractGUI::populateLowerNextButtonBlock (   $disabled )

protected

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

References buildNextButtonInstance().

Referenced by populateNextButtons().

        {
                $button = $this->buildNextButtonInstance($disabled);
                $button->setId('bottomnextbutton');

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateLowerPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateLowerPreviousButtonBlock (   $disabled )

protected

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

References buildPreviousButtonInstance().

Referenced by populatePreviousButtons().

        {
                $button = $this->buildPreviousButtonInstance($disabled);
                $button->setId('bottomprevbutton');

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateMessageContent()

ilTestPlayerAbstractGUI::populateMessageContent (   $contentHTML )

protected

Parameters

$contentHTML

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

References getContentBlockName().

Referenced by ilTestPlayerDynamicQuestionSetGUI\showCheckedQuestionResettingConfirmation().

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateModals()

ilTestPlayerAbstractGUI::populateModals ( )

protected

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

References populateDiscardSolutionModal(), and populateNavWhileEditModal().

Referenced by showQuestionEditable().

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

                if( $this->object->getKioskMode() )
                {
                        $this->tpl->addJavaScript('Services/UICore/lib/bootstrap-3.2.0/dist/js/bootstrap.min.js', true);
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

populateNavWhileEditModal()

ilTestPlayerAbstractGUI::populateNavWhileEditModal ( )

protected

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

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

Referenced by populateModals().

        {
                require_once 'Services/Form/classes/class.ilFormPropertyGUI.php';
                require_once 'Services/Form/classes/class.ilHiddenInputGUI.php';

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

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

                $button = ilSubmitButton::getInstance();
                $button->setCommand(ilTestPlayerCommands::SUBMIT_SOLUTION);
                $button->setCaption('tst_nav_while_edit_modal_save_btn');
                $button->setPrimary(true);
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();

                foreach(array('nextcmd', 'nextseq') as $hiddenPostVar)
                {
                        $nextCmdInp = new ilHiddenInputGUI($hiddenPostVar);
                        $nextCmdInp->setValue('');
                        $tpl->setCurrentBlock('hidden_inputs');
                        $tpl->setVariable('HIDDEN_INPUT', $nextCmdInp->getToolbarHTML());
                        $tpl->parseCurrentBlock();
                }
                
                $button = ilLinkButton::getInstance();
                $this->ctrl->setParameter($this, 'pmode', self::PRESENTATION_MODE_VIEW);
                $button->setId('nextCmdLink');
                $button->setUrl('#');
                $this->ctrl->setParameter($this, 'pmode', $this->getPresentationModeParameter());
                $button->setCaption('tst_nav_while_edit_modal_nosave_btn');
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();

                $button = ilLinkButton::getInstance();
                $button->setId('tst_cancel_nav_while_edit_button');
                $button->setCaption('tst_nav_while_edit_modal_cancel_btn');
                $tpl->setCurrentBlock('buttons');
                $tpl->setVariable('BUTTON', $button->render());
                $tpl->parseCurrentBlock();

                $modal = ilModalGUI::getInstance();
                $modal->setId('tst_nav_while_edit_modal');
                $modal->setHeading($this->lng->txt('tst_nav_while_edit_modal_header'));
                $modal->setBody($tpl->get());
                
                $this->tpl->setCurrentBlock('nav_while_edit_modal');
                $this->tpl->setVariable('NAV_WHILE_EDIT_MODAL', $modal->getHTML());
                $this->tpl->parseCurrentBlock();

                $this->tpl->addJavaScript('Modules/Test/js/ilTestPlayerNavWhileEditModal.js', true);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

populateNextButtons()

ilTestPlayerAbstractGUI::populateNextButtons (   $disabled )

protected

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

References populateLowerNextButtonBlock(), and populateUpperNextButtonBlock().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

populatePreviousButtons()

ilTestPlayerAbstractGUI::populatePreviousButtons (   $disabled )

protected

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

References populateLowerPreviousButtonBlock(), and populateUpperPreviousButtonBlock().

Referenced by populateQuestionNavigation().

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateQuestionNavigation()

ilTestPlayerAbstractGUI::populateQuestionNavigation (   $sequenceElement,   $disabled  )

protected

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

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

Referenced by ilTestOutputGUI\showQuestionCmd().

        {
                if( !$this->isFirstQuestionInSequence($sequenceElement) )
                {
                        $this->populatePreviousButtons($disabled);
                }

                if( !$this->isLastQuestionInSequence($sequenceElement) )
                {
                        $this->populateNextButtons($disabled);
                }
        }

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

Referenced by populateInstantResponseBlocks().

        {
                $scoreInformation = sprintf(
                                $this->lng->txt( "you_received_a_of_b_points" ), $reachedPoints, $maxPoints
                );
                
                $this->tpl->setCurrentBlock( "received_points_information" );
                $this->tpl->setVariable("RECEIVED_POINTS_INFORMATION", $scoreInformation);
                $this->tpl->parseCurrentBlock();
        }

Here is the caller graph for this function:

populateSolutionBlock()

ilTestPlayerAbstractGUI::populateSolutionBlock (   $solutionoutput )

protected

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

Referenced by populateInstantResponseBlocks().

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

Here is the caller graph for this function:

populateSpecificFeedbackBlock()

ilTestPlayerAbstractGUI::populateSpecificFeedbackBlock (   $question_gui )

protected

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

Referenced by populateInstantResponseBlocks().

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

Here is the caller graph for this function:

populateSyntaxStyleBlock()

ilTestPlayerAbstractGUI::populateSyntaxStyleBlock ( )

protected

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

References ilObjStyleSheet\getSyntaxStylePath().

Referenced by prepareTestPage().

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateTestNavigationToolbar()

ilTestPlayerAbstractGUI::populateTestNavigationToolbar ( ilTestNavigationToolbarGUI  $toolbarGUI )

protected

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

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

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

Here is the caller graph for this function:

populateUpperNextButtonBlock()

ilTestPlayerAbstractGUI::populateUpperNextButtonBlock (   $disabled )

protected

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

References buildNextButtonInstance().

Referenced by populateNextButtons().

        {
                $button = $this->buildNextButtonInstance($disabled);
                $button->setId('nextbutton');

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

Here is the call graph for this function:

Here is the caller graph for this function:

populateUpperPreviousButtonBlock()

ilTestPlayerAbstractGUI::populateUpperPreviousButtonBlock (   $disabled )

protected

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

References buildPreviousButtonInstance().

Referenced by populatePreviousButtons().

        {
                $button = $this->buildPreviousButtonInstance($disabled);
                $button->setId('prevbutton');

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

Here is the call graph for this function:

Here is the caller graph for this function:

prepareSummaryPage()

ilTestPlayerAbstractGUI::prepareSummaryPage ( )

protected

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

References getContentBlockName(), and populateKioskHead().

Referenced by ilTestPlayerDynamicQuestionSetGUI\showQuestionSelectionCmd().

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

                if ($this->object->getKioskMode())
                {
                        $this->populateKioskHead();
                }
        }

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

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

previousQuestionCmd()

ilTestPlayerAbstractGUI::previousQuestionCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

redirectAfterAutosaveCmd()

ilTestPlayerAbstractGUI::redirectAfterAutosaveCmd

(

)

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

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

        {
                $active_id = $this->testSession->getActiveId();
                $actualpass = $this->object->_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();
        }

Here is the call graph for this function:

redirectBackCmd()

ilTestPlayerAbstractGUI::redirectBackCmd

(

)

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

References $GLOBALS, and backToInfoScreenCmd().

Referenced by afterTestPassFinishedCmd(), and endingTimeReached().

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

Here is the call graph for this function:

Here is the caller graph for this function:

resumePlayerCmd()

ilTestPlayerAbstractGUI::resumePlayerCmd ( )

abstractprotected

Resume a test at the last position.

Referenced by getLockParameter().

Here is the caller graph for this function:

saveQuestionSolution()

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

abstract

saves the user input of a question

Referenced by autosaveCmd(), confirmHintRequestCmd(), markQuestionAndSaveIntermediateCmd(), showRequestedHintListCmd(), submitIntermediateSolutionCmd(), unmarkQuestionAndSaveIntermediateCmd(), and updateWorkingTime().

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

References $_POST.

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

showAnswerOptionalQuestionsConfirmation()

ilTestPlayerAbstractGUI::showAnswerOptionalQuestionsConfirmation ( )

protected

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

References populateHelperGuiContent().

Referenced by prepareTestPage().

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

Here is the call graph for this function:

Here is the caller graph for this function:

showFinalStatementCmd()

ilTestPlayerAbstractGUI::showFinalStatementCmd

(

)

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

References ilTestPlayerCommands\AFTER_TEST_PASS_FINISHED, and getContentBlockName().

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

Here is the call graph for this function:

showInstantResponseCmd()

ilTestPlayerAbstractGUI::showInstantResponseCmd ( )

abstractprotected

Referenced by confirmHintRequestCmd().

Here is the caller graph for this function:

showListOfAnswers()

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

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

Parameters

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

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

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

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

Here is the call graph for this function:

showMaximumAllowedUsersReachedMessage()

ilTestPlayerAbstractGUI::showMaximumAllowedUsersReachedMessage

(

)

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

References ilTestPlayerCommands\BACK_TO_INFO_SCREEN, and getContentBlockName().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

showQuestionCmd()

ilTestPlayerAbstractGUI::showQuestionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

showQuestionEditable()

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

protected

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

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

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

        {
                $questionNavigationGUI = $this->buildEditableStateQuestionNavigationGUI(
                        $questionGui->object->getId(), $this->populateCharSelectorIfRequired()
                );
                if( $isQuestionWorkedThrough )
                {
                        $questionNavigationGUI->setDiscardSolutionButtonEnabled(true);
                }
                else
                {
                        $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;
                }

                // hey: prevPassSolutions - determine solution pass index and configure gui accordingly 
                $solutionPassIndex = $this->determineSolutionPassIndex($questionGui);
                $questionGui->setPreviousSolutionPrefilled($solutionPassIndex < $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
                        $solutionPassIndex,                                     #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();

                $this->populateIntermediateSolutionSaver($questionGui);
        }

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

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

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

        {
                $questionNavigationGUI = $this->buildReadOnlyStateQuestionNavigationGUI($questionGui->object->getId());
                $questionNavigationGUI->setQuestionWorkedThrough($isQuestionWorkedThrough);
                $questionGui->setNavigationGUI($questionNavigationGUI);
                
                $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());
        }

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

References ilAssQuestionHintRequestGUI\CMD_SHOW_LIST, and saveQuestionSolution().

        {
                $this->saveQuestionSolution(false);

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

Here is the call graph for this function:

showSideList()

ilTestPlayerAbstractGUI::showSideList (   $presentationMode,   $currentSequenceElement  )

protected

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

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

Referenced by prepareTestPage().

        {
                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);
                        $questionSideListGUI->setCurrentPresentationMode($presentationMode);
                        $questionSideListGUI->setDisabled($presentationMode == self::PRESENTATION_MODE_EDIT);
                        $this->tpl->setVariable('LIST_OF_QUESTIONS', $questionSideListGUI->getHTML());
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

skipQuestionCmd()

ilTestPlayerAbstractGUI::skipQuestionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

startPlayerCmd()

ilTestPlayerAbstractGUI::startPlayerCmd ( )

protected

Start a test for the first time.

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

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

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

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

                $this->processLocker->requestTestStartLockCheckLock();
                
                if( $this->testSession->lookupTestStartLock() != $testStartLock )
                {
                        $this->testSession->persistTestStartLock($testStartLock);
                        $isFirstTestStartRequest = true;
                }

                $this->processLocker->releaseTestStartLockCheckLock();
                
                if( $isFirstTestStartRequest )
                {
                        $this->handleUserSettings();
                        $this->ctrl->redirect($this, ilTestPlayerCommands::INIT_TEST);
                }
                
                $this->ctrl->setParameterByClass('ilObjTestGUI', 'lock', $testStartLock);
                $this->ctrl->redirectByClass("ilobjtestgui", "redirectToInfoScreen");
        }

Here is the call graph for this function:

startTestCmd()

ilTestPlayerAbstractGUI::startTestCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

submitIntermediateSolutionCmd()

ilTestPlayerAbstractGUI::submitIntermediateSolutionCmd ( )

protected

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

References saveQuestionSolution(), and ilTestPlayerCommands\SHOW_QUESTION.

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

Here is the call graph for this function:

submitSolutionCmd()

ilTestPlayerAbstractGUI::submitSolutionCmd ( )

abstractprotected

Referenced by determineSolutionPassIndex().

Here is the caller graph for this function:

suspendTestCmd()

ilTestPlayerAbstractGUI::suspendTestCmd

(

)

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

Referenced by maxProcessingTimeReached().

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

Here is the caller graph for this function:

toggleSideListCmd()

ilTestPlayerAbstractGUI::toggleSideListCmd

(

)

Toggle side list.

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

References $ilUser, and ilTestPlayerCommands\SHOW_QUESTION.

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

unmarkQuestionAndSaveIntermediateCmd()

ilTestPlayerAbstractGUI::unmarkQuestionAndSaveIntermediateCmd ( )

protected

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

References saveQuestionSolution(), and unmarkQuestionCmd().

        {
                $this->saveQuestionSolution(false);
                $this->unmarkQuestionCmd();
        }

Here is the call graph for this function:

unmarkQuestionCmd()

ilTestPlayerAbstractGUI::unmarkQuestionCmd ( )

protected

Set a question unsolved.

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

References getCurrentSequenceElement(), and ilTestPlayerCommands\SHOW_QUESTION.

Referenced by unmarkQuestionAndSaveIntermediateCmd().

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

updateWorkingTime()

ilTestPlayerAbstractGUI::updateWorkingTime

(

)

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

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

References $_SESSION, canSaveResult(), and saveQuestionSolution().

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$assSettings

ilTestPlayerAbstractGUI::$assSettings

protected

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

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

$cachedQuestionGuis

ilTestPlayerAbstractGUI::$cachedQuestionGuis = array()

private

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

$cachedQuestionObjects

ilTestPlayerAbstractGUI::$cachedQuestionObjects = array()

private

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

$cmdCtrl

ilTestPlayerAbstractGUI::$cmdCtrl

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

$endingTimeReached

ilTestPlayerAbstractGUI::$endingTimeReached

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

$maxProcessingTimeReached

ilTestPlayerAbstractGUI::$maxProcessingTimeReached

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

$passwordChecker

ilTestPlayerAbstractGUI::$passwordChecker

protected

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

$processLocker

ilTestPlayerAbstractGUI::$processLocker

protected

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

$ref_id

ilTestPlayerAbstractGUI::$ref_id

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

$saveResult

ilTestPlayerAbstractGUI::$saveResult

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

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

$sequence

ilTestPlayerAbstractGUI::$sequence

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

$testSequence

ilTestPlayerAbstractGUI::$testSequence = null

protected

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

Referenced by archiveParticipantSubmission().

$testSession

ilTestPlayerAbstractGUI::$testSession

protected

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

PRESENTATION_MODE_EDIT

const ilTestPlayerAbstractGUI::PRESENTATION_MODE_EDIT = 'edit'

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

Referenced by ilTestPlayerDynamicQuestionSetGUI\editSolutionCmd(), ilTestOutputGUI\editSolutionCmd(), ilTestPlayerDynamicQuestionSetGUI\showInstantResponseCmd(), 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 ilTestPlayerDynamicQuestionSetGUI\discardSolutionCmd(), ilTestOutputGUI\discardSolutionCmd(), ilTestPlayerDynamicQuestionSetGUI\showInstantResponseCmd(), ilTestOutputGUI\showQuestionCmd(), ilTestPlayerDynamicQuestionSetGUI\showQuestionCmd(), ilTestPlayerDynamicQuestionSetGUI\submitSolutionCmd(), and ilTestOutputGUI\submitSolutionCmd().

---

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

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