Inheritance diagram for ilCertificateAppEventListener:

Collaboration diagram for ilCertificateAppEventListener:

Public Member Functions
	__construct (\ilDBInterface $db, \ilObjectDataCache $objectDataCache, \ilLogger $logger)
	ilCertificateAppEventListener constructor. More...

	withComponent (string $component)

	withEvent (string $event)

	withParameters (array $parameters)

	handle ()

Static Public Member Functions

static handleEvent ($a_component, $a_event, $a_parameter)

Handle an event in a listener.

Parameters

string	$a_component	component, e.g. "Modules/Forum" or "Services/User"
string	$a_event	event e.g. "createUser", "updateUser", "deleteUser", ...
array	$a_parameter	parameter array (assoc), array("name" => ..., "phone_office" => ...)

More...

Protected Member Functions
	isLearningAchievementEvent ()

	isUserDeletedEvent ()

	isCompletedStudyProgramme ()

Protected Attributes
	$db

	$component = ''

	$event = ''

	$parameters = []

Private Member Functions
	handleLPUpdate ()

	handleDeletedUser ()

	processEntry ($type, $objectId, int $userId, ilCertificateTemplate $template, ilSetting $settings)

	handleCompletedStudyProgramme ()

Private Attributes
	$objectDataCache

	$logger

	$certificateQueueRepository

	$certificateClassMap

	$templateRepository

	$userCertificateRepository

Detailed Description

Definition at line 12 of file class.ilCertificateAppEventListener.php.

Constructor & Destructor Documentation

◆ __construct()

ilCertificateAppEventListener::__construct	(	\ilDBInterface	$db,
		\ilObjectDataCache	$objectDataCache,
		\ilLogger	$logger
	)

ilCertificateAppEventListener constructor.

Parameters

\ilDBInterface	$db
\ilObjectDataCache	$objectDataCache
\ilLogger	$logger

Definition at line 58 of file class.ilCertificateAppEventListener.php.

References $db, $logger, and $objectDataCache.

       {
         $this->db = $db;
         $this->objectDataCache = $objectDataCache;
         $this->logger = $logger;
         $this->certificateQueueRepository = new \ilCertificateQueueRepository($this->db, $this->logger);
         $this->certificateClassMap = new \ilCertificateTypeClassMap();
         $this->templateRepository = new \ilCertificateTemplateRepository($this->db, $this->logger);
         $this->userCertificateRepository = new \ilUserCertificateRepository($this->db, $this->logger);
     }

Member Function Documentation

◆ handle()

ilCertificateAppEventListener::handle ( )

Definition at line 144 of file class.ilCertificateAppEventListener.php.

References Vendor\Package\$e, handleCompletedStudyProgramme(), handleDeletedUser(), handleLPUpdate(), isCompletedStudyProgramme(), isLearningAchievementEvent(), and isUserDeletedEvent().

     {
         try {
             if ($this->isLearningAchievementEvent()) {
                 $this->handleLPUpdate();
             } elseif ($this->isUserDeletedEvent()) {
                 $this->handleDeletedUser();
             } elseif ($this->isCompletedStudyProgramme()) {
                 $this->handleCompletedStudyProgramme();
             }
         } catch (\ilException $e) {
             $this->logger->error($e->getMessage());
         }
     }

Here is the call graph for this function:

◆ handleCompletedStudyProgramme()

ilCertificateAppEventListener::handleCompletedStudyProgramme ( )

private

Definition at line 365 of file class.ilCertificateAppEventListener.php.

References ilCronConstants\IN_PROGRESS.

Referenced by handle().

     {
         $settings = new ilSetting('certificate');
         $objectId = $this->parameters['prg_id'] ?? 0;
         $userId = $this->parameters['usr_id'] ?? 0;
         try {
             $template = $this->templateRepository->fetchCurrentlyActiveCertificate($objectId);
             if (true === $template->isCurrentlyActive()) {
                 $entry = new \ilCertificateQueueEntry(
                     $objectId,
                     $userId,
                     ilStudyProgrammePlaceholderValues::class,
                     \ilCronConstants::IN_PROGRESS,
                     $template->getId(),
                     time()
                                                       );
                 $mode = $settings->get('persistent_certificate_mode', '');
                 if ($mode === 'persistent_certificate_mode_instant') {
                     $cronjob = new ilCertificateCron();
                     $cronjob->init();
                     return $cronjob->processEntry(0, $entry, array());
                 }
                 $this->certificateQueueRepository->addToQueue($entry);
             }
         } catch (ilException $exception) {
             $this->logger->warning($exception->getMessage());
         }
     }

Here is the caller graph for this function:

◆ handleDeletedUser()

ilCertificateAppEventListener::handleDeletedUser ( )

private

Exceptions

