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	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 168 of file class.ilLOUtils.php.

    {
        $title = $def->getPoolTitle();
        // fau: taxFilter/typeFilter - get title for extended filter conditions
        $filterTitle = array();
        $filterTitle[] = $trans->getTaxonomyFilterLabel($def->getMappedTaxonomyFilter());
        $filterTitle[] = $trans->getTypeFilterLabel($def->getTypeFilter());
        if (!empty($filterTitle)) {
            $title .= ' -> ' . implode(' / ', $filterTitle);
        }
        #$tax_id = $def->getMappedFilterTaxId();
        #if($tax_id)
        #{
        #       $title .= (' -> '. $trans->getTaxonomyTreeLabel($tax_id));
        #}
        #$tax_node = $def->getMappedFilterTaxNodeId();
        #if($tax_node)
        #{
        #       $title .= (' -> ' .$trans->getTaxonomyNodeLabel($tax_node));
        #}
        // fau.
        return $title;
    }

References $def, $title, ilTestTaxonomyFilterLabelTranslater\getTaxonomyFilterLabel(), and ilTestTaxonomyFilterLabelTranslater\getTypeFilterLabel().

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 221 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 192 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:

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 44 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 $factory, $schema, 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 128 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, $list, $title, $translator, 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 116 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