ilLOUtils Class Reference

Settings for LO courses. More...

Collaboration diagram for ilLOUtils:

Static Public Member Functions
static	isCompleted ($a_cont_oid, $a_test_rid, $a_objective_id, $max_points, $reached, $limit_perc)
	Check if objective is completed. More...
static	lookupObjectiveRequiredPercentage ($a_container_id, $a_objective_id, $a_test_ref_id, $a_max_points)
static	lookupMaxAttempts ($a_container_id, $a_objective_id)
static	lookupRandomTest ($a_test_obj_id)
	Check if test is a random test. More...
static	lookupQplBySequence ($a_test_ref_id, $a_sequence_id)
	Lookup assigned qpl name (including taxonomy) by sequence. More...
static	hasActiveRun ($a_container_id, $a_test_ref_id, $a_objective_id)
static	getTestResultLinkForUser ($a_test_ref_id, $a_user_id)

Static Protected Member Functions
static	buildQplTitleByDefinition (ilTestRandomQuestionSetSourcePoolDefinition $def, ilTestTaxonomyFilterLabelTranslater $trans)
	build title by definition More...

Detailed Description

Settings for LO courses.

Author

Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

Definition at line 10 of file class.ilLOUtils.php.

Member Function Documentation

buildQplTitleByDefinition()

static ilLOUtils::buildQplTitleByDefinition ( ilTestRandomQuestionSetSourcePoolDefinition  $def, ilTestTaxonomyFilterLabelTranslater  $trans  )

staticprotected

build title by definition

Parameters

ilTestRandomQuestionSetSourcePoolDefinition

$def

Definition at line 179 of file class.ilLOUtils.php.

        {
                $title = $def->getPoolTitle();
                $tax_id = $def->getMappedFilterTaxId();
                if($tax_id)
                {
                        $title .= (' -> '. $trans->getTaxonomyTreeLabel($tax_id));
                }
                $tax_node = $def->getMappedFilterTaxNodeId();
                if($tax_node)
                {
                        $title .= (' -> ' .$trans->getTaxonomyNodeLabel($tax_node));
                }
                return $title;
        }

References ilTestRandomQuestionSetSourcePoolDefinition\getMappedFilterTaxId(), ilTestRandomQuestionSetSourcePoolDefinition\getMappedFilterTaxNodeId(), ilTestRandomQuestionSetSourcePoolDefinition\getPoolTitle(), and ilTestTaxonomyFilterLabelTranslater\getTaxonomyTreeLabel().

Referenced by lookupQplBySequence().

Here is the call graph for this function:

Here is the caller graph for this function:

getTestResultLinkForUser()

static ilLOUtils::getTestResultLinkForUser (   $a_test_ref_id,   $a_user_id  )

static

Definition at line 225 of file class.ilLOUtils.php.

        {
                global $ilCtrl, $ilUser, $ilAccess;
                
                if($ilUser->getId() == ANONYMOUS_USER_ID)
                {
                        return;
                }
                                
                $valid = $tutor = false;
                if($a_user_id == $ilUser->getId())
                {
                        $valid = $ilAccess->checkAccess('read', '', $a_test_ref_id);
                }               
                if(!$valid)
                {                       
                        $valid = $ilAccess->checkAccess('write', '', $a_test_ref_id);
                        $tutor = true;
                }
                if($valid)
                {
                        $testObjId = ilObject::_lookupObjId($a_test_ref_id);
                        if(!$tutor)
                        {                                       
                                require_once 'Modules/Test/classes/class.ilObjTestAccess.php';
                                if(ilObjTestAccess::visibleUserResultExists($testObjId, $a_user_id))
                                {       
                                        $ilCtrl->setParameterByClass('ilObjTestGUI', 'ref_id', $a_test_ref_id);
                                        $link = $ilCtrl->getLinkTargetByClass(array('ilRepositoryGUI', 'ilObjTestGUI'), 'userResultsGateway');
                                        $ilCtrl->setParameterByClass('ilObjTestGUI', 'ref_id', '');
                                        return $link;
                                }
                        }
                        else
                        {
                                include_once 'Modules/Test/classes/class.ilObjTest.php';
                                $testId = ilObjTest::_getTestIDFromObjectID($testObjId);
                                if($testId)
                                {                                       
                                        $userActiveId = ilObjTest::_getActiveIdOfUser($a_user_id, $testId);             
                                        if($userActiveId)
                                        {
                                                $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'ref_id', $a_test_ref_id);
                                                $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'active_id', $userActiveId);
                                                $link = $ilCtrl->getLinkTargetByClass(array('ilRepositoryGUI', 'ilObjTestGUI', 'ilTestEvaluationGUI'), 'outParticipantsResultsOverview');
                                                $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'ref_id', '');
                                                $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'active_id', '');
                                                return $link;
                                        }
                                }                       
                        }                       
                }
        }

