Inheritance diagram for ilLTIConsumerPlaceholderValues:

Collaboration diagram for ilLTIConsumerPlaceholderValues:

Public Member Functions
	__construct (ilDefaultPlaceholderValues $defaultPlaceholderValues=null, ilLanguage $language=null, ilCertificateObjectHelper $objectHelper=null, ilCertificateUserObjectHelper $userObjectHelper=null, ilCertificateLPStatusHelper $lpStatusHelper=null, ilCertificateUtilHelper $utilHelper=null, ilCertificateDateHelper $dateHelper=null)

	getPlaceholderValuesForPreview (int $userId, int $objId)
	This method is different then the 'getPlaceholderValues' method, this method is used to create a placeholder value array containing dummy values that is used to create a preview certificate. More...

	getPlaceholderValues (int $userId, int $objId)
	This method MUST return an array that contains the actual data for the given user of the given object. More...

Protected Member Functions
	getMasteryScore (ilObjLTIConsumer $object)

	getReachedScore (ilObjLTIConsumer $object, int $userId)

Private Attributes
	$defaultPlaceholderValuesObject

	$objectHelper

	$userObjectHelper

	$utilHelper

	$lpStatusHelper

	$dateHelper

	$language

Detailed Description

Definition at line 13 of file class.ilLTIConsumerPlaceholderValues.php.

Constructor & Destructor Documentation

◆ __construct()

ilLTIConsumerPlaceholderValues::__construct	(	ilDefaultPlaceholderValues	$defaultPlaceholderValues = `null`,
		ilLanguage	$language = `null`,
		ilCertificateObjectHelper	$objectHelper = `null`,
		ilCertificateUserObjectHelper	$userObjectHelper = `null`,
		ilCertificateLPStatusHelper	$lpStatusHelper = `null`,
		ilCertificateUtilHelper	$utilHelper = `null`,
		ilCertificateDateHelper	$dateHelper = `null`
	)

Parameters

ilDefaultPlaceholderValues	$defaultPlaceholderValues
ilLanguage \| null	$language
ilCertificateObjectHelper \| null	$objectHelper
ilCertificateTestObjectHelper \| null	$testObjectHelper
ilCertificateUserObjectHelper \| null	$userObjectHelper
ilCertificateLPStatusHelper \| null	$lpStatusHelper
ilCertificateUtilHelper \| null	$utilHelper
ilDatePresentation \| null	$dateHelper

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

References $dateHelper, $DIC, $language, $lpStatusHelper, $objectHelper, $userObjectHelper, $utilHelper, and language().

       {
         if (null === $language) {
             global $DIC; /* @var \ILIAS\DI\Container $DIC */
             $language = $DIC->language();
         }
         $this->language = $language;
 
         if (null === $defaultPlaceholderValues) {
             $defaultPlaceholderValues = new ilDefaultPlaceholderValues();
         }
         $this->defaultPlaceholderValuesObject = $defaultPlaceholderValues;
 
         if (null === $objectHelper) {
             $objectHelper = new ilCertificateObjectHelper();
         }
         $this->objectHelper = $objectHelper;
 
         if (null === $userObjectHelper) {
             $userObjectHelper = new ilCertificateUserObjectHelper();
         }
         $this->userObjectHelper = $userObjectHelper;
 
         if (null === $lpStatusHelper) {
             $lpStatusHelper = new ilCertificateLPStatusHelper();
         }
         $this->lpStatusHelper = $lpStatusHelper;
 
         if (null === $utilHelper) {
             $utilHelper = new ilCertificateUtilHelper();
         }
         $this->utilHelper = $utilHelper;
 
         if (null === $dateHelper) {
             $dateHelper = new ilCertificateDateHelper();
         }
         $this->dateHelper = $dateHelper;
     }

Here is the call graph for this function:

Member Function Documentation

◆ getMasteryScore()

ilLTIConsumerPlaceholderValues::getMasteryScore ( ilObjLTIConsumer $object )

protected

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

References ilObjLTIConsumer\getMasteryScorePercent().

