Abstract class ilLPStatus for all learning progress modes E.g ilLPStatusManual, ilLPStatusObjectives ... More...

Inheritance diagram for ilLPStatus:

Collaboration diagram for ilLPStatus:

Public Member Functions
	ilLPStatus ($a_obj_id)

	_getCountNotAttempted ($a_obj_id)

	_getNotAttempted ($a_obj_id)

	_getCountInProgress ($a_obj_id)

	_getInProgress ($a_obj_id)

	_getCountCompleted ($a_obj_id)

	_getCompleted ($a_obj_id)

	_getFailed ($a_obj_id)

	_getCountFailed ()

	_getStatusInfo ($a_obj_id)

	_getTypicalLearningTime ($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...

	_lookupStatusChanged ($a_obj_id, $a_user_id)
	Lookup status changed. More...

Static Public Member Functions
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	_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)

Data Fields
	$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
static	$list_gui_cache

Protected Member Functions
	raiseEvent ($a_obj_id, $a_usr_id, $a_status, $a_percentage)

Static Protected Member Functions
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...

Detailed Description

Abstract class ilLPStatus for all learning progress modes E.g ilLPStatusManual, ilLPStatusObjectives ...

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

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

Member Function Documentation

◆ _getCompleted()

ilLPStatus::_getCompleted ( $a_obj_id )

Definition at line 69 of file class.ilLPStatus.php.

         {
                 return array();
         }

◆ _getCountCompleted()

ilLPStatus::_getCountCompleted ( $a_obj_id )

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

         {
                 return 0;
         }

◆ _getCountFailed()

ilLPStatus::_getCountFailed ( )

Definition at line 77 of file class.ilLPStatus.php.

         {
                 return 0;
         }

◆ _getCountInProgress()

ilLPStatus::_getCountInProgress ( $a_obj_id )

Definition at line 56 of file class.ilLPStatus.php.

         {
                 return 0;
         }

◆ _getCountNotAttempted()

ilLPStatus::_getCountNotAttempted ( $a_obj_id )

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

         {
                 return 0;
         }

◆ _getFailed()

ilLPStatus::_getFailed ( $a_obj_id )

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

         {
                 return array();
         }

◆ _getInProgress()

ilLPStatus::_getInProgress ( $a_obj_id )

Definition at line 60 of file class.ilLPStatus.php.

         {
                 return array();
         }

◆ _getNotAttempted()

ilLPStatus::_getNotAttempted ( $a_obj_id )

Definition at line 51 of file class.ilLPStatus.php.

         {
                 return array();
         }

◆ _getStatusInfo()

ilLPStatus::_getStatusInfo ( $a_obj_id )

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

         {
                 return array();
         }

◆ _getTypicalLearningTime()

ilLPStatus::_getTypicalLearningTime ( $a_obj_id )

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

References ilMDEducational\_getTypicalLearningTimeSeconds().

         {
                 include_once 'Services/MetaData/classes/class.ilMDEducational.php';
                 return ilMDEducational::_getTypicalLearningTimeSeconds($a_obj_id);
         }

Here is the call graph for this function:

◆ _hasUserCompleted()

static ilLPStatus::_hasUserCompleted	(	$a_obj_id,
		$a_user_id
	)

static

Lookup user object completion.

Parameters

int	$a_obj_id
int	$a_user_id

Returns: bool

Definition at line 605 of file class.ilLPStatus.php.

Referenced by ilConditionHandler\_checkCondition(), ilObjSAHSLearningModuleAccess\_lookupUserCertificate(), ilTimingCache\_showWarning(), ilObjSAHSLearningModuleAccess\checkCondition(), ilObjStudyProgramme\getCompletedCourses(), ilSCORMVerificationTableGUI\getItems(), ilContainerStartObjects\isFullfilled(), and ilCourseStart\isFullfilled().

         {
                 return (self::_lookupStatus($a_obj_id, $a_user_id) == self::LP_STATUS_COMPLETED_NUM);
         }

Here is the caller graph for this function:

◆ _lookupCompletedForObject()

static ilLPStatus::_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

Definition at line 690 of file class.ilLPStatus.php.

         {
                 return self::_lookupStatusForObject($a_obj_id, self::LP_STATUS_COMPLETED_NUM, $a_user_ids);
         }

◆ _lookupFailedForObject()

static ilLPStatus::_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

Definition at line 702 of file class.ilLPStatus.php.

         {
                 return self::_lookupStatusForObject($a_obj_id, self::LP_STATUS_FAILED_NUM, $a_user_ids);
         }

◆ _lookupInProgressForObject()

static ilLPStatus::_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

Definition at line 714 of file class.ilLPStatus.php.

         {
                 return self::_lookupStatusForObject($a_obj_id, self::LP_STATUS_IN_PROGRESS_NUM, $a_user_ids);
         }

◆ _lookupPercentage()

static ilLPStatus::_lookupPercentage	(	$a_obj_id,
		$a_user_id
	)

static

Lookup percentage.

Parameters

int	$a_obj_id	object id
int	$a_user_id	user id

Definition at line 583 of file class.ilLPStatus.php.

References $ilDB.

