LSControlBuilder.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
use ILIAS\KioskMode\ControlBuilder;
use ILIAS\KioskMode\LocatorBuilder;
use ILIAS\KioskMode\TOCBuilder;
use ILIAS\KioskMode\URLBuilder;
 
use ILIAS\UI\Factory;
use ILIAS\UI\Component\Signal;
 
class LSControlBuilder implements ControlBuilder
{
    const CMD_START_OBJECT = 'start_legacy_obj';
    const CMD_CHECK_CURRENT_ITEM_LP = 'ccilp';
 
    protected $exit_control;
 
    protected $previous_control;
 
    protected $next_control;
 
    protected $done_control;
 
    protected $controls = [];
 
    protected $toggles = [];
 
    protected $mode_controls = [];
 
    protected $toc;
 
    protected $loc;
 
    protected $ui_factory;
 
    protected $url_builder;
 
    protected $start;
 
    protected $additional_js;
 
    protected $global_settings;
 
    public function __construct(
        Factory $ui_factory,
        LSURLBuilder $url_builder,
        ilLanguage $language,
        LSGlobalSettings $global_settings
    ) {
        $this->ui_factory = $ui_factory;
        $this->url_builder = $url_builder;
        $this->lng = $language;
        $this->global_settings = $global_settings;
    }
 
    public function getExitControl()
    {
        return $this->exit_control;
    }
 
    public function getPreviousControl()
    {
        return $this->previous_control;
    }
 
    public function getNextControl()
    {
        return $this->next_control;
    }
 
    public function getDoneControl()
    {
        return $this->done_control;
    }
 
    public function getToggles()
    {
        return $this->toggles;
    }
 
    public function getModeControls()
    {
        return $this->mode_controls;
    }
 
    public function getControls() : array
    {
        return $this->controls;
    }
 
    public function getLocator()
    {
        return $this->loc;
    }
 
    public function getToc()
    {
        return $this->toc;
    }
 
    public function exit(string $command) : ControlBuilder
    {
        if ($this->exit_control) {
            throw new \LogicException("Only one exit-control per view...", 1);
        }
        $cmd = $this->url_builder->getHref($command);
 
        $label = 'lso_player_suspend';
        if ($command === ilLSPlayer::LSO_CMD_FINISH) {
            $label = 'lso_player_finish';
        }
 
        $exit_button = $this->ui_factory->button()->bulky(
            $this->ui_factory->symbol()->glyph()->close(),
            $this->lng->txt($label),
            $cmd
        );
 
        $this->exit_control = $exit_button;
        return $this;
    }
 
    public function next(string $command, int $parameter = null) : ControlBuilder
    {
        if ($this->next_control) {
            throw new \LogicException("Only one next-control per view...", 1);
        }
        $label = $this->lng->txt('lso_player_next');
        $cmd = $this->url_builder->getHref($command, $parameter);
        $btn = $this->ui_factory->button()->standard($label, $cmd);
        if ($command === '') {
            $btn = $btn->withUnavailableAction();
        }
        $this->next_control = $btn;
        return $this;
    }
 
    public function previous(string $command, int $parameter = null) : ControlBuilder
    {
        if ($this->previous_control) {
            throw new \LogicException("Only one previous-control per view...", 1);
        }
        $label = $this->lng->txt('lso_player_previous');
        $cmd = $this->url_builder->getHref($command, $parameter);
        $btn = $this->ui_factory->button()->standard($label, $cmd);
        if ($command === '') {
            $btn = $btn->withUnavailableAction();
        }
        $this->previous_control = $btn;
        return $this;
    }
 
    public function done(string $command, int $parameter = null) : ControlBuilder
    {
        if ($this->done_control) {
            throw new \LogicException("Only one done-control per view...", 1);
        }
        $label = $this->lng->txt('lso_player_done');
        $cmd = $this->url_builder->getHref($command, $parameter);
        $btn = $this->ui_factory->button()->primary($label, $cmd);
        $this->done_control = $btn;
        return $this;
    }
 
    public function generic(string $label, string $command, int $parameter = null) : ControlBuilder
    {
        $cmd = $this->url_builder->getHref($command, $parameter);
        $this->controls[] = $this->ui_factory->button()->standard($label, $cmd);
        return $this;
    }
 
    public function genericWithSignal(string $label, Signal $signal) : ControlBuilder
    {
        $this->controls[] = $this->ui_factory->button()->standard($label, '')
            ->withOnClick($signal);
        return $this;
    }
 
    public function toggle(string $label, string $on_command, string $off_command) : ControlBuilder
    {
        throw new \Exception("NYI: Toggles", 1);
 
        $cmd_on = $this->url_builder->getHref($on_command, 0);
        $cmd_off = $this->url_builder->getHref($off_command, 0);
        //build toggle and add to $this->toggles
        //return $this;
    }
 
    public function mode(string $command, array $labels) : ControlBuilder
    {
        $actions = [];
        foreach ($labels as $parameter => $label) {
            $actions[$label] = $this->url_builder->getHref($command, $parameter);
        }
        $this->mode_controls[] = $this->ui_factory->viewControl()->mode($actions, '');
        return $this;
    }
 
    public function locator(string $command) : LocatorBuilder
    {
        if ($this->loc) {
            throw new \LogicException("Only one locator per view...", 1);
        }
        $this->loc = new LSLocatorBuilder($command, $this);
        return $this->loc;
    }
 
    public function tableOfContent(
        string $label,
        string $command,
        int $parameter = null,
        $state = null
    ) : TOCBuilder {
        if ($this->toc) {
            throw new \LogicException("Only one ToC per view...", 1);
        }
        $this->toc = new LSTOCBuilder($this, $command, $label, $parameter, $state);
        return $this->toc;
    }
 
    public function start(string $label, string $url, int $parameter = null) : ControlBuilder
    {
        if ($this->start) {
            throw new \LogicException("Only one start-control per view...", 1);
        }
        $this_cmd = $this->url_builder->getHref(self::CMD_START_OBJECT, $parameter);
        $lp_cmd = str_replace(
            '&cmd=view&',
            '&cmd=' . self::CMD_CHECK_CURRENT_ITEM_LP . '&',
            $this_cmd
        );
 
        $this->setListenerJS($lp_cmd, $this_cmd);
        $this->start = $this->ui_factory->button()
            ->primary($label, '')
            ->withOnLoadCode(function ($id) use ($url) {
                $interval = $this->global_settings->getPollingIntervalMilliseconds();
                return "$('#{$id}').on('click', function(ev) {
                                        var il_ls_win = window.open('$url');
                                        window._lso_current_item_lp = -1;
                                        window.setInterval(lso_checkLPOfObject, $interval);
                                })";
            });
 
        return $this;
    }
 
    public function getStartControl()
    {
        return $this->start;
    }
 
    public function getAdditionalJS() : string
    {
        return $this->additional_js;
    }
 
    protected function setListenerJS(
        string $check_lp_url,
        string $on_lp_change_url
    ) {
        $this->additional_js =
<<<JS
function lso_checkLPOfObject()
{
    if(! il.UICore.isPageVisible()) {
        return;
    }
 
        $.ajax({
                url: "$check_lp_url",
        }).done(function(data) {
                if(window._lso_current_item_lp === -1) {
                        window._lso_current_item_lp = data;
                }
                if (window._lso_current_item_lp !== data) {
                        location.replace('$on_lp_change_url');
                }
        });
}
JS;
    }
}