class.ilStudyProgrammePlaceholderValues.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\StudyProgramme\Certificate;

class ilStudyProgrammePlaceholderValues implements \ilCertificatePlaceholderValues
{
    private readonly \ilDefaultPlaceholderValues $defaultPlaceholderValuesObject;
    private readonly \ilCertificateObjectHelper $objectHelper;

    public function __construct(
        ?\ilDefaultPlaceholderValues $defaultPlaceholderValues = null,
        ?\ilLanguage $language = null,
        ?\ilCertificateObjectHelper $objectHelper = null
    ) {
        if (null === $language) {
            global $DIC;
            $language = $DIC->language();
            $language->loadLanguageModule('certificate');
        }

        if (null === $defaultPlaceholderValues) {
            $defaultPlaceholderValues = new \ilDefaultPlaceholderValues();
        }

        if (null === $objectHelper) {
            $objectHelper = new \ilCertificateObjectHelper();
        }
        $this->objectHelper = $objectHelper;

        $this->defaultPlaceholderValuesObject = $defaultPlaceholderValues;
    }

    public function getPlaceholderValues(int $userId, int $objId): array
    {
        $object = $this->objectHelper->getInstanceByObjId($objId);
        $placeholders = $this->defaultPlaceholderValuesObject->getPlaceholderValues($userId, $objId);
        $assignments = $object->getAssignmentsOfSingleProgramForUser($userId);
        $latest_progress = $this->getRelevantProgressFromAssignments($assignments);
        $type = $object->getSubType();

        $placeholders['PRG_TITLE'] = \ilLegacyFormElementsUtil::prepareFormOutput($object->getTitle());
        $placeholders['PRG_DESCRIPTION'] = \ilLegacyFormElementsUtil::prepareFormOutput($object->getDescription());
        $placeholders['PRG_TYPE'] = \ilLegacyFormElementsUtil::prepareFormOutput($type ? $type->getTitle() : '');
        $placeholders['PRG_POINTS'] = \ilLegacyFormElementsUtil::prepareFormOutput(
            $latest_progress ? (string) $latest_progress->getCurrentAmountOfPoints() : ''
        );
        $placeholders['PRG_COMPLETION_DATE'] = \ilLegacyFormElementsUtil::prepareFormOutput(
            $latest_progress && $latest_progress->getCompletionDate() instanceof \DateTimeImmutable ? $latest_progress->getCompletionDate(
            )->format('d.m.Y') : ''
        );
        $placeholders['PRG_EXPIRES_AT'] = \ilLegacyFormElementsUtil::prepareFormOutput(
            $latest_progress && $latest_progress->getValidityOfQualification(
            ) instanceof \DateTimeImmutable ? $latest_progress->getValidityOfQualification()->format('d.m.Y') : ''
        );
        return $placeholders;
    }

    public function getPlaceholderValuesForPreview(int $userId, int $objId): array
    {
        $placeholders = $this->defaultPlaceholderValuesObject->getPlaceholderValuesForPreview($userId, $objId);

        $object = $this->objectHelper->getInstanceByObjId($objId);
        $type = $object->getSubType();
        $today = \ilLegacyFormElementsUtil::prepareFormOutput((new \DateTime())->format('d.m.Y'));
        $placeholders['PRG_TITLE'] = \ilLegacyFormElementsUtil::prepareFormOutput($object->getTitle());
        $placeholders['PRG_DESCRIPTION'] = \ilLegacyFormElementsUtil::prepareFormOutput($object->getDescription());
        $placeholders['PRG_TYPE'] = \ilLegacyFormElementsUtil::prepareFormOutput($type ? $type->getTitle() : '');
        $placeholders['PRG_POINTS'] = \ilLegacyFormElementsUtil::prepareFormOutput((string) $object->getPoints());
        $placeholders['PRG_COMPLETION_DATE'] = $today;
        $placeholders['PRG_EXPIRES_AT'] = $today;
        return $placeholders;
    }

    protected function getRelevantProgressFromAssignments(array $assignments): ?\ilPRGProgress
    {
        if (count($assignments) === 0) {
            return null;
        }
        $latest_progress = null;
        $latest_successful = $this->getLatestSuccessfulAssignment($assignments);
        if ($latest_successful) {
            $latest_progress = $latest_successful->getProgressTree();
        }
        return $latest_progress;
    }

    protected function getLatestSuccessfulAssignment(array $assignments): ?\ilPRGAssignment
    {
        $successful = array_filter(
            $assignments,
            fn($ass) => $ass->getProgressTree()->isSuccessful()
        );
        if (count($successful) === 0) {
            return null;
        }

        //is there an unlimited validity? if so, take latest.
        $unlimited = array_filter(
            $successful,
            fn($ass) => is_null($ass->getProgressTree()->getValidityOfQualification())
        );
        if (count($unlimited) > 0) {
            $successful = $unlimited;
            usort($successful, static function (\ilPRGAssignment $a, \ilPRGAssignment $b): int {
                $a_dat = $a->getProgressTree()->getCompletionDate();
                $b_dat = $b->getProgressTree()->getCompletionDate();
                if ($a_dat > $b_dat) {
                    return -1;
                } elseif ($a_dat < $b_dat) {
                    return 1;
                } else {
                    return 0;
                }
            });
        } else {
            //there are (only) limited validities: take the one that lasts the longest.
            $limited = array_filter(
                $successful,
                fn($ass) => !is_null($ass->getProgressTree()->getValidityOfQualification())
            );
            $successful = $limited;
            usort($successful, static function (\ilPRGAssignment $a, \ilPRGAssignment $b): int {
                $a_dat = $a->getProgressTree()->getValidityOfQualification();
                $b_dat = $b->getProgressTree()->getValidityOfQualification();
                if ($a_dat > $b_dat) {
                    return -1;
                } elseif ($a_dat < $b_dat) {
                    return 1;
                } else {
                    return 0;
                }
            });
        }
        return array_shift($successful);
    }
}