Referenced by ilLearningProgressBaseGUI\__appendLPDetails(), and ilObjSCORMLearningModule\importRaw().

         {
                 global $ilDB;
                 
                 $set = $ilDB->query("SELECT percentage FROM ut_lp_marks WHERE ".
                         " status_dirty = ".$ilDB->quote(0, "integer").
                         " AND usr_id = ".$ilDB->quote($a_user_id, "integer").
                         " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                         );
                 if ($rec = $ilDB->fetchAssoc($set))
                 {
                         return $rec["percentage"];
                 }
         }

Here is the caller graph for this function:

◆ _lookupStatus()

static ilLPStatus::_lookupStatus	(	$a_obj_id,
		$a_user_id,
		$a_create = `true`
	)

static

Lookup status.

Parameters

int	$a_obj_id	object id
int	$a_user_id	user id
bool	$a_create

Definition at line 548 of file class.ilLPStatus.php.

References $ilDB, and ilLPStatusWrapper\_updateStatus().

Referenced by ilLearningProgressBaseGUI\__readStatus(), ilObjSAHSLearningModuleAccess\checkCondition(), ilObjCourse\checkLPStatusSync(), ilCourseMailTemplateTutorContext\getDescription(), ilScormMailTemplateLPContext\getDescription(), ilSoapSCORMAdministration\getSCORMCompletionStatus(), ilObjSCORMInitData\getStatus(), ilObjSCORMLearningModule\importRaw(), and ilLearningProgressBaseGUI\initEditUserForm().

         {
                 global $ilDB;
                 
                 $set = $ilDB->query("SELECT status FROM ut_lp_marks WHERE ".
                         " status_dirty = ".$ilDB->quote(0, "integer").
                         " AND usr_id = ".$ilDB->quote($a_user_id, "integer").
                         " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                         );
                 if ($rec = $ilDB->fetchAssoc($set))
                 {
                         return $rec["status"];
                 }
                 else if((bool)$a_create)
                 {
                         include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                         ilLPStatusWrapper::_updateStatus($a_obj_id, $a_user_id); 
                         $set = $ilDB->query("SELECT status FROM ut_lp_marks WHERE ".
                                 " status_dirty = ".$ilDB->quote(0, "integer").
                                 " AND usr_id = ".$ilDB->quote($a_user_id, "integer").
                                 " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                                 );
                         if ($rec = $ilDB->fetchAssoc($set))
                         {
                                 return $rec["status"];
                         }
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupStatusChanged()

ilLPStatus::_lookupStatusChanged	(	$a_obj_id,
		$a_user_id
	)

Lookup status changed.

Parameters

int	$a_obj_id	object id
int	$a_user_id	user id

Definition at line 616 of file class.ilLPStatus.php.

References $ilDB, and ilLPStatusWrapper\_updateStatus().

Referenced by ilCertificateAdapter\getUserCompletionDate().

         {
                 global $ilDB;
                 
                 $set = $ilDB->query("SELECT status_changed FROM ut_lp_marks WHERE ".
                         " status_dirty = ".$ilDB->quote(0, "integer").
                         " AND usr_id = ".$ilDB->quote($a_user_id, "integer").
                         " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                         );
                 if ($rec = $ilDB->fetchAssoc($set))
                 {
                         return $rec["status_changed"];
                 }
                 else
                 {
                         include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                         ilLPStatusWrapper::_updateStatus($a_obj_id, $a_user_id); 
                         $set = $ilDB->query("SELECT status_changed FROM ut_lp_marks WHERE ".
                                 " status_dirty = ".$ilDB->quote(0, "integer").
                                 " AND usr_id = ".$ilDB->quote($a_user_id, "integer").
                                 " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                                 );
                         if ($rec = $ilDB->fetchAssoc($set))
                         {
                                 return $rec["status_changed"];
                         }
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupStatusForObject()

static ilLPStatus::_lookupStatusForObject	(	$a_obj_id,
		$a_status,
		$a_user_ids = `null`
	)

staticprotected

Get users with given status for object.

Parameters

int	$a_obj_id
int	$a_status
array	$a_user_ids

Returns: array

Definition at line 653 of file class.ilLPStatus.php.

References $ilDB, and $res.

         {
                 global $ilDB;
                 
                 $sql = "SELECT usr_id, status, status_dirty FROM ut_lp_marks".
                         " WHERE obj_id = ".$ilDB->quote($a_obj_id, "integer").
                         " AND status = ".$ilDB->quote($a_status, "integer");
                 if($a_user_ids)
                 {
                         $sql .= " AND ".$ilDB->in("usr_id", $a_user_ids, "", "integer");
                 }                               
                 
                 $set = $ilDB->query($sql);
                 $res = array();
                 while($rec = $ilDB->fetchAssoc($set))
                 {                       
                         if($res["status_dirty"])
                         {
                                 // update status and check again
                                 if(self::_lookupStatus($a_obj_id, $rec["usr_id"]) != $a_status)
                                 {
                                         continue;
                                 }
                         }       
                         $res[] = $rec["usr_id"];
                 }
                 
                 return $res;
         }                       

◆ _updateStatus()

ilLPStatus::_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)

Learning progress:

lm: ilLPStatusManual (st, nr, t, ok, p-, m-), ilLPStatusVisits (st, nr, p, t, ok, m-), ilLPStatusTypicalLearningTime (st, nr, p, t, ok, m-)
dbk: ilLPStatusManual (st, nr, t ok, p-, m-)
htlm: ilLPStatusManual (st, nr, t, m ok, p-) (but mark handling different than lm/dbk)
crs: ilLPStatusManualByTutor (st ok), ilLPStatusObjectives (st ok), ilLPStatusCollection
grp: ilLPStatusManualByTutor, ilLPStatusCollection
fold: ilLPStatusCollection
session: ilLPStatusEvent (st ok, nr and t only for infoscreen, comment and mark are not saved in learning progress table!)
exercise: ilLPStatusExerciseReturned (st, nr, m ok, t-, p-)
scorm: ilLPStatusSCORM (st, nr, p, t, m ok), ilLPStatusSCORMPackage (st, nr, t, m ok, p-)
tst: ilLPStatusTestFinished (st, nr, t, p ok, mark not synced), ilLPStatusTestPassed (st, nr, t ok, p-, mark not synced)

Added determine Status to:

Updating the status:

ilLPStatus::setInProgressIfNotAttempted($a_obj_id, $a_user_id) added to: – ilLearningProgress->_tracProgress() – ilTestSession->saveToDb()
ilChangeEvent::_recordReadEvent() added to: – ilObjSessionGUI->infoScreen()

- ilLearningProgress->_tracProgress() added to:

ilLPStatusWrapper::_updateStatus($a_obj_id, $a_user_id); added to: – ilInfoScreenGUI->saveProgress() – ilLMPresentation->ilPage() – ilLPListOfObjectsGUI->updateUser() – ilCourseObjectiveResult->reset() – ilCourseObjectiveResult->__updatePassed() – ilEventParticipants->updateUser() – ilEventParticipants->_updateParticipation() – ilEventParticipants->_register() – ilEventParticipants->_unregister() – ilExerciseMembers->assignMember() – ilExerciseMembers->deassignMember() – ilExerciseMembers->ilClone() – ilExerciseMembers->writeStatus() – ilExerciseMembers->writeReturned() – ilSCORM13Player->writeGObjective() – ilObjSCORM2004LearningModule->deleteTrackingDataOfUsers() – ilObjSCORM2004LearningModule->importSuccess() – ilObjSCORM2004LearningModuleGUI->confirmedDeleteTracking() – ilSCORM13Player->removeCMIData() – ilSCORM13Player->setCMIData() – ilObjSCORMLearningModule->importSuccess() – ilObjSCORMLearningModule->importRaw() – ilObjSCORMLearningModuleGUI->confirmedDelete() – ilObjSCORMLearningModuleGUI->decreaseAttempt() – ilObjSCORMTracking->store() – ilObjSCORMTracking-> _insertTrackData() – ilSCORMPresentationGUI->increase_attemptAndsave_module_version() – ilTestScoringGUI->setPointsManual() – ilTestSession->increaseTestPass() – ilTestSession->saveToDb()
ilLPStatusWrapper::_refreshStatus($a_ojb_id); aufgenommen in: – ilCourseObjective->add() – ilCourseObjective->delete() – ilCourseObjective->deleteAll() – ilExerciseMembers->delete() – ilSCORM13Package->removeCMIData() – ilAICCCourse->delete() – ilAICCUnit->delete() – ilObjAICCLearningModule->delete() – ilSCORMItem->delete() – ilLPStatusWrapper->update() – ilLPListOfSettingsGUI->assign() – ilLPListOfSettingsGUI->deassign() – ilLPListOfSettingsGUI->groupMaterials() – ilLPListOfSettingsGUI->releaseMaterials() – ilObjTestGUI->confirmDeleteAllUserResultsObject move to ilObjTest but this can ba called for each single question – ilConditionHandlerGUI->updateCondition()
external time/access values for read events ilChangeEvent::_recordReadEvent($a_obj_id, $a_user_id, false, $attempts, $time); – ilObjSCORMTracking->_syncReadEvent in ilObjSCORMTracking->store() (add to refresh) – ilSCORM2004Tracking->_syncReadEvent in ilSCORM13Player->setCMIData() Write status

Parameters

Definition at line 195 of file class.ilLPStatus.php.

References $changed, determinePercentage(), and determineStatus().

         {
 //global $ilLog;
 //$ilLog->write("ilLPStatus-_updateStatus-");
 
                 $status = $this->determineStatus($a_obj_id, $a_usr_id, $a_obj);
                 $percentage = $this->determinePercentage($a_obj_id, $a_usr_id, $a_obj);
                 $changed = self::writeStatus($a_obj_id, $a_usr_id, $status, $percentage);
                 
                 if($changed || (bool)$a_force_raise) // #15529
                 {
                         self::raiseEvent($a_obj_id, $a_usr_id, $status, $percentage);                   
                 }                       
         }

Here is the call graph for this function:

◆ checkLPModesForObjects()

static ilLPStatus::checkLPModesForObjects	(		$a_obj_ids,
		array &	$a_coll_obj_ids
	)

staticprotected

Process lp modes for given objects.

Parameters

array $a_obj_ids

Returns: array

Definition at line 755 of file class.ilLPStatus.php.

References $obj_id, $valid, ilLPObjSettings\_lookupDBModeForObjects(), ilLPCollection\getCollectionModes(), ilObjectLP\getInstance(), ilLPObjSettings\LP_MODE_DEACTIVATED, and ilLPObjSettings\LP_MODE_UNDEFINED.

         {
                 $valid = array();
                 
                 // all lp modes with collections (gathered separately)
                 include_once "Services/Tracking/classes/collection/class.ilLPCollection.php";   
                 $coll_modes = ilLPCollection::getCollectionModes();
                 
                 include_once "Services/Tracking/classes/class.ilLPObjSettings.php";                     
                 
                 // check if objects have LP activated at all (DB entries)       
                 $existing = ilLPObjSettings::_lookupDBModeForObjects($a_obj_ids);
                 foreach($existing as $obj_id => $obj_mode)
                 {                                                                                               
                         if($obj_mode != ilLPObjSettings::LP_MODE_DEACTIVATED)
                         {
                                 $valid[$obj_id] = $obj_id;
                                 
                                 if(in_array($obj_mode, $coll_modes))
                                 {
                                         $a_coll_obj_ids[] = $obj_id;
                                 }
                         }
                 }
                                                                 
                 // missing objects in DB (default mode)
                 include_once "Services/Object/classes/class.ilObjectLP.php";                    
                 if(sizeof($existing) != sizeof($a_obj_ids))
                 {                                                                                       
                         foreach(array_diff($a_obj_ids, $existing) as $obj_id)
                         {
                                 $olp = ilObjectLP::getInstance($obj_id);
                                 $mode = $olp->getCurrentMode();
                                 if($mode == ilLPObjSettings::LP_MODE_DEACTIVATED)
                                 {
                                         // #11141
                                         unset($valid[$obj_id]);
                                 }
                                 else if($mode != ilLPObjSettings::LP_MODE_UNDEFINED)
                                 {
                                         $valid[$obj_id] = $obj_id;
 
                                         if(in_array($mode, $coll_modes))
                                         {
                                                 $a_coll_obj_ids[] = $obj_id;
                                         }
                                 }
                         }
                         unset($existing);
                 }
                 
                 return array_values($valid);
         }

Here is the call graph for this function:

◆ checkStatusForObject()

static ilLPStatus::checkStatusForObject	(	$a_obj_id,
		$a_users = `false`
	)

static

This function checks whether the status for a given number of users is dirty and must be recalculated.

"Missing" records are not inserted!

Parameters

Definition at line 240 of file class.ilLPStatus.php.

References $ilDB, $r, and ilLPStatusFactory\_getInstance().

Referenced by ilTrQuery\refreshObjectsStatus().

         {
                 global $ilDB;
 
 //@todo: there maybe the need to add extra handling for sessions here, since the
 // "in progress" status is time dependent here. On the other hand, if they registered
 // to the session, they already accessed the course and should have a "in progress"
 // anyway. But the status on the session itself may not be correct.
 
                 $sql = "SELECT usr_id FROM ut_lp_marks WHERE ".
                         " obj_id = ".$ilDB->quote($a_obj_id, "integer")." AND ".
                         " status_dirty = ".$ilDB->quote(1, "integer");
                 if(is_array($a_users) && count($a_users) > 0)
                 {
                         $sql .= " AND ".$ilDB->in("usr_id", $a_users, false, "integer");        
                 }                       
                 $set = $ilDB->query($sql);
                 $dirty = false;
                 if ($rec = $ilDB->fetchAssoc($set))
                 {
                         $dirty = true;
                 }
 
                 // check if any records are missing
                 $missing = false;
                 if (!$dirty && is_array($a_users) && count($a_users) > 0)
                 {
                         $set = $ilDB->query("SELECT count(usr_id) cnt FROM ut_lp_marks WHERE ".
                                 " obj_id = ".$ilDB->quote($a_obj_id, "integer")." AND ".
                                 $ilDB->in("usr_id", $a_users, false, "integer"));
                         $r = $ilDB->fetchAssoc($set);
                         if ($r["cnt"] < count($a_users))
                         {
                                 $missing = true;
                         }
                 }
 
                 // refresh status, if records are dirty or missing
                 if ($dirty || $missing)
                 {
                         require_once "Services/Tracking/classes/class.ilLPStatusFactory.php"; // #13330
                         $trac_obj = ilLPStatusFactory::_getInstance($a_obj_id);
                         $trac_obj->refreshStatus($a_obj_id, $a_users);
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ determinePercentage()

ilLPStatus::determinePercentage	(	$a_obj_id,
		$a_usr_id,
		$a_obj = `null`
	)

Determine percentage.

Parameters

Definition at line 216 of file class.ilLPStatus.php.

Referenced by _updateStatus(), and refreshStatus().

         {
                 return false;
         }

Here is the caller graph for this function:

◆ determineStatus()

ilLPStatus::determineStatus	(	$a_obj_id,
		$a_usr_id,
		$a_obj = `null`
	)

Determine status.

Parameters

Definition at line 227 of file class.ilLPStatus.php.

Referenced by ilLPStatusDownloaded\_getCompleted(), and _updateStatus().

         {
                 return false;
         }

Here is the caller graph for this function:

◆ getListGUIStatus()

static ilLPStatus::getListGUIStatus ( $a_obj_id )

static

Definition at line 900 of file class.ilLPStatus.php.

Referenced by ilObjectListGUI\insertProperties().

         {
                 return self::$list_gui_cache[$a_obj_id];
         }

Here is the caller graph for this function:

◆ getLPStatusForObjects()

static ilLPStatus::getLPStatusForObjects	(	$a_user_id,
		$a_obj_ids
	)

staticprotected

Get LP status for given objects (and user)

Parameters

int	$a_user_id
array	$a_obj_ids

Returns: array

Definition at line 816 of file class.ilLPStatus.php.

References $ilDB, $obj_id, $res, and $row.

         {
                 global $ilDB; 
                 
                 $res = array();
                 
                 // get user lp data                     
                 $sql = "SELECT status, status_dirty, obj_id FROM ut_lp_marks".                  
                         " WHERE ".$ilDB->in("obj_id", $a_obj_ids, "", "integer").
                         " AND usr_id = ".$ilDB->quote($a_user_id, "integer");
                 $set = $ilDB->query($sql);
                 while($row = $ilDB->fetchAssoc($set))
                 {                               
                         if(!$row["status_dirty"])
                         {                               
                                 $res[$row["obj_id"]] = $row["status"];                          
                         }
                         else
                         {
                                 $res[$row["obj_id"]] = self::_lookupStatus($row["obj_id"], $a_user_id);
                         }
                 }
 
                 // process missing user entries (same as dirty entries, see above)
                 foreach($a_obj_ids as $obj_id)
                 {
                         if(!isset($res[$obj_id]))
                         {                                       
                                 $res[$obj_id] = self::_lookupStatus($obj_id, $a_user_id);
                                 if($res[$obj_id] === null)
                                 {
                                         $res[$obj_id] = self::LP_STATUS_NOT_ATTEMPTED_NUM;
                                 }
                         }
                 }
                         
                 return $res;
         }

◆ ilLPStatus()

ilLPStatus::ilLPStatus ( $a_obj_id )

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

References $ilDB.

         {
                 global $ilDB;
 
                 $this->obj_id = $a_obj_id;
                 $this->db =& $ilDB;
         }

◆ preloadListGUIData()

static ilLPStatus::preloadListGUIData ( $a_obj_ids )

static

Definition at line 855 of file class.ilLPStatus.php.

References $_GET, $ilUser, $lng, $obj_id, $path, $res, $text, ilObjUserTracking\_enabledLearningProgress(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilObjUserTracking\_hasLearningProgressLearner(), ilObjUserTracking\_hasLearningProgressListGUI(), and ilUtil\img().

Referenced by ilObjectListGUIPreloader\preload().

         {
                 global $ilUser, $lng;
                 
                 $user_id = $ilUser->getId();
                 
                 $res = array();
                 
                 include_once("Services/Tracking/classes/class.ilObjUserTracking.php");
                 if($ilUser->getId() != ANONYMOUS_USER_ID &&
                         ilObjUserTracking::_enabledLearningProgress() &&
                         ilObjUserTracking::_hasLearningProgressLearner() && // #12042
                         ilObjUserTracking::_hasLearningProgressListGUI())
                 {                                                                                       
                         // -- validate
                         
                         // :TODO: we need the parent ref id, but this is awful
                         $a_obj_ids = self::validateLPForObjects($user_id, $a_obj_ids, (int)$_GET["ref_id"]);
                         
                         // we are not handling the collections differently yet
                         $coll_obj_ids = array();
                         $a_obj_ids = self::checkLPModesForObjects($a_obj_ids, $coll_obj_ids);
                         
                         
                         // -- gather
                         
                         $res = self::getLPStatusForObjects($user_id, $a_obj_ids);
                         
                         
                         // -- render
 
                         // value to icon
                         $lng->loadLanguageModule("trac");               
                         include_once("./Services/Tracking/classes/class.ilLearningProgressBaseGUI.php");
                         foreach($res as $obj_id => $status)
                         {                       
                                 $path = ilLearningProgressBaseGUI::_getImagePathForStatus($status);
                                 $text = ilLearningProgressBaseGUI::_getStatusText($status);
                                 $res[$obj_id] = ilUtil::img($path, $text);                      
                         }
                 }
                 
                 self::$list_gui_cache = $res;           
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ raiseEvent()

ilLPStatus::raiseEvent	(	$a_obj_id,
		$a_usr_id,
		$a_status,
		$a_percentage
	)

protected

Definition at line 286 of file class.ilLPStatus.php.

         {
                 global $ilAppEventHandler;
                 
                 $ilAppEventHandler->raise("Services/Tracking", "updateStatus", array(
                         "obj_id" => $a_obj_id,
                         "usr_id" => $a_usr_id,
                         "status" => $a_status,
                         "percentage" => $a_percentage
                         ));
         }

◆ refreshStatus()

ilLPStatus::refreshStatus	(	$a_obj_id,
		$a_users = `null`
	)

Refresh status.

Parameters

Definition at line 304 of file class.ilLPStatus.php.

References $failed, ilLPStatusWrapper\_getCompleted(), ilLPStatusWrapper\_getFailed(), ilLPStatusWrapper\_getInProgress(), ilLPStatusWrapper\_getNotAttempted(), ilLPStatusWrapper\_updateStatus(), and determinePercentage().

         {
                 include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                 $not_attempted = ilLPStatusWrapper::_getNotAttempted($a_obj_id);
                 foreach ($not_attempted as $user_id)
                 {
                         $percentage = $this->determinePercentage($a_obj_id, $user_id);
                         if(self::writeStatus($a_obj_id, $user_id, self::LP_STATUS_NOT_ATTEMPTED_NUM, $percentage, true))
                         {
                                 self::raiseEvent($a_obj_id, $user_id, self::LP_STATUS_NOT_ATTEMPTED_NUM, $percentage);
                         }
                 }
                 $in_progress = ilLPStatusWrapper::_getInProgress($a_obj_id);
                 foreach ($in_progress as $user_id)
                 {
                         $percentage = $this->determinePercentage($a_obj_id, $user_id);
                         if(self::writeStatus($a_obj_id, $user_id, self::LP_STATUS_IN_PROGRESS_NUM, $percentage, true))
                         {
                                 self::raiseEvent($a_obj_id, $user_id, self::LP_STATUS_IN_PROGRESS_NUM, $percentage);
                         }
                 }
                 $completed = ilLPStatusWrapper::_getCompleted($a_obj_id);
                 foreach ($completed as $user_id)
                 {
                         $percentage = $this->determinePercentage($a_obj_id, $user_id);
                         if(self::writeStatus($a_obj_id, $user_id, self::LP_STATUS_COMPLETED_NUM, $percentage, true))
                         {
                                 self::raiseEvent($a_obj_id, $user_id, self::LP_STATUS_COMPLETED_NUM, $percentage);
                         }
                 }
                 $failed = ilLPStatusWrapper::_getFailed($a_obj_id);
                 foreach ($failed as $user_id)
                 {
                         $percentage = $this->determinePercentage($a_obj_id, $user_id);
                         if(self::writeStatus($a_obj_id, $user_id, self::LP_STATUS_FAILED_NUM, $percentage, true))
                         {
                                 self::raiseEvent($a_obj_id, $user_id, self::LP_STATUS_FAILED_NUM, $percentage);
                         }
                 }               
                 if($a_users)
                 {               
                         $missing_users = array_diff($a_users, $not_attempted+$in_progress+$completed+$failed);                  
                         if($missing_users)
                         {
                                 foreach ($missing_users as $user_id)
                                 {               
                                         ilLPStatusWrapper::_updateStatus($a_obj_id, $user_id);
                                 }
                         }
                 }
         }

Here is the call graph for this function:

◆ setAllDirty()

static ilLPStatus::setAllDirty ( )

static

Sets all status to dirty.

For testing puproses.

Parameters

Definition at line 515 of file class.ilLPStatus.php.

References $ilDB.

         {
                 global $ilDB;
         
                 $ilDB->manipulate("UPDATE ut_lp_marks SET ".
                         " status_dirty = ".$ilDB->quote(1, "integer")
                         );
                 
         }

◆ setDirty()

static ilLPStatus::setDirty ( $a_obj_id )

static

Sets status of an object to dirty.

Parameters

integer object id

Returns

Definition at line 531 of file class.ilLPStatus.php.

References $ilDB.

         {
                 global $ilDB;
         
                 $ilDB->manipulate("UPDATE ut_lp_marks SET ".
                         " status_dirty = ".$ilDB->quote(1, "integer").
                         " WHERE obj_id = ".$ilDB->quote($a_obj_id, "integer")
                         );
         }

◆ setInProgressIfNotAttempted()

static ilLPStatus::setInProgressIfNotAttempted	(	$a_obj_id,
		$a_user_id
	)

static

This function shoudl be clalled for normal "read events".

The "in progress" status is only written, if current status is "NOT ATTEMPTED"

Definition at line 476 of file class.ilLPStatus.php.

References $ilDB, and ilLPStatusWrapper\_updateStatus().

Referenced by ilLearningProgress\_tracProgress().

         {
                 global $ilDB;
                 
                 // #11513
 
                 $needs_update = false;
 
                 $set = $ilDB->query("SELECT usr_id, status FROM ut_lp_marks WHERE ".
                         " obj_id = ".$ilDB->quote($a_obj_id, "integer")." AND ".
                         " usr_id = ".$ilDB->quote($a_user_id, "integer")
                         );                      
                 if ($rec = $ilDB->fetchAssoc($set))
                 {
                         // current status is not attempted, so we need to update
                         if($rec["status"] == self::LP_STATUS_NOT_ATTEMPTED_NUM)
                         {
                                 $needs_update = true;
                         }
                 }
                 else
                 {
                         // no ut_lp_marks yet, we should update
                         $needs_update = true;
                 }
                         
                 if($needs_update)
                 {
                         require_once "Services/Tracking/classes/class.ilLPStatusWrapper.php";
                         ilLPStatusWrapper::_updateStatus($a_obj_id, $a_user_id);
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ validateLPForObjects()

static ilLPStatus::validateLPForObjects	(	$a_user_id,
		$a_obj_ids,
		$a_parent_ref_id
	)

staticprotected

Process given objects for lp-relevance.

Parameters

int	$a_user_id
array	$a_obj_ids
int	$a_parent_ref_id

Returns: arraye

Definition at line 732 of file class.ilLPStatus.php.

References $obj_id, and ilObjectLP\getLPMemberships().

         {               
                 $lp_invalid = array();
                 
                 include_once "Services/Object/classes/class.ilObjectLP.php";                    
                 $memberships = ilObjectLP::getLPMemberships($a_user_id, $a_obj_ids, $a_parent_ref_id);
                 foreach($memberships as $obj_id => $status)
                 {
                         if(!$status)
                         {
                                 $lp_invalid[] = $obj_id;
                         }
                 }
                 
                 return array_diff($a_obj_ids, $lp_invalid);
         }

Here is the call graph for this function:

◆ writeStatus()

static ilLPStatus::writeStatus	(	$a_obj_id,
		$a_user_id,
		$a_status,
		$a_percentage = `false`,
		$a_force_per = `false`
	)

static

Write status for user and object.

Parameters

Definition at line 362 of file class.ilLPStatus.php.

References $ilDB, $ret, ilObject\_lookupType(), ilLPStatusWrapper\_removeStatusCache(), and ilLPStatusWrapper\_updateStatus().

Referenced by ilLPStatusSCORMPackage\refreshStatus(), ilLPStatusSCORM\refreshStatus(), ilObjSCORMTracking\syncGlobalStatus(), and ilSCORM2004StoreData\syncGlobalStatus().

         {
                 global $ilDB;
                                 
                 $update_collections = false;
 
                 // get status in DB
                 $set = $ilDB->query("SELECT usr_id,status,status_dirty FROM ut_lp_marks WHERE ".
                         " obj_id = ".$ilDB->quote($a_obj_id, "integer")." AND ".
                         " usr_id = ".$ilDB->quote($a_user_id, "integer")
                         );
                 $rec = $ilDB->fetchAssoc($set); 
                 
                 // update
                 if ($rec)
                 {
                         // status has changed: update
                         if ($rec["status"] != $a_status)
                         {
                                 $ret = $ilDB->manipulate("UPDATE ut_lp_marks SET ".
                                         " status = ".$ilDB->quote($a_status, "integer").",".
                                         " status_changed = ".$ilDB->now().",".
                                         " status_dirty = ".$ilDB->quote(0, "integer").
                                         " WHERE usr_id = ".$ilDB->quote($a_user_id, "integer").
                                         " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                                         );
                                 if ($ret != 0)
                                 {
                                         $update_collections = true;
                                 }
                         }
                         // status has not changed: reset dirty flag
                         else if ($rec["status_dirty"])
                         {
                                 $ilDB->manipulate("UPDATE ut_lp_marks SET ".
                                         " status_dirty = ".$ilDB->quote(0, "integer").
                                         " WHERE usr_id = ".$ilDB->quote($a_user_id, "integer").
                                         " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                                         );
                         }
                 }
                 // insert
                 else
                 {
                         /*
                         $ilDB->manipulate("INSERT INTO ut_lp_marks ".
                                 "(status, status_changed, usr_id, obj_id, status_dirty) VALUES (".
                                 $ilDB->quote($a_status, "integer").",".
                                 $ilDB->now().",".
                                 $ilDB->quote($a_user_id, "integer").",".
                                 $ilDB->quote($a_obj_id, "integer").",".
                                 $ilDB->quote(0, "integer").
                                 ")");
                         */
                         
                         // #13783
                         $ilDB->replace("ut_lp_marks",
                                 array(
                                         "obj_id" => array("integer", $a_obj_id),
                                         "usr_id" => array("integer", $a_user_id)
                                 ),
                                 array(
                                         "status" => array("integer", $a_status),
                                         "status_changed" => array("timestamp", date("Y-m-d H:i:s")), // was $ilDB->now()
                                         "status_dirty" => array("integer", 0)
                                 )
                         );                      
                         
                         $update_collections = true;
                 }
 
                 // update percentage
                 if ($a_percentage !== false || $a_force_per)
                 {
                         $a_percentage = max(0, (int) $a_percentage);
                         $a_percentage = min(100, $a_percentage);
                         $ret = $ilDB->manipulate("UPDATE ut_lp_marks SET ".
                                 " percentage = ".$ilDB->quote($a_percentage, "integer").
                                 " WHERE usr_id = ".$ilDB->quote($a_user_id, "integer").
                                 " AND obj_id = ".$ilDB->quote($a_obj_id, "integer")
                                 );
                 }
 
                 // update collections
                 if ($update_collections)
                 {
                         // a change occured - remove existing cache entry
                         include_once("./Services/Tracking/classes/class.ilLPStatusWrapper.php");
                         ilLPStatusWrapper::_removeStatusCache($a_obj_id, $a_user_id);                   
                         
                         $set = $ilDB->query("SELECT ut_lp_collections.obj_id obj_id FROM ".
                                 "object_reference JOIN ut_lp_collections ON ".
                                 "(object_reference.obj_id = ".$ilDB->quote($a_obj_id, "integer").
                                 " AND object_reference.ref_id = ut_lp_collections.item_id)");
                         while ($rec = $ilDB->fetchAssoc($set))
                         {
                                 if (in_array(ilObject::_lookupType($rec["obj_id"]), array("crs", "grp", "fold")))
                                 {
                                         // just to make sure - remove existing cache entry 
                                         ilLPStatusWrapper::_removeStatusCache($rec["obj_id"], $a_user_id);
                                         
                                         ilLPStatusWrapper::_updateStatus($rec["obj_id"], $a_user_id);
                                 }
                         }
                 }
                 
                 return $update_collections;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $db

ilLPStatus::$db = null

Definition at line 19 of file class.ilLPStatus.php.

◆ $list_gui_cache

ilLPStatus::$list_gui_cache

static

Definition at line 21 of file class.ilLPStatus.php.

◆ $obj_id

ilLPStatus::$obj_id = null

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

Referenced by checkLPModesForObjects(), getLPStatusForObjects(), preloadListGUIData(), and validateLPForObjects().

◆ LP_STATUS_COMPLETED

const ilLPStatus::LP_STATUS_COMPLETED = 'trac_completed'

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

Referenced by ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilObjCourseGUI\fetchPrintMemberData(), ilGroupParticipantsTableGUI\fillRow(), ilCourseParticipantsTableGUI\fillRow(), ilTrQuery\getSCOsStatusForUser(), ilTrQuery\getSubItemsStatusForUser(), ilTrSummaryTableGUI\initFilter(), ilTrObjectUsersPropsTableGUI\initFilter(), ilObjGroupGUI\readMemberData(), and ilObjCourseGUI\readMemberData().

◆ LP_STATUS_COMPLETED_NUM

const ilLPStatus::LP_STATUS_COMPLETED_NUM = 2

Definition at line 30 of file class.ilLPStatus.php.

Referenced by ilLPObjectStatisticsLPTableGUI\__construct(), ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilLMExplorerGUI\checkLPIcon(), ilObjCourse\checkLPStatusSync(), ilLPStatusSurveyFinished\determineStatus(), ilLPStatusStudyProgramme\determineStatus(), ilTrSummaryTableGUI\fillHeaderCSV(), ilTrSummaryTableGUI\fillHeaderExcel(), ilLPProgressTableGUI\fillRow(), ilTrObjectUsersPropsTableGUI\fillRow(), ilTrMatrixTableGUI\fillRow(), ilLPObjectStatisticsLPTableGUI\getGraph(), ilTrMatrixTableGUI\getItems(), ilTrSummaryTableGUI\getItems(), ilLOUserResults\getObjectiveStatusForLP(), ilTrQuery\getObjectsDataForUser(), ilSoapSCORMAdministration\getSCORMCompletionStatus(), ilLOUserResults\getSummarizedObjectiveStatusForLP(), ilTrQuery\getUserObjectiveMatrix(), ilCourseAppEventListener\handleEvent(), ilObjSCORM2004LearningModule\importSuccess(), ilObjSCORMLearningModule\importSuccess(), ilLearningProgressGUI\initCollectionManualForm(), ilLearningProgressBaseGUI\initEditUserForm(), ilTrSummaryTableGUI\initFilter(), ilTrObjectUsersPropsTableGUI\initFilter(), ilStudyProgrammeLeafMock\markCompletedFor(), ilStudyProgrammeAppEventListener\onServiceTrackingUpdateStatus(), ilLearningProgressGUI\showtlt(), ilStudyProgrammeLPTest\testMarkAccredited(), and ilStudyProgrammeLPTest\testUnmarkAccredited().

◆ LP_STATUS_FAILED

const ilLPStatus::LP_STATUS_FAILED = 'trac_failed'

Definition at line 26 of file class.ilLPStatus.php.

Referenced by ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilObjCourseGUI\fetchPrintMemberData(), ilGroupParticipantsTableGUI\fillRow(), ilCourseParticipantsTableGUI\fillRow(), ilTrQuery\getSCOsStatusForUser(), ilObjSCORM2004LearningModule\importSuccess(), ilObjSCORMLearningModule\importSuccess(), ilTrSummaryTableGUI\initFilter(), ilTrObjectUsersPropsTableGUI\initFilter(), ilObjGroupGUI\readMemberData(), and ilObjCourseGUI\readMemberData().

◆ LP_STATUS_FAILED_NUM

const ilLPStatus::LP_STATUS_FAILED_NUM = 3

Definition at line 31 of file class.ilLPStatus.php.

Referenced by ilLPObjectStatisticsLPTableGUI\__construct(), ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilObjSAHSLearningModuleAccess\checkCondition(), ilTrSummaryTableGUI\fillHeaderCSV(), ilTrSummaryTableGUI\fillHeaderExcel(), ilLPObjectStatisticsLPTableGUI\getGraph(), ilTrMatrixTableGUI\getItems(), ilTrSummaryTableGUI\getItems(), ilLOUserResults\getObjectiveStatusForLP(), ilTrQuery\getObjectsDataForUser(), ilSoapSCORMAdministration\getSCORMCompletionStatus(), ilLOUserResults\getSummarizedObjectiveStatusForLP(), ilTrQuery\getUserObjectiveMatrix(), ilObjSCORM2004LearningModule\importSuccess(), ilObjSCORMLearningModule\importSuccess(), ilTrSummaryTableGUI\initFilter(), and ilTrObjectUsersPropsTableGUI\initFilter().

◆ LP_STATUS_IN_PROGRESS

const ilLPStatus::LP_STATUS_IN_PROGRESS = 'trac_in_progress'

Definition at line 24 of file class.ilLPStatus.php.

Referenced by ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilObjCourseGUI\fetchPrintMemberData(), ilGroupParticipantsTableGUI\fillRow(), ilCourseParticipantsTableGUI\fillRow(), ilTrQuery\getSCOsStatusForUser(), ilTrQuery\getSubItemsStatusForUser(), ilObjSCORM2004LearningModule\importSuccess(), ilObjSCORMLearningModule\importSuccess(), ilTrSummaryTableGUI\initFilter(), ilTrObjectUsersPropsTableGUI\initFilter(), ilObjGroupGUI\readMemberData(), and ilObjCourseGUI\readMemberData().

◆ LP_STATUS_IN_PROGRESS_NUM

const ilLPStatus::LP_STATUS_IN_PROGRESS_NUM = 1

Definition at line 29 of file class.ilLPStatus.php.

Referenced by ilLPObjectStatisticsLPTableGUI\__construct(), ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLPStatusObjectives\_getStatusInfo(), ilLearningProgressBaseGUI\_getStatusText(), ilLMExplorerGUI\checkLPIcon(), ilLPStatusSurveyFinished\determineStatus(), ilLPStatusStudyProgramme\determineStatus(), ilTrSummaryTableGUI\fillHeaderCSV(), ilTrSummaryTableGUI\fillHeaderExcel(), ilLPObjectStatisticsLPTableGUI\getGraph(), ilTrMatrixTableGUI\getItems(), ilTrSummaryTableGUI\getItems(), ilLOUserResults\getObjectiveStatusForLP(), ilTrQuery\getObjectsDataForUser(), ilSoapSCORMAdministration\getSCORMCompletionStatus(), ilLOUserResults\getSummarizedObjectiveStatusForLP(), ilTrQuery\getUserObjectiveMatrix(), ilObjSCORM2004LearningModule\importSuccess(), ilObjSCORMLearningModule\importSuccess(), ilLPObjectStatisticsLPTableGUI\initFilter(), ilTrSummaryTableGUI\initFilter(), ilTrObjectUsersPropsTableGUI\initFilter(), ilLearningProgressGUI\showtlt(), ilStudyProgrammeLPTest\testInitialLPActive(), ilStudyProgrammeLPTest\testInitialLPDraft(), ilStudyProgrammeLPTest\testInitialProgressOutdated(), ilStudyProgrammeLPTest\testMarkAccredited(), ilStudyProgrammeLPTest\testMarkNotRelevant(), and ilStudyProgrammeLPTest\testUnmarkAccredited().

◆ LP_STATUS_NOT_ATTEMPTED

const ilLPStatus::LP_STATUS_NOT_ATTEMPTED = 'trac_no_attempted'

Definition at line 23 of file class.ilLPStatus.php.

Referenced by ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getImagePathForStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilObjCourseGUI\fetchPrintMemberData(), ilGroupParticipantsTableGUI\fillRow(), ilCourseParticipantsTableGUI\fillRow(), ilTrQuery\getSCOsStatusForUser(), ilTrQuery\getSubItemsStatusForUser(), ilObjSCORM2004LearningModule\importSuccess(), ilObjSCORMLearningModule\importSuccess(), ilTrSummaryTableGUI\initFilter(), ilTrObjectUsersPropsTableGUI\initFilter(), ilObjGroupGUI\readMemberData(), and ilObjCourseGUI\readMemberData().

◆ LP_STATUS_NOT_ATTEMPTED_NUM

const ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM = 0

Definition at line 28 of file class.ilLPStatus.php.

Referenced by ilLPObjectStatisticsLPTableGUI\__construct(), ilLearningProgressBaseGUI\__readStatus(), ilLearningProgressBaseGUI\_getStatusText(), ilTrQuery\buildFilters(), ilLMExplorerGUI\checkLPIcon(), ilLPStatusSurveyFinished\determineStatus(), ilLPStatusStudyProgramme\determineStatus(), ilTrSummaryTableGUI\fillHeaderCSV(), ilTrSummaryTableGUI\fillHeaderExcel(), ilTrMatrixTableGUI\fillRow(), ilScormMailTemplateLPContext\getDescription(), ilCourseMailTemplateTutorContext\getDescription(), ilLPObjectStatisticsLPTableGUI\getGraph(), ilTrMatrixTableGUI\getItems(), ilTrSummaryTableGUI\getItems(), ilTrQuery\getObjectivesStatusForUser(), ilTrQuery\getObjectsDataForUser(), ilTrQuery\getUserObjectiveMatrix(), ilObjSCORM2004LearningModule\importSuccess(), ilObjSCORMLearningModule\importSuccess(), ilLearningProgressGUI\initCollectionManualForm(), ilTrSummaryTableGUI\initFilter(), ilTrObjectUsersPropsTableGUI\initFilter(), ilLearningProgressGUI\showtlt(), ilStudyProgrammeLPTest\testInitialLPDraft(), ilStudyProgrammeLPTest\testInitialProgressOutdated(), ilStudyProgrammeLPTest\testMarkNotRelevant(), and ilStudyProgrammeLPTest\testNewNodesAreNotRelevant().

◆ LP_STATUS_NOT_PARTICIPATED

const ilLPStatus::LP_STATUS_NOT_PARTICIPATED = 'trac_not_participated'

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

Referenced by ilLearningProgressBaseGUI\_getImagePathForStatus().

◆ LP_STATUS_NOT_REGISTERED

const ilLPStatus::LP_STATUS_NOT_REGISTERED = 'trac_not_registered'

Definition at line 34 of file class.ilLPStatus.php.

Referenced by ilLearningProgressBaseGUI\_getImagePathForStatus().

◆ LP_STATUS_PARTICIPATED

const ilLPStatus::LP_STATUS_PARTICIPATED = 'trac_participated'

Definition at line 35 of file class.ilLPStatus.php.

Referenced by ilLearningProgressBaseGUI\_getImagePathForStatus().

◆ LP_STATUS_REGISTERED

const ilLPStatus::LP_STATUS_REGISTERED = 'trac_registered'

Definition at line 33 of file class.ilLPStatus.php.

Referenced by ilLearningProgressBaseGUI\_getImagePathForStatus().

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

Services/Tracking/classes/class.ilLPStatus.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Detailed Description

Member Function Documentation

◆ _getCompleted()

◆ _getCountCompleted()

◆ _getCountFailed()

◆ _getCountInProgress()

◆ _getCountNotAttempted()

◆ _getFailed()

◆ _getInProgress()

◆ _getNotAttempted()

◆ _getStatusInfo()

◆ _getTypicalLearningTime()

◆ _hasUserCompleted()

◆ _lookupCompletedForObject()

◆ _lookupFailedForObject()

◆ _lookupInProgressForObject()

◆ _lookupPercentage()

◆ _lookupStatus()

◆ _lookupStatusChanged()

◆ _lookupStatusForObject()

◆ _updateStatus()

- ilLearningProgress->_tracProgress() added to:

◆ checkLPModesForObjects()

◆ checkStatusForObject()

◆ determinePercentage()

◆ determineStatus()

◆ getListGUIStatus()

◆ getLPStatusForObjects()

◆ ilLPStatus()

◆ preloadListGUIData()

◆ raiseEvent()

◆ refreshStatus()

◆ setAllDirty()

◆ setDirty()

◆ setInProgressIfNotAttempted()

◆ validateLPForObjects()

◆ writeStatus()

Field Documentation

◆ $db

◆ $list_gui_cache

◆ $obj_id

◆ LP_STATUS_COMPLETED

◆ LP_STATUS_COMPLETED_NUM

◆ LP_STATUS_FAILED

◆ LP_STATUS_FAILED_NUM

◆ LP_STATUS_IN_PROGRESS

◆ LP_STATUS_IN_PROGRESS_NUM

◆ LP_STATUS_NOT_ATTEMPTED

◆ LP_STATUS_NOT_ATTEMPTED_NUM

◆ LP_STATUS_NOT_PARTICIPATED

◆ LP_STATUS_NOT_REGISTERED

◆ LP_STATUS_PARTICIPATED

◆ LP_STATUS_REGISTERED