class.SkillProfileCompletionManager.php

Go to the documentation of this file.

<?php

namespace ILIAS\Skill\Profile;

class SkillProfileCompletionManager
{
    protected SkillProfileManager $profile_manager;
    protected SkillProfileCompletionDBRepository $profile_completion_repo;
    protected \ilTree $tree_service;
    protected \ilObjectDefinition $obj_definition;

    public function __construct(
        SkillProfileManager $profile_manager,
        ?SkillProfileCompletionDBRepository $profile_completion_repo = null
    ) {
        global $DIC;

        $this->profile_manager = $profile_manager;
        $this->profile_completion_repo = ($profile_completion_repo)
            ?: $DIC->skills()->internal()->repo()->getProfileCompletionRepo();
        $this->tree_service = $DIC->repositoryTree();
        $this->obj_definition = $DIC["objDefinition"];
    }

    public function getActualMaxLevels(
        int $user_id,
        array $skills,
        string $gap_mode = "",
        string $gap_mode_type = "",
        int $gap_mode_obj_id = 0
    ): array {
        // get actual levels for gap analysis
        $actual_levels = [];
        foreach ($skills as $sk) {
            $bs = new \ilBasicSkill($sk["base_skill_id"]);
            if ($gap_mode == "max_per_type") {
                $max = $bs->getMaxLevelPerType($sk["tref_id"], $gap_mode_type, $user_id);
            } elseif ($gap_mode == "max_per_object") {
                if ($this->obj_definition->isContainer(\ilObject::_lookupType($gap_mode_obj_id))) {
                    $sub_objects = $this->tree_service->getSubTree(
                        $this->tree_service->getNodeData((int) current(\ilObject::_getAllReferences($gap_mode_obj_id))),
                        false,
                        \ilObjectLP::getSupportedObjectTypes()
                    );
                    $max = 0;
                    foreach ($sub_objects as $ref_id) {
                        $obj_id = \ilContainerReference::_lookupObjectId($ref_id);
                        $max_tmp = $bs->getMaxLevelPerObject($sk["tref_id"], $obj_id, $user_id);
                        if ($max_tmp > $max) {
                            $max = $max_tmp;
                        }
                    }
                } else {
                    $max = $bs->getMaxLevelPerObject($sk["tref_id"], $gap_mode_obj_id, $user_id);
                }
            } else {
                $max = $bs->getMaxLevel($sk["tref_id"], $user_id);
            }
            $actual_levels[$sk["base_skill_id"]][$sk["tref_id"]] = $max;
        }

        return $actual_levels;
    }

    public function getActualLastLevels(
        int $user_id,
        array $skills,
        string $gap_mode = "",
        string $gap_mode_type = "",
        int $gap_mode_obj_id = 0
    ): array {
        // todo for coming feature
        return [];
    }

    public function getActualNextLevelFulfilments(
        int $user_id,
        array $skills,
        string $gap_mode = "",
        string $gap_mode_type = "",
        int $gap_mode_obj_id = 0
    ): array {
        // get actual next level fulfilments for gap analysis
        $fuls = [];
        foreach ($skills as $sk) {
            $bs = new \ilBasicSkill($sk["base_skill_id"]);
            if ($gap_mode == "max_per_type") {
                $perc = $bs->getNextLevelFulfilmentPerType($sk["tref_id"], $gap_mode_type, $user_id);
            } elseif ($gap_mode == "max_per_object") {
                $perc = $bs->getNextLevelFulfilmentPerObject($sk["tref_id"], $gap_mode_obj_id, $user_id);
            } else {
                $perc = $bs->getNextLevelFulfilment($sk["tref_id"], $user_id);
            }
            $fuls[$sk["base_skill_id"]][$sk["tref_id"]] = $perc;
        }

        return $fuls;
    }

    public function getProfileProgress(int $user_id, int $profile_id): int
    {
        $profile = $this->profile_manager->getById($profile_id);
        $profile_levels = $profile->getSkillLevels();
        $skills = [];
        foreach ($profile_levels as $l) {
            $skills[] = array(
                "base_skill_id" => $l["base_skill_id"],
                "tref_id" => $l["tref_id"],
                "level_id" => $l["level_id"]
            );
        }
        $actual_levels = $this->getActualMaxLevels($user_id, $skills);

        $profile_count = 0;
        $achieved_count = 0;
        foreach ($profile_levels as $profile) {
            if ($actual_levels[$profile["base_skill_id"]][$profile["tref_id"]] >= $profile["level_id"]) {
                $achieved_count++;
            }
            $profile_count++;
        }
        if ($profile_count == 0) {
            return 0;
        }
        $progress = $achieved_count / $profile_count * 100;

        return (int) $progress;
    }

    public function isProfileFulfilled(int $user_id, int $profile_id): bool
    {
        if ($this->getProfileProgress($user_id, $profile_id) == 100) {
            return true;
        }
        return false;
    }

    public function getAllProfileCompletionsForUser(int $user_id): array
    {
        $user_profiles = $this->profile_manager->getProfilesOfUser($user_id);
        $profile_comps = [];
        foreach ($user_profiles as $p) {
            if ($this->isProfileFulfilled($user_id, $p["id"])) {
                $profile_comps[$p["id"]] = true;
            } else {
                $profile_comps[$p["id"]] = false;
            }
        }

        return $profile_comps;
    }

    public function getEntries(int $user_id, int $profile_id): array
    {
        return $this->profile_completion_repo->getEntries($user_id, $profile_id);
    }

    public function getFulfilledEntriesForUser(int $user_id): array
    {
        return $this->profile_completion_repo->getFulfilledEntriesForUser($user_id);
    }

    public function getAllEntriesForUser(int $user_id): array
    {
        return $this->profile_completion_repo->getAllEntriesForUser($user_id);
    }

    public function getAllEntriesForProfile(int $profile_id): array
    {
        return $this->profile_completion_repo->getAllEntriesForProfile($profile_id);
    }

    public function writeCompletionEntryForAllProfiles(int $user_id): void
    {
        $completions = $this->getAllProfileCompletionsForUser($user_id);
        foreach ($completions as $profile_id => $fulfilled) {
            if ($fulfilled) {
                $this->profile_completion_repo->addFulfilmentEntry($user_id, $profile_id);
            } else {
                $this->profile_completion_repo->addNonFulfilmentEntry($user_id, $profile_id);
            }
        }
    }

    public function writeCompletionEntryForSingleProfile(int $user_id, int $profile_id): void
    {
        if ($this->isProfileFulfilled($user_id, $profile_id)) {
            $this->profile_completion_repo->addFulfilmentEntry($user_id, $profile_id);
        } else {
            $this->profile_completion_repo->addNonFulfilmentEntry($user_id, $profile_id);
        }
    }

    public function deleteEntriesForProfile(int $profile_id): void
    {
        $this->profile_completion_repo->deleteEntriesForProfile($profile_id);
    }

    public function deleteEntriesForUser(int $user_id): void
    {
        $this->profile_completion_repo->deleteEntriesForUser($user_id);
    }
}