class.ilObjFileGUI.php

Go to the documentation of this file.

<?php
 
use ILIAS\UI\Component\Input\Container\Form\FormInput;
use ILIAS\UI\Component\Input\Field\Section;
use ILIAS\HTTP\Wrapper\WrapperFactory;
use ILIAS\UI\Renderer;
use Psr\Http\Message\ServerRequestInterface;
use ILIAS\Filesystem\Exception\FileNotFoundException;
use ILIAS\DI\UIServices;
use ILIAS\UI\Component\Input\Field\UploadHandler;
use ILIAS\ResourceStorage\Services;
use ILIAS\ResourceStorage\Stakeholder\ResourceStakeholder;
use ILIAS\UI\Component\Input\Container\Form\Standard;
use ILIAS\File\Icon\IconDatabaseRepository;
use ILIAS\components\File\Settings\General;
use ILIAS\Refinery\String\Group;
use ILIAS\Data\Factory;
use ILIAS\WOPI\Discovery\ActionDBRepository;
use ILIAS\WOPI\Embed\EmbeddedApplication;
use ILIAS\Data\URI;
use ILIAS\MetaData\Services\ServicesInterface as LOMServices;
use ILIAS\File\Capabilities\Capabilities;
use ILIAS\File\Capabilities\CapabilityBuilder;
use ILIAS\File\Capabilities\CapabilityCollection;
use ILIAS\File\Capabilities\Context;
use ILIAS\ILIASObject\Properties\CoreProperties\TitleAndDescription;
 
class ilObjFileGUI extends ilObject2GUI
{
    use ilObjFileCopyrightInput;
    use ilObjFileInfoProvider;
    use ilObjFileTransformation;
 
    public const UPLOAD_MAX_FILES = 100;
    public const PARAM_FILES = 'files';
    public const PARAM_TITLE = 'title';
    public const PARAM_DESCRIPTION = 'description';
    public const PARAM_COPYRIGHT_ID = "copyright_id";
 
    public const PARAM_UPLOAD_ORIGIN = 'origin';
    public const UPLOAD_ORIGIN_STANDARD = 'standard';
    public const UPLOAD_ORIGIN_DROPZONE = 'dropzone';
 
    public const CMD_EDIT = Capabilities::EDIT_SETTINGS->value;
    public const CMD_VERSIONS = Capabilities::MANAGE_VERSIONS->value;
    public const CMD_UPLOAD_FILES = "uploadFiles";
 
    public const CMD_SEND_FILE = Capabilities::DOWNLOAD->value;
    private CapabilityCollection $capabilities;
 
    public ?ilObject $object = null;
    public ilLanguage $lng;
    protected UIServices $ui;
    protected UploadHandler $upload_handler;
    protected ResourceStakeholder $stakeholder;
    protected Services $storage;
    protected ?ilLogger $log = null;
    protected ilObjectService $obj_service;
    protected \ILIAS\Refinery\Factory $refinery;
    protected General $general_settings;
    protected ilFileServicesSettings $file_service_settings;
    protected IconDatabaseRepository $icon_repo;
    protected \ILIAS\UI\Component\Input\Factory $inputs;
    protected Renderer $renderer;
    protected ServerRequestInterface $request;
    protected Factory $data_factory;
    private ActionDBRepository $action_repo;
    protected LOMServices $lom_services;
 
    public function __construct(int $a_id = 0, int $a_id_type = self::REPOSITORY_NODE_ID, int $a_parent_node_id = 0)
    {
        global $DIC;
        $this->refinery = $DIC->refinery();
        $this->file_service_settings = $DIC->fileServiceSettings();
        $this->user = $DIC->user();
        $this->lng = $DIC->language();
        $this->log = ilLoggerFactory::getLogger(ilObjFile::OBJECT_TYPE);
        $this->ui = $DIC->ui();
        $this->storage = $DIC->resourceStorage();
        $this->upload_handler = new ilObjFileUploadHandlerGUI();
        $this->stakeholder = new ilObjFileStakeholder();
        $this->general_settings = new General();
        parent::__construct($a_id, $a_id_type, $a_parent_node_id);
        $this->obj_service = $DIC->object();
        $this->lng->loadLanguageModule(ilObjFile::OBJECT_TYPE);
        $this->icon_repo = new IconDatabaseRepository();
        $this->inputs = $DIC->ui()->factory()->input();
        $this->renderer = $DIC->ui()->renderer();
        $this->request = $DIC->http()->request();
        $this->data_factory = new Factory();
        $this->action_repo = new ActionDBRepository($DIC->database());
        $this->lom_services = $DIC->learningObjectMetadata();
 
        $capability_builder = new CapabilityBuilder(
            new ilObjFileInfoRepository(),
            $this->access,
            $this->ctrl,
            $this->action_repo,
            $DIC->http(),
            $DIC['static_url.uri_builder']
        );
 
        $capability_context = new Context(
            $this->object_id,
            $this->ref_id,
            ($a_id_type === self::WORKSPACE_NODE_ID) ? Context::CONTEXT_WORKSPACE : Context::CONTEXT_REPO
        );
 
        $this->capabilities = $capability_builder->get($capability_context);
    }
 
