class.ilMediaPoolPage.php

Go to the documentation of this file.

<?php

class ilMediaPoolPage extends ilPageObject
{
    protected ilObjMediaPool $pool;

    public function getParentType(): string
    {
        return "mep";
    }

    public function setPool(ilObjMediaPool $pool): void
    {
        $this->pool = $pool;
    }

    public static function deleteAllPagesOfMediaPool(int $a_media_pool_id): void
    {
        // @todo deletion process of snippets
    }

    public static function exists(int $a_media_pool_id, string $a_title): void
    {
        // @todo: check if we need this
    }

    public static function lookupTitle(int $a_page_id): string
    {
        return ilMediaPoolItem::lookupTitle($a_page_id);
    }

    public function getUsages(bool $a_incl_hist = true): array
    {
        return self::lookupUsages($this->getId(), $a_incl_hist);
    }

    public static function lookupUsages(
        int $a_id,
        bool $a_incl_hist = true
    ): array {
        global $DIC;

        $ilDB = $DIC->database();

        // get usages in pages
        $q = "SELECT * FROM page_pc_usage WHERE pc_id = " .
            $ilDB->quote($a_id, "integer") .
            " AND pc_type = " . $ilDB->quote("incl", "text");

        if (!$a_incl_hist) {
            $q .= " AND usage_hist_nr = " . $ilDB->quote(0, "integer");
        }

        $us_set = $ilDB->query($q);
        $ret = array();
        $ct = "";
        while ($us_rec = $ilDB->fetchAssoc($us_set)) {
            $ut = "";
            if (is_int(strpos($us_rec["usage_type"], ":"))) {
                $us_arr = explode(":", $us_rec["usage_type"]);
                $ut = $us_arr[1];
                $ct = $us_arr[0];
            }

            // check whether page exists
            $skip = false;
            if ($ut === "pg" && !ilPageObject::_exists($ct, $us_rec["usage_id"])) {
                $skip = true;
            }

            if (!$skip) {
                $ret[] = array("type" => $us_rec["usage_type"],
                    "id" => $us_rec["usage_id"],
                    "hist_nr" => $us_rec["usage_hist_nr"],
                    "lang" => $us_rec["usage_lang"]);
            }
        }

        // get usages in media pools
        $q = "SELECT DISTINCT mep_id FROM mep_tree JOIN mep_item ON (child = obj_id) WHERE mep_item.obj_id = " .
            $ilDB->quote($a_id, "integer") . " AND mep_item.type = " . $ilDB->quote("pg", "text");
        $us_set = $ilDB->query($q);
        while ($us_rec = $ilDB->fetchAssoc($us_set)) {
            $ret[] = [
                "type" => "mep",
                "id" => (int) $us_rec["mep_id"]
            ];
        }

        return $ret;
    }

    protected function getMetadataType(): string
    {
        return "mpg";
    }

    public function MDUpdateListener(string $a_element): bool
    {
        switch ($a_element) {
            case 'General':

                // Update Title and description
                $paths = $this->lom_services->paths();
                $title = $this->lom_services->read(
                    $this->pool->getId(),
                    $this->getId(),
                    $this->getMetadataType(),
                    $paths->title()
                )->firstData($paths->title())->value();

                $item = new ilMediaPoolItem($this->getId());
                $item->setTitle($title);
                $item->update();

                break;

            default:
        }
        return true;
    }

    public function createMetaData(int $pool_id): bool
    {
        $ilUser = $this->user;

        $this->lom_services->derive()
                           ->fromBasicProperties(
                               self::lookupTitle($this->getId()),
                               '',
                               $ilUser->getPref('language')
                           )->forObject($pool_id, $this->getId(), $this->getMetadataType());

        return true;
    }

    public function updateMetaData(): void
    {
        $paths = $this->lom_services->paths();
        $this->lom_services->manipulate($this->pool->getId(), $this->getId(), $this->getMetadataType())
                           ->prepareCreateOrUpdate($paths->title(), self::lookupTitle($this->getId()))
                           ->execute();
    }


    public function deleteMetaData(): void
    {
        // Delete meta data
        $this->lom_services->deleteAll($this->pool->getId(), $this->getId(), $this->getMetadataType());
    }
}