ILIAS  release_5-3 Revision v5.3.23-19-g915713cf615
ilLPStatusEvent Class Reference
+ Inheritance diagram for ilLPStatusEvent:
+ Collaboration diagram for ilLPStatusEvent:

Public Member Functions

 __construct ($a_obj_id)
 
 determineStatus ($a_obj_id, $a_user_id, $a_obj=null)
 Determine status. More...
 
- Public Member Functions inherited from ilLPStatus
 __construct ($a_obj_id)
 
 _updateStatus ($a_obj_id, $a_usr_id, $a_obj=null, $a_percentage=false, $a_force_raise=false)
 New status handling (st: status, nr: accesses, p: percentage, t: time spent, m: mark) More...
 
 determinePercentage ($a_obj_id, $a_usr_id, $a_obj=null)
 Determine percentage. More...
 
 determineStatus ($a_obj_id, $a_usr_id, $a_obj=null)
 Determine status. More...
 
 refreshStatus ($a_obj_id, $a_users=null)
 Refresh status. More...
 

Static Public Member Functions

static _getNotAttempted ($a_obj_id)
 
static _getInProgress ($a_obj_id)
 
static _getCompleted ($a_obj_id)
 
static _getStatusInfo ($a_obj_id)
 
static _lookupCompletedForObject ($a_obj_id, $a_user_ids=null)
 Get completed users for object. More...
 
static _lookupFailedForObject ($a_obj_id, $a_user_ids=null)
 Get failed users for object. More...
 
static _lookupInProgressForObject ($a_obj_id, $a_user_ids=null)
 Get in progress users for object. More...
 
- Static Public Member Functions inherited from ilLPStatus
static _getCountNotAttempted ($a_obj_id)
 
static _getNotAttempted ($a_obj_id)
 
static _getCountInProgress ($a_obj_id)
 
static _getInProgress ($a_obj_id)
 
static _getCountCompleted ($a_obj_id)
 
static _getCompleted ($a_obj_id)
 
static _getFailed ($a_obj_id)
 
static _getCountFailed ()
 
static _getStatusInfo ($a_obj_id)
 
static _getTypicalLearningTime ($a_obj_id)
 
static checkStatusForObject ($a_obj_id, $a_users=false)
 This function checks whether the status for a given number of users is dirty and must be recalculated. More...
 
static writeStatus ($a_obj_id, $a_user_id, $a_status, $a_percentage=false, $a_force_per=false)
 Write status for user and object. More...
 
static setInProgressIfNotAttempted ($a_obj_id, $a_user_id)
 This function shoudl be clalled for normal "read events". More...
 
static setAllDirty ()
 Sets all status to dirty. More...
 
static setDirty ($a_obj_id)
 Sets status of an object to dirty. More...
 
static _lookupStatus ($a_obj_id, $a_user_id, $a_create=true)
 Lookup status. More...
 
static _lookupPercentage ($a_obj_id, $a_user_id)
 Lookup percentage. More...
 
static _hasUserCompleted ($a_obj_id, $a_user_id)
 Lookup user object completion. More...
 
static _lookupStatusChanged ($a_obj_id, $a_user_id)
 Lookup status changed. More...
 
static _lookupCompletedForObject ($a_obj_id, $a_user_ids=null)
 Get completed users for object. More...
 
static _lookupFailedForObject ($a_obj_id, $a_user_ids=null)
 Get failed users for object. More...
 
static _lookupInProgressForObject ($a_obj_id, $a_user_ids=null)
 Get in progress users for object. More...
 
static preloadListGUIData ($a_obj_ids)
 
static getListGUIStatus ($a_obj_id, $a_image_only=false)
 

Static Protected Member Functions

static getMembers ($a_obj_id, $a_is_crs_id=false)
 Get members for object. More...
 
- Static Protected Member Functions inherited from ilLPStatus
static raiseEvent ($a_obj_id, $a_usr_id, $a_status, $a_percentage)
 
static _lookupStatusForObject ($a_obj_id, $a_status, $a_user_ids=null)
 Get users with given status for object. More...
 
