class.ilAssOrderingElement.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

class ilAssOrderingElement
{
    const EXPORT_IDENT_PROPERTY_SEPARATOR = '_';

    public static $objectInstanceCounter = 0;
    public $objectInstanceId;

    public $id;

    protected $random_identifier = null;

    protected $solution_identifier = null;

    protected $indentation = 0;

    protected $position = null;

    protected $content = null;

    protected $uploadImageName = null;

    protected $uploadImageFile = null;

    protected $imageRemovalRequest = false;

    protected $imagePathWeb = null;

    protected $imagePathFs = null;
    protected $imageThumbnailPrefix = null;

    public function __construct(int $id = -1)
    {
        $this->id = $id;
        $this->objectInstanceId = ++self::$objectInstanceCounter;
    }

    public function __clone()
    {
        $this->objectInstanceId = ++self::$objectInstanceCounter;
    }

    public function getClone() : ilAssOrderingElement
    {
        return clone $this;
    }

    public function getId() : int
    {
        return $this->id;
    }

    public function setId(int $id) : void
    {
        $this->id = $id;
    }

    public function getRandomIdentifier() : int
    {
        return $this->random_identifier;
    }

    public function setRandomIdentifier(int $random_identifier) : void
    {
        $this->random_identifier = $random_identifier;
    }

    public function getSolutionIdentifier()
    {
        return $this->solution_identifier;
    }

    public function setSolutionIdentifier($solution_identifier)
    {
        $this->solution_identifier = $solution_identifier;
    }

    public function setIndentation($indentation)
    {
        $this->indentation = $indentation;
    }

    public function getIndentation()
    {
        return $this->indentation;
    }

    public function getPosition()
    {
        return $this->position;
    }

    public function setPosition($position)
    {
        $this->position = $position;
    }

    public function getContent()
    {
        return $this->content;
    }

    public function setContent($content)
    {
        if (is_array($content)) {
            $content = array_shift($content);
        }
        $this->content = $content;
    }

    public function getUploadImageFile() : ?string
    {
        return $this->uploadImageFile;
    }

    public function setUploadImageFile($uploadImageFile)
    {
        if (is_array($uploadImageFile)) {
            $uploadImageFile = array_shift($uploadImageFile);
        }
        $this->uploadImageFile = $uploadImageFile;
    }

    public function getUploadImageName()
    {
        return $this->uploadImageName;
    }

    public function setUploadImageName($uploadImageName)
    {
        if (is_array($uploadImageName)) {
            $uploadImageName = array_shift($uploadImageName);
        }
        $this->uploadImageName = $uploadImageName;
    }

    public function isImageUploadAvailable()
    {
        return (bool) strlen($this->getUploadImageFile());
    }

    public function isImageRemovalRequest()
    {
        return $this->imageRemovalRequest;
    }

    public function setImageRemovalRequest($imageRemovalRequest)
    {
        $this->imageRemovalRequest = $imageRemovalRequest;
    }

    public function getImagePathWeb()
    {
        return $this->imagePathWeb;
    }

    public function setImagePathWeb($imagePathWeb)
    {
        $this->imagePathWeb = $imagePathWeb;
    }

    public function getImagePathFs()
    {
        return $this->imagePathFs;
    }

    public function setImagePathFs($imagePathFs)
    {
        $this->imagePathFs = $imagePathFs;
    }

    public function getImageThumbnailPrefix()
    {
        return $this->imageThumbnailPrefix;
    }

    public function setImageThumbnailPrefix($imageThumbnailPrefix)
    {
        $this->imageThumbnailPrefix = $imageThumbnailPrefix;
    }

    public function isSameElement(ilAssOrderingElement $element) : bool
    {
        return [
            $this->getRandomIdentifier(),
            $this->getSolutionIdentifier(),
            $this->getPosition(),
            $this->getIndentation(),
        ] == [
            $element->getRandomIdentifier(),
            $element->getSolutionIdentifier(),
            $element->getPosition(),
            $element->getIndentation()
        ];
    }