Definition at line 306 of file class.ilCertificateAppEventListener.php.

Referenced by handle().

     {
         $portfolioFileService = new ilPortfolioCertificateFileService();
 
         if (false === array_key_exists('usr_id', $this->parameters)) {
             $this->logger->error('User ID is not added to the event. Abort.');
             return;
         }
 
         $this->logger->info('User has been deleted. Try to delete user certificates');
 
         $userId = $this->parameters['usr_id'];
 
         $this->userCertificateRepository->deleteUserCertificates((int) $userId);
 
         $this->certificateQueueRepository->removeFromQueueByUserId((int) $userId);
 
         $portfolioFileService->deleteUserDirectory($userId);
 
         $this->logger->info(sprintf(
             'All relevant data sources for the user certificates for user(user_id: "%s" deleted)',
             $userId
         ));
     }

Here is the caller graph for this function:

◆ handleEvent()

static ilCertificateAppEventListener::handleEvent	(	$a_component,
		$a_event,
		$a_parameter
	)

static

Handle an event in a listener.

Parameters

string	$a_component	component, e.g. "Modules/Forum" or "Services/User"
string	$a_event	event e.g. "createUser", "updateUser", "deleteUser", ...
array	$a_parameter	parameter array (assoc), array("name" => ..., "phone_office" => ...)

Implements ilAppEventListener.

Definition at line 162 of file class.ilCertificateAppEventListener.php.

References $DIC.

     {
         global $DIC;
 
         $listener = new static(
             $DIC->database(),
             $DIC['ilObjDataCache'],
             $DIC->logger()->cert()
         );
 
         $listener
             ->withComponent($a_component)
             ->withEvent($a_event)
             ->withParameters($a_parameter)
             ->handle();
     }

◆ handleLPUpdate()

ilCertificateAppEventListener::handleLPUpdate ( )

private

Exceptions

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

References $refId, $templateRepository, $type, ilObject\_getAllReferences(), ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM, and processEntry().

