ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5f
class.ilLOUtils.php
Go to the documentation of this file.
1 <?php
2 /* Copyright (c) 1998-2010 ILIAS open source, Extended GPL, see docs/LICENSE */
3 
10 class ilLOUtils
11 {
12 
16  public static function isCompleted($a_cont_oid, $a_test_rid, $a_objective_id, $max_points, $reached, $limit_perc)
17  {
18  include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
19  $settings = ilLOSettings::getInstanceByObjId($a_cont_oid);
20 
21  if(self::lookupRandomTest(ilObject::_lookupObjId($a_test_rid)))
22  {
23  if(!$max_points)
24  {
25  return true;
26  }
27  else
28  {
29  return ($reached / $max_points * 100) >= $limit_perc;
30  }
31  }
32  else
33  {
34  $required_perc = self::lookupObjectiveRequiredPercentage($a_cont_oid, $a_objective_id, $a_test_rid, $max_points);
35 
36  if(!$max_points)
37  {
38  return TRUE;
39  }
40  else
41  {
42  return ($reached / $max_points * 100) >= $required_perc;
43  }
44  }
45  }
46 
53  public static function lookupObjectiveRequiredPercentage($a_container_id, $a_objective_id, $a_test_ref_id, $a_max_points)
54  {
55  include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
56  $settings = ilLOSettings::getInstanceByObjId($a_container_id);
57 
58  include_once './Modules/Course/classes/Objectives/class.ilLOTestAssignments.php';
59  $assignments = ilLOTestAssignments::getInstance($a_container_id);
60  $a_test_type = $assignments->getTypeByTest($a_test_ref_id);
61 
62  if($assignments->isSeparateTest($a_test_ref_id))
63  {
64  include_once './Services/Object/classes/class.ilObjectFactory.php';
65  $factory = new ilObjectFactory();
66  $tst = $factory->getInstanceByRefId($a_test_ref_id, FALSE);
67  if($tst instanceof ilObjTest)
68  {
69  $schema = $tst->getMarkSchema();
70  foreach($schema->getMarkSteps() as $mark)
71  {
72  if($mark->getPassed())
73  {
74  return (int) $mark->getMinimumLevel();
75  }
76  }
77  }
78  }
79 
80 
81 
82  $tst_ref_id = $a_test_ref_id;
83  if(self::lookupRandomTest(ilObject::_lookupObjId($tst_ref_id)))
84  {
85  include_once './Modules/Course/classes/Objectives/class.ilLORandomTestQuestionPools.php';
86  return (int) ilLORandomTestQuestionPools::lookupLimit($a_container_id, $a_objective_id, $a_test_type);
87  }
88  else
89  {
90  include_once './Modules/Course/classes/class.ilCourseObjectiveQuestion.php';
91  $limit = ilCourseObjectiveQuestion::loookupTestLimit(ilObject::_lookupObjId($tst_ref_id), $a_objective_id);
92  return $limit;
93  }
94  }
95 
103  public static function lookupMaxAttempts($a_container_id, $a_objective_id)
104  {
105  include_once './Modules/Course/classes/Objectives/class.ilLOSettings.php';
106  $settings = ilLOSettings::getInstanceByObjId($a_container_id);
107  if($settings->isGeneralQualifiedTestVisible())
108  {
109  return 0;
110  }
111  include_once './Modules/Course/classes/class.ilCourseObjective.php';
112  $max_passes = ilCourseObjective::lookupMaxPasses($a_objective_id);
113 
114  return (int) $max_passes;
115  }
116 
117 
123  public static function lookupRandomTest($a_test_obj_id)
124  {
125  include_once './Modules/Test/classes/class.ilObjTest.php';
126  return ilObjTest::_lookupRandomTest($a_test_obj_id);
127  }
128 
135  public static function lookupQplBySequence($a_test_ref_id, $a_sequence_id)
136  {
137  if(!$a_sequence_id)
138  {
139  return '';
140  }
141  $tst = ilObjectFactory::getInstanceByRefId($a_test_ref_id,false);
142  if(!$tst instanceof ilObjTest)
143  {
144  return '';
145  }
146  include_once './Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionList.php';
147  include_once './Modules/Test/classes/class.ilTestRandomQuestionSetSourcePoolDefinitionFactory.php';
149  $GLOBALS['ilDB'],
150  $tst,
152  $GLOBALS['ilDB'],
153  $tst
154  )
155  );
156 
157  $list->loadDefinitions();
158 
159  include_once './Modules/Test/classes/class.ilTestTaxonomyFilterLabelTranslater.php';
160  $translator = new ilTestTaxonomyFilterLabelTranslater($GLOBALS['ilDB']);
161  $translator->loadLabels($list);
162 
163  $title = '';
164  foreach ($list as $definition)
165  {
166  if($definition->getId() != $a_sequence_id)
167  {
168  continue;
169  }
170  $title = self::buildQplTitleByDefinition($definition, $translator);
171  }
172  return $title;
173  }
174 
180  {
181  $title = $def->getPoolTitle();
182  $tax_id = $def->getMappedFilterTaxId();
183  if($tax_id)
184  {
185  $title .= (' -> '. $trans->getTaxonomyTreeLabel($tax_id));
186  }
187  $tax_node = $def->getMappedFilterTaxNodeId();
188  if($tax_node)
189  {
190  $title .= (' -> ' .$trans->getTaxonomyNodeLabel($tax_node));
191  }
192  return $title;
193  }
194 
195  public static function hasActiveRun($a_container_id, $a_test_ref_id, $a_objective_id)
196  {
197  return FALSE;
198 
199  // check if pass exists
200  include_once './Modules/Test/classes/class.ilObjTest.php';
201  if(
203  $a_test_ref_id,
204  $GLOBALS['ilUser']->getId())
205  )
206  {
207  return false;
208  }
209 
210  // check if multiple pass exists
211  include_once './Modules/Course/classes/Objectives/class.ilLOTestRun.php';
212  $last_objectives = ilLOTestRun::lookupObjectives(
213  $a_container_id,
214  $GLOBALS['ilUser']->getId(),
215  ilObject::_lookupObjId($a_test_ref_id)
216  );
217 
218  if(count((array) $last_objectives) and in_array((int) $a_objective_id, (array) $last_objectives))
219  {
220  return true;
221  }
222  return false;
223  }
224 
225  public static function getTestResultLinkForUser($a_test_ref_id, $a_user_id)
226  {
227  global $ilCtrl, $ilUser, $ilAccess;
228 
229  if($ilUser->getId() == ANONYMOUS_USER_ID)
230  {
231  return;
232  }
233 
234  $valid = $tutor = false;
235  if($a_user_id == $ilUser->getId())
236  {
237  $valid = $ilAccess->checkAccess('read', '', $a_test_ref_id);
238  }
239  if(!$valid)
240  {
241  $valid = $ilAccess->checkAccess('write', '', $a_test_ref_id);
242  $tutor = true;
243  }
244  if($valid)
245  {
246  $testObjId = ilObject::_lookupObjId($a_test_ref_id);
247  if(!$tutor)
248  {
249  require_once 'Modules/Test/classes/class.ilObjTestAccess.php';
250  if(ilObjTestAccess::visibleUserResultExists($testObjId, $a_user_id))
251  {
252  $ilCtrl->setParameterByClass('ilObjTestGUI', 'ref_id', $a_test_ref_id);
253  $link = $ilCtrl->getLinkTargetByClass(array('ilRepositoryGUI', 'ilObjTestGUI'), 'userResultsGateway');
254  $ilCtrl->setParameterByClass('ilObjTestGUI', 'ref_id', '');
255  return $link;
256  }
257  }
258  else
259  {
260  include_once 'Modules/Test/classes/class.ilObjTest.php';
261  $testId = ilObjTest::_getTestIDFromObjectID($testObjId);
262  if($testId)
263  {
264  $userActiveId = ilObjTest::_getActiveIdOfUser($a_user_id, $testId);
265  if($userActiveId)
266  {
267  $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'ref_id', $a_test_ref_id);
268  $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'active_id', $userActiveId);
269  $link = $ilCtrl->getLinkTargetByClass(array('ilRepositoryGUI', 'ilObjTestGUI', 'ilTestEvaluationGUI'), 'outParticipantsResultsOverview');
270  $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'ref_id', '');
271  $ilCtrl->setParameterByClass('ilTestEvaluationGUI', 'active_id', '');
272  return $link;
273  }
274  }
275  }
276  }
277  }
278 }
279 ?>
static isCompleted($a_cont_oid, $a_test_rid, $a_objective_id, $max_points, $reached, $limit_perc)
Check if objective is completed.
static getInstanceByObjId($a_obj_id)
get singleton instance
static loookupTestLimit($a_test_id, $a_objective_id)
static getInstance($a_container_id)
Get instance by container id.
Class ilObjectFactory.
getInstanceByRefId($a_ref_id, $stop_on_error=true)
get an instance of an Ilias object by reference id
_getTestIDFromObjectID($object_id)
Returns the ILIAS test id for a given object id.
static lookupMaxPasses($a_objective_id)
static _lookupRandomTest($a_obj_id)
Returns the fact wether the test with passed obj id is a random questions test or not...
$valid
static hasActiveRun($a_container_id, $a_test_ref_id, $a_objective_id)
global $ilCtrl
Definition: ilias.php:18
static lookupObjectives($a_container_id, $a_user_id, $a_test_id)
static visibleUserResultExists($testObjId, $userId)
static lookupRandomTest($a_test_obj_id)
Check if test is a random test.
static _lookupObjId($a_id)
static lookupObjectiveRequiredPercentage($a_container_id, $a_objective_id, $a_test_ref_id, $a_max_points)
static lookupMaxAttempts($a_container_id, $a_objective_id)
Settings for LO courses.
static getTestResultLinkForUser($a_test_ref_id, $a_user_id)
global $ilUser
Definition: imgupload.php:15
static lookupLimit($a_container_id, $a_objective_id, $a_test_type)
$GLOBALS['PHPCAS_CLIENT']
This global variable is used by the interface class phpCAS.
Definition: CAS.php:276
static isParticipantsLastPassActive($testRefId, $userId)
_getActiveIdOfUser($user_id="", $test_id="")
Gets the active id of the tst_active table for the active user.
static lookupQplBySequence($a_test_ref_id, $a_sequence_id)
Lookup assigned qpl name (including taxonomy) by sequence.
static buildQplTitleByDefinition(ilTestRandomQuestionSetSourcePoolDefinition $def, ilTestTaxonomyFilterLabelTranslater $trans)
build title by definition