Collaboration diagram for ilMMTopItemFormGUI:

Public Member Functions
	__construct (ilCtrl $ctrl, Factory $ui_fa, Renderer $ui_re, ilLanguage $lng, Services $http, ilMMItemFacadeInterface $item, ilMMItemRepository $repository)

	save ()

	getHTML ()

Data Fields
const	F_ACTIVE = 'active'
	ilMMTopItemFormGUI constructor. More...

const	F_TITLE = 'title'

const	F_TYPE = 'type'

const	F_ROLE_BASED_VISIBILITY = "role_based_visibility"

Protected Attributes
ilLanguage	$lng

ilCtrl	$ctrl

ILIAS UI Factory	$ui_fa

ILIAS UI Renderer	$ui_re

Private Member Functions
	initForm ()

	getTypeGroups (Closure $f, bool $new)

Private Attributes
const	F_ICON = 'icon'

Services	$http

ilMMItemRepository	$repository

Standard	$form

ilMMItemFacadeInterface	$item_facade

ilObjMainMenuAccess	$access

Detailed Description

Class ilMMTopItemFormGUI.

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

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

Constructor & Destructor Documentation

◆ __construct()

ilMMTopItemFormGUI::__construct	(	ilCtrl	$ctrl,
		Factory	$ui_fa,
		Renderer	$ui_re,
		ilLanguage	$lng,
		Services	$http,
		ilMMItemFacadeInterface	$item,
		ilMMItemRepository	$repository
	)

Definition at line 68 of file class.ilMMTopItemFormGUI.php.

      {
        $this->repository = $repository;
        $this->http = $http;
        $this->ctrl = $ctrl;
        $this->ui_fa = $ui_fa;
        $this->ui_re = $ui_re;
        $this->lng = $lng;
        $this->item_facade = $item;
        $this->access = new ilObjMainMenuAccess();
        if (!$this->item_facade->isEmpty()) {
            $this->ctrl->saveParameterByClass(ilMMTopItemGUI::class, ilMMAbstractItemGUI::IDENTIFIER);
        }
 
        $this->initForm();
    }

References $ctrl, $http, $lng, $repository, $ui_fa, $ui_re, ILIAS\Repository\access(), ILIAS\Repository\ctrl(), ILIAS\FileDelivery\http(), ilMMAbstractItemGUI\IDENTIFIER, initForm(), ILIAS\Repository\lng(), and ILIAS\UI\examples\Deck\repository().

Here is the call graph for this function:

Member Function Documentation

◆ getHTML()

ilMMTopItemFormGUI::getHTML ( )

Returns: string

Definition at line 231 of file class.ilMMTopItemFormGUI.php.

                             : string
    {
        return $this->ui_re->render([$this->form]);
    }

References ILIAS\Repository\form().

Here is the call graph for this function:

◆ getTypeGroups()

ilMMTopItemFormGUI::getTypeGroups	(	Closure	$f,
		bool	$new
	)

private

Parameters

Closure $f

Returns: array

Definition at line 240 of file class.ilMMTopItemFormGUI.php.

                                                         : array
    {
        $type_groups = [];
        $type_informations = $this->repository->getPossibleTopItemTypesWithInformation($new);
        foreach ($type_informations as $classname => $information) {
            if ($this->item_facade->isEmpty()
                || (!$this->item_facade->isEmpty() && $classname === $this->item_facade->getType() && $this->item_facade->isCustom())
            ) { // https://mantis.ilias.de/view.php?id=24152
                $inputs = $this->repository->getTypeHandlerForType($classname)->getAdditionalFieldsForSubForm($this->item_facade->identification());
                $type_groups[$this->hash($classname)] = $f()->field()->group(
                    $inputs,
                    $information->getTypeNameForPresentation()
                );
            }
        }
 
        return $type_groups;
    }

References Vendor\Package\$f, ILIAS\UI\Implementation\Component\Input\$inputs, and ILIAS\UI\examples\Deck\repository().

Referenced by initForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initForm()

ilMMTopItemFormGUI::initForm ( )

private

