Retrieval.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\MediaPool\PageUsage;
 
use ILIAS\Data\Order;
use ILIAS\Data\Range;
use ILIAS\MediaPool\InternalDomainService;
use ILIAS\Repository\RetrievalBase;
use ILIAS\Repository\RetrievalInterface;
 
class Retrieval implements RetrievalInterface
{
    use RetrievalBase;
 
    protected ?array $data = null;
 
    public function __construct(
        protected \ilMediaPoolPage $page,
        protected bool $include_hist,
        protected InternalDomainService $domain
    ) {
    }
 
    public function getData(
        array $fields,
        ?Range $range = null,
        ?Order $order = null,
        array $filter = [],
        array $parameters = []
    ): \Generator {
        $data = $this->collectData();
        $data = $this->applyOrder($data, $order);
        $data = $this->applyRange($data, $range);
 
        yield from $data;
    }
 
    public function count(
        array $filter = [],
        array $parameters = []
    ): int {
        return count($this->collectData());
    }
 
    public function isFieldNumeric(string $field): bool
    {
        return false;
    }
 
    protected function collectData(): array
    {
        if ($this->data !== null) {
            return $this->data;
        }
 
        $usages = $this->page->getUsages($this->include_hist);
        $clip_count = 0;
        $aggregated_usages = [];
 
        foreach ($usages as $usage) {
            $usage["trash"] = false;
            $usage_type = (string) ($usage["type"] ?? "");
            if (str_contains($usage_type, ":")) {
                [$container_type, $sub_type] = explode(":", $usage_type, 2);
 
                if ($sub_type === "pg") {
                    $page = \ilPageObjectFactory::getInstance(
                        $container_type,
                        (int) $usage["id"]
                    );
                    $usage["page"] = $page;
                    $repo_tree = $this->domain->repositoryTree();
                    $ref_ids = array_filter(
                        \ilObject::_getAllReferences($page->getRepoObjId()),
                        static fn($ref_id): bool => $repo_tree->isInTree($ref_id)
                    );
                    if ($ref_ids === []) {
                        $usage["trash"] = true;
                    }
                }
            }
 
            if ($usage_type === "clip") {
                $clip_count++;
                continue;
            }
 
            if (!$this->include_hist && $usage["trash"]) {
                continue;
            }
 
            $key = $usage_type . ":" . (string) $usage["id"];
            if (!isset($aggregated_usages[$key])) {
                $aggregated_usages[$key] = $usage;
            }
            $aggregated_usages[$key]["versions"][] = [
                "hist_nr" => $usage["hist_nr"] ?? 0,
                "lang" => $usage["lang"] ?? ""
            ];
        }
 
        if ($clip_count > 0) {
            $aggregated_usages["clip"] = [
                "type" => "clip",
                "cnt" => $clip_count
            ];
        }
 
        $this->data = [];
        foreach ($aggregated_usages as $id => $usage) {
            $this->data[] = $this->buildRow((string) $id, $usage);
        }
 
        return $this->data;
    }
 
