ILIAS  release_7 Revision v7.30-3-g800a261c036
ilLPStatusCmiXapiAbstract Class Reference
+ Inheritance diagram for ilLPStatusCmiXapiAbstract:
+ Collaboration diagram for ilLPStatusCmiXapiAbstract:

Public Member Functions

 getCmixUserResult ($objId, $usrId)
 
 determineStatus ($a_obj_id, $a_usr_id, $a_obj=null)
 Determine status. More...
 
 determinePercentage ($a_obj_id, $a_usr_id, $a_obj=null)
 Determine percentage. 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 _getFailed ($a_obj_id)
 
static _getStatusInfo ($a_obj_id)
 
- 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, &$a_old_status=self::LP_STATUS_NOT_ATTEMPTED_NUM)
 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=true)
 

Protected Member Functions

 ensureObject ($objId, $object=null)
 
 resultSatisfyCompleted (ilCmiXapiResult $result)
 
 resultSatisfyFailed (ilCmiXapiResult $result)
 

Static Protected Member Functions

static _resultSatisfyCompleted (ilCmiXapiResult $result, $a_obj_id)
 
static _resultSatisfyFailed (ilCmiXapiResult $result, $a_obj_id)
 
- Static Protected Member Functions inherited from ilLPStatus
static raiseEvent ($a_obj_id, $a_usr_id, $a_status, $a_old_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...
 

Protected Attributes

 $cmixUserResult = array()
 
- Protected Attributes inherited from ilLPStatus
 $obj_id = null
 
 $db = null
 

Static Private Member Functions

static getUserIdsByLpStatusNum ($objId, $lpStatusNum)
 
static loadStatusInfo ($a_obj_id)
 

Static Private Attributes

static $statusInfoCache = array()
 

Additional Inherited Members

- Data Fields inherited from ilLPStatus
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 14 of file class.ilLPStatusCmiXapiAbstract.php.

Member Function Documentation

◆ _getCompleted()

static ilLPStatusCmiXapiAbstract::_getCompleted (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 73 of file class.ilLPStatusCmiXapiAbstract.php.

74 {
76 $a_obj_id,
78 );
79 }
static getUserIdsByLpStatusNum($objId, $lpStatusNum)
const LP_STATUS_COMPLETED_NUM

References getUserIdsByLpStatusNum(), and ilLPStatus\LP_STATUS_COMPLETED_NUM.

+ Here is the call graph for this function:

◆ _getFailed()

static ilLPStatusCmiXapiAbstract::_getFailed (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 81 of file class.ilLPStatusCmiXapiAbstract.php.

82 {
84 $a_obj_id,
86 );
87 }
const LP_STATUS_FAILED_NUM

References getUserIdsByLpStatusNum(), and ilLPStatus\LP_STATUS_FAILED_NUM.

+ Here is the call graph for this function:

◆ _getInProgress()

static ilLPStatusCmiXapiAbstract::_getInProgress (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 65 of file class.ilLPStatusCmiXapiAbstract.php.

66 {
68 $a_obj_id,
70 );
71 }
const LP_STATUS_IN_PROGRESS_NUM

References getUserIdsByLpStatusNum(), and ilLPStatus\LP_STATUS_IN_PROGRESS_NUM.

+ Here is the call graph for this function:

◆ _getNotAttempted()

static ilLPStatusCmiXapiAbstract::_getNotAttempted (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 57 of file class.ilLPStatusCmiXapiAbstract.php.

58 {
60 $a_obj_id,
62 );
63 }
const LP_STATUS_NOT_ATTEMPTED_NUM

References getUserIdsByLpStatusNum(), and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

+ Here is the call graph for this function:

◆ _getStatusInfo()

static ilLPStatusCmiXapiAbstract::_getStatusInfo (   $a_obj_id)
static

Reimplemented from ilLPStatus.

Definition at line 95 of file class.ilLPStatusCmiXapiAbstract.php.

96 {
97 if (self::$statusInfoCache[$a_obj_id] === null) {
98 self::$statusInfoCache[$a_obj_id] = self::loadStatusInfo($a_obj_id);
99 }
100
101 return self::$statusInfoCache[$a_obj_id];
102 }

References loadStatusInfo().

Referenced by getUserIdsByLpStatusNum().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ _resultSatisfyCompleted()

static ilLPStatusCmiXapiAbstract::_resultSatisfyCompleted ( ilCmiXapiResult  $result,
  $a_obj_id 
)
staticprotected
Parameters
ilObjCmiXapi$object
ilCmiXapiResult$result
Returns
bool

Definition at line 182 of file class.ilLPStatusCmiXapiAbstract.php.

183 {
184 $lpStatusDetermination = new static($a_obj_id);
185 return $lpStatusDetermination->resultSatisfyCompleted($result);
186 }
$result

References $result.

◆ _resultSatisfyFailed()

static ilLPStatusCmiXapiAbstract::_resultSatisfyFailed ( ilCmiXapiResult  $result,
  $a_obj_id 
)
staticprotected
Parameters
ilObjCmiXapi$object
ilCmiXapiResult$result
Returns
bool

Definition at line 199 of file class.ilLPStatusCmiXapiAbstract.php.

200 {
201 $lpStatusDetermination = new static($a_obj_id);
202 return $lpStatusDetermination->resultSatisfyFailed($result);
203 }

References $result.

◆ determinePercentage()

ilLPStatusCmiXapiAbstract::determinePercentage (   $a_obj_id,
  $a_usr_id,
  $a_obj = null 
)

Determine percentage.

Parameters

return

Reimplemented from ilLPStatus.

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

161 {
162 $cmixResult = $this->getCmixUserResult($a_obj_id, $a_usr_id);
163
164 if ($cmixResult instanceof ilCmiXapiResult) {
165 return 100 * (float) $cmixResult->getScore();
166 }
167
168 return 0;
169 }

References getCmixUserResult().

+ Here is the call graph for this function:

◆ determineStatus()

ilLPStatusCmiXapiAbstract::determineStatus (   $a_obj_id,
  $a_usr_id,
  $a_obj = null 
)

Determine status.

Parameters

return

Reimplemented from ilLPStatus.

Definition at line 137 of file class.ilLPStatusCmiXapiAbstract.php.

138 {
139 $cmixUserResult = $this->getCmixUserResult($a_obj_id, $a_usr_id);
140
141 if ($cmixUserResult instanceof ilCmiXapiResult) {
144 }
145
148 }
149
151 }
152
153 if (ilCmiXapiUser::exists($a_obj_id, $a_usr_id)) {
155 }
156
158 }
static exists($objId, $usrId, $privacyIdent=999)
resultSatisfyCompleted(ilCmiXapiResult $result)
resultSatisfyFailed(ilCmiXapiResult $result)

