class.ilStudyProgrammeSettings.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilStudyProgrammeSettings
{
    // There are two different modes the programs' calculation of the learning
    // progress can run in. It is also possible, that the mode is not defined
    // yet.
    public const MODE_UNDEFINED = 0;

    // User is successful if he collected enough points in the sub nodes of
    // this node.
    public const MODE_POINTS = 1;

    // User is successful if he has the "completed" learning progress in any
    // sub object.
    public const MODE_LP_COMPLETED = 2;

    public static array $MODES = [
        self::MODE_UNDEFINED,
        self::MODE_POINTS,
        self::MODE_LP_COMPLETED
    ];


    // A program tree has a lifecycle during which it has three status.

    // The program is a draft, that is users won't be assigned to the program
    // already.
    public const STATUS_DRAFT = 10;

    // The program is active, that is users can be assigned to it.
    public const STATUS_ACTIVE = 20;

    // The program is outdated, that is users won't be assigned to it but can
    // still complete the program.
    public const STATUS_OUTDATED = 30;

    public const NO_RESTART = -1;
    public const NO_VALIDITY_OF_QUALIFICATION_PERIOD = -1;
    public const NO_DEADLINE = -1;

    // Defaults
    public const DEFAULT_POINTS = 100;
    public const DEFAULT_SUBTYPE = 0;

    public const DATE_TIME_FORMAT = 'Y-m-d H:i:s';
    public const DATE_FORMAT = 'Y-m-d';

    protected int $obj_id;

    protected string $last_change;

    protected int $lp_mode;

    protected bool $access_ctrl_positions;

    protected ilStudyProgrammeTypeSettings $type_settings;
    protected ilStudyProgrammeAssessmentSettings $assessment_settings;
    protected ilStudyProgrammeDeadlineSettings $deadline_settings;
    protected ilStudyProgrammeValidityOfAchievedQualificationSettings $validity_of_qualification_settings;
    protected ilStudyProgrammeAutoMailSettings $automail_settings;

    public function __construct(
        int $a_id,
        ilStudyProgrammeTypeSettings $type_settings,
        ilStudyProgrammeAssessmentSettings $assessment_settings,
        ilStudyProgrammeDeadlineSettings $deadline_settings,
        ilStudyProgrammeValidityOfAchievedQualificationSettings $validity_of_qualification_settings,
        ilStudyProgrammeAutoMailSettings $automail_settings
    ) {
        $this->obj_id = $a_id;
        $this->type_settings = $type_settings;
        $this->assessment_settings = $assessment_settings;
        $this->deadline_settings = $deadline_settings;
        $this->validity_of_qualification_settings = $validity_of_qualification_settings;
        $this->automail_settings = $automail_settings;
    }

    public function getObjId(): int
    {
        return $this->obj_id;
    }

    public function getLastChange(): DateTime
    {
        return DateTime::createFromFormat(self::DATE_TIME_FORMAT, $this->last_change);
    }

    public function updateLastChange(): ilStudyProgrammeSettings
    {
        $this->setLastChange(new DateTime());
        return $this;
    }

    public function setLastChange(DateTime $a_timestamp): ilStudyProgrammeSettings
    {
        $this->last_change = $a_timestamp->format(self::DATE_TIME_FORMAT);
        return $this;
    }

    public function setLPMode(int $a_mode): ilStudyProgrammeSettings
    {
        if (!in_array($a_mode, self::$MODES)) {
            throw new ilException("ilStudyProgramme::setLPMode: No lp mode: "
                                 . "'$a_mode'");
        }
        $this->lp_mode = $a_mode;
        $this->updateLastChange();
        return $this;
    }

    public function getLPMode(): int
    {
        return $this->lp_mode;
    }

    public function getTypeSettings(): ilStudyProgrammeTypeSettings
    {
        return $this->type_settings;
    }

    public function withTypeSettings(ilStudyProgrammeTypeSettings $type_settings): ilStudyProgrammeSettings
    {
        $clone = clone $this;
        $clone->type_settings = $type_settings;
        return $clone;
    }

    public function getAssessmentSettings(): ilStudyProgrammeAssessmentSettings
    {
        return $this->assessment_settings;
    }

    public function withAssessmentSettings(
        ilStudyProgrammeAssessmentSettings $assessment_settings
    ): ilStudyProgrammeSettings {
        $clone = clone $this;
        $clone->assessment_settings = $assessment_settings;
        $clone->updateLastChange();
        return $clone;
    }

    public function getDeadlineSettings(): ilStudyProgrammeDeadlineSettings
    {
        return $this->deadline_settings;
    }

    public function withDeadlineSettings(
        ilStudyProgrammeDeadlineSettings $deadline_settings
    ): ilStudyProgrammeSettings {
        $clone = clone $this;
        $clone->deadline_settings = $deadline_settings;
        return $clone;
    }

    public function getValidityOfQualificationSettings(): ilStudyProgrammeValidityOfAchievedQualificationSettings
    {
        return $this->validity_of_qualification_settings;
    }

    public function withValidityOfQualificationSettings(
        ilStudyProgrammeValidityOfAchievedQualificationSettings $validity_of_qualification_settings
    ): ilStudyProgrammeSettings {
        $clone = clone $this;
        $clone->validity_of_qualification_settings = $validity_of_qualification_settings;
        return $clone;
    }

    public function validationExpires(): bool
    {
        return !is_null($this->getValidityOfQualificationSettings()->getQualificationDate()) ||
                $this->getValidityOfQualificationSettings()->getQualificationPeriod() !== self::NO_VALIDITY_OF_QUALIFICATION_PERIOD;
    }

    public function getAutoMailSettings(): ilStudyProgrammeAutoMailSettings
    {
        return $this->automail_settings;
    }

    public function withAutoMailSettings(
        ilStudyProgrammeAutoMailSettings $automail_settings
    ): ilStudyProgrammeSettings {
        $clone = clone $this;
        $clone->automail_settings = $automail_settings;
        return $clone;
    }
}