References $ilCtrl, $ilUser, $valid, ilObjTest\_getActiveIdOfUser(), ilObjTest\_getTestIDFromObjectID(), ilObject\_lookupObjId(), and ilObjTestAccess\visibleUserResultExists().

Referenced by ilContainerObjectiveGUI\buildObjectiveProgressBar(), and ilLOMemberTestResultTableGUI\createTestResultLink().

Here is the call graph for this function:

Here is the caller graph for this function:

hasActiveRun()

static ilLOUtils::hasActiveRun (   $a_container_id,   $a_test_ref_id,   $a_objective_id  )

static

Definition at line 195 of file class.ilLOUtils.php.

        {
                return FALSE;
                
                // check if pass exists
                include_once './Modules/Test/classes/class.ilObjTest.php';
                if(
                        !ilObjTest::isParticipantsLastPassActive(
                                $a_test_ref_id,
                                $GLOBALS['ilUser']->getId())
                )
                {
                        return false;
                }
 
                // check if multiple pass exists
                include_once './Modules/Course/classes/Objectives/class.ilLOTestRun.php';
                $last_objectives = ilLOTestRun::lookupObjectives(
                                $a_container_id, 
                                $GLOBALS['ilUser']->getId(),
                                ilObject::_lookupObjId($a_test_ref_id)
                );
                
                if(count((array) $last_objectives) and in_array((int) $a_objective_id, (array) $last_objectives))
                {
                        return true;
                }
                return false;
        }

References $GLOBALS, ilObject\_lookupObjId(), ilObjTest\isParticipantsLastPassActive(), and ilLOTestRun\lookupObjectives().

Referenced by ilContainerObjectiveGUI\showObjectives().

Here is the call graph for this function:

Here is the caller graph for this function:

isCompleted()

static ilLOUtils::isCompleted (   $a_cont_oid,   $a_test_rid,   $a_objective_id,   $max_points,   $reached,   $limit_perc  )

static

Check if objective is completed.

Definition at line 16 of file class.ilLOUtils.php.

        {
                include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
                $settings = ilLOSettings::getInstanceByObjId($a_cont_oid);
                
                if(self::lookupRandomTest(ilObject::_lookupObjId($a_test_rid)))
                {
                        if(!$max_points)
                        {
                                return true;
                        }
                        else
                        {
                                return ($reached / $max_points * 100) >= $limit_perc;
                        }
                }
                else
                {
                        $required_perc = self::lookupObjectiveRequiredPercentage($a_cont_oid, $a_objective_id, $a_test_rid, $max_points);
                        
                        if(!$max_points)
                        {
                                return TRUE;
                        }
                        else
                        {
                                return ($reached / $max_points * 100) >= $required_perc;
                        }
                }
        }

References ilObject\_lookupObjId(), ilLOSettings\getInstanceByObjId(), and lookupObjectiveRequiredPercentage().

Referenced by ilLOTestQuestionAdapter\updateQuestionResult().

Here is the call graph for this function:

Here is the caller graph for this function:

lookupMaxAttempts()

static ilLOUtils::lookupMaxAttempts (   $a_container_id,   $a_objective_id  )

static

Parameters

type	$a_container_id
type	$a_objective_id
type	$a_passes

Returns

boolean

Definition at line 103 of file class.ilLOUtils.php.

        {
                include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
                $settings = ilLOSettings::getInstanceByObjId($a_container_id);
                if($settings->isGeneralQualifiedTestVisible())
                {
                        return 0;
                }
                include_once './Modules/Course/classes/class.ilCourseObjective.php';
                $max_passes = ilCourseObjective::lookupMaxPasses($a_objective_id);
                
                return (int) $max_passes;
        }

References ilLOSettings\getInstanceByObjId(), and ilCourseObjective\lookupMaxPasses().

Referenced by ilLOTestQuestionAdapter\initUserResult().

Here is the call graph for this function:

Here is the caller graph for this function:

lookupObjectiveRequiredPercentage()

static ilLOUtils::lookupObjectiveRequiredPercentage (   $a_container_id,   $a_objective_id,   $a_test_ref_id,   $a_max_points  )

static

Parameters

