class.ilCertificateCron.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2018 ILIAS open source, Extended GPL, see docs/LICENSE */
 
class ilCertificateCron extends \ilCronJob
{
    const DEFAULT_SCHEDULE_HOURS = 1;
 
    protected $lng;
 
    private $queueRepository;
 
    private $templateRepository;
 
    private $userRepository;
 
    private $logger;
 
    private $valueReplacement;
 
    private $objectHelper;
 
    private $dic;
 
    private $settings;
 
    public function __construct(
        ilCertificateQueueRepository $queueRepository = null,
        ilCertificateTemplateRepository $templateRepository = null,
        ilUserCertificateRepository $userRepository = null,
        ilCertificateValueReplacement $valueReplacement = null,
        ilLogger $logger = null,
        \ILIAS\DI\Container $dic = null,
        ilLanguage $language = null,
        ilCertificateObjectHelper $objectHelper = null,
        ilSetting $setting = null
    ) {
        if (null === $dic) {
            global $DIC;
            $dic = $DIC;
        }
        $this->dic = $dic;
 
        $this->queueRepository = $queueRepository;
        $this->templateRepository = $templateRepository;
        $this->userRepository = $userRepository;
        $this->valueReplacement = $valueReplacement;
        $this->logger = $logger;
        $this->objectHelper = $objectHelper;
        $this->settings = $setting;
 
        if ($dic) {
            if (isset($dic['lng'])) {
                $language = $dic->language();
                $language->loadLanguageModule('certificate');
            }
        }
 
        $this->lng = $language;
    }
 
    public function getTitle()
    {
        return $this->lng->txt('cert_cron_task_title');
    }
 
    public function getDescription()
    {
        return $this->lng->txt('cert_cron_task_desc');
    }
 
    public function init()
    {
        if (null === $this->dic) {
            global $DIC;
            $this->dic = $DIC;
        }
 
        $database = $this->dic->database();
 
        if (null === $this->logger) {
            $this->logger = $this->dic->logger()->cert();
        }
 
        if (null === $this->queueRepository) {
            $this->queueRepository = new ilCertificateQueueRepository($database, $this->logger);
        }
 
        if (null === $this->templateRepository) {
            $this->templateRepository = new ilCertificateTemplateRepository($database, $this->logger);
        }
 
        if (null === $this->userRepository) {
            $this->userRepository = new ilUserCertificateRepository($database, $this->logger);
        }
 
        if (null === $this->valueReplacement) {
            $this->valueReplacement = new ilCertificateValueReplacement();
        }
 
        if (null === $this->objectHelper) {
            $this->objectHelper = new ilCertificateObjectHelper();
        }
 
        if (null === $this->settings) {
            $this->settings = new ilSetting('certificate');
        }
    }
 
    public function run()
    {
        $this->init();
 
        $result = new ilCronJobResult();
        $result->setStatus(ilCronJobResult::STATUS_NO_ACTION);
 
        $currentMode = $this->settings->get('persistent_certificate_mode', 'persistent_certificate_mode_cron');
        if ($currentMode !== 'persistent_certificate_mode_cron') {
            $this->logger->warning(sprintf(
                'Will not start cron job, because the mode is not set as cron job. Current Mode in settings: "%s"',
                $currentMode
            ));
            return $result;
        }
 
        $this->logger->info('START - Begin with cron job to create user certificates from templates');
 
        $entries = $this->queueRepository->getAllEntriesFromQueue();
 
        $status = ilCronJobResult::STATUS_OK;
 
        $entryCounter = 0;
        $succeededGenerations = [];
        foreach ($entries as $entry) {
            try {
                $succeededGenerations = $this->processEntry(
                    $entryCounter,
                    $entry,
                    $succeededGenerations
                );
 
                ++$entryCounter;
            } catch (ilInvalidCertificateException $exception) {
                $this->logger->warning($exception->getMessage());
                $this->logger->warning('The user MAY not be able to achieve the certificate based on the adapters settings');
                $this->logger->warning('Due the error, the entry will now be removed from the queue.');
 
                $this->queueRepository->removeFromQueue($entry->getId());
 
                continue;
            } catch (ilException $exception) {
                $this->logger->warning($exception->getMessage());
                $this->logger->warning('Due the error, the entry will now be removed from the queue.');
 
                $this->queueRepository->removeFromQueue($entry->getId());
                continue;
            }
        }
 
        $result->setStatus($status);
        if (count($succeededGenerations) > 0) {
            $result->setMessage(sprintf(
                'Generated %s certificate(s) in run. Result: %s',
                count($succeededGenerations),
                implode(' | ', $succeededGenerations)
            ));
        } else {
            $result->setMessage('0 certificates generated in current run.');
        }
 
        return $result;
    }
 