    protected function updateLearningProgress(): void
    {
        if ($this->object->getLPMode() === ilLPObjSettings::LP_MODE_CONTENT_VISITED) {
            ilLPStatusWrapper::_updateStatus(
                $this->object->getId(),
                $this->user->getId(),
                null,
                false,
                true
            );
        }
    }
 
    public function getType(): string
    {
        return ilObjFile::OBJECT_TYPE;
    }
 
    public function getParentId(): int
    {
        return $this->parent_id;
    }
 
    #[\Override]
    public function executeCommand(): void
    {
        global $DIC;
        $ilNavigationHistory = $DIC['ilNavigationHistory'];
        $ilUser = $DIC['ilUser'];
        $ilTabs = $DIC['ilTabs'];
        $ilErr = $DIC['ilErr'];
 
        $next_class = $this->ctrl->getNextClass($this);
        $cmd = $this->ctrl->getCmd();
 
        if (
            !$this->getCreationMode()
            && (
                $this->id_type === self::REPOSITORY_NODE_ID
                && $this->capabilities->get(Capabilities::DOWNLOAD)->isUnlocked()
            )) {
            // add entry to navigation history
            $ilNavigationHistory->addItem(
                $this->node_id,
                (string) $this->capabilities->get(Capabilities::INFO_PAGE)->getUri(),
                ilObjFile::OBJECT_TYPE
            );
        }
 
        $this->prepareOutput();
 
        $info = (new ilObjFileInfoRepository())->getByObjectId($this->obj_id);
 
        $suffix = $info->getSuffix();
        $path_file_icon = $this->icon_repo->getIconFilePathBySuffix($suffix);
        $this->tpl->setTitleIcon($path_file_icon);
 
        switch ($next_class) {
            case strtolower(ilInfoScreenGUI::class):
                $this->infoScreenForward();    // forwards command
                break;
 
            case 'ilobjectmetadatagui':
                if (!$this->capabilities->get(Capabilities::EDIT_SETTINGS)->isUnlocked()) {
                    $ilErr->raiseError($this->lng->txt('permission_denied'), $ilErr->WARNING);
                }
 
                $ilTabs->activateTab("id_meta");
 
                $md_gui = new ilObjectMetaDataGUI($this->object, null, null, $this->call_by_reference);
 
                // todo: make this work
                // $md_gui->addMDObserver($this->object,'MDUpdateListener','Technical');
 
                $this->ctrl->forwardCommand($md_gui);
                break;
 
                // repository permissions
            case 'ilpermissiongui':
                $ilTabs->activateTab("id_permissions");
                $perm_gui = new ilPermissionGUI($this);
                $this->ctrl->forwardCommand($perm_gui);
                break;
 
            case "ilexportgui":
                $ilTabs->activateTab("export");
                $exp_gui = new ilExportGUI($this);
                $exp_gui->addFormat();
                $this->ctrl->forwardCommand($exp_gui);
                break;
 
            case 'ilobjectcopygui':
                $cp = new ilObjectCopyGUI($this);
                $cp->setType(ilObjFile::OBJECT_TYPE);
                $this->ctrl->forwardCommand($cp);
                break;
 
                // personal workspace permissions
            case "ilworkspaceaccessgui":
                $ilTabs->activateTab("id_permissions");
                $wspacc = new ilWorkspaceAccessGUI($this->node_id, $this->getAccessHandler());
                $this->ctrl->forwardCommand($wspacc);
                break;
 
            case "ilcommonactiondispatchergui":
                $gui = ilCommonActionDispatcherGUI::getInstanceFromAjaxCall();
                $this->ctrl->forwardCommand($gui);
                break;
 
            case "illearningprogressgui":
                $ilTabs->activateTab('learning_progress');
                $user_id = $this->request_wrapper->has('user_id')
                    ? $this->request_wrapper->retrieve('user_id', $this->refinery->kindlyTo()->int())
                    : $ilUser->getId();
                $new_gui = new ilLearningProgressGUI(
                    ilLearningProgressGUI::LP_CONTEXT_REPOSITORY,
                    $this->object->getRefId(),
                    $user_id
                );
                $this->ctrl->forwardCommand($new_gui);
                $this->tabs_gui->setTabActive('learning_progress');
                break;
            case strtolower(ilFileVersionsGUI::class):
                $this->tabs_gui->activateTab("id_versions");
 
                if (!$this->capabilities->get(Capabilities::MANAGE_VERSIONS)->isUnlocked()) {
                    $this->error->raiseError($this->lng->txt("permission_denied"), $this->error->MESSAGE);
                }
                $obj = $this->object;
                $this->ctrl->forwardCommand(new ilFileVersionsGUI($obj));
                break;
            case strtolower(ilObjFileUploadHandlerGUI::class):
                $this->ctrl->forwardCommand(new ilObjFileUploadHandlerGUI());
                break;
            case strtolower(ilWOPIEmbeddedApplicationGUI::class):
                $capability = match($cmd) {
                    ilWOPIEmbeddedApplicationGUI::CMD_VIEW => $this->capabilities->get(Capabilities::VIEW_EXTERNAL),
                    ilWOPIEmbeddedApplicationGUI::CMD_EDIT => $this->capabilities->get(Capabilities::EDIT_EXTERNAL),
                    ilWOPIEmbeddedApplicationGUI::CMD_RETURN => $this->capabilities->get(Capabilities::INFO_PAGE),
                    default => null
                };
 
                if ($capability === null || !$capability->isUnlocked()) {
                    $this->error->raiseError($this->lng->txt("permission_denied"), $this->error->MESSAGE);
                    return;
                }
                $action = match ($capability->getCapability()) {
                    Capabilities::VIEW_EXTERNAL => $this->action_repo->getViewActionForSuffix($suffix),
                    Capabilities::EDIT_EXTERNAL => $this->action_repo->getEditActionForSuffix($suffix),
                    default => null
                };
 
                $this->tabs_gui->activateTab('content');
                $this->updateLearningProgress();
 
                if ($this->id_type === Context::CONTEXT_WORKSPACE) {
                    $goto_link = ilWorkspaceAccessHandler::getGotoLink(
                        $this->node_id,
                        $this->object->getId()
                    );
                } else {
                    $goto_link = ilLink::_getLink($this->object->getRefId());
                }
 
                $embeded_application = new EmbeddedApplication(
                    $this->storage->manage()->find($this->object->getResourceId()),
                    $action,
                    $this->stakeholder,
                    new URI($goto_link),
                    $capability->getCapability() === Capabilities::VIEW_EXTERNAL,
                    $this->lng->getLangKey()
                );
 
                $this->ctrl->forwardCommand(
                    new ilWOPIEmbeddedApplicationGUI(
                        $embeded_application
                    )
                );
                break;
 
            case strtolower(ilFileCommonSettingsGUI::class):
                $this->initSettingsTab();
                $this->tabs_gui->activateSubTab("service_settings");
                $this->ctrl->forwardCommand(
                    new ilFileCommonSettingsGUI(
                        $this->object,
                        $this->ctrl,
                        $this->tpl,
                        $this->lng,
                        $this->object_service
                    )
                );
                break;
 
            default:
                // in personal workspace use object2gui
                if ($this->id_type === self::WORKSPACE_NODE_ID) {
                    $this->addHeaderAction();
                    $ilTabs->clearTargets();
 
                    if (empty($cmd) || $cmd === 'render') {
                        $cmd = Capabilities::INFO_PAGE->value;
                        $this->$cmd();
                    } else {
                        parent::executeCommand();
                    }
                    break; // otherwise subtabs are duplicated
                }
 
                if (empty($cmd) || $cmd === 'render') {
                    $cmd = Capabilities::INFO_PAGE->value;
                }
 
                $this->$cmd();
                break;
        }
 
        $this->addHeaderAction();
    }
 
 
    protected function addUIFormToAccordion(
        ilAccordionGUI $accordion,
        Standard $form,
        int $form_type
    ): void {
        // abort if form-type is unknown
        if (!in_array($form_type, [self::CFORM_NEW, self::CFORM_CLONE, self::CFORM_IMPORT], true)) {
            return;
        }
 
        $inputs = $form->getInputs();
        // use label of first input as title, because UI Component forms don't support form-titles yet
        $title = ($inputs === []) ?
            '' : $inputs[array_key_first($inputs)]->getLabel();
 
        $tpl = new ilTemplate("tpl.creation_acc_head.html", true, true, "components/ILIAS/ILIASObject");
        $tpl->setVariable("TITLE", $this->lng->txt("option") . " " . $form_type . ": " . $title);
 
        $accordion->addItem($tpl->get(), $this->ui->renderer()->render($form));
    }
 