Definition at line 92 of file class.ilMMTopItemFormGUI.php.

                               : void
    {
        $txt = function ($key) {
            return $this->lng->txt($key);
        };
        $f = function (): InputFactory {
            return $this->ui_fa->input();
        };
 
        // TITLE
        $title = $f()->field()->text($txt('topitem_title_default'), $txt('topitem_title_default_byline'))
                     ->withRequired(true);
        if (!$this->item_facade->isEmpty()) {
            $title = $title->withValue($this->item_facade->getDefaultTitle());
        }
 
        $items[self::F_TITLE] = $title;
 
        if ($this->item_facade->supportsCustomIcon()) {
            // ICON
            $icon = $f()->field()->file(new ilMMUploadHandlerGUI(), $txt('topitem_icon'))
                        ->withByline($txt('topitem_icon_byline'))
                        ->withAcceptedMimeTypes([MimeType::IMAGE__SVG_XML]);
            if ($this->item_facade->getIconID() !== null) {
                $icon = $icon->withValue([$this->item_facade->getIconID()]);
            }
 
            $items[self::F_ICON] = $icon;
        }
 
        // TYPE
        if (($this->item_facade->isEmpty() || $this->item_facade->isCustom())) {
            $type_groups = $this->getTypeGroups($f, $this->item_facade->isEmpty());
            $type = $f()->field()->switchableGroup(
                $type_groups,
                $txt('topitem_type'),
                $txt('topitem_type_byline')
            )->withRequired(true);
            if (!$this->item_facade->isEmpty()) {
                $string = $this->item_facade->getType() === '' ? TopParentItem::class : $this->item_facade->getType();
                $type = $type->withValue($this->hash($string));
            } else {
                $type = $type->withValue($this->hash(TopParentItem::class));
            }
            $items[self::F_TYPE] = $type;
        }
 
        // ACTIVE
        $active = $f()->field()->checkbox($txt('topitem_active'), $txt('topitem_active_byline'));
        $active = $active->withValue($this->item_facade->isActivated());
        $items[self::F_ACTIVE] = $active;
 
        // ROLE BASED VISIBILITY
        if ($this->item_facade->supportsRoleBasedVisibility()) {
            $value_role_based_visibility = null;
            $global_roles = $this->access->getGlobalRoles();
            $global_role_ids = $this->item_facade->getGlobalRoleIDs();
            if ($this->item_facade->hasRoleBasedVisibility() && !empty($global_role_ids)) {
                // remove deleted roles, see https://mantis.ilias.de/view.php?id=34936
                $value_role_based_visibility[0] = array_intersect(
                    $global_role_ids,
                    array_keys($global_roles)
                );
            }
            $role_based_visibility = $f()->field()->optionalGroup(
                [
                    $f()->field()->multiSelect(
                        $txt('sub_global_roles'),
                        $global_roles
                    )->withRequired(false)
                ],
                $txt('sub_role_based_visibility'),
                $txt('sub_role_based_visibility_byline')
            )->withValue($value_role_based_visibility);
            $items[self::F_ROLE_BASED_VISIBILITY] = $role_based_visibility;
        }
 
        // RETURN FORM
        if ($this->item_facade->isEmpty()) {
            $section = $f()->field()->section($items, $txt(ilMMTopItemGUI::CMD_ADD), "");
            $this->form = $f()->container()->form()->standard($this->ctrl->getLinkTargetByClass(
                ilMMTopItemGUI::class,
                ilMMTopItemGUI::CMD_CREATE
            ), [$section]);
        } else {
            $section = $f()->field()->section($items, $txt(ilMMTopItemGUI::CMD_EDIT), "");
            $this->form = $f()->container()->form()->standard($this->ctrl->getLinkTargetByClass(
                ilMMTopItemGUI::class,
                ilMMTopItemGUI::CMD_UPDATE
            ), [$section]);
        }
    }

References Vendor\Package\$f, ILIAS\LTI\ToolProvider\$key, $txt, $type, ILIAS\Repository\access(), ilMMTopItemGUI\CMD_ADD, ilMMTopItemGUI\CMD_CREATE, ilMMTopItemGUI\CMD_EDIT, ilMMTopItemGUI\CMD_UPDATE, ILIAS\Repository\ctrl(), F_ACTIVE, F_ICON, F_ROLE_BASED_VISIBILITY, F_TITLE, F_TYPE, ILIAS\Repository\form(), getTypeGroups(), and ILIAS\Repository\lng().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ save()

ilMMTopItemFormGUI::save ( )

Definition at line 185 of file class.ilMMTopItemFormGUI.php.

                          : bool
    {
        $this->form = $this->form->withRequest($this->http->request());
        $data = $this->form->getData();
        if (is_null($data)) {
            return false;
        }
 
        $this->item_facade->setAction((string) ($data[0]['action'] ?? ''));
        $this->item_facade->setDefaultTitle((string) $data[0][self::F_TITLE]);
        $this->item_facade->setActiveStatus((bool) $data[0][self::F_ACTIVE]);
        if ($this->item_facade->supportsRoleBasedVisibility()) {
            $this->item_facade->setRoleBasedVisibility((bool) $data[0][self::F_ROLE_BASED_VISIBILITY]);
            if ($data[0][self::F_ROLE_BASED_VISIBILITY] and !empty($data[0][self::F_ROLE_BASED_VISIBILITY])) {
                $this->item_facade->setGlobalRoleIDs((array) $data[0][self::F_ROLE_BASED_VISIBILITY][0]);
            }
        }
 
        $this->item_facade->setIsTopItm(true);
 
        if ($this->item_facade->isEmpty()) {
            $type = $this->unhash((string) ($data[0][self::F_TYPE][0]));
            $this->item_facade->setType($type);
            $this->repository->createItem($this->item_facade);
        }
 
        if ($this->item_facade->supportsCustomIcon()) {
            $icon = (string) ($data[0][self::F_ICON][0] ?? '');
            $this->item_facade->setIconID($icon);
        }
 
        if ($this->item_facade->isCustom()) {
            $type = $this->item_facade->getType();
            $type_specific_data = (array) $data[0][self::F_TYPE][1];
            $type_handler = $this->repository->getTypeHandlerForType($type);
            $type_handler->saveFormFields($this->item_facade->identification(), $type_specific_data);
        }
 
        $this->repository->updateItem($this->item_facade);
 
        return true;
    }