References $cmixUserResult, ilCmiXapiUser\exists(), getCmixUserResult(), ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_FAILED_NUM, ilLPStatus\LP_STATUS_IN_PROGRESS_NUM, ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM, resultSatisfyCompleted(), and resultSatisfyFailed().

+ Here is the call graph for this function:

◆ ensureObject()

ilLPStatusCmiXapiAbstract::ensureObject (   $objId,
  $object = null 
)
protected
Parameters
$objId
$object
Returns
ilObjCmiXapi

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

49 {
50 if (!($object instanceof ilObjCmiXapi)) {
52 }
53
54 return $object;
55 }
static getInstanceByObjId($a_obj_id, $stop_on_error=true)
get an instance of an Ilias object by object id
$objId
Definition: xapitoken.php:39

References $objId, and ilObjectFactory\getInstanceByObjId().

+ Here is the call graph for this function:

◆ getCmixUserResult()

ilLPStatusCmiXapiAbstract::getCmixUserResult (   $objId,
  $usrId 
)
Parameters
$objId
$usrId
Returns
ilCmiXapiResult

Definition at line 25 of file class.ilLPStatusCmiXapiAbstract.php.

26 {
27 if (!isset($this->cmixUserResult[$objId])) {
28 $this->cmixUserResult[$objId] = array();
29 }
30
31 if (!isset($this->cmixUserResult[$objId][$usrId])) {
32 try {
34 $this->cmixUserResult[$objId][$usrId] = $cmixUserResult;
35 } catch (ilCmiXapiException $e) {
36 $this->cmixUserResult[$objId][$usrId] = null;
37 }
38 }
39
40 return $this->cmixUserResult[$objId][$usrId];
41 }
static getInstanceByObjIdAndUsrId($objId, $usrId)