    protected function buildRow(string $id, array $usage): array
    {
        $usage_type = (string) ($usage["type"] ?? "");
        $container_type = "";
        if (str_contains($usage_type, ":")) {
            [$container_type, $usage_type] = explode(":", $usage_type, 2);
        }
 
        $item = [
            "type" => "",
            "title" => "",
            "sub_txt" => "",
            "sub_title" => "",
            "link" => ""
        ];
 
        switch ($usage_type) {
            case "pg":
                $page = $usage["page"] ?? null;
                if (!$page instanceof \ilPageObject) {
                    break;
                }
 
                switch ($container_type) {
                    case "lm":
                        $lm_obj = new \ilObjLearningModule($page->getParentId(), false);
                        $item["type"] = $this->domain->lng()->txt("obj_" . $container_type);
                        $item["title"] = $lm_obj->getTitle();
                        $item["sub_txt"] = $this->domain->lng()->txt("pg");
                        $item["sub_title"] = \ilLMObject::_lookupTitle($page->getId());
                        $ref_id = $this->getFirstWritableRefId($lm_obj->getId());
                        if ($ref_id > 0) {
                            $item["link"] = \ilLink::_getLink(
                                null,
                                "pg",
                                [],
                                $page->getId() . "_" . $ref_id
                            );
                        }
                        break;
 
                    case "wpg":
                        $item["type"] = $this->domain->lng()->txt("obj_wiki");
                        $item["title"] = \ilObject::_lookupTitle($page->getParentId());
                        $item["sub_txt"] = $this->domain->lng()->txt("pg");
                        $item["sub_title"] = \ilWikiPage::lookupTitle($page->getId());
                        $ref_id = $this->getFirstWritableRefId($page->getParentId());
                        if ($ref_id > 0) {
                            $item["link"] = \ilLink::_getStaticLink($ref_id, "wiki");
                        }
                        break;
 
                    case "term":
                        $term_id = $page->getId();
                        $glossary_id = \ilGlossaryTerm::_lookGlossaryID($term_id);
                        $item["type"] = $this->domain->lng()->txt("obj_glo");
                        $item["title"] = \ilObject::_lookupTitle($glossary_id);
                        $item["sub_txt"] = $this->domain->lng()->txt("cont_term");
                        $item["sub_title"] = \ilGlossaryTerm::_lookGlossaryTerm($term_id);
                        $ref_id = $this->getFirstWritableRefId($page->getParentId());
                        if ($ref_id > 0) {
                            $item["link"] = \ilLink::_getStaticLink($ref_id, "glo");
                        }
                        break;
 
                    case "cont":
                        $object_type = \ilObject::_lookupType($page->getId());
                        $item["type"] = $this->domain->lng()->txt("obj_" . $object_type);
                        $item["title"] = \ilObject::_lookupTitle($page->getId());
                        $ref_id = $this->getFirstWritableRefId($page->getId());
                        if ($ref_id > 0) {
                            $item["link"] = \ilLink::_getStaticLink($ref_id, $object_type);
                        }
                        break;
 
                    case "copa":
                        $item["type"] = $this->domain->lng()->txt("obj_" . $container_type);
                        $item["title"] = \ilObject::_lookupTitle($page->getId());
                        $ref_id = $this->getFirstWritableRefId($page->getId());
                        if ($ref_id > 0) {
                            $item["link"] = \ilLink::_getStaticLink($ref_id, $container_type);
                        }
                        break;
                }
 
                if (($usage["trash"] ?? false) === true) {
                    $item["title"] .= " (" . $this->domain->lng()->txt("trash") . ")";
                }
                break;
 
            case "mep":
                $item["type"] = $this->domain->lng()->txt("obj_mep");
                $item["title"] = \ilObject::_lookupTitle((int) $usage["id"]);
                $ref_id = $this->getFirstWritableRefId((int) $usage["id"]);
                if ($ref_id > 0) {
                    $item["link"] = \ilLink::_getStaticLink($ref_id, "mep");
                }
                break;
 
            case "map":
                $item["type"] = $this->domain->lng()->txt("obj_mob");
                $item["title"] = \ilObject::_lookupTitle((int) $usage["id"]);
                $item["sub_txt"] = $this->domain->lng()->txt("cont_link_area");
                break;
        }
 
        $title = $item["title"];
        if ($item["sub_txt"] !== "") {
            $title .= ", " . $item["sub_txt"];
            if ($item["sub_title"] !== "") {
                $title .= ": " . $item["sub_title"];
            }
        }
 
        if ($usage_type === "clip") {
            $title = $this->domain->lng()->txt("cont_users_have_mob_in_clip1") .
                " " . (int) ($usage["cnt"] ?? 0) . " " .
                $this->domain->lng()->txt("cont_users_have_mob_in_clip2");
        }
 
        return [
            "id" => $id,
            "object" => $title,
            "object_link" => $item["link"],
            "type" => $item["type"],
            "versions" => $this->buildVersions($usage)
        ];
    }
 
    protected function buildVersions(array $usage): string
    {
        if (!is_array($usage["versions"] ?? null) || !isset($usage["page"])) {
            return " ";
        }
 
        $versions = $usage["versions"];
        $version_text = "";
        if (count($versions) > 5) {
            $version_text = "..., ";
            $versions = array_slice($versions, -5);
        }
 
        $separator = "";
        foreach ($versions as $version) {
            $history_number = $version["hist_nr"] ?? 0;
            if ($history_number == 0) {
                $history_number = $this->domain->lng()->txt("cont_current_version");
            }
            $version_text .= $separator . $history_number;
            if (($version["lang"] ?? "") !== "") {
                $version_text .= "/" . $version["lang"];
            }
            $separator = ", ";
        }
 
        return $version_text;
    }
 
    protected function getFirstWritableRefId(int $object_id): int
    {
        foreach (\ilObject::_getAllReferences($object_id) as $ref_id) {
            if ($this->domain->access()->checkAccess("write", "", $ref_id)) {
                return (int) $ref_id;
            }
        }
        return 0;
    }
}