    protected function addLegacyFormToAccordion(
        ilAccordionGUI $accordion,
        ilPropertyFormGUI $form,
        int $form_type
    ): void {
        // abort if form-type is unknown
        if (!in_array($form_type, [self::CFORM_NEW, self::CFORM_CLONE, self::CFORM_IMPORT], true)) {
            return;
        }
        $title = $form->getTitle();
        $form->setTitle(''); // see https://mantis.ilias.de/view.php?id=37786
 
        $tpl = new ilTemplate("tpl.creation_acc_head.html", true, true, "components/ILIAS/ILIASObject");
        $tpl->setVariable("TITLE", $this->lng->txt("option") . " " . $form_type . ": " . $title);
 
        $accordion->addItem($tpl->get(), $form->getHTML());
    }
 
    #[\Override]
    protected function initCreateForm(string $new_type): Standard
    {
        return $this->initUploadForm();
    }
 
    #[\Override]
    protected function getCreationFormTitle(): string
    {
        return $this->lng->txt('upload_files');
    }
 
    public function initUploadForm(): Standard
    {
        $this->getLanguage()->loadLanguageModule('file');
        $inputs = [];
 
        $this->ctrl->setParameterByClass(self::class, 'new_type', $this->getType());
        $this->ctrl->setParameterByClass(
            self::class,
            self::PARAM_UPLOAD_ORIGIN,
            self::UPLOAD_ORIGIN_STANDARD
        );
 
 
        $inputs[self::PARAM_FILES] = $this->ui->factory()->input()->field()->file(
            $this->upload_handler,
            $this->lng->txt('upload_files'),
            null,
            $this->ui->factory()->input()->field()->group([
                self::PARAM_TITLE => $this->ui->factory()->input()->field()->text(
                    $this->lng->txt('title')
                )->withAdditionalTransformation(
                    $this->getEmptyStringToNullTransformation()
                ),
                self::PARAM_DESCRIPTION => $this->ui->factory()->input()->field()->textarea(
                    $this->lng->txt('description')
                )->withAdditionalTransformation(
                    $this->getEmptyStringToNullTransformation()
                ),
            ])
        )->withMaxFiles(
            self::UPLOAD_MAX_FILES
        )->withRequired(true);
 
        if ($this->lom_services->copyrightHelper()->isCopyrightSelectionActive()) {
            $inputs[self::PARAM_COPYRIGHT_ID] = $this->getCopyrightSelectionInput('set_license_for_all_files');
        }
 
        return $this->ui->factory()->input()->container()->form()->standard(
            $this->ctrl->getFormActionByClass(self::class, self::CMD_UPLOAD_FILES),
            $inputs
        )->withSubmitLabel($this->lng->txt('upload_files'));
    }
 
