class.ilFileVersionFormGUI.php

Go to the documentation of this file.

<?php
 
use ILIAS\UI\Component\Input\Container\Form\Standard;
use ILIAS\UI\Factory;
use ILIAS\UI\Renderer;
use ILIAS\ResourceStorage\Services;
use Psr\Http\Message\RequestInterface;
 
class ilFileVersionFormGUI
{
    use ilObjFileSecureString;
    public const MODE_ADD = 1;
    public const MODE_REPLACE = 2;
    public const F_TITLE = 'title';
    public const F_DESCRIPTION = "description";
    public const F_FILE = "file";
    public const F_SAVE_MODE = 'save_mode';
 
    private \ilObjFile $file;
    private ?Standard $form;
    private Factory $ui_factory;
    private Renderer $ui_renderer;
    private RequestInterface $request;
    private ilGlobalTemplateInterface $global_tpl;
    private ilLanguage $lng;
    private Services $resource_services;
    private string $post_url;
 
    public function __construct(ilFileVersionsGUI $file_version_gui, private int $save_mode = self::MODE_ADD)
    {
        global $DIC;
        $this->file = $file_version_gui->getFile();
        ;
        $this->lng = $DIC->language();
        $this->ui_factory = $DIC->ui()->factory();
        $this->ui_renderer = $DIC->ui()->renderer();
        $this->request = $DIC->http()->request();
        $this->global_tpl = $DIC->ui()->mainTemplate();
        $this->resource_services = $DIC->resourceStorage();
        $this->post_url = $DIC->ctrl()->getFormAction(
            $file_version_gui,
            $this->resolveParentCommand($save_mode)
        );
        $this->lng->loadLanguageModule('file');
        $this->initForm();
    }
 
    private function initForm(): void
    {
        switch ($this->save_mode) {
            case self::MODE_REPLACE:
                $this->global_tpl->setOnScreenMessage('info', $this->lng->txt('replace_file_info'));
                $group_title = $this->lng->txt('replace_file');
                break;
            case self::MODE_ADD:
            default:
                $this->global_tpl->setOnScreenMessage('info', $this->lng->txt('file_new_version_info'));
                $group_title = $this->lng->txt('file_new_version');
                break;
        }
 
        $upload_handler = new ilFileVersionsUploadHandlerGUI(
            $this->file,
            $this->save_mode === self::MODE_REPLACE
                ? ilFileVersionsUploadHandlerGUI::MODE_REPLACE
                : ilFileVersionsUploadHandlerGUI::MODE_APPEND
        );
 
        $inputs = [
            self::F_TITLE => $this->ui_factory->input()->field()->text(
                $this->lng->txt(self::F_TITLE),
                $this->lng->txt("if_no_title_then_filename")
            )->withRequired(false)
             ->withMaxLength(ilObject::TITLE_LENGTH)
             ->withValue($this->file->getTitle()),
 
            self::F_DESCRIPTION => $this->ui_factory->input()->field()->textarea(
                $this->lng->txt(self::F_DESCRIPTION)
            ),
            self::F_FILE => $this->ui_factory->input()->field()->file(
                $upload_handler,
                $this->lng->txt(self::F_FILE)
            )->withMaxFiles(1)
             ->withRequired(true),
        ];
 
        $group = $this->ui_factory->input()->field()->group($inputs, $group_title);
 
        $this->form = $this->ui_factory->input()->container()->form()->standard($this->post_url, [$group]);
    }
 
    public function saveObject(): bool
    {
        $this->form = $this->form->withRequest($this->request);
        $data = $this->form->getData()[0] ?? null;
        if ($data === null) {
            return false;
        }
 
        $title = empty($data[self::F_TITLE]) ? $this->file->getTitle() : $data[self::F_TITLE];
        $description = $data[self::F_DESCRIPTION] !== '' ? $data[self::F_DESCRIPTION] : $this->file->getDescription();
        $revision_number = $data[self::F_FILE][0] ?? null;
        if ($revision_number === null) {
            return false;
        }
        $revision_number = (int) $revision_number;
 
        // Title differs, update Revision and Object
        $rid = $this->resource_services->manage()->find($this->file->getResourceId());
        $resource = $this->resource_services->manage()->getResource($rid);
        $new_revision = $resource->getSpecificRevision($revision_number);
 
        $new_revision->setTitle(
            $this->ensureSuffix($title, $new_revision->getInformation()->getSuffix())
        );
        $this->resource_services->manage()->updateRevision($new_revision);
 
        $this->file->setDescription($description);
        $this->file->updateObjectFromCurrentRevision();
 
        return true;
    }
 
    public function getHTML(): string
    {
        return $this->ui_renderer->render($this->form);
    }
 
    private function resolveParentCommand(int $mode): string
    {
        return match ($mode) {
            self::MODE_REPLACE => ilFileVersionsGUI::CMD_CREATE_REPLACING_VERSION,
            default => ilFileVersionsGUI::CMD_CREATE_NEW_VERSION,
        };
    }
}