ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI Class Reference

Collaboration diagram for ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI:

Public Member Functions
	__construct (protected Container $dic)
	getNotificationItem (int $nr_buckets)
	Get the Notification Items. More...
	getItemForObserver (Bucket $observer)

Protected Member Functions
	getAggregateItems ()

Private Member Functions
	getDefaultCardContent (Bucket $observer)
	getProgressbar (Bucket $observer)
	getCloseButtonAction (Option $option, string $redirect_uri, Bucket $observer)
	getRefreshUrl (Bucket $observer)
	addFromUrlToNextRequest (string $redirect_uri)
	txt (string $id)

Detailed Description

Author

Oskar Truffer ot@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Definition at line 37 of file PopOverGUI.php.

Constructor & Destructor Documentation

__construct()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::__construct

(

protected Container

$dic

)

Definition at line 42 of file PopOverGUI.php.

    {
    }

Member Function Documentation

addFromUrlToNextRequest()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::addFromUrlToNextRequest ( string  $redirect_uri )

private

Definition at line 260 of file PopOverGUI.php.

                                                                  : void
    {
        $this->dic->ctrl()->setParameterByClass(ControllerGUI::class, ControllerGUI::FROM_URL, ControllerGUI::hash($redirect_uri));
    }

References ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\FROM_URL, and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\hash().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getCloseButtonAction().

Here is the call graph for this function:

Here is the caller graph for this function:

getAggregateItems()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::getAggregateItems ( )

protected

Returns

Notification[]

Definition at line 68 of file PopOverGUI.php.

                                          : array
    {
        $persistence = $this->dic->backgroundTasks()->persistence();
        $items = [];
        $observer_ids = $persistence->getBucketIdsOfUser($this->dic->user()->getId(), 'id', 'DESC');
        foreach ($persistence->loadBuckets($observer_ids) as $observer) {
            $items[] = $this->getItemForObserver($observer);
        }
 
        return $items;
    }

References ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getItemForObserver().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getNotificationItem().

Here is the call graph for this function:

Here is the caller graph for this function:

getCloseButtonAction()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::getCloseButtonAction ( Option  $option, string  $redirect_uri, Bucket  $observer  )

private

Definition at line 225 of file PopOverGUI.php.

                                                                                                 : string
    {
        $ctrl = $this->dic->ctrl();
        $persistence = $this->dic->backgroundTasks()->persistence();
        $ctrl->setParameterByClass(ControllerGUI::class, ControllerGUI::OBSERVER_ID, $persistence->getBucketContainerId($observer));
        $this->addFromUrlToNextRequest($redirect_uri);
        $ctrl->setParameterByClass(ControllerGUI::class, ControllerGUI::IS_ASYNC, "true");
 
        switch ($option->getValue()) {
            case AbstractTask::MAIN_ABORT:
                $action = $ctrl->getLinkTargetByClass([ControllerGUI::class], ControllerGUI::CMD_ABORT);
                break;
            case AbstractTask::MAIN_REMOVE:
                $action = $ctrl->getLinkTargetByClass([ControllerGUI::class], ControllerGUI::CMD_REMOVE);
                break;
            default:
                $ctrl->setParameterByClass(ControllerGUI::class, ControllerGUI::SELECTED_OPTION, $option->getValue());
                $action = $ctrl->getLinkTargetByClass([ControllerGUI::class], ControllerGUI::CMD_USER_INTERACTION);
                break;
        }
 
        return $action;
    }

References ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\addFromUrlToNextRequest(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_ABORT, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_REMOVE, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_USER_INTERACTION, ILIAS\BackgroundTasks\Task\UserInteraction\Option\getValue(), ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\IS_ASYNC, ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask\MAIN_ABORT, ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask\MAIN_REMOVE, ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\OBSERVER_ID, and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\SELECTED_OPTION.

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getItemForObserver().

Here is the call graph for this function:

Here is the caller graph for this function:

getDefaultCardContent()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::getDefaultCardContent ( Bucket  $observer )

private

Definition at line 144 of file PopOverGUI.php.

                                                            : Content
    {
        return $this->getProgressbar($observer);
    }

References ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getProgressbar().

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getItemForObserver().

Here is the call graph for this function:

Here is the caller graph for this function:

getItemForObserver()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::getItemForObserver

(

Bucket

$observer

)

Definition at line 81 of file PopOverGUI.php.

                                                        : Notification
    {
        $redirect_uri = "//{$_SERVER['HTTP_HOST']}{$_SERVER['REQUEST_URI']}";
 
        $f = $this->dic->ui()->factory();
 
        $state = $observer->getState();
        $current_task = $observer->getCurrentTask();
 
        $icon = $f->symbol()->icon()->standard("bgtk", $this->txt("bg_task"));
        $title = $observer->getTitle() . ($state === State::SCHEDULED ? " ({$this->txt('scheduled')})" : "");
 
        if ($state === State::USER_INTERACTION) {
            $actions = $this->getUserInteractionContent($observer, $redirect_uri);
            $primary_action = array_pop($actions);
            if ($primary_action instanceof Button) {
                $title = $primary_action->withLabel($title);
            }
            $item = $f->item()->notification($title, $icon);
 
            //            $item = $item->withProperties([
            //                $this->dic->language()->txt('nc_mail_prop_time') => \ilDatePresentation::formatDate(
            //                    new \ilDateTime(time(), IL_CAL_UNIX)
            //                )
            //            ]);
 
            $item = $item->withActions($f->dropdown()->standard($actions));
            $input = $current_task->getInput();
            $message = $current_task->getMessage($input);
 
            if (!empty($message) && $message != null) {
                $item = $item->withDescription($message);
            } else {
                $item = $item->withAdditionalContent($this->getProgressbar($observer));
            }
 
            return $item->withCloseAction(
                $this->getCloseButtonAction($current_task->getRemoveOption(), $redirect_uri, $observer)
            );
        }
 
        $item = $f->item()->notification($title, $icon);
 
        if ($state === State::RUNNING) {
            $url = $this->getRefreshUrl($observer);
            //Running Items probably need to refresh themselves, right?
            $item = $item->withAdditionalOnLoadCode(fn($id): string => "var notification_item = il.UI.item.notification.getNotificationItemObject($('#$id'));
                    il.BGTask.refreshItem(notification_item,'$url');");
 
            $expected = $current_task instanceof Job ? $current_task->getExpectedTimeOfTaskInSeconds() : 0;
            $possibly_failed = ($observer->getLastHeartbeat() < (time() - $expected));
            if ($possibly_failed) {
                $item = $item->withDescription($this->txt('task_might_be_failed'));
                $item = $item->withCloseAction(
                    $this->getCloseButtonAction($current_task->getAbortOption(), $redirect_uri, $observer)
                );
            }
        }
 
        return $item->withAdditionalContent($this->getDefaultCardContent($observer));
    }

References Vendor\Package\$f, $id, $message, ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getCloseButtonAction(), ILIAS\BackgroundTasks\Bucket\getCurrentTask(), ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getDefaultCardContent(), ILIAS\BackgroundTasks\Task\Job\getExpectedTimeOfTaskInSeconds(), ILIAS\BackgroundTasks\Bucket\getLastHeartbeat(), ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getProgressbar(), ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getRefreshUrl(), ILIAS\BackgroundTasks\Bucket\getState(), ILIAS\BackgroundTasks\Bucket\getTitle(), ILIAS\BackgroundTasks\Implementation\Bucket\State\RUNNING, ILIAS\BackgroundTasks\Implementation\Bucket\State\SCHEDULED, ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\txt(), and ILIAS\BackgroundTasks\Implementation\Bucket\State\USER_INTERACTION.

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getAggregateItems().

Here is the call graph for this function:

Here is the caller graph for this function:

getNotificationItem()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::getNotificationItem

(

int

$nr_buckets

)

Get the Notification Items.

DOES NOT DO ANY PERMISSION CHECKS.

Definition at line 50 of file PopOverGUI.php.

                                                        : Notification
    {
        $ui_factory = $this->dic->ui()->factory();
 
        $title = $ui_factory->link()->standard($this->txt('background_tasks'), '#');
        $icon = $ui_factory->symbol()->icon()->standard('bgtk', $this->txt('background_tasks'));
 
        return $this->dic->ui()->factory()
            ->item()
            ->notification($title, $icon)
            ->withDescription("$nr_buckets {$this->txt('background_tasks')}")
            ->withAggregateNotifications($this->getAggregateItems());
    }

References ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getAggregateItems(), ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\txt(), and ILIAS\UI\Component\Item\Item\withDescription().

Here is the call graph for this function:

getProgressbar()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::getProgressbar ( Bucket  $observer )

private

Definition at line 197 of file PopOverGUI.php.

                                                     : Content
    {
        $percentage = $observer->getOverallPercentage();
 
        switch (true) {
            case ($percentage === 100):
                $running = "";
                $content = $this->dic->language()->txt("completed");
                break;
            case ($observer->getState() === State::USER_INTERACTION):
                $running = "";
                $content = $this->dic->language()->txt("waiting");
                break;
            default:
                $running = "active";
                $content = "{$percentage}%";
                break;
        }
 
        return $this->dic->ui()->factory()->legacy()->content(" <div class='progress'>
                    <div class='progress-bar progress-bar-striped {$running}' role='progressbar' aria-valuenow='{$percentage}'
                        aria-valuemin='0' aria-valuemax='100' style='width:{$percentage}%'>
                        {$content}
                    </div>
                                </div> ");
    }

References ILIAS\BackgroundTasks\Bucket\getOverallPercentage(), ILIAS\BackgroundTasks\Bucket\getState(), and ILIAS\BackgroundTasks\Implementation\Bucket\State\USER_INTERACTION.

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getDefaultCardContent(), and ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getItemForObserver().

Here is the call graph for this function:

Here is the caller graph for this function:

getRefreshUrl()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::getRefreshUrl ( Bucket  $observer )

private

Definition at line 250 of file PopOverGUI.php.

                                                    : string
    {
        $ctrl = $this->dic->ctrl();
        $persistence = $this->dic->backgroundTasks()->persistence();
        $ctrl->setParameterByClass(ControllerGUI::class, ControllerGUI::OBSERVER_ID, $persistence->getBucketContainerId($observer));
 
        return $ctrl->getLinkTargetByClass([ControllerGUI::class], ControllerGUI::CMD_GET_REPLACEMENT_ITEM);
    }

References ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\CMD_GET_REPLACEMENT_ITEM, and ILIAS\BackgroundTasks\Implementation\UI\ControllerGUI\OBSERVER_ID.

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getItemForObserver().

Here is the caller graph for this function:

txt()

ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI::txt ( string  $id )

private

Definition at line 266 of file PopOverGUI.php.

                                    : string
    {
        return $this->dic->language()->txt($id);
    }

References $id.

Referenced by ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getItemForObserver(), and ILIAS\BackgroundTasks\Implementation\UI\PopOverGUI\getNotificationItem().

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• components/ILIAS/BackgroundTasks/src/Implementation/UI/PopOverGUI.php