static validateLPForObjects ($a_user_id, $a_obj_ids, $a_parent_ref_id)
 Process given objects for lp-relevance. More...
 
static checkLPModesForObjects ($a_obj_ids, array &$a_coll_obj_ids)
 Process lp modes for given objects. More...
 
static getLPStatusForObjects ($a_user_id, $a_obj_ids)
 Get LP status for given objects (and user) More...
 

Additional Inherited Members

- Data Fields inherited from ilLPStatus
 $obj_id = null
 
 $db = null
 
const LP_STATUS_NOT_ATTEMPTED = 'trac_no_attempted'
 
const LP_STATUS_IN_PROGRESS = 'trac_in_progress'
 
const LP_STATUS_COMPLETED = 'trac_completed'
 
const LP_STATUS_FAILED = 'trac_failed'
 
const LP_STATUS_NOT_ATTEMPTED_NUM = 0
 
const LP_STATUS_IN_PROGRESS_NUM = 1
 
const LP_STATUS_COMPLETED_NUM = 2
 
const LP_STATUS_FAILED_NUM = 3
 
const LP_STATUS_REGISTERED = 'trac_registered'
 
const LP_STATUS_NOT_REGISTERED = 'trac_not_registered'
 
const LP_STATUS_PARTICIPATED = 'trac_participated'
 
const LP_STATUS_NOT_PARTICIPATED = 'trac_not_participated'
 
- Static Public Attributes inherited from ilLPStatus
static $list_gui_cache
 

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilLPStatusEvent::__construct (   $a_obj_id)

Reimplemented from ilLPStatus.

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

39 {
40 global $ilDB;
41
42 parent::__construct($a_obj_id);
43 $this->db = $ilDB;
44 }
global $ilDB

References $ilDB.

Member Function Documentation

◆ _getCompleted()

