class.ilECSMappingUtils.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilECSMappingUtils
{
    public const MAPPED_WHOLE_TREE = 1;
    public const MAPPED_MANUAL = 2;
    public const MAPPED_UNMAPPED = 3;

    public const PARALLEL_ONE_COURSE = 0;
    public const PARALLEL_GROUPS_IN_COURSE = 1;
    public const PARALLEL_ALL_COURSES = 2;
    public const PARALLEL_COURSES_FOR_LECTURERS = 3;

    public static function lookupMappingStatus(int $a_server_id, int $a_mid, int $a_tree_id): int
    {
        if (ilECSNodeMappingAssignments::hasAssignments($a_server_id, $a_mid, $a_tree_id)) {
            if (ilECSNodeMappingAssignments::isWholeTreeMapped($a_server_id, $a_mid, $a_tree_id)) {
                return self::MAPPED_WHOLE_TREE;
            }
            return self::MAPPED_MANUAL;
        }
        return self::MAPPED_UNMAPPED;
    }

    public static function mappingStatusToString(int $a_status): string
    {
        global $DIC;

        return $DIC->language()->txt('ecs_node_mapping_status_' . $a_status);
    }


    public static function getCourseMappingFieldInfo(): array
    {
        global $DIC;

        $lng = $DIC['lng'];

        $field_info = array();
        $counter = 0;
        foreach (
            array(
                'organisation',
                'orgunit',
                'term',
                'title',
                'lecturer',
                'courseType',
                'degreeProgramme',
                'module',
                'venue'
                ) as $field) {
            $field_info[$counter]['name'] = $field;
            $field_info[$counter]['translation'] = $lng->txt('ecs_cmap_att_' . $field);
            $counter++;
        }
        return $field_info;
    }

    public static function getCourseMappingFieldSelectOptions(): array
    {
        global $DIC;

        $lng = $DIC['lng'];

        $options[''] = $lng->txt('select_one');
        foreach (self::getCourseMappingFieldInfo() as $info) {
            $options[$info['name']] = $info['translation'];
        }
        return $options;
    }

    public static function getCourseValueByMappingAttribute($course, $a_field): array
    {
        switch ($a_field) {
            case 'organisation':
                return array((string) $course->organisation);

            case 'term':
                if (property_exists($course, "term")) {
                    return array((string) $course->term);
                }
                return [];

            case 'title':
                return array((string) $course->title);

            case 'orgunit':
                $units = array();
                foreach ((array) $course->organisationalUnits as $unit) {
                    $units[] = (string) $unit->title;
                }
                return $units;

            case 'lecturer':
                $lecturers = array();
                foreach ((array) $course->groups as $group) {
                    foreach ((array) $group->lecturers as $lecturer) {
                        $lecturers[] = $lecturer->lastName . ', ' . $lecturer->firstName;
                    }
                }
                return $lecturers;

            case 'courseType':
                return array((string) $course->lectureType);

            case 'degreeProgramme':
                $degree_programmes = array();
                foreach ((array) $course->degreeProgrammes as $prog) {
                    $degree_programmes[] = (string) $prog->title;
                }
                return $degree_programmes;

            case 'module':
                $modules = array();
                foreach ((array) $course->modules as $mod) {
                    $modules[] = (string) $mod->title;
                }
                return $modules;

            case 'venue':
                $venues = [];
                foreach ((array) $course->groups as $group) {
                    foreach ((array) $group->datesAndVenues as $venue) {
                        $venues[] = (string) $venue->venue;
                    }
                }
                return $venues;
        }
        return array();
    }


    public static function getRoleMappingInfo($a_role_type_info = 0): array
    {
        //KEEP!!! until the defines are turned into proper constants
        include_once './Services/Membership/classes/class.ilParticipants.php';
        $roles = array(
            ilParticipants::IL_CRS_ADMIN => array(
                'role' => ilParticipants::IL_CRS_ADMIN,
                'lang' => 'il_crs_admin',
                'create' => true,
                'required' => true,
                'type' => 'crs'),
            ilParticipants::IL_CRS_TUTOR => array(
                'role' => ilParticipants::IL_CRS_TUTOR,
                'lang' => 'il_crs_tutor',
                'create' => true,
                'required' => false,
                'type' => 'crs'),
            ilParticipants::IL_CRS_MEMBER => array(
                'role' => ilParticipants::IL_CRS_MEMBER,
                'lang' => 'il_crs_member',
                'create' => false,
                'required' => true,
                'type' => 'crs'),
            ilParticipants::IL_GRP_ADMIN => array(
                'role' => ilParticipants::IL_GRP_ADMIN,
                'lang' => 'il_grp_admin',
                'create' => true,
                'required' => false,
                'type' => 'grp'),
            ilParticipants::IL_GRP_MEMBER => array(
                'role' => ilParticipants::IL_GRP_MEMBER,
                'lang' => 'il_grp_member',
                'create' => false,
                'required' => false,
                'type' => 'grp')
        );
        if (!$a_role_type_info) {
            return $roles;
        }
        return $roles[$a_role_type_info];
    }

    public static function getAuthModeSelection(): array
    {
        global $DIC;

        $lng = $DIC->language();
        $active_auth_modes = ilAuthUtils::_getActiveAuthModes();
        $options = [];
        $options["0"] = $lng->txt('select_one');
        foreach ($active_auth_modes as $auth_string => $auth_int) {
            if (
                $auth_string === 'default' ||
                $auth_string === 'ecs' ||
                substr($auth_string, 0, 3) === 'lti'
            ) {
                continue;
            }
            $options[$auth_string] = ilAuthUtils::getAuthModeTranslation((string) $auth_int);
        }
        return $options;
    }
}