    public function getId()
    {
        return 'certificate';
    }
 
    public function hasAutoActivation()
    {
        return true;
    }
 
    public function hasFlexibleSchedule()
    {
        return true;
    }
 
    public function getDefaultScheduleType()
    {
        return self::SCHEDULE_TYPE_IN_MINUTES;
    }
 
    public function getDefaultScheduleValue()
    {
        return 1;
    }
 
    public function processEntry(int $entryCounter, ilCertificateQueueEntry $entry, array $succeededGenerations) : array
    {
        if ($entryCounter > 0 && $entryCounter % 10 === 0) {
            ilCronManager::ping($this->getId());
        }
 
        $this->logger->debug('Entry found will start of processing the entry');
 
        $class = $entry->getAdapterClass();
        $this->logger->debug('Adapter class to be executed "' . $class . '"');
 
        $placeholderValueObject = new $class();
        if (!$placeholderValueObject instanceof ilCertificatePlaceholderValues) {
            throw new ilException('The given class ' . $class . ' MUST be an instance of ilCertificateCronAdapter and MUST have an accessible namespace. The class map MAY be reloader.');
        }
 
        $objId = $entry->getObjId();
        $userId = $entry->getUserId();
        $templateId = $entry->getTemplateId();
 
        $this->logger->debug(sprintf(
            'Fetch certificate template for user id: "%s" and object id: "%s" and template id: "%s"',
            $userId,
            $objId,
            $templateId
        ));
 
        $template = $this->templateRepository->fetchTemplate($templateId);
 
        $object = $this->objectHelper->getInstanceByObjId($objId, false);
        if (!$object instanceof ilObject) {
            throw new ilException(sprintf(
                'The given object id: "%s"  could not be referred to an actual object',
                $objId
            ));
        }
 
        $type = $object->getType();
 
        $userObject = $this->objectHelper->getInstanceByObjId($userId, false);
        if (!$userObject || !($userObject instanceof \ilObjUser)) {
            throw new ilException('The given user id"' . $userId . '" could not be referred to an actual user');
        }
 
        $this->logger->debug(sprintf(
            'Object type: "%s"',
            $type
        ));
 
        $certificateContent = $template->getCertificateContent();
 
        $placeholderValues = $placeholderValueObject->getPlaceholderValues($userId, $objId);
 
        $this->logger->debug(sprintf(
            'Values for placeholders: "%s"',
            json_encode($placeholderValues)
        ));
 
        $certificateContent = $this->valueReplacement->replace(
            $placeholderValues,
            $certificateContent
        );
 
        $thumbnailImagePath = (string) $template->getThumbnailImagePath();
        $userCertificate = new ilUserCertificate(
            $template->getId(),
            $objId,
            $type,
            $userId,
            $userObject->getFullname(),
            (int) $entry->getStartedTimestamp(),
            $certificateContent,
            json_encode($placeholderValues),
            null,
            $template->getVersion(),
            ILIAS_VERSION_NUMERIC,
            true,
            $template->getBackgroundImagePath(),
            $thumbnailImagePath
        );
 
        $persistedUserCertificate = $this->userRepository->save($userCertificate);
 
        $succeededGenerations[] = implode('/', [
            'obj_id: ' . $objId,
            'usr_id: ' . $userId
        ]);
 
        $this->queueRepository->removeFromQueue($entry->getId());
 
        $this->dic->event()->raise(
            'Services/Certificate',
            'certificateIssued',
            ['certificate' => $persistedUserCertificate]
        );
 
        return $succeededGenerations;
    }
}