type	$a_container_id
type	$a_objective_id
type	$a_test_type

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

        {
                include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
                $settings = ilLOSettings::getInstanceByObjId($a_container_id);
                
                include_once './Modules/Course/classes/Objectives/class.ilLOTestAssignments.php';
                $assignments = ilLOTestAssignments::getInstance($a_container_id);
                $a_test_type = $assignments->getTypeByTest($a_test_ref_id);
                
                if($assignments->isSeparateTest($a_test_ref_id))
                {
                        include_once './Services/Object/classes/class.ilObjectFactory.php';
                        $factory = new ilObjectFactory();
                        $tst = $factory->getInstanceByRefId($a_test_ref_id, FALSE);
                        if($tst instanceof ilObjTest)
                        {
                                $schema = $tst->getMarkSchema();
                                foreach($schema->getMarkSteps() as $mark)
                                {
                                        if($mark->getPassed())
                                        {
                                                return (int) $mark->getMinimumLevel();
                                        }
                                }
                        }
                }
                
                
                
                $tst_ref_id = $a_test_ref_id;
                if(self::lookupRandomTest(ilObject::_lookupObjId($tst_ref_id)))
                {
                        include_once './Modules/Course/classes/Objectives/class.ilLORandomTestQuestionPools.php';
                        return (int) ilLORandomTestQuestionPools::lookupLimit($a_container_id, $a_objective_id, $a_test_type);
                }
                else
                {
                        include_once './Modules/Course/classes/class.ilCourseObjectiveQuestion.php';
                        $limit = ilCourseObjectiveQuestion::loookupTestLimit(ilObject::_lookupObjId($tst_ref_id), $a_objective_id);
                        return $limit;
                }
        }

References ilObject\_lookupObjId(), ilLOTestAssignments\getInstance(), ilLOSettings\getInstanceByObjId(), ilLORandomTestQuestionPools\lookupLimit(), and ilCourseObjectiveQuestion\loookupTestLimit().

Referenced by ilLOTestQuestionAdapter\initUserResult(), and isCompleted().

Here is the call graph for this function:

Here is the caller graph for this function:

lookupQplBySequence()

static ilLOUtils::lookupQplBySequence (   $a_test_ref_id,   $a_sequence_id  )

static

Lookup assigned qpl name (including taxonomy) by sequence.

Parameters

type	$a_test_ref_id
type	$a_sequence_id

Returns

string

Definition at line 135 of file class.ilLOUtils.php.

        {
                if(!$a_sequence_id)
                {
                        return '';
                }
                $tst = ilObjectFactory::getInstanceByRefId($a_test_ref_id,false);
                if(!$tst instanceof ilObjTest)
                {
                        return '';
                }
                include_once './Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionList.php';
                include_once './Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionFactory.php';
                $list = new ilTestRandomQuestionSetSourcePoolDefinitionList(
                                $GLOBALS['ilDB'],
                                $tst,
                                new ilTestRandomQuestionSetSourcePoolDefinitionFactory(
                                                $GLOBALS['ilDB'],
                                                $tst
                                )
                );
                                
                $list->loadDefinitions();
 
                include_once './Modules/Test/classes/class.ilTestTaxonomyFilterLabelTranslater.php';
                $translator = new ilTestTaxonomyFilterLabelTranslater($GLOBALS['ilDB']);
                $translator->loadLabels($list);
                
                $title = '';
                foreach ($list as $definition)
                {
                        if($definition->getId() != $a_sequence_id)
                        {
                                continue;
                        }
                        $title = self::buildQplTitleByDefinition($definition, $translator);
                }
                return $title;
        }

References $GLOBALS, buildQplTitleByDefinition(), and ilObjectFactory\getInstanceByRefId().

Referenced by ilCourseObjectivesTableGUI\parse().

Here is the call graph for this function:

Here is the caller graph for this function:

lookupRandomTest()

static ilLOUtils::lookupRandomTest (   $a_test_obj_id )

static

Check if test is a random test.

Parameters

type

$a_test_obj_id

Returns

bool

Definition at line 123 of file class.ilLOUtils.php.

        {
                include_once './Modules/Test/classes/class.ilObjTest.php';
                return ilObjTest::_lookupRandomTest($a_test_obj_id);
        }

References ilObjTest\_lookupRandomTest().

Referenced by ilLOEditorStatus\lookupQuestionsAssigned(), and ilCourseObjectivesTableGUI\parse().

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• Modules/Course/classes/Objectives/class.ilLOUtils.php