class.ilObjRemoteCourse.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilObjRemoteCourse extends ilRemoteObjectBase
{
    public const DB_TABLE_NAME = "remote_course_settings";

    public const ACTIVATION_OFFLINE = 0;
    public const ACTIVATION_UNLIMITED = 1;
    public const ACTIVATION_LIMITED = 2;

    protected $availability_type;
    protected $end;
    protected $start;

    public function initType(): void
    {
        $this->type = "rcrs";
    }

    protected function getTableName(): string
    {
        return self::DB_TABLE_NAME;
    }

    protected function getECSObjectType(): string
    {
        return "/campusconnect/courselinks";
    }

    public function setAvailabilityType($a_type)
    {
        $this->availability_type = $a_type;
    }

    public function getAvailabilityType()
    {
        return $this->availability_type;
    }

    public function setStartingTime($a_time)
    {
        $this->start = $a_time;
    }

    public function getStartingTime()
    {
        return $this->start;
    }

    public function setEndingTime($a_time)
    {
        $this->end = $a_time;
    }

    public function getEndingTime()
    {
        return $this->end;
    }

    public static function _lookupOnline($a_obj_id)
    {
        global $ilDB;

        $query = "SELECT * FROM " . self::DB_TABLE_NAME .
            " WHERE obj_id = " . $ilDB->quote($a_obj_id, 'integer') . " ";
        $res = $ilDB->query($query);
        $row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
        switch ($row->availability_type) {
            case self::ACTIVATION_UNLIMITED:
                return true;

            case self::ACTIVATION_OFFLINE:
                return false;

            case self::ACTIVATION_LIMITED:
                return time() > $row->r_start && time < $row->r_end;

            default:
                return false;
        }

        return false;
    }

    protected function doCreateCustomFields(array &$a_fields): void
    {
        $a_fields["availability_type"] = array("integer", 0);
        $a_fields["r_start"] = array("integer", 0);
        $a_fields["r_end"] = array("integer", 0);
    }

    protected function doUpdateCustomFields(array &$a_fields): void
    {
        $a_fields["availability_type"] = array("integer", $this->getAvailabilityType());
        $a_fields["r_start"] = array("integer",(int) $this->getStartingTime());
        $a_fields["r_end"] = array("integer", (int) $this->getEndingTime());
    }

    protected function doReadCustomFields($a_row): void
    {
        $this->setAvailabilityType($a_row->availability_type);
        $this->setStartingTime($a_row->r_start);
        $this->setEndingTime($a_row->r_end);
    }

    protected function updateCustomFromECSContent(ilECSSetting $a_server, $a_ecs_content): void
    {
        // add custom values
        $this->setAvailabilityType($a_ecs_content->status == 'online' ? self::ACTIVATION_UNLIMITED : self::ACTIVATION_OFFLINE);

        // :TODO: ACTIVATION_LIMITED is currently not supported in ECS yet

        // adv. metadata
        $definition = ilECSUtils::getEContentDefinition($this->getECSObjectType());
        $this->importMetadataFromJson(
            $a_ecs_content,
            $a_server,
            $definition,
            ilECSDataMappingSetting::MAPPING_IMPORT_RCRS
        );

        $import = new ilECSImport($a_server->getServerId(), $this->getId());
        $import->setContentId($a_ecs_content->courseID);
        $import->save();
    }
}