CoursePlaceholderValues.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Course\Certificate;
 
use ilObjUser;
use ilLanguage;
use ilException;
use ilDatabaseException;
use ilDateTimeException;
use ILIAS\ILIASObject\Properties\Translations\Translations as ilObjectTranslation;
use ilCertificateDateHelper;
use ilLegacyFormElementsUtil;
use ilCertificateObjectHelper;
use ilObjectNotFoundException;
use ilDefaultPlaceholderValues;
use ilCertificateLPStatusHelper;
use ilInvalidCertificateException;
use ilCertificatePlaceholderValues;
use ilObjectCustomUserFieldsPlaceholderValues;
 
class CoursePlaceholderValues implements ilCertificatePlaceholderValues
{
    private readonly ilDefaultPlaceholderValues $defaultPlaceholderValuesObject;
    private readonly ilObjectCustomUserFieldsPlaceholderValues $customUserFieldsPlaceholderValuesObject;
    private readonly ilCertificateObjectHelper $objectHelper;
    private readonly CertificateParticipantsHelper $participantsHelper;
    private readonly ilCertificateDateHelper $dateHelper;
    private readonly ilCertificateLPStatusHelper $lpStatusHelper;
 
    public function __construct(
        ?ilObjectCustomUserFieldsPlaceholderValues $customUserFieldsPlaceholderValues = null,
        ?ilDefaultPlaceholderValues $defaultPlaceholderValues = null,
        ?ilLanguage $language = null,
        ?ilCertificateObjectHelper $objectHelper = null,
        ?CertificateParticipantsHelper $participantsHelper = null,
        ?ilCertificateDateHelper $dateHelper = null,
        ?ilCertificateLPStatusHelper $lpStatusHelper = null
    ) {
        if (null === $language) {
            global $DIC;
            $language = $DIC->language();
            $language->loadLanguageModule('certificate');
        }
 
        if (null === $defaultPlaceholderValues) {
            $defaultPlaceholderValues = new ilDefaultPlaceholderValues();
        }
 
        if (null === $customUserFieldsPlaceholderValues) {
            $customUserFieldsPlaceholderValues = new ilObjectCustomUserFieldsPlaceholderValues();
        }
 
        if (null === $objectHelper) {
            $objectHelper = new ilCertificateObjectHelper();
        }
        $this->objectHelper = $objectHelper;
 
        if (null === $participantsHelper) {
            $participantsHelper = new CertificateParticipantsHelper();
        }
        $this->participantsHelper = $participantsHelper;
 
        if (null === $dateHelper) {
            $dateHelper = new ilCertificateDateHelper();
        }
        $this->dateHelper = $dateHelper;
 
        if (null === $lpStatusHelper) {
            $lpStatusHelper = new ilCertificateLPStatusHelper();
        }
        $this->lpStatusHelper = $lpStatusHelper;
 
        $this->customUserFieldsPlaceholderValuesObject = $customUserFieldsPlaceholderValues;
        $this->defaultPlaceholderValuesObject = $defaultPlaceholderValues;
    }
 
    private function hasCompletionDate($possibleDate): bool
    {
        return
            $possibleDate !== false &&
            $possibleDate !== null &&
            $possibleDate !== ''
        ;
    }
 
    public function getPlaceholderValues(int $userId, int $objId): array
    {
        $courseObject = $this->objectHelper->getInstanceByObjId($objId);
 
        $placeholders = $this->defaultPlaceholderValuesObject->getPlaceholderValues($userId, $objId);
 
        $customUserFieldsPlaceholders = $this->customUserFieldsPlaceholderValuesObject->getPlaceholderValues(
            $userId,
            $objId
        );
 
        $placeholders = array_merge($placeholders, $customUserFieldsPlaceholders);
 
        $completionDate = $this->participantsHelper->getDateTimeOfPassed($objId, $userId);
        if (!$this->hasCompletionDate($completionDate)) {
            $completionDate = $this->lpStatusHelper->lookupStatusChanged($objId, $userId);
        }
 
        $user = $this->objectHelper->getInstanceByObjId($userId);
        if ($this->hasCompletionDate($completionDate)) {
            $placeholders['DATE_COMPLETED'] = $this->dateHelper->formatDate($completionDate, $user);
            $placeholders['DATETIME_COMPLETED'] = $this->dateHelper->formatDateTime($completionDate, $user);
        }
 
        $lng_code = $user->getLanguage();
        $course_translation = $courseObject->getObjectTranslation();
        $title = $courseObject->getTitle();
        if ($course_translation instanceof ilObjectTranslation) {
            $languages = $course_translation->getLanguages();
            foreach ($languages as $trans) {
                if ($trans->getLanguageCode() === $lng_code) {
                    $title = $trans->getTitle();
 
                    break;
                }
            }
        }
 
        $placeholders['COURSE_TITLE'] = ilLegacyFormElementsUtil::prepareFormOutput($title);
 
        return $placeholders;
    }
 
    public function getPlaceholderValuesForPreview(int $userId, int $objId): array
    {
        $placeholders = $this->defaultPlaceholderValuesObject->getPlaceholderValuesForPreview($userId, $objId);
 
        $customUserFieldsPlaceholders = $this->customUserFieldsPlaceholderValuesObject->getPlaceholderValuesForPreview(
            $userId,
            $objId
        );
 
        $placeholders = array_merge($placeholders, $customUserFieldsPlaceholders);
 
        $object = $this->objectHelper->getInstanceByObjId($objId);
 
        $placeholders['COURSE_TITLE'] = ilLegacyFormElementsUtil::prepareFormOutput($object->getTitle());
 
        return $placeholders;
    }
}