class.ilAccessibilityDocument.php

Go to the documentation of this file.

<?php
 
class ilAccessibilityDocument extends ActiveRecord implements ilAccessibilitySignableDocument
{
    public const TABLE_NAME = 'acc_documents';
 
    protected ?int $id;
 
    protected ?int $creation_ts = 0;
 
    protected ?int $modification_ts = 0;
 
    protected ?int $owner_usr_id = 0;
 
    protected ?int $last_modified_usr_id = 0;
 
    protected ?int $sorting = 0;
 
    protected ?string $title = '';
 
    protected ?string $text = '';
 
    protected array $criteria = [];
 
    protected array $initialPersistedCriteria = [];
 
    private bool $criteriaFetched = false;
 
    public static function returnDbTableName(): string
    {
        return self::TABLE_NAME;
    }
 
    public function content(): string
    {
        return $this->text;
    }
 
    public function title(): string
    {
        return $this->title;
    }
 
    public function id(): int
    {
        return (int) $this->id;
    }
 
    public function read(): void
    {
        parent::read();
 
        $this->fetchAllCriterionAssignments();
    }
 
    public function buildFromArray(array $array): static
    {
        $document = parent::buildFromArray($array);
 
        $this->fetchAllCriterionAssignments();
 
        return $document;
    }
 
    public function create(): void
    {
        $this->setCreationTs(time());
 
        parent::create();
 
        foreach ($this->criteria as $criterionAssignment) {
            $criterionAssignment->setDocId($this->getId());
            $criterionAssignment->store();
        }
 
        $this->initialPersistedCriteria = $this->criteria;
    }
 
    public function update(): void
    {
        $this->setModificationTs(time());
 
        foreach ($this->criteria as $criterionAssignment) {
            $criterionAssignment->setDocId($this->getId());
            $criterionAssignment->store();
        }
 
        foreach ($this->initialPersistedCriteria as $criterionAssignment) {
            $found = array_filter(
                $this->criteria,
                function (ilAccessibilityDocumentCriterionAssignment $criterionToMatch) use ($criterionAssignment) {
                    return $criterionToMatch->getId() == $criterionAssignment->getId();
                }
            );
 
            if (0 === count($found)) {
                $criterionAssignment->delete();
            }
        }
 
        $this->initialPersistedCriteria = $this->criteria;
 
        parent::update();
    }
 
    public function delete(): void
    {
        foreach ($this->initialPersistedCriteria as $criterionAssignment) {
            $criterionAssignment->delete();
        }
 
        $this->initialPersistedCriteria = $this->criteria = [];
 
        parent::delete();
    }
 
    public function criteria(): array
    {
        return $this->criteria;
    }
 
    public function attachCriterion(ilAccessibilityDocumentCriterionAssignment $criterionAssignment): void
    {
        foreach ($this->criteria as $currentAssignment) {
            if ($currentAssignment->equals($criterionAssignment)) {
                throw new ilAccessibilityDuplicateCriterionAssignmentException(sprintf(
                    "Cannot attach duplicate criterion with criterion typeIdent %s and value: %s",
                    $criterionAssignment->getCriterionId(),
                    var_export($criterionAssignment->getCriterionValue(), true)
                ));
            }
        }
 
        $this->criteria[] = $criterionAssignment;
    }
 
    public function detachCriterion(ilAccessibilityDocumentCriterionAssignment $criterionAssignment): void
    {
        $numCriteriaBeforeRemoval = count($this->criteria);
 
        $this->criteria = array_filter(
            $this->criteria,
            function (ilAccessibilityDocumentCriterionAssignment $currentAssignment) use ($criterionAssignment) {
                return !$currentAssignment->equals($criterionAssignment);
            }
        );
 
        $numCriteriaAfterRemoval = count($this->criteria);
 
        if ($numCriteriaAfterRemoval === $numCriteriaBeforeRemoval) {
            throw new OutOfBoundsException(sprintf(
                "Could not find any criterion with criterion typeIdent %s and value: %s",
                $criterionAssignment->getCriterionId(),
                var_export($criterionAssignment->getCriterionValue(), true)
            ));
        }
    }
 
    public function fetchAllCriterionAssignments(): void
    {
        if (!$this->criteriaFetched) {
            $this->criteriaFetched = true;
 
            $this->initialPersistedCriteria = [];
            $this->criteria = [];
 
            $criteria = ilAccessibilityDocumentCriterionAssignment::where(['doc_id' => $this->getId()])->get();
            foreach ($criteria as $criterionAssignment) {
                $this->criteria[] = $criterionAssignment;
            }
 
            $this->initialPersistedCriteria = $this->criteria;
        }
    }
}