class.SkillResourcesManager.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Skill\Resource;
 
use ILIAS\Skill\Usage;
 
class SkillResourcesManager implements Usage\SkillUsageInfo
{
    protected SkillResourceDBRepository $skill_res_repo;
    protected \ilSkillLevelRepository $level_repo;
 
    public function __construct(
        ?SkillResourceDBRepository $skill_res_repo = null,
        ?\ilSkillLevelRepository $level_repo = null
    ) {
        global $DIC;
 
        $this->skill_res_repo = ($skill_res_repo)
            ?: $DIC->skills()->internal()->repo()->getResourceRepo();
        $this->level_repo = ($level_repo)
            ?: $DIC->skills()->internal()->repo()->getLevelRepo();
    }
 
    public function getResources(int $skill_id, int $tref_id): array
    {
        return $this->skill_res_repo->getAll($skill_id, $tref_id);
    }
 
    public function getResourcesOfLevel(int $skill_id, int $tref_id, int $level_id): array
    {
        $all_resources = $this->skill_res_repo->getAll($skill_id, $tref_id);
        $resources_of_level = [];
        foreach ($all_resources as $lid => $level) {
            foreach ($level as $resource) {
                if ($lid == $level_id) {
                    $resources_of_level[] = $resource;
                }
            }
        }
 
        return $resources_of_level;
    }
 
    public function setResource(
        int $skill_id,
        int $tref_id,
        int $level_id,
        int $rep_ref_id,
        bool $imparting,
        bool $trigger
    ): void {
        $this->skill_res_repo->addOrUpdate($skill_id, $tref_id, $level_id, $rep_ref_id, $imparting, $trigger);
    }
 
    public function setResourceAsSuggested(
        int $skill_id,
        int $tref_id,
        int $level_id,
        int $rep_ref_id
    ): void {
        $this->skill_res_repo->updateImparting($skill_id, $tref_id, $level_id, $rep_ref_id, true);
    }
 
    public function setResourceAsNotSuggested(
        int $skill_id,
        int $tref_id,
        int $level_id,
        int $rep_ref_id
    ): void {
        $this->skill_res_repo->updateImparting($skill_id, $tref_id, $level_id, $rep_ref_id, false);
    }
 
    public function setResourceAsTrigger(
        int $skill_id,
        int $tref_id,
        int $level_id,
        int $rep_ref_id
    ): void {
        $obj_id = \ilObject::_lookupObjId($rep_ref_id);
        $obj_type = \ilObject::_lookupType($obj_id);
        if (!\ilObjectLP::isSupportedObjectType($obj_type)) {
            return;
        }
        $this->skill_res_repo->updateTrigger($skill_id, $tref_id, $level_id, $rep_ref_id, true);
    }
 
    public function setResourceAsNoTrigger(
        int $skill_id,
        int $tref_id,
        int $level_id,
        int $rep_ref_id
    ): void {
        $this->skill_res_repo->updateTrigger($skill_id, $tref_id, $level_id, $rep_ref_id, false);
    }
 
    public function removeResource(
        int $skill_id,
        int $tref_id,
        int $level_id,
        int $rep_ref_id
    ): void {
        $this->skill_res_repo->remove($skill_id, $tref_id, $level_id, $rep_ref_id);
    }
 
    public function removeResourcesForSkill(int $skill_node_id, bool $is_reference = false): void
    {
        $this->skill_res_repo->removeForSkill($skill_node_id, $is_reference);
    }
 
    public function isLevelTooLow(int $tref_id, array $skill_levels, array $profile_levels, array $actual_levels): bool
    {
        $too_low = true;
 
        foreach ($skill_levels as $v) {
            $v["id"] = (int) $v["id"];
            $v["skill_id"] = (int) $v["skill_id"];
            foreach ($profile_levels as $pl) {
                if ($pl->getLevelId() === $v["id"] &&
                    $pl->getBaseSkillId() === $v["skill_id"]) {
                    $too_low = true;
                }
            }
 
            if ($actual_levels[$v["skill_id"]][$tref_id] == $v["id"]) {
                $too_low = false;
            }
        }
        return $too_low;
    }
 
    public function determineCurrentTargetLevel(array $skill_levels, array $profile_levels): int
    {
        $target_level = 0;
        foreach ($skill_levels as $l) {
            $l["id"] = (int) $l["id"];
            $l["skill_id"] = (int) $l["skill_id"];
            foreach ($profile_levels as $pl) {
                if ($pl->getLevelId() === $l["id"] &&
                    $pl->getBaseSkillId() === $l["skill_id"]) {
                    $target_level = $l["id"];
                }
            }
        }
 
        return $target_level;
    }
 
    public function getSuggestedResources(int $skill_id, int $tref_id, array $skill_levels, array $profile_levels): array
    {
        $target_level = $this->determineCurrentTargetLevel($skill_levels, $profile_levels);
        $target_level_order_nr = $this->level_repo->lookupLevelNumber($target_level);
        $resources = $this->getResources($skill_id, $tref_id);
        $imp_resources = [];
        foreach ($resources as $level) {
            foreach ($level as $r) {
                $res_level_order_nr = $this->level_repo->lookupLevelNumber($r->getLevelId());
                if ($r->getImparting() &&
                    $target_level_order_nr >= $res_level_order_nr) {
                    $imp_resources[$res_level_order_nr . "_" . $r->getLevelId()][] = $r;
                }
            }
        }
 
        ksort($imp_resources);
        return $imp_resources;
    }
 
    public function getTriggerLevelsForRefId(int $rep_ref_id): array
    {
        return $this->skill_res_repo->getTriggerLevelsForRefId($rep_ref_id);
    }
 
    public static function getUsageInfo(array $a_cskill_ids): array
    {
        global $DIC;
 
        $usage_manager = $DIC->skills()->internal()->manager()->getUsageManager();
 
        return $usage_manager->getUsageInfoGeneric(
            $a_cskill_ids,
            Usage\SkillUsageManager::RESOURCE,
            "skl_skill_resource",
            "rep_ref_id",
            "base_skill_id"
        );
    }
}