ILIAS  release_5-0 Revision 5.0.0-1144-gc4397b1f87
ilLearningProgress Class Reference
+ Collaboration diagram for ilLearningProgress:

Public Member Functions

 ilLearningProgress ()
 
 _getProgress ($a_user_id, $a_obj_id)
 

Static Public Member Functions

static _tracProgress ($a_user_id, $a_obj_id, $a_ref_id, $a_obj_type='')
 
static _lookupProgressByObjId ($a_obj_id)
 lookup progress for a specific object More...
 

Data Fields

 $db = null
 

Detailed Description

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

Member Function Documentation

◆ _getProgress()

ilLearningProgress::_getProgress (   $a_user_id,
  $a_obj_id 
)

Definition at line 61 of file class.ilLearningProgress.php.

References $row, ilChangeEvent\_lookupReadEvents(), IL_CAL_TIMESTAMP, and IL_CAL_UNIX.

Referenced by ilLearningProgressBaseGUI\__appendLPDetails(), and ilInfoScreenGUI\showLearningProgress().

62  {
63  require_once 'Services/Tracking/classes/class.ilChangeEvent.php';
64  $events = ilChangeEvent::_lookupReadEvents($a_obj_id, $a_user_id);
65 
66  include_once './Services/Calendar/classes/class.ilDateTime.php';
67 
68  foreach($events as $row)
69  {
70  $tmp_date = new ilDateTime($row['last_access'],IL_CAL_UNIX);
71  $row['last_access'] = $tmp_date->get(IL_CAL_TIMESTAMP);
72 
73  if ($progress)
74  {
75  $progress['spent_seconds'] += $row['spent_seconds'];
76  $progress['access_time'] = max($progress['access_time'], $row['last_access']);
77  }
78  else
79  {
80  $progress['obj_id'] = $row['obj_id'];
81  $progress['user_id'] = $row['usr_id'];
82  $progress['spent_seconds'] = $row['spent_seconds'];
83  $progress['access_time'] = $row['last_access'];
84  $progress['visits'] = $row['read_count'];
85  }
86  }
87  return $progress ? $progress : array();
88  }
const IL_CAL_UNIX
Date and time handling
static _lookupReadEvents($obj_id, $usr_id=null)
Reads all read events which occured on the object which happened after the last time the user caught ...
const IL_CAL_TIMESTAMP
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _lookupProgressByObjId()

static ilLearningProgress::_lookupProgressByObjId (   $a_obj_id)
static

lookup progress for a specific object

public

Parameters
intobj_id
Returns
array of progress data

Definition at line 97 of file class.ilLearningProgress.php.

References $row, and ilChangeEvent\_lookupReadEvents().

Referenced by ilObjCourseGUI\fetchPrintMemberData(), ilObjGroupGUI\readMemberData(), and ilObjCourseGUI\readMemberData().

98  {
99  include_once('./Services/Tracking/classes/class.ilChangeEvent.php');
100  foreach(ilChangeEvent::_lookupReadEvents($a_obj_id) as $row)
101  {
102  if(isset($progress[$row['usr_id']]))
103  {
104  $progress[$row['usr_id']]['spent_seconds'] += $row['spent_seconds'];
105  $progress[$row['usr_id']]['read_count'] += $row['read_count'];
106  $progress[$row['usr_id']]['ts'] = max($row['last_access'],$progress[$row['usr_id']]['ts']);
107  }
108  else
109  {
110  $progress[$row['usr_id']]['spent_seconds'] = $row['spent_seconds'];
111  $progress[$row['usr_id']]['read_count'] = $row['read_count'];
112  $progress[$row['usr_id']]['ts'] = $row['last_access'];
113 
114  }
115  $progress[$row['usr_id']]['usr_id'] = $row['usr_id'];
116  $progress[$row['usr_id']]['obj_id'] = $row['obj_id'];
117  }
118  return $progress ? $progress : array();
119  }
static _lookupReadEvents($obj_id, $usr_id=null)
Reads all read events which occured on the object which happened after the last time the user caught ...
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _tracProgress()

static ilLearningProgress::_tracProgress (   $a_user_id,
  $a_obj_id,
  $a_ref_id,
  $a_obj_type = '' 
)
static

Definition at line 48 of file class.ilLearningProgress.php.

References $ilDB, ilChangeEvent\_recordReadEvent(), and ilLPStatus\setInProgressIfNotAttempted().

Referenced by ilTestSessionDynamicQuestionSet\saveToDb(), ilTestSession\saveToDb(), ilObjFileBasedLMGUI\showLearningModule(), ilObjExerciseGUI\showOverviewObject(), ilLMTracker\trackAccess(), ilObjCourseGUI\viewObject(), and ilObjGroupGUI\viewObject().

49  {
50  global $ilDB;
51 
52  require_once('Services/Tracking/classes/class.ilChangeEvent.php');
53  ilChangeEvent::_recordReadEvent($a_obj_type, $a_ref_id, $a_obj_id, $a_user_id);
54 
55  require_once 'Services/Tracking/classes/class.ilLPStatus.php';
56  ilLPStatus::setInProgressIfNotAttempted($a_obj_id, $a_user_id);
57 
58  return true;
59  }
_recordReadEvent($a_type, $a_ref_id, $obj_id, $usr_id, $isCatchupWriteEvents=true, $a_ext_rc=false, $a_ext_time=false)
Records a read event and catches up with write events.
static setInProgressIfNotAttempted($a_obj_id, $a_user_id)
This function shoudl be clalled for normal "read events".
global $ilDB
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ ilLearningProgress()

ilLearningProgress::ilLearningProgress ( )

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

References $ilDB.

41  {
42  global $ilDB;
43 
44  $this->db = $ilDB;
45  }
global $ilDB

Field Documentation

◆ $db

ilLearningProgress::$db = null

Definition at line 38 of file class.ilLearningProgress.php.


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