References $cmixUserResult, Vendor\Package\$e, $objId, and ilCmiXapiResult\getInstanceByObjIdAndUsrId().

Referenced by determinePercentage(), and determineStatus().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getUserIdsByLpStatusNum()

static ilLPStatusCmiXapiAbstract::getUserIdsByLpStatusNum (   $objId,
  $lpStatusNum 
)
staticprivate

Definition at line 89 of file class.ilLPStatusCmiXapiAbstract.php.

90 {
91 $statusInfo = self::_getStatusInfo($objId);
92 return $statusInfo[$lpStatusNum];
93 }

References $objId, and _getStatusInfo().

Referenced by _getCompleted(), _getFailed(), _getInProgress(), and _getNotAttempted().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ loadStatusInfo()

static ilLPStatusCmiXapiAbstract::loadStatusInfo (   $a_obj_id)
staticprivate

Definition at line 104 of file class.ilLPStatusCmiXapiAbstract.php.

105 {
106 $statusInfo = [
111 ];
112
113 $cmixUsers = ilCmiXapiUser::getUsersForObject($a_obj_id);
114 $userResults = ilCmiXapiResult::getResultsForObject($a_obj_id);
115
116 foreach ($cmixUsers as $cmixUser) {
118
119 if (isset($userResults[$cmixUser->getUsrId()])) {
120 $userResult = $userResults[$cmixUser->getUsrId()];
121
122 if (self::_resultSatisfyCompleted($userResult, $a_obj_id)) {
124 }
125
126 if (self::_resultSatisfyFailed($userResult, $a_obj_id)) {
128 }
129 }
130
131 $statusInfo[$status][] = $cmixUser->getUsrId();
132 }
133
134 return $statusInfo;
135 }
static getResultsForObject($objId)
static getUsersForObject($objId, $asUsrId=false)

References ilCmiXapiResult\getResultsForObject(), ilCmiXapiUser\getUsersForObject(), ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_FAILED_NUM, ilLPStatus\LP_STATUS_IN_PROGRESS_NUM, and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

Referenced by _getStatusInfo().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ resultSatisfyCompleted()

ilLPStatusCmiXapiAbstract::resultSatisfyCompleted ( ilCmiXapiResult  $result)
abstractprotected
Parameters
ilCmiXapiResult$result
Returns
bool

Reimplemented in ilLPStatusCmiXapiCompleted, ilLPStatusCmiXapiCompletedOrPassed, and ilLPStatusCmiXapiPassed.

Referenced by determineStatus().

+ Here is the caller graph for this function:

◆ resultSatisfyFailed()

ilLPStatusCmiXapiAbstract::resultSatisfyFailed ( ilCmiXapiResult  $result)
abstractprotected

Field Documentation

◆ $cmixUserResult

ilLPStatusCmiXapiAbstract::$cmixUserResult = array()
protected

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

Referenced by determineStatus(), and getCmixUserResult().

◆ $statusInfoCache

ilLPStatusCmiXapiAbstract::$statusInfoCache = array()
staticprivate

Definition at line 18 of file class.ilLPStatusCmiXapiAbstract.php.


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