    protected function uploadFiles(): void
    {
        $origin = ($this->request_wrapper->has(self::PARAM_UPLOAD_ORIGIN)) ?
            $this->request_wrapper->retrieve(
                self::PARAM_UPLOAD_ORIGIN,
                $this->refinery->kindlyTo()->string()
            ) : self::UPLOAD_ORIGIN_STANDARD;
 
        if (self::UPLOAD_ORIGIN_DROPZONE === $origin) {
            $dropzone = new ilObjFileUploadDropzone($this->parent_id);
            $dropzone = $dropzone->getDropzone()->withRequest($this->request);
            $data = $dropzone->getData();
        } else {
            $form = $this->initUploadForm()->withRequest($this->request);
            $data = $form->getData();
        }
        $files = $data[self::PARAM_FILES] ?? $data[0] ?? null;
 
        if (empty($files)) {
            $form = $this->initUploadForm()->withRequest($this->request);
            $this->tpl->setContent($this->getCreationFormsHTML($form));
            return;
        }
 
        $processor = new ilObjFileProcessor(
            $this->stakeholder,
            $this,
            $this->storage,
            $this->file_service_settings
        );
 
        $errors = false;
        foreach ($files as $file_data) {
            $rid = $this->storage->manage()->find($file_data[0]);
            if (null !== $rid) {
                try {
                    $processor->process(
                        $rid,
                        $file_data[1][self::PARAM_TITLE] ?? null,
                        $file_data[1][self::PARAM_DESCRIPTION] ?? null,
                        $data[self::PARAM_COPYRIGHT_ID] ?? null
                    );
                } catch (Throwable $t) {
                    $errors = true;
                    if (null !== $this->log) {
                        $this->log->error($t->getMessage() . ": " . $t->getTraceAsString());
                    }
                }
            }
        }
 
        if ($errors) {
            $this->ui->mainTemplate()->setOnScreenMessage(
                'failure',
                $this->lng->txt('could_not_create_file_objs'),
                true
            );
        }
 
        if ($processor->getInvalidFileNames() !== []) {
            $this->ui->mainTemplate()->setOnScreenMessage(
                'info',
                sprintf(
                    $this->lng->txt('file_upload_info_file_with_critical_extension'),
                    implode(', ', $processor->getInvalidFileNames())
                ),
                true
            );
        }
 
        $link = match ($this->id_type) {
            self::WORKSPACE_NODE_ID => $this->ctrl->getLinkTargetByClass(ilObjWorkspaceRootFolderGUI::class),
            default => ilLink::_getLink($this->requested_ref_id),
        };
 
        $this->ctrl->redirectToURL($link);
    }
 
    #[\Override]
    public function putObjectInTree(ilObject $obj, ?int $parent_node_id = null): void
    {
        // this is needed to support multi fileuploads in personal and shared resources
        $backup_node_id = $this->node_id;
        parent::putObjectInTree($obj, $parent_node_id);
        $this->node_id = $backup_node_id;
    }
 