Referenced by handle().

     {
         $status = $this->parameters['status'] ?? \ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM;
 
         $settings = new ilSetting('certificate');
 
         if ($status == \ilLPStatus::LP_STATUS_COMPLETED_NUM) {
             $objectId = $this->parameters['obj_id'] ?? 0;
             $userId = $this->parameters['usr_id'] ?? 0;
 
             $type = $this->objectDataCache->lookupType($objectId);
 
             $this->logger->info(sprintf(
                 "Certificate evaluation triggered, received 'completed' learning progress for: usr_id: %s/obj_id: %s/type: %s",
                 $userId,
                 $objectId,
                 $type
             ));
 
             if ($this->certificateClassMap->typeExistsInMap($type)) {
                 try {
                     $template = $this->templateRepository->fetchCurrentlyActiveCertificate($objectId);
 
                     if (true === $template->isCurrentlyActive()) {
                         $this->logger->info(sprintf(
                             "Trigger persisting certificate achievement for: usr_id: %s/obj_id: %s/type: %s/template_id: %s",
                             $userId,
                             $objectId,
                             $type,
                             $template->getId()
                         ));
                         $this->processEntry($type, $objectId, $userId, $template, $settings);
                     } else {
                         $this->logger->info(sprintf(
                             "Did not trigger certificate achievement for inactive template: usr_id: %s/obj_id: %s/type: %s/template_id: %s",
                             $userId,
                             $objectId,
                             $type,
                             $template->getId()
                         ));
                     }
                 } catch (ilException $exception) {
                     $this->logger->info(sprintf(
                         "Did not find an active certificate template for case: usr_id: %s/obj_id: %s/type: %s",
                         $userId,
                         $objectId,
                         $type
                     ));
                 }
             } else {
                 $this->logger->info(sprintf(
                     "Object type is not of interest, skipping certificate evaluation for this object"
                 ));
             }
 
             if ($type === 'crs') {
                 $this->logger->info(
                     'Skipping handling for course, because courses cannot be certificate trigger ' .
                     '(with globally disabled learning progress) for other certificate enabled objects'
                 );
                 return;
             }
 
             $this->logger->info(
                 'Triggering certificate evaluation of possible depending course objects ...'
             );
 
             foreach (\ilObject::_getAllReferences($objectId) as $refId) {
                 $templateRepository = new \ilCertificateTemplateRepository($this->db, $this->logger);
                 $progressEvaluation = new \ilCertificateCourseLearningProgressEvaluation($templateRepository);
 
                 $templatesOfCompletedCourses = $progressEvaluation->evaluate($refId, $userId);
                 if (0 === count($templatesOfCompletedCourses)) {
                     $this->logger->info(sprintf(
                         "No dependent course certificate template configuration found for child object: usr_id: %s/obj_id: %s/ref_id: %s/type: %s",
                         $userId,
                         $objectId,
                         $refId,
                         $type
                     ));
                     continue;
                 }
 
                 foreach ($templatesOfCompletedCourses as $courseTemplate) {
                     // We do not check if we support the type anymore, because the type 'crs' is always supported
                     try {
                         $courseObjectId = $courseTemplate->getObjId();
 
                         if (true === $courseTemplate->isCurrentlyActive()) {
                             $type = $this->objectDataCache->lookupType($courseObjectId);
 
                             $this->logger->info(sprintf(
                                 "Trigger persisting certificate achievement for: usr_id: %s/obj_id: %s/type: %s/template_id: %s",
                                 $userId,
                                 $courseObjectId,
                                 'crs',
                                 $courseTemplate->getId()
                             ));
                             $this->processEntry($type, $courseObjectId, $userId, $courseTemplate, $settings);
                         } else {
                             $this->logger->info(sprintf(
                                 "Did not trigger certificate achievement for inactive template: usr_id: %s/obj_id: %s/type: %s/template_id: %s",
                                 $userId,
                                 $objectId,
                                 $type,
                                 $courseTemplate->getId()
                             ));
                         }
                     } catch (ilException $exception) {
                         $this->logger->warning($exception->getMessage());
                         continue;
                     }
                 }
             }
 
             $this->logger->info(
                 'Finished certificate evaluation'
             );
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isCompletedStudyProgramme()

ilCertificateAppEventListener::isCompletedStudyProgramme ( )

protected

Definition at line 133 of file class.ilCertificateAppEventListener.php.

Referenced by handle().

                                                    : bool
     {
         return (
                 'Modules/StudyProgramme' === $this->component &&
                 'userSuccessful' === $this->event
                 );
     }

Here is the caller graph for this function:

◆ isLearningAchievementEvent()

ilCertificateAppEventListener::isLearningAchievementEvent ( )

protected

Returns: bool

Definition at line 114 of file class.ilCertificateAppEventListener.php.

Referenced by handle().

                                                     : bool
     {
         return (
             'Services/Tracking' === $this->component &&
             'updateStatus' === $this->event
         );
     }

Here is the caller graph for this function:

◆ isUserDeletedEvent()

ilCertificateAppEventListener::isUserDeletedEvent ( )

protected

Returns: bool

Definition at line 125 of file class.ilCertificateAppEventListener.php.

Referenced by handle().

                                             : bool
     {
         return (
             'Services/User' === $this->component &&
             'deleteUser' === $this->event
         );
     }

Here is the caller graph for this function:

◆ processEntry()

ilCertificateAppEventListener::processEntry	(		$type,
			$objectId,
		int	$userId,
		ilCertificateTemplate	$template,
		ilSetting	$settings
	)

private

Parameters

	$type
	$objectId
int	$userId
ilCertificateTemplate	$template
ilSetting	$settings

Exceptions

ilDatabaseException
ilException
ilInvalidCertificateException

Definition at line 341 of file class.ilCertificateAppEventListener.php.

References $type, ilSetting\get(), ilCertificateTemplate\getId(), and ilCronConstants\IN_PROGRESS.

Referenced by handleLPUpdate().

     {
         $className = $this->certificateClassMap->getPlaceHolderClassNameByType($type);
 
         $entry = new \ilCertificateQueueEntry(
             $objectId,
             $userId,
             $className,
             \ilCronConstants::IN_PROGRESS,
             $template->getId(),
             time()
         );
 
         $mode = $settings->get('persistent_certificate_mode', 'persistent_certificate_mode_cron');
         if ($mode === 'persistent_certificate_mode_instant') {
             $cronjob = new ilCertificateCron();
             $cronjob->init();
             $cronjob->processEntry(0, $entry, array());
             return;
         }
 
         $this->certificateQueueRepository->addToQueue($entry);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ withComponent()

ilCertificateAppEventListener::withComponent ( string $component )

Parameters

string $component

Returns

Definition at line 76 of file class.ilCertificateAppEventListener.php.

References $component.

                                                      : self
     {
         $clone = clone $this;
 
         $clone->component = $component;
 
         return $clone;
     }

◆ withEvent()

ilCertificateAppEventListener::withEvent ( string $event )

Parameters

string $event

Returns

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

References $event.

                                              : self
     {
         $clone = clone $this;
 
         $clone->event = $event;
 
         return $clone;
     }

◆ withParameters()

ilCertificateAppEventListener::withParameters ( array $parameters )

Parameters

array $parameters

Returns

Definition at line 102 of file class.ilCertificateAppEventListener.php.

References $parameters.

                                                       : self
     {
         $clone = clone $this;
 
         $clone->parameters = $parameters;
 
         return $clone;
     }