Referenced by getPlaceholderValues().

                                                                  : string
     {
         $masteryScore = sprintf('%0.2f %%', $object->getMasteryScorePercent());
         return $masteryScore;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPlaceholderValues()

ilLTIConsumerPlaceholderValues::getPlaceholderValues	(	int	$userId,
		int	$objId
	)

This method MUST return an array that contains the actual data for the given user of the given object.

ilInvalidCertificateException MUST be thrown if the data could not be determined or the user did NOT achieve the certificate.

Parameters

int	$userId
int	$objId

Exceptions

ilInvalidCertificateException

Returns: mixed - [PLACEHOLDER] => 'actual value'

Implements ilCertificatePlaceholderValues.

Definition at line 119 of file class.ilLTIConsumerPlaceholderValues.php.

References getMasteryScore(), and getReachedScore().

                                                                   : array
     {
         $placeholders = $this->defaultPlaceholderValuesObject->getPlaceholderValues($userId, $objId);
 
         /* @var ilObjLTIConsumer $object */
         $object = $this->objectHelper->getInstanceByObjId($objId);
 
         $placeholders['OBJECT_TITLE'] = $this->utilHelper->prepareFormOutput($object->getTitle());
         $placeholders['OBJECT_DESCRIPTION'] = $this->utilHelper->prepareFormOutput($object->getDescription());
 
         $placeholders['MASTERY_SCORE'] = $this->utilHelper->prepareFormOutput($this->getMasteryScore($object));
         $placeholders['REACHED_SCORE'] = $this->utilHelper->prepareFormOutput($this->getReachedScore($object, $userId));
         
         $completionDate = $this->lpStatusHelper->lookupStatusChanged($objId, $userId);
         if ($completionDate !== false &&
             $completionDate !== null &&
             $completionDate !== ''
         ) {
             $placeHolders['DATE_COMPLETED'] = $this->dateHelper->formatDate($completionDate);
             $placeHolders['DATETIME_COMPLETED'] = $this->dateHelper->formatDateTime($completionDate);
         }
 
         return $placeholders;
     }

Here is the call graph for this function:

◆ getPlaceholderValuesForPreview()

ilLTIConsumerPlaceholderValues::getPlaceholderValuesForPreview	(	int	$userId,
		int	$objId
	)

This method is different then the 'getPlaceholderValues' method, this method is used to create a placeholder value array containing dummy values that is used to create a preview certificate.

Parameters

int	$userId
int	$objId

Returns: array

Implements ilCertificatePlaceholderValues.

Definition at line 106 of file class.ilLTIConsumerPlaceholderValues.php.

References language().

     {
         $placeholders = $this->defaultPlaceholderValuesObject->getPlaceholderValuesForPreview($userId, $objId);
 
         $placeholders['OBJECT_TITLE'] = $this->utilHelper->prepareFormOutput($this->language->txt('lti_cert_ph_object_title'));
         $placeholders['OBJECT_DESCRIPTION'] = $this->utilHelper->prepareFormOutput($this->language->txt('lti_cert_ph_object_description'));
 
         $placeholders['MASTERY_SCORE'] = $this->utilHelper->prepareFormOutput($this->language->txt('lti_cert_ph_mastery_score'));
         $placeholders['REACHED_SCORE'] = $this->utilHelper->prepareFormOutput($this->language->txt('lti_cert_ph_reached_score'));
         
         return $placeholders;
     }

Here is the call graph for this function:

◆ getReachedScore()

ilLTIConsumerPlaceholderValues::getReachedScore	(	ilObjLTIConsumer	$object,
		int	$userId
	)

protected

Definition at line 150 of file class.ilLTIConsumerPlaceholderValues.php.

References ilLTIConsumerResult\getByKeys(), and ilObject\getId().

Referenced by getPlaceholderValues().

                                                                               : string
     {
         $userResult = ilLTIConsumerResult::getByKeys($object->getId(), $userId);
 
         $reachedScore = sprintf('%0.2f %%', 0);
         if ($userResult) {
             $reachedScore = sprintf('%0.2f %%', $userResult->getResult() * 100);
         }
 
         return $reachedScore;
     }