    #[\Override]
    public function update(): void
    {
        $data = [];
        $form = $this->initPropertiesForm();
        $form = $form->withRequest($this->request);
        $inputs = $form->getData();
 
        $title_and_description = $inputs['file_info']['title_and_description'];
 
        $title = $title_and_description->getTitle();
        // bugfix mantis 26045:
        $filename = $this->object->getFileName();
        if (trim((string) $title) === '') {
            $title = $filename;
        }
        $title = $this->object->appendSuffixToTitle($title, $filename);
 
        $this->object->handleChangedObjectTitle($title);
 
        $description = $title_and_description->getLongDescription();
        $this->object->setDescription($description);
 
        $updated_title_and_description = new TitleAndDescription($title, $description);
        $this->object->getObjectProperties()->storePropertyTitleAndDescription($updated_title_and_description);
 
        $this->object->setImportantInfo($inputs['file_info']['important_info']);
        $this->object->setRating($inputs['obj_features']['rating'] ?? false);
        $this->object->setOnclickMode((int) $inputs['file_info']['on_click_action']);
        $this->object->update();
 
        $this->object->getObjectProperties()->storePropertyIsOnline($inputs['availability']['online_status']);
 
        if (($inputs['presentation']['tile_image'] ?? null) !== null) {
            $this->object->getObjectProperties()->storePropertyTileImage($inputs['presentation']['tile_image']);
        }
 
        // BEGIN ChangeEvent: Record update event.
        if (!empty($data["name"])) {
            global $DIC;
            $ilUser = $DIC['ilUser'];
            ilChangeEvent::_recordWriteEvent($this->object->getId(), $ilUser->getId(), 'update');
        }
        // END ChangeEvent: Record update event.
 
        // Update ecs export settings
        //        $ecs = new ilECSFileSettings($this->object);
        //        $ecs->handleSettingsUpdate(); TODO: reintroduce usage of ECS file settings once they have been made compatible with the new ui components
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt("msg_obj_modified"), true);
        $this->ctrl->redirectByClass(self::class, self::CMD_EDIT);
    }
 
    #[\Override]
    public function edit(): void
    {
        global $DIC;
        $ilErr = $DIC['ilErr'];
 
        if (!$this->capabilities->get(Capabilities::EDIT_SETTINGS)->isUnlocked()) {
            $ilErr->raiseError($this->lng->txt("msg_no_perm_write"));
        }
 
        $this->initSettingsTab();
 
        $form = $this->initPropertiesForm();
 
        //        $ecs = new ilECSFileSettings($this->object);
        //        $ecs->addSettingsToForm($form, ilObjFile::OBJECT_TYPE); TODO: reintroduce usage of ECS file settings once they have been made compatible with the new ui components
 
        $this->tpl->setContent($this->renderer->render($form));
    }
 
    protected function initPropertiesForm(): Standard
    {
        $title_and_description = $this->object->getObjectProperties()->getPropertyTitleAndDescription()->toForm(
            $this->lng,
            $this->ui->factory()->input()->field(),
            $this->refinery
        );
 
        $important_info = $this->inputs->field()->markdown(
            new ilUIMarkdownPreviewGUI(),
            $this->lng->txt('important_info'),
            $this->lng->txt('important_info_byline')
        )->withValue(
            $this->object->getImportantInfo() ?? ""
        );
 
        $on_click_action = $this->inputs->field()->radio(
            $this->lng->txt('on_click_action')
        )->withOption(
            (string) ilObjFile::CLICK_MODE_DOWNLOAD,
            $this->lng->txt('file_action_download'),
            $this->lng->txt('file_action_download_info'),
        )->withOption(
            (string) ilObjFile::CLICK_MODE_INFOPAGE,
            $this->lng->txt('file_action_show'),
            $this->lng->txt('file_action_show_info'),
        )->withValue(
            (string) $this->object->getOnClickMode()
        );
 
        $input_groups = array_filter([
            "title_and_description" => $title_and_description,
            "important_info" => $important_info,
            "on_click_action" => $on_click_action
        ], static fn(FormInput $input): bool => null !== $input);
 
        $file_info_section = $this->inputs->field()->section(
            $input_groups,
            $this->lng->txt('file_info')
        );
 
        $online_status = $this->object->getObjectProperties()->getPropertyIsOnline()->toForm(
            $this->lng,
            $this->ui->factory()->input()->field(),
            $this->refinery
        );
        $availability_section = $this->inputs->field()->section(
            ["online_status" => $online_status],
            $this->lng->txt('rep_activation_availability')
        );
 
        $presentation_section = null;
        if ($this->id_type === self::REPOSITORY_NODE_ID) {
            $tile_image = $this->object->getObjectProperties()->getPropertyTileImage()->toForm(
                $this->lng,
                $this->ui->factory()->input()->field(),
                $this->refinery
            );
            $presentation_section = $this->inputs->field()->section(
                ["tile_image" => $tile_image],
                $this->lng->txt('settings_presentation_header')
            );
        }
 
        $additional_features_section = null;
        if ($this->id_type === self::REPOSITORY_NODE_ID) {
            $this->lng->loadLanguageModule('rating');
 
            $enable_rating = $this->inputs->field()->checkbox(
                $this->lng->txt('rating_activate_rating'),
                $this->lng->txt('rating_activate_rating_info')
            )->withValue(
                $this->object->hasRating()
            );
            $additional_features_section = $this->inputs->field()->section(
                ["rating" => $enable_rating],
                $this->lng->txt('obj_features')
            );
        }
 
        $inputs = array_filter([
            "file_info" => $file_info_section,
            "availability" => $availability_section,
            "presentation" => $presentation_section,
            "obj_features" => $additional_features_section
        ], static fn(?Section $input): bool => null !== $input);
 
        return $this->inputs->container()->form()->standard(
            $this->ctrl->getLinkTargetByClass(self::class, 'update'),
            $inputs
        );
    }
 
    public function sendFile(): bool
    {
        $hist_entry_id = $this->request_wrapper->has('hist_id')
            ? $this->request_wrapper->retrieve('hist_id', $this->refinery->kindlyTo()->int())
            : null;
        try {
            if (ANONYMOUS_USER_ID === $this->user->getId() && $this->request_wrapper->has('transaction')) {
                $this->object->sendFile($hist_entry_id);
            }
 
            if ($this->capabilities->get(Capabilities::DOWNLOAD)->isUnlocked()) {
                // Record read event and catchup with write events
                ilChangeEvent::_recordReadEvent(
                    $this->object->getType(),
                    $this->object->getRefId(),
                    $this->object->getId(),
                    $this->user->getId()
                );
                $this->updateLearningProgress();
 
                $this->object->sendFile($hist_entry_id);
            } else {
                $this->error->raiseError($this->lng->txt("permission_denied"), $this->error->MESSAGE);
            }
        } catch (FileNotFoundException $e) {
            $this->error->raiseError($e->getMessage(), $this->error->MESSAGE);
        }
 
        return true;
    }
 
    public function showSummary(): void
    {
        $this->ctrl->redirectToURL(
            (string) $this->capabilities->get(Capabilities::INFO_PAGE)->getUri()
        );
    }
    public function showSummaryForced(): void
    {
        $this->ctrl->redirectToURL(
            (string) $this->capabilities->get(Capabilities::FORCED_INFO_PAGE)->getUri()
        );
    }
 
    public function versions(): void
    {
        $this->ctrl->redirectToURL(
            (string) $this->capabilities->get(Capabilities::MANAGE_VERSIONS)->getUri()
        );
    }
 
    public function unzipCurrentRevision(): void
    {
        $this->ctrl->redirectToURL(
            (string) $this->capabilities->get(Capabilities::UNZIP)->getUri()
        );
    }
 
    protected function editExternal(): void
    {
        $this->ctrl->redirectToURL(
            (string) $this->capabilities->get(Capabilities::EDIT_EXTERNAL)->getUri()
        );
    }
    protected function viewExternal(): void
    {
        $this->ctrl->redirectToURL(
            (string) $this->capabilities->get(Capabilities::VIEW_EXTERNAL)->getUri()
        );
    }
 
    public function infoScreenForward(): void
    {
        $this->tabs_gui->activateTab("id_info");
 
        if (!$this->capabilities->get(Capabilities::INFO_PAGE)->isUnlocked()) {
            $GLOBALS['DIC']['ilErr']->raiseError(
                $this->lng->txt("msg_no_perm_read"),
                2
            ); // TODO remove magic number and old ilErr call
        }
 
        // add set completed button, if LP mode is active
        if ($this->object->getLPMode() === ilLPObjSettings::LP_MODE_MANUAL) {
            if (ilLPStatus::_hasUserCompleted($this->object->getId(), $this->user->getId())) {
                $label = $this->lng->txt('file_btn_lp_toggle_state_completed');
            } else {
                $label = $this->lng->txt('file_btn_lp_toggle_state_not_completed');
            }
            $this->toolbar->addComponent(
                $this->ui->factory()->button()->standard(
                    $label,
                    $this->ctrl->getLinkTarget($this, 'toggleLearningProgress')
                )
            );
        }
 
        // Add WOPI editor Button
        if ($this->capabilities->get(Capabilities::EDIT_EXTERNAL)->isUnlocked()) {
            $external_editor = $this->ui->factory()
                                        ->button()
                                        ->standard(
                                            $this->lng->txt('open_external_editor'),
                                            $this->ctrl->getLinkTargetByClass(
                                                \ilWOPIEmbeddedApplicationGUI::class,
                                                \ilWOPIEmbeddedApplicationGUI::CMD_EDIT
                                            )
                                        );
            $this->toolbar->addComponent($external_editor);
        }
 
        $info = $this->buildInfoScreen(false);
        $this->ctrl->forwardCommand($info);
    }
 
    protected function toggleLearningProgress(): void
    {
        ilLearningProgress::_tracProgress(
            $this->user->getId(),
            $this->obj_id,
            $this->ref_id,
            'file'
        );
 
        $lp_marks = new ilLPMarks($this->obj_id, $this->user->getId());
        $lp_marks->setCompleted(!ilLPStatus::_hasUserCompleted($this->object->getId(), $this->user->getId()));
        $lp_marks->update();
 
        ilLPStatusWrapper::_updateStatus($this->obj_id, $this->user->getId());
 
        $this->tpl->setOnScreenMessage('success', $this->lng->txt('msg_obj_modified'), true);
        $this->ctrl->redirect($this, Capabilities::INFO_PAGE->value);
    }
 
    public function buildInfoScreen(bool $kiosk_mode): ilInfoScreenGUI
    {
        $info = new ilInfoScreenGUI($this);
 
        if (!$kiosk_mode) { // in kiosk mode we don't want to show the following sections
            $info->enablePrivateNotes();
 
            if ($this->capabilities->get(Capabilities::DOWNLOAD)->isUnlocked()) {
                $info->enableNews();
            }
 
            // no news editing for files, just notifications
            $info->enableNewsEditing(false);
            if ($this->capabilities->get(Capabilities::MANAGE_VERSIONS)->isUnlocked()) {
                $news_set = new ilSetting("news");
                $enable_internal_rss = $news_set->get("enable_rss_for_internal");
 
                if ($enable_internal_rss) {
                    $info->setBlockProperty("news", "settings", true);
                    $info->setBlockProperty("news", "public_notifications_option", true);
                }
            }
 
            $obj_id = $this->object->getId();
            $record_gui = new ilAdvancedMDRecordGUI(
                ilAdvancedMDRecordGUI::MODE_INFO,
                'file',
                $obj_id,
                '',
                0,
                $this->call_by_reference
            );
            $record_gui->setInfoObject($info);
            $record_gui->parse();
        }
        // show rating is not possible in kiosk mode
 
        // Important Information
        $important_info = $this->object->getImportantInfo();
        if (!empty($important_info)) {
            $group = new Group(new Factory(), $this->lng);
            $markdown_to_html = $group->markdown()->toHTML();
 
            $info->addSection($this->lng->txt("important_info"));
            $info->addProperty("", $markdown_to_html->transform($important_info));
        }
 
        // Download Launcher
        if ($this->capabilities->get(Capabilities::DOWNLOAD)->isUnlocked()) {
            // get permanent download link for repository
            if ($this->id_type === self::REPOSITORY_NODE_ID) {
                $download_target = ilObjFileAccess::_getPermanentDownloadLink($this->node_id);
            } else {
                $download_target = rtrim(ILIAS_HTTP_PATH, '/') . '/' . $this->ctrl->getLinkTarget(
                    $this,
                    self::CMD_SEND_FILE
                );
            }
            $url = $this->data_factory->uri($download_target);
            $link = $this->data_factory->link($this->lng->txt('file_download'), $url);
            $download_launcher = $this->ui->factory()->launcher()->inline($link);
            // create own section for download launcher if there is no important info section
            if (empty($important_info)) {
                $info->addSection("");
            }
            // add download launcher
            $info->addProperty("", $this->renderer->render($download_launcher));
        }
 
        // standard meta data
        $info->addMetaDataSections($this->object->getId(), 0, $this->object->getType());
 
        // in kiosk mode we don't want to show the following sections
        // links to resource
        if (!$kiosk_mode && ($this->access->checkAccess("write", "", $this->ref_id) ||
            $this->access->checkAccess("edit_permissions", "", $this->ref_id))) {
            $rs = ilObject::_getAllReferences($this->obj_id);
            $refs = [];
            foreach ($rs as $r) {
                if ($this->tree->isInTree($r)) {
                    $refs[] = $r;
                }
            }
            if (count($refs) > 1) {
                $links = $sep = "";
                foreach ($refs as $r) {
                    $cont_loc = new ilLocatorGUI();
                    $cont_loc->addContextItems($r, true);
                    $links .= $sep . $cont_loc->getHTML();
                    $sep = "<br />";
                }
 
                $info->addProperty(
                    $this->lng->txt("res_links"),
                    '<div class="small">' . $links . '</div>'
                );
            }
        }
 
        // File Info
        $info->addSection($this->lng->txt("file_info"));
        if ($kiosk_mode) {
            $file_info_for_users = $this->getFileInfoForUsers();
            foreach ($file_info_for_users as $file_info_entry_key => $file_info_entry_value) {
                if ($file_info_entry_value !== null) {
                    $info->addProperty($file_info_entry_key, $file_info_entry_value);
                }
            }
        } else {
            $file_info = $this->getAllFileInfoForCurrentUser();
            foreach ($file_info as $file_info_block) {
                foreach ($file_info_block as $file_info_entry_key => $file_info_entry_value) {
                    if ($file_info_entry_value !== null) {
                        $info->addProperty($file_info_entry_key, $file_info_entry_value);
                    }
                }
            }
        }
 
        $info->hideFurtherSections(false);
 
        return $info;
    }
 
    // get tabs
    #[\Override]
    protected function setTabs(): void
    {
        global $DIC;
        $ilHelp = $DIC['ilHelp'];
        $ilHelp->setScreenIdComponent(ilObjFile::OBJECT_TYPE);
 
        $this->ctrl->setParameter($this, "ref_id", $this->node_id);
 
        if (($c = $this->capabilities->get(Capabilities::VIEW_EXTERNAL)) && $c->isUnlocked()) {
            $this->tabs_gui->addTab(
                "content",
                $this->lng->txt("content"),
                $c->getURI()
            );
        }
 
        if (($c = $this->capabilities->get(Capabilities::MANAGE_VERSIONS)) && $c->isUnlocked()) {
            $this->tabs_gui->addTab(
                "id_versions",
                $this->lng->txt(self::CMD_VERSIONS),
                $this->ctrl->getLinkTargetByClass(ilFileVersionsGUI::class, ilFileVersionsGUI::CMD_DEFAULT)
            );
        }
 
        if (($c = $this->capabilities->get(Capabilities::INFO_PAGE)) && $c->isUnlocked()) {
            $this->tabs_gui->addTab(
                "id_info",
                $this->lng->txt("info_short"),
                $this->ctrl->getLinkTargetByClass(["ilobjfilegui", "ilinfoscreengui"], "showSummary")
            );
        }
 
        if (($c = $this->capabilities->get(Capabilities::EDIT_SETTINGS)) && $c->isUnlocked()) {
            $this->tabs_gui->addTab(
                "settings",
                $this->lng->txt("settings"),
                $this->ctrl->getLinkTarget($this, self::CMD_EDIT)
            );
        }
 
        if (ilLearningProgressAccess::checkAccess($this->object->getRefId())) {
            $this->tabs_gui->addTab(
                'learning_progress',
                $this->lng->txt('learning_progress'),
                $this->ctrl->getLinkTargetByClass([self::class, 'illearningprogressgui'], '')
            );
        }
 
        // meta data
        if (($c = $this->capabilities->get(Capabilities::EDIT_SETTINGS)) && $c->isUnlocked()) {
            $mdgui = new ilObjectMetaDataGUI($this->object, null, null, $this->call_by_reference);
            $mdtab = $mdgui->getTab();
            if ($mdtab) {
                $this->tabs_gui->addTab(
                    "id_meta",
                    $this->lng->txt("meta_data"),
                    $mdtab
                );
            }
        }
 
        // export
        if (($c = $this->capabilities->get(Capabilities::EDIT_SETTINGS)) && $c->isUnlocked()) {
            $this->tabs_gui->addTab(
                "export",
                $this->lng->txt("export"),
                $this->ctrl->getLinkTargetByClass("ilexportgui", "")
            );
        }
 
        // will add permission tab if needed
        parent::setTabs();
    }
 
    protected function initSettingsTab(): void
    {
        $this->tabs_gui->activateTab("settings");
        // add subtab for common settings
        $this->tabs_gui->addSubTab(
            'file_settings',
            $this->lng->txt('settings'),
            $this->ctrl->getLinkTargetByClass(self::class, self::CMD_EDIT)
        );
        if (in_array('file', ilAdvancedMDRecord::_getActivatedObjTypes(), true)) {
            $this->tabs_gui->addSubTab(
                'service_settings',
                $this->lng->txt('service_settings'),
                $this->ctrl->getLinkTargetByClass(ilFileCommonSettingsGUI::class, ilFileCommonSettingsGUI::CMD_EDIT)
            );
        }
 
        $this->tabs_gui->activateSubTab("file_settings");
    }
 
    public static function _goto($a_target, $a_additional = null): void
    {
        global $DIC;
        $main_tpl = $DIC->ui()->mainTemplate();
        $ilErr = $DIC['ilErr'];
        $lng = $DIC['lng'];
        $ilAccess = $DIC['ilAccess'];
 
        if ($a_additional && str_ends_with((string) $a_additional, "wsp")) {
            ilObjectGUI::_gotoSharedWorkspaceNode((int) $a_target);
        }
 
        // added support for direct download goto links
        if ($a_additional && str_ends_with((string) $a_additional, "download")) {
            ilObjectGUI::_gotoRepositoryNode($a_target, "sendfile");
        }
 
        // static method, no workspace support yet
 
        if ($ilAccess->checkAccess("visible", "", $a_target)
            || $ilAccess->checkAccess("read", "", $a_target)) {
            ilObjectGUI::_gotoRepositoryNode($a_target, Capabilities::INFO_PAGE->value);
        } elseif ($ilAccess->checkAccess("read", "", ROOT_FOLDER_ID)) {
            $main_tpl->setOnScreenMessage(
                'failure',
                sprintf(
                    $lng->txt("msg_no_perm_read_item"),
                    ilObject::_lookupTitle(ilObject::_lookupObjId($a_target))
                ),
                true
            );
            ilObjectGUI::_gotoRepositoryRoot();
        }
 
        $ilErr->raiseError($lng->txt("msg_no_perm_read"), $ilErr->FATAL);
    }
 
    protected function addLocatorItems(): void
    {
        global $DIC;
        $ilLocator = $DIC['ilLocator'];
 
        if (is_object($this->object)) {
            $ilLocator->addItem($this->object->getTitle(), $this->ctrl->getLinkTarget($this, ""), "", $this->node_id);
        }
    }
 
    #[\Override]
    protected function initHeaderAction(?string $a_sub_type = null, ?int $a_sub_id = null): ?\ilObjectListGUI
    {
        $lg = parent::initHeaderAction($a_sub_type, $a_sub_id);
        if ($lg instanceof ilObjectListGUI && $this->object->hasRating()) {
            $lg->enableRating(
                true,
                null,
                false,
                [ilCommonActionDispatcherGUI::class, ilRatingGUI::class]
            );
        }
 
        return $lg;
    }
 
    protected function getCtrl(): \ilCtrl
    {
        return $this->ctrl;
    }
 
    protected function getFileObj(): ilObjFile
    {
        if (!$this->object instanceof ilObjFile) {
            throw new ilFileException("Error: object is not of type ilObjFile or doesn't exist");
        }
 
        return $this->object;
    }
 
    protected function getFileStakeholder(): ilObjFileStakeholder
    {
        return $this->stakeholder;
    }
 
    protected function getGeneralSettings(): General
    {
        return $this->general_settings;
    }
 
    protected function getLanguage(): \ilLanguage
    {
        return $this->lng;
    }
 
    protected function getNodeID(): int
    {
        return $this->node_id;
    }
 
    protected function getRefinery(): \ILIAS\Refinery\Factory
    {
        return $this->refinery;
    }
 
    protected function getUIFactory(): ILIAS\UI\Factory
    {
        return $this->ui->factory();
    }
 
    protected function getUser(): ilObjUser
    {
        return $this->user;
    }
}