static ilLPStatusEvent::_getCompleted (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 79 of file class.ilLPStatusEvent.php.

80 {
81 $status_info = ilLPStatusWrapper::_getStatusInfo($a_obj_id);
82 return $status_info['participated_users'] ? $status_info['participated_users'] : array();
83 }
static _getStatusInfo($a_obj_id)
Reads informations about the object e.g test results, tlt, number of visits.

References ilLPStatusWrapper\_getStatusInfo().

+ Here is the call graph for this function:

◆ _getInProgress()

static ilLPStatusEvent::_getInProgress (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 62 of file class.ilLPStatusEvent.php.

63 {
64 $status_info = ilLPStatusWrapper::_getStatusInfo($a_obj_id);
65
66 // If registration is disabled in_progress is not available
67 if (!$status_info['registration']) {
68 return array();
69 }
70 // If event has occured in_progress is impossible
71 if ($status_info['starting_time'] < time()) {
72 return array();
73 }
74
75 // Otherwise all users who registered will get the status in progress
76 return $status_info['registered_users'] ? $status_info['registered_users'] : array();
77 }

References ilLPStatusWrapper\_getStatusInfo().

+ Here is the call graph for this function:

◆ _getNotAttempted()

static ilLPStatusEvent::_getNotAttempted (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 46 of file class.ilLPStatusEvent.php.

47 {
48 $status_info = ilLPStatusWrapper::_getStatusInfo($a_obj_id);
49
50 $users = array();
51
52 $members = self::getMembers($status_info['crs_id'], true);
53 if ($members) {
54 // diff in progress and completed (use stored result in LPStatusWrapper)
55 $users = array_diff((array) $members, ilLPStatusWrapper::_getInProgress($a_obj_id));
56 $users = array_diff((array) $users, ilLPStatusWrapper::_getCompleted($a_obj_id));
57 }
58
59 return $users;
60 }
$users
Definition: authpage.php:44
static getMembers($a_obj_id, $a_is_crs_id=false)
Get members for object.
static _getCompleted($a_obj_id)
Static function to read the users who have the status 'completed'.
static _getInProgress($a_obj_id)
Static function to read users who have the status 'in_progress'.

References $users, ilLPStatusWrapper\_getCompleted(), ilLPStatusWrapper\_getInProgress(), ilLPStatusWrapper\_getStatusInfo(), and getMembers().

+ Here is the call graph for this function:

◆ _getStatusInfo()

static ilLPStatusEvent::_getStatusInfo (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 85 of file class.ilLPStatusEvent.php.

86 {
87 $tree = $GLOBALS['DIC']->repositoryTree();
88
89 $references = ilObject::_getAllReferences($a_obj_id);
90 $ref_id = end($references);
91
92 $member_ref_id = null;
93 if ($id = $tree->checkForParentType($ref_id, 'grp')) {
94 $member_ref_id = $id;
95 } elseif ($id = $tree->checkForParentType($ref_id, 'crs')) {
96 $member_ref_id = $id;
97 }
98
99 $status_info = array();
100 $status_info['crs_id'] = ilObject::_lookupObjId($member_ref_id);
101 $status_info['registration'] = ilObjSession::_lookupRegistrationEnabled($a_obj_id);
102 $status_info['title'] = ilObject::_lookupTitle($a_obj_id);
103 $status_info['description'] = ilObject::_lookupDescription($a_obj_id);
104
105 $time_info = ilSessionAppointment::_lookupAppointment($a_obj_id);
106 $status_info['starting_time'] = $time_info['start'];
107 $status_info['ending_time'] = $time_info['end'];
108 $status_info['fullday'] = $time_info['fullday'];
109
110 $status_info['registered_users'] = ilEventParticipants::_getRegistered($a_obj_id);
111 $status_info['participated_users'] = ilEventParticipants::_getParticipated($a_obj_id);
112
113 return $status_info;
114 }
static _getParticipated($a_event_id)
static _getRegistered($a_event_id)
static _lookupRegistrationEnabled($a_obj_id)
lookup registration enabled
static _lookupObjId($a_id)
static _lookupTitle($a_id)
lookup object title
static _lookupDescription($a_id)
lookup object description
static _getAllReferences($a_id)
get all reference ids of object
static _lookupAppointment($a_obj_id)
lookup appointment
if(!array_key_exists('StateId', $_REQUEST)) $id
$GLOBALS['loaded']
Global hash that tracks already loaded includes.

References $GLOBALS, $id, ilObject\_getAllReferences(), ilEventParticipants\_getParticipated(), ilEventParticipants\_getRegistered(), ilSessionAppointment\_lookupAppointment(), ilObject\_lookupDescription(), ilObject\_lookupObjId(), ilObjSession\_lookupRegistrationEnabled(), and ilObject\_lookupTitle().

+ Here is the call graph for this function:

◆ _lookupCompletedForObject()

static ilLPStatusEvent::_lookupCompletedForObject (   $a_obj_id,
  $a_user_ids = null 
)
static

Get completed users for object.

Parameters
int$a_obj_id
array$a_user_ids
Returns
array

Reimplemented from ilLPStatus.

Definition at line 191 of file class.ilLPStatusEvent.php.

192 {
193 if (!$a_user_ids) {
194 $a_user_ids = self::getMembers($a_obj_id);
195 if (!$a_user_ids) {
196 return array();
197 }
198 }
199 return self::_lookupStatusForObject($a_obj_id, self::LP_STATUS_COMPLETED_NUM, $a_user_ids);
200 }
static _lookupStatusForObject($a_obj_id, $a_status, $a_user_ids=null)
Get users with given status for object.

References ilLPStatus\_lookupStatusForObject(), and getMembers().

+ Here is the call graph for this function:

◆ _lookupFailedForObject()

static ilLPStatusEvent::_lookupFailedForObject (   $a_obj_id,
  $a_user_ids = null 
)
static

Get failed users for object.

Parameters
int$a_obj_id
array$a_user_ids
Returns
array

Reimplemented from ilLPStatus.

Definition at line 209 of file class.ilLPStatusEvent.php.

210 {
211 return array();
212 }

◆ _lookupInProgressForObject()

static ilLPStatusEvent::_lookupInProgressForObject (   $a_obj_id,
  $a_user_ids = null 
)
static

Get in progress users for object.

Parameters
int$a_obj_id
array$a_user_ids
Returns
array

Reimplemented from ilLPStatus.

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

222 {
223 if (!$a_user_ids) {
224 $a_user_ids = self::getMembers($a_obj_id);
225 if (!$a_user_ids) {
226 return array();
227 }
228 }
229 return self::_lookupStatusForObject($a_obj_id, self::LP_STATUS_IN_PROGRESS_NUM, $a_user_ids);
230 }

References ilLPStatus\_lookupStatusForObject(), and getMembers().

+ Here is the call graph for this function:

◆ determineStatus()

ilLPStatusEvent::determineStatus (   $a_obj_id,
  $a_user_id,
  $a_obj = null 
)

Determine status.

Parameters
integerobject id
integeruser id
objectobject (optional depends on object type)
Returns
integer status

Reimplemented from ilLPStatus.

Definition at line 124 of file class.ilLPStatusEvent.php.

125 {
126 global $ilObjDataCache;
127
129 switch ($ilObjDataCache->lookupType($a_obj_id)) {
130 case 'sess':
131 include_once './Modules/Session/classes/class.ilEventParticipants.php';
132 include_once('./Modules/Session/classes/class.ilSessionAppointment.php');
133 include_once('./Modules/Session/classes/class.ilObjSession.php');
134
135 $time_info = ilSessionAppointment::_lookupAppointment($a_obj_id);
136 $registration = ilObjSession::_lookupRegistrationEnabled($a_obj_id);
137
138 // If registration is disabled in_progress is not available
139 // If event has occured in_progress is impossible
140 if ($registration && $time_info['start'] >= time()) {
141 // is user registered -> in progress
142 if (ilEventParticipants::_isRegistered($a_user_id, $a_obj_id)) {
144 }
145 }
146 if (ilEventParticipants::_hasParticipated($a_user_id, $a_obj_id)) {
148 }
149 break;
150 }
151 return $status;
152 }
static _isRegistered($a_usr_id, $a_event_id)
static _hasParticipated($a_usr_id, $a_event_id)
const LP_STATUS_COMPLETED_NUM
const LP_STATUS_IN_PROGRESS_NUM
const LP_STATUS_NOT_ATTEMPTED_NUM

References ilEventParticipants\_hasParticipated(), ilEventParticipants\_isRegistered(), ilSessionAppointment\_lookupAppointment(), ilObjSession\_lookupRegistrationEnabled(), ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_IN_PROGRESS_NUM, and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

+ Here is the call graph for this function:

◆ getMembers()

static ilLPStatusEvent::getMembers (   $a_obj_id,
  $a_is_crs_id = false 
)
staticprotected

Get members for object.

Parameters
int$a_obj_id
bool$a_is_crs_id
Returns
array

Definition at line 160 of file class.ilLPStatusEvent.php.

161 {
162 if (!$a_is_crs_id) {
163 $tree = $GLOBALS['DIC']->repositoryTree();
164 $references = ilObject::_getAllReferences($a_obj_id);
165 $ref_id = end($references);
166
167 $member_ref_id = null;
168 if ($id = $tree->checkForParentType($ref_id, 'grp')) {
169 $member_ref_id = $id;
170 } elseif ($id = $tree->checkForParentType($ref_id, 'crs')) {
171 $member_ref_id = $id;
172 } else {
173 return [];
174 }
175 $member_obj_id = ilObject::_lookupObjId($member_ref_id);
176 } else {
177 $member_obj_id = $a_obj_id;
178 }
179
180 $member_obj = ilParticipants::getInstanceByObjId($member_obj_id);
181 return $member_obj->getMembers();
182 }
static getInstanceByObjId($a_obj_id)
Get instance by obj type.

References $GLOBALS, $id, ilObject\_getAllReferences(), ilObject\_lookupObjId(), and ilParticipants\getInstanceByObjId().

Referenced by _getNotAttempted(), _lookupCompletedForObject(), and _lookupInProgressForObject().

+ 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: