Inheritance diagram for ilObjFilePreviewRendererGUI:

Collaboration diagram for ilObjFilePreviewRendererGUI:

Public Member Functions
	__construct (private readonly ?int $object_id=null)

	has ()

	getTriggerComponents (bool $as_button=false)

	getRenderedTriggerComponents (bool $as_button=false)

	executeCommand ()

Data Fields
const	P_RID = "rid"

const	CMD_GET_ASYNC_MODAL = 'getAsyncModal'

Protected Member Functions
	resolveRidString (?int $object_id)

	isAccessGranted ()

Private Member Functions
	getAsyncModal ()

Private Attributes
ilDBInterface	$db
	@readonly More...

Factory	$ui_factory
	@readonly More...

Renderer	$ui_renderer
	@readonly More...

ilCtrlInterface	$ctrl
	@readonly More...

ResourceIdentification	$rid = null

Services	$irss
	@readonly More...

ILIAS HTTP Services	$http
	@readonly More...

WrapperFactory	$http_wrapper
	@readonly More...

ILIAS Refinery Factory	$refinery
	@readonly More...

FlavourDefinition	$flavour_definition
	@readonly More...

ilAccessHandler	$access
	@readonly More...

ilLanguage	$language
	@readonly More...

int	$preview_size
	@readonly More...

int	$pages_to_extract
	@readonly More...

bool	$activated = false

string	$file_name = ''

FlavourDefinition	$fallback_flavour_definition
	@readonly More...

Detailed Description

Author: Fabian Schmid fabia.nosp@m.n@sr.nosp@m..solu.nosp@m.tion.nosp@m.s

Definition at line 34 of file class.ilObjFilePreviewRendererGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilObjFilePreviewRendererGUI::__construct ( private readonly ?int $object_id = null )

Definition at line 99 of file class.ilObjFilePreviewRendererGUI.php.

      {
        global $DIC;
 
        $settings = (new SettingsFactory())->getSettings();
        $this->activated = $settings->isPreviewEnabled();
 
        $this->db = $DIC->database();
        $this->ctrl = $DIC->ctrl();
 
        $this->ui_factory = $DIC->ui()->factory();
        $this->ui_renderer = $DIC->ui()->renderer();
        $this->irss = $DIC->resourceStorage();
        $this->http = $DIC->http();
        $this->http_wrapper = $DIC->http()->wrapper();
        $this->refinery = $DIC->refinery();
        $this->access = $DIC->access();
        $this->language = $DIC->language();
        $this->language->loadLanguageModule('file');
 
        $rid_string = $this->resolveRidString($this->object_id);
 
        $this->rid = $this->irss->manage()->find($rid_string);
        $this->flavour_definition = new PagesToExtract(
            $settings->isPersisting(),
            $settings->getImageSize(),
            $settings->getMaximumPreviews()
        );
        $this->fallback_flavour_definition = new FitToSquare(
            $settings->isPersisting(),
            $settings->getImageSize()
        );
        // Resolve File Name
        if ($this->rid !== null) {
            $this->file_name = $this->irss->manage()->getCurrentRevision($this->rid)->getTitle();
        }
    }

References $DIC, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ILIAS\FileDelivery\http(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), ILIAS\Repository\refinery(), and resolveRidString().

Here is the call graph for this function:

Member Function Documentation

◆ executeCommand()

ilObjFilePreviewRendererGUI::executeCommand ( )

Definition at line 197 of file class.ilObjFilePreviewRendererGUI.php.

                                    : void
    {
        $cmd = $this->ctrl->getCmd();
        match ($cmd) {
            self::CMD_GET_ASYNC_MODAL => $this->{$cmd}(),
            default => throw new InvalidArgumentException('Command not found: ' . $cmd),
        };
    }

References ILIAS\Repository\ctrl().

Here is the call graph for this function:

◆ getAsyncModal()

ilObjFilePreviewRendererGUI::getAsyncModal ( )

private

Definition at line 248 of file class.ilObjFilePreviewRendererGUI.php.

                                    : void
    {
        if (!$this->isAccessGranted()) {
            throw new LogicException('User cannot see this resource');
        }
 
        // Resolve Flavour for Definition
        $flavour = $this->irss->flavours()->get($this->rid, $this->flavour_definition);
        $flavour_urls = $this->irss->consume()->flavourUrls($flavour)->getURLsAsArray();
        if ($flavour_urls === []) { // Try Fallback
            $flavour = $this->irss->flavours()->get($this->rid, $this->fallback_flavour_definition);
            $flavour_urls = $this->irss->consume()->flavourUrls($flavour)->getURLsAsArray();
        }
 
        $page_title = function (?int $index): string {
            $index_string = $index !== null ? (($index + 1) . ' ') : '';
            return sprintf(
                $this->language->txt('preview_caption'),
                $index_string,
                $this->file_name
            );
        };
 
        // Build Pages for Lightbox
        $pages = array_map(function (string $url, $i) use ($page_title): LightboxImagePage {
            $title = $page_title($i);
            return $this->ui_factory->modal()->lightboxImagePage(
                $this->ui_factory->image()->responsive(
                    $url,
                    $title
                ),
                $title
            );
        }, $flavour_urls, count($flavour_urls) > 1 ? array_keys($flavour_urls) : []);
 
        // Fallback to a TextPage if no Flavour Images were found
        if ($pages === []) {
            $pages = $this->ui_factory->modal()->lightboxTextPage(
                sprintf(
                    $this->language->txt('preview_not_possible'),
                    'components/ILIAS/File/classes/Preview/README.md'
                ),
                $this->language->txt('preview')
            );
        }
        $modal = $this->ui_factory->modal()->lightbox($pages);
 
        // Send response and end script
        $response = $this->http->response()->withBody(Streams::ofString($this->ui_renderer->renderAsync($modal)));
        $this->http->saveResponse($response);
        $this->http->sendResponse();
    }

References $response, $url, ILIAS\FileDelivery\http(), isAccessGranted(), and ILIAS\UI\examples\Symbol\Glyph\Language\language().

Here is the call graph for this function:

◆ getRenderedTriggerComponents()

ilObjFilePreviewRendererGUI::getRenderedTriggerComponents ( bool $as_button = false )

Definition at line 192 of file class.ilObjFilePreviewRendererGUI.php.

                                                                         : string
    {
        return $this->ui_renderer->render($this->getTriggerComponents($as_button));
    }

References getTriggerComponents().

Here is the call graph for this function:

◆ getTriggerComponents()

ilObjFilePreviewRendererGUI::getTriggerComponents ( bool $as_button = false )

Definition at line 161 of file class.ilObjFilePreviewRendererGUI.php.

                                                                 : array
    {
        if (!$this->isAccessGranted()) {
            throw new LogicException('User cannot see this resource');
        }
 
        $this->ctrl->setParameterByClass(self::class, self::P_RID, $this->rid->serialize());
 
        $modal = $this->ui_factory->modal()
                                  ->lightbox([])
                                  ->withAsyncRenderUrl(
                                      $this->ctrl->getLinkTargetByClass(self::class, self::CMD_GET_ASYNC_MODAL)
                                  );
 
        if (!$as_button) {
            $trigger = $this->ui_factory->symbol()->glyph()->preview(
                "#"
            )->withOnClick($modal->getShowSignal());
        } else {
            $trigger = $this->ui_factory->button()->standard(
                $this->language->txt('show_preview'),
                "#"
            )->withOnClick($modal->getShowSignal());
        }
 
        return [
            $modal,
            $trigger
        ];
    }

References ILIAS\Repository\ctrl(), isAccessGranted(), and ILIAS\UI\examples\Symbol\Glyph\Language\language().

Referenced by getRenderedTriggerComponents().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ has()

ilObjFilePreviewRendererGUI::has ( )

Definition at line 138 of file class.ilObjFilePreviewRendererGUI.php.

                         : bool
    {
        if (!$this->activated) {
            return false;
        }
        if ($this->rid === null) {
            return false;
        }
        if (
            !$this->irss->flavours()->possible(
                $this->rid,
                $this->flavour_definition
            )
            && !$this->irss->flavours()->possible(
                $this->rid,
                $this->fallback_flavour_definition
            )
        ) {
            return false;
        }
        return $this->isAccessGranted();
    }

References isAccessGranted().

Here is the call graph for this function:

◆ isAccessGranted()

ilObjFilePreviewRendererGUI::isAccessGranted ( )

protected

Definition at line 227 of file class.ilObjFilePreviewRendererGUI.php.

                                        : bool
    {
        // if object_id is set, we can check the access using it's ref_ids
        if ($this->object_id !== null) {
            foreach (ilObject::_getAllReferences($this->object_id) as $ref_id) {
                if ($this->access->checkAccess('read', '', $ref_id)) {
                    return true;
                }
            }
            return false;
        }
        // else we ask the stakeholders if they allow access
        $resource = $this->irss->manage()->getResource($this->rid);
        foreach ($resource->getStakeholders() as $stakeholder) {
            if ($stakeholder->canBeAccessedByCurrentUser($this->rid)) {
                return true;
            }
        }
        return false;
    }

References $ref_id, ilObject\_getAllReferences(), and ILIAS\Repository\access().

Referenced by getAsyncModal(), getTriggerComponents(), and has().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resolveRidString()

ilObjFilePreviewRendererGUI::resolveRidString ( ?int $object_id )

protected

Returns: mixed

Definition at line 209 of file class.ilObjFilePreviewRendererGUI.php.

                                                        : string
    {
        if ($object_id !== null) {
            return $this->db->fetchObject(
                $this->db->queryF(
                    'SELECT rid FROM file_data WHERE file_id = %s',
                    ['integer'],
                    [$object_id]
                )
            )->rid ?? '';
        }
        return $this->http_wrapper->query()->has(self::P_RID)
            ? $this->http_wrapper->query()->retrieve(
                self::P_RID,
                $this->refinery->to()->string()
            ) : '';
    }