    public function getStorageValue1($orderingType)
    {
        switch ($orderingType) {
            case assOrderingQuestion::OQ_NESTED_TERMS:
            case assOrderingQuestion::OQ_NESTED_PICTURES:

                return $this->getPosition();

            case assOrderingQuestion::OQ_TERMS:
            case assOrderingQuestion::OQ_PICTURES:

                return $this->getSolutionIdentifier();
        }
    }

    public function getStorageValue2($orderingType)
    {
        switch ($orderingType) {
            case assOrderingQuestion::OQ_NESTED_TERMS:
            case assOrderingQuestion::OQ_NESTED_PICTURES:

                return $this->getRandomIdentifier() . ':' . $this->getIndentation();

            case assOrderingQuestion::OQ_TERMS:
            case assOrderingQuestion::OQ_PICTURES:

                return $this->getPosition() + 1;
        }
    }

    public function __toString()
    {
        return $this->getContent();
    }

    protected function thumbnailFileExists()
    {
        if (!$this->getContent()) {
            return false;
        }

        return file_exists($this->getThumbnailFilePath());
    }

    protected function getThumbnailFilePath()
    {
        return $this->getImagePathFs() . $this->getImageThumbnailPrefix() . $this->getContent();
    }

    protected function getThumbnailFileUrl()
    {
        return $this->getImagePathWeb() . $this->getImageThumbnailPrefix() . $this->getContent();
    }

    protected function imageFileExists()
    {
        if (!$this->getContent()) {
            return false;
        }

        return file_exists($this->getImageFilePath());
    }

    protected function getImageFilePath()
    {
        return $this->getImagePathFs() . $this->getContent();
    }

    protected function getImageFileUrl()
    {
        return $this->getImagePathWeb() . $this->getContent();
    }

    public function getPresentationImageUrl()
    {
        if ($this->thumbnailFileExists()) {
            return $this->getThumbnailFileUrl();
        }

        if ($this->imageFileExists()) {
            return $this->getImageFileUrl();
        }

        return '';
    }

    public function getExportIdent()
    {
        $ident = array(
            $this->getRandomIdentifier(),
            $this->getSolutionIdentifier(),
            $this->getPosition(),
            $this->getIndentation()
        );

        return implode(self::EXPORT_IDENT_PROPERTY_SEPARATOR, $ident);
    }

    public function isExportIdent(string $ident) : bool
    {
        if (!strlen($ident)) {
            return false;
        }

        $parts = explode(self::EXPORT_IDENT_PROPERTY_SEPARATOR, $ident);
        return
            count($parts) == 4
            && ilAssOrderingElementList::isValidRandomIdentifier($parts[0])
            && ilAssOrderingElementList::isValidSolutionIdentifier($parts[1])
            && ilAssOrderingElementList::isValidPosition($parts[2])
            && ilAssOrderingElementList::isValidIndentation($parts[3]);
    }

    public function setExportIdent($ident)
    {
        if ($this->isExportIdent($ident)) {
            list($randomId, $solutionId, $pos, $indent) = explode(
                self::EXPORT_IDENT_PROPERTY_SEPARATOR,
                $ident
            );
            $this->setRandomIdentifier((int) $randomId);
            $this->setSolutionIdentifier($solutionId);
            $this->setPosition($pos);
            $this->setIndentation($indent);
        }
    }


    public function withRandomIdentifier(int $id) : self
    {
        $clone = clone $this;
        $clone->random_identifier = $id;
        return $clone;
    }
    public function withSolutionIdentifier(int $id) : self
    {
        $clone = clone $this;
        $clone->solution_identifier = $id;
        return $clone;
    }
    public function withPosition(int $position) : self
    {
        $clone = clone $this;
        $clone->position = $position;
        return $clone;
    }
    public function withIndentation(int $indentation) : self
    {
        $clone = clone $this;
        $clone->indentation = $indentation;
        return $clone;
    }
    public function withContent(string $content) : self
    {
        $clone = clone $this;
        $clone->content = $content;
        return $clone;
    }
}