ILIAS  release_8 Revision v8.19
All Data Structures Namespaces Files Functions Variables Modules Pages
ilLPStatusLtiOutcome Class Reference

Class ilLPStatusLtiOutcome. More...

+ Inheritance diagram for ilLPStatusLtiOutcome:
+ Collaboration diagram for ilLPStatusLtiOutcome:

Public Member Functions

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

Private Member Functions

 getLtiUserResult (int $objId, int $usrId)
 
 ensureObject (int $objId, $object)
 

Static Private Attributes

static array $userResultCache = array()
 

Additional Inherited Members

- Static Public Member Functions inherited from ilLPStatus
static _getCountNotAttempted (int $a_obj_id)
 
static _getNotAttempted (int $a_obj_id)
 
static _getCountInProgress (int $a_obj_id)
 
static _getInProgress (int $a_obj_id)
 
static _getCountCompleted (int $a_obj_id)
 
static _getCompleted (int $a_obj_id)
 
static _getFailed (int $a_obj_id)
 
static _getCountFailed (int $a_obj_id)
 
static _getStatusInfo (int $a_obj_id)
 
static _getTypicalLearningTime (int $a_obj_id)
 
static checkStatusForObject (int $a_obj_id, ?array $a_users=null)
 This function checks whether the status for a given number of users is dirty and must be recalculated. More...
 
static writeStatus (int $a_obj_id, int $a_user_id, int $a_status, int $a_percentage=0, bool $a_force_per=false, ?int &$a_old_status=self::LP_STATUS_NOT_ATTEMPTED_NUM)
 Write status for user and object. More...
 
static setInProgressIfNotAttempted (int $a_obj_id, int $a_user_id)
 This function shoudl be clalled for normal "read events". More...
 
static setAllDirty ()
 Sets all status to dirty. More...
 
static setDirty (int $a_obj_id)
 Sets status of an object to dirty. More...
 
static _lookupStatus (int $a_obj_id, int $a_user_id, bool $a_create=true)
 Lookup status. More...
 
static _lookupPercentage (int $a_obj_id, int $a_user_id)
 Lookup percentage. More...
 
static _hasUserCompleted (int $a_obj_id, int $a_user_id)
 Lookup user object completion. More...
 
static _lookupStatusChanged (int $a_obj_id, int $a_user_id)
 Lookup status changed. More...
 
static _lookupCompletedForObject (int $a_obj_id, ?array $a_user_ids=null)
 Get completed users for object. More...
 
static _lookupFailedForObject (int $a_obj_id, ?array $a_user_ids=null)
 Get failed users for object. More...
 
static _lookupInProgressForObject (int $a_obj_id, ?array $a_user_ids=null)
 Get in progress users for object. More...
 
static preloadListGUIData (array $a_obj_ids)
 
static getListGUIStatus (int $a_obj_id, bool $a_image_only=true)
 
static hasListGUIStatus (int $a_obj_id)
 
- 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
 
- Static Protected Member Functions inherited from ilLPStatus
static raiseEvent (int $a_obj_id, int $a_usr_id, int $a_status, int $a_old_status, int $a_percentage)
 
static _lookupStatusForObject (int $a_obj_id, int $a_status, ?array $a_user_ids=null)
 Get users with given status for object. More...
 
static validateLPForObjects (int $a_user_id, array $a_obj_ids, int $a_parent_ref_id)
 Process given objects for lp-relevance. More...
 
static checkLPModesForObjects (array $a_obj_ids, array &$a_coll_obj_ids)
 Process lp modes for given objects. More...
 
static getLPStatusForObjects (int $a_user_id, array $a_obj_ids)
 Get LP status for given objects (and user) More...
 
- Protected Attributes inherited from ilLPStatus
int $obj_id
 
ilDBInterface $db
 
ilObjectDataCache $ilObjDataCache
 

Detailed Description

Member Function Documentation

◆ determinePercentage()

ilLPStatusLtiOutcome::determinePercentage ( int  $a_obj_id,
int  $a_usr_id,
?object  $a_obj = null 
)

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

References getLtiUserResult().

65  : int {
66  $ltiResult = $this->getLtiUserResult($a_obj_id, $a_usr_id);
67 
68  if ($ltiResult instanceof ilLTIConsumerResult) {
69  return $ltiResult->getResult() * 100;
70  }
71 
72  return 0;
73  }
getLtiUserResult(int $objId, int $usrId)
+ Here is the call graph for this function:

◆ determineStatus()

ilLPStatusLtiOutcome::determineStatus ( int  $a_obj_id,
int  $a_usr_id,
object  $a_obj = null 
)

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

References ensureObject(), and getLtiUserResult().

44  : int {
45  $ltiResult = $this->getLtiUserResult($a_obj_id, $a_usr_id);
46 
47  if ($ltiResult instanceof ilLTIConsumerResult) {
48  $object = $this->ensureObject($a_obj_id, $a_obj);
49  $ltiMasteryScore = $object->getMasteryScore();
50 
51  if ($ltiResult->getResult() >= $ltiMasteryScore) {
52  return self::LP_STATUS_COMPLETED_NUM;
53  }
54 
55  return self::LP_STATUS_IN_PROGRESS_NUM;
56  }
57 
58  return self::LP_STATUS_NOT_ATTEMPTED_NUM;
59  }
ensureObject(int $objId, $object)
getLtiUserResult(int $objId, int $usrId)
+ Here is the call graph for this function:

◆ ensureObject()

ilLPStatusLtiOutcome::ensureObject ( int  $objId,
  $object 
)
private

Definition at line 32 of file class.ilLPStatusLtiOutcome.php.

References ilObjectFactory\getInstanceByObjId().

Referenced by determineStatus().

33  {
34  if (!($object instanceof ilObjLTIConsumer)) {
36  }
37  return $object;
38  }
$objId
Definition: xapitoken.php:57
static getInstanceByObjId(?int $obj_id, bool $stop_on_error=true)
get an instance of an Ilias object by object id
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getLtiUserResult()

ilLPStatusLtiOutcome::getLtiUserResult ( int  $objId,
int  $usrId 
)
private

Definition at line 17 of file class.ilLPStatusLtiOutcome.php.

References $objId, and ilLTIConsumerResult\getByKeys().

Referenced by determinePercentage(), and determineStatus().

21  if (!isset(self::$userResultCache[$objId])) {
22  self::$userResultCache[$objId] = array();
23  }
24 
25  if (!isset(self::$userResultCache[$objId][$usrId])) {
26  $ltiUserResult = ilLTIConsumerResult::getByKeys($objId, $usrId);
27  self::$userResultCache[$objId][$usrId] = $ltiUserResult;
28  }
29  return self::$userResultCache[$objId][$usrId];
30  }
$objId
Definition: xapitoken.php:57
static getByKeys(int $a_obj_id, int $a_usr_id, ?bool $a_create=false)
Get a result by object and user key.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Field Documentation

◆ $userResultCache

array ilLPStatusLtiOutcome::$userResultCache = array()
staticprivate

Definition at line 15 of file class.ilLPStatusLtiOutcome.php.


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