Inheritance diagram for ILIAS\User\Settings\SettingsImplementation:

Collaboration diagram for ILIAS\User\Settings\SettingsImplementation:

Public Member Functions
	__construct (private readonly Language $lng, private readonly \ilSetting $settings, private readonly UIFactory $ui_factory, private readonly Refinery $refinery, private readonly ConfigurationRepository $user_settings_configuration_repository, private readonly DataRepository $user_settings_data_repository)

	buildFormInputs (array $pages, Context $context, ?\ilObjUser $user)

	addSectionsToLegacyForm (\ilPropertyFormGUI $form, array $pages, Context $context, ?\ilObjUser $user)

	performAdditionalChecks (\ilGlobalTemplateInterface $tpl, \ilPropertyFormGUI $form)

	saveForm (\ilPropertyFormGUI\|array $form, array $pages, Context $context, \ilObjUser $user)
	If it is possible to set the preference on the user, this is what will be done, the user needs to be updated/stored after calling this function. More...

	getSettingByDefinitionClass (string $definition_class)

	getValueFromLegacyFormByDefinitionClass (string $definition_class, \ilPropertyFormGUI $form)

	settingAvailableToUser (string $definition_class)

	getSettingValueFor (int $user_id, string $key)

	getExportableSettings ()

	getSettingByDefinitionClass (string $definition_class)

	getValueFromLegacyFormByDefinitionClass (string $definition_class, \ilPropertyFormGUI $form)

	settingAvailableToUser (string $definition_class)

	getSettingValueFor (int $user_id, string $key)

Private Member Functions
	getSettingsForPagesBySections (array $pages)

	reorderSections (array $sections)

	buildInputsForSection (array $settings, ?\ilObjUser $user)

	addSectionToLegacyForm (\ilPropertyFormGUI $form, ?\ilObjUser $user, array $section)

	addDefaultInputsToLegacyForm (\ilPropertyFormGUI $form, ?\ilObjUser $user, array $section)

	addAdditionalInputsToLegacyForm (\ilPropertyFormGUI $form, ?\ilObjUser $user, array $section)

	buildSectionKey (Setting $setting)

	filterSettingsInSectionForAvailability (Context $context, array $settings)

	retrieveValueFromInputs (\ilPropertyFormGUI\|array $form, Setting $setting)

	checkStartingPointValue (\ilGlobalTemplateInterface $tpl, \ilPropertyFormGUI $form)

Detailed Description

Definition at line 28 of file SettingsImplementation.php.

Constructor & Destructor Documentation

◆ __construct()

ILIAS\User\Settings\SettingsImplementation::__construct	(	private readonly Language	$lng,
		private readonly \ilSetting	$settings,
		private readonly UIFactory	$ui_factory,
		private readonly Refinery	$refinery,
		private readonly ConfigurationRepository	$user_settings_configuration_repository,
		private readonly DataRepository	$user_settings_data_repository
	)

Definition at line 30 of file SettingsImplementation.php.

37 {

38 }

Member Function Documentation

◆ addAdditionalInputsToLegacyForm()

ILIAS\User\Settings\SettingsImplementation::addAdditionalInputsToLegacyForm	(	\ilPropertyFormGUI	$form,
		?\ilObjUser	$user,
		array	$section
	)

private

Definition at line 305 of file SettingsImplementation.php.

     : \ilPropertyFormGUI {
        $section_key = $this->buildSectionKey($section[0]);
        $values = array_reduce(
            $section,
            function (array $c, Setting $v) use ($user): array {
                $input = $v->getLegacyInput($this->lng, $this->settings, $user);
                $input->setPostVar($v->getIdentifier());
                $c['checkbox']->addSubItem($input);
                $c['defaults'] .= "{$v->getLabel($this->lng)}: "
                    . "{$v->getDefaultValueForDisplay($this->lng, $this->settings)}; ";
                if ($v->hasUserPersonalizedSetting($this->settings, $user)) {
                    $c['has_personalization'] = true;
                }
                return $c;
            },
            [
                'checkbox' => new \ilCheckboxInputGUI(
                    $this->lng->txt("personalise_{$section_key}"),
                    $section_key
                ),
                'defaults' => "{$this->lng->txt('default')}<br>",
                'has_personalization' => false
            ]
        );
        $values['checkbox']->setInfo(trim($values['defaults']));
        $values['checkbox']->setChecked($values['has_personalization']);
 
        $form->addItem($values['checkbox']);
 
        return $form;
    }

References $c, ILIAS\User\Settings\Setting\getIdentifier(), ILIAS\User\Settings\Setting\getLegacyInput(), ILIAS\User\Settings\Setting\hasUserPersonalizedSetting(), if, ILIAS\Repository\lng(), and ILIAS\Repository\settings().

Here is the call graph for this function:

◆ addDefaultInputsToLegacyForm()

ILIAS\User\Settings\SettingsImplementation::addDefaultInputsToLegacyForm	(	\ilPropertyFormGUI	$form,
		?\ilObjUser	$user,
		array	$section
	)

private

Definition at line 289 of file SettingsImplementation.php.

     : \ilPropertyFormGUI {
        return array_reduce(
            $section,
            function (\ilPropertyFormGUI $c, Setting $v) use ($user): \ilPropertyFormGUI {
                $input = $v->getLegacyInput($this->lng, $this->settings, $user);
                $c->addItem($input);
                return $c;
            },
            $form
        );
    }

◆ addSectionsToLegacyForm()

ILIAS\User\Settings\SettingsImplementation::addSectionsToLegacyForm	(	\ilPropertyFormGUI	$form,
		array	$pages,
		Context	$context,
		?\ilObjUser	$user
	)

Parameters

array<AvailablePages> $pages

Definition at line 90 of file SettingsImplementation.php.

     : \ilPropertyFormGUI {
        return array_reduce(
            $this->getSettingsForPagesBySections($pages),
            fn(\ilPropertyFormGUI $c, array $v): \ilPropertyFormGUI => $this->addSectionToLegacyForm(
                $c,
                $user,
                $this->filterSettingsInSectionForAvailability($context, $v)
            ),
            $form
        );
    }

◆ addSectionToLegacyForm()

ILIAS\User\Settings\SettingsImplementation::addSectionToLegacyForm	(	\ilPropertyFormGUI	$form,
		?\ilObjUser	$user,
		array	$section
	)

private

Definition at line 272 of file SettingsImplementation.php.

     : \ilPropertyFormGUI {
        if ($section === []) {
            return $form;
        }
 
        if ($section[0]->getSettingsPage() === AvailablePages::MainSettings
            && $section[0]->getSection() === AvailableSections::Main) {
            return $this->addDefaultInputsToLegacyForm($form, $user, $section);
        }
 
        return $this->addAdditionalInputsToLegacyForm($form, $user, $section);
    }

◆ buildFormInputs()

ILIAS\User\Settings\SettingsImplementation::buildFormInputs	(	array	$pages,
		Context	$context,
		?\ilObjUser	$user
	)

Parameters

array<AvailablePages> $pages

Returns: array<string, \ILIAS\UI\Component\Input\Input>

Definition at line 44 of file SettingsImplementation.php.

     : array {
        return array_reduce(
            $this->getSettingsForPagesBySections($pages),
            function (array $c, array $v) use ($pages, $context, $user): array {
                $settings = $this->filterSettingsInSectionForAvailability($context, $v);
                if ($settings === []) {
                    return $c;
                }
 
                $page = $settings[0]->getSettingsPage();
                $section = $settings[0]->getSection();
                $section_key = $this->buildSectionKey($settings[0]);
 
                ['inputs' => $inputs, 'byline' => $byline, 'personalized' => $personalized] = $this->buildInputsForSection(
                    $settings,
                    $user
                );
 
                if (!in_array(AvailablePages::MainSettings, $pages)
                    || $page === AvailablePages::MainSettings && $section === AvailableSections::Main) {
                    return $c + $inputs;
                }
 
                $c[$section_key] = $this->ui_factory->input()->field()->optionalGroup(
                    $inputs,
                    $this->lng->txt("personalise_{$section_key}"),
                    $byline
                );
 
                if (!$personalized) {
                    $c[$section_key] = $c[$section_key]->withValue(null);
                }
 
                return $c;
            },
            []
        );
    }

References $c.

◆ buildInputsForSection()

ILIAS\User\Settings\SettingsImplementation::buildInputsForSection	(	array	$settings,
		?\ilObjUser	$user
	)

private

Definition at line 243 of file SettingsImplementation.php.

     : array {
        return array_reduce(
            $settings,
            function (array $c, Setting $v) use ($user): array {
                $c['inputs'][$v->getIdentifier()] = $v->getInput(
                    $this->ui_factory->input()->field(),
                    $this->lng,
                    $this->refinery,
                    $this->settings,
                    $user
                );
                $c['byline'] .= "{$v->getLabel($this->lng)}: "
                    . "{$v->getDefaultValueForDisplay($this->lng, $this->settings)}; ";
                if ($v->hasUserPersonalizedSetting($this->settings, $user)) {
                    $c['personalized'] = true;
                }
                return $c;
            },
            [
                'inputs' => [],
                'byline' => "{$this->lng->txt('default')}<br>",
                'personalized' => false
            ]
        );
    }

References $c.

◆ buildSectionKey()

ILIAS\User\Settings\SettingsImplementation::buildSectionKey ( Setting $setting )

private

Definition at line 341 of file SettingsImplementation.php.

                                                      : string
    {
        return $setting->getSettingsPage() === AvailablePages::MainSettings
            ? $setting->getSection()->value
            : $setting->getSettingsPage()->value;
    }

References ILIAS\User\Settings\Setting\getSection(), and ILIAS\User\Settings\Setting\getSettingsPage().

Here is the call graph for this function:

◆ checkStartingPointValue()

ILIAS\User\Settings\SettingsImplementation::checkStartingPointValue	(	\ilGlobalTemplateInterface	$tpl,
		\ilPropertyFormGUI	$form
	)

private

Definition at line 376 of file SettingsImplementation.php.

     : bool {
        return $form->getInput('additional') === ''
            || $this->user_settings_configuration_repository
                ->getByIdentifier('starting_point')
                ->validateUserChoice(
                    $tpl,
                    $this->lng,
                    $form
                );
    }

◆ filterSettingsInSectionForAvailability()

ILIAS\User\Settings\SettingsImplementation::filterSettingsInSectionForAvailability	(	Context	$context,
		array	$settings
	)

private

Definition at line 348 of file SettingsImplementation.php.

     : array {
        return array_values(
            array_filter(
                $settings,
                static fn(Setting $v): bool => $context->isSettingAvailable($v)
            )
        );
    }

◆ getExportableSettings()

ILIAS\User\Settings\SettingsImplementation::getExportableSettings ( )

Returns: list<Setting>

Definition at line 190 of file SettingsImplementation.php.

                                           : array
    {
        $context = Context::Export;
        return array_filter(
            $this->user_settings_configuration_repository->get(),
            static fn(Setting $v): bool => $context->isSettingAvailable($v)
        );
    }

◆ getSettingByDefinitionClass()

ILIAS\User\Settings\SettingsImplementation::getSettingByDefinitionClass ( string $definition_class )

Implements ILIAS\User\Settings\Settings.

Definition at line 155 of file SettingsImplementation.php.

     : Setting {
        $setting = $this->user_settings_configuration_repository->getByDefinitionClass($definition_class);
        if ($setting === null) {
            throw new \UnexpectedValueException('No class by that name');
        }
        return $setting;
    }

◆ getSettingsForPagesBySections()

ILIAS\User\Settings\SettingsImplementation::getSettingsForPagesBySections ( array $pages )

private

Parameters

array<AvailablePages> $pages

Definition at line 202 of file SettingsImplementation.php.

     : array {
        return $this->reorderSections(
            array_reduce(
                $this->user_settings_configuration_repository->get(),
                function (array $c, Setting $v) use ($pages): array {
                    if (!in_array($v->getSettingsPage(), $pages)) {
                        return $c;
                    }
 
                    $section_key = $this->buildSectionKey($v);
                    if (!array_key_exists($section_key, $c)) {
                        $c[$section_key] = [];
                    }
 
                    $c[$section_key][] = $v;
                    return $c;
                },
                []
            )
        );
    }

References $c.

◆ getSettingValueFor()

ILIAS\User\Settings\SettingsImplementation::getSettingValueFor	(	int	$user_id,
		string	$key
	)

Implements ILIAS\User\Settings\Settings.

Definition at line 182 of file SettingsImplementation.php.

                                                                 : ?string
    {
        return $this->user_settings_data_repository->getFor($user_id)[$key] ?? null;
    }

References $user_id.

◆ getValueFromLegacyFormByDefinitionClass()

ILIAS\User\Settings\SettingsImplementation::getValueFromLegacyFormByDefinitionClass	(	string	$definition_class,
		\ilPropertyFormGUI	$form
	)

Implements ILIAS\User\Settings\Settings.

Definition at line 165 of file SettingsImplementation.php.

     : mixed {
        return $form->getInput(
            $this->getSettingByDefinitionClass($definition_class)->getIdentifier()
        );
    }

◆ performAdditionalChecks()

ILIAS\User\Settings\SettingsImplementation::performAdditionalChecks	(	\ilGlobalTemplateInterface	$tpl,
		\ilPropertyFormGUI	$form
	)

Definition at line 107 of file SettingsImplementation.php.

     : bool {
        return $this->checkStartingPointValue(
            $tpl,
            $form
        );
    }

◆ reorderSections()

ILIAS\User\Settings\SettingsImplementation::reorderSections ( array $sections )

private

Definition at line 226 of file SettingsImplementation.php.

     : array {
        if (isset($sections[AvailableSections::Main->value])) {
            $default_section = $sections[AvailableSections::Main->value];
            unset($sections[AvailableSections::Main->value]);
            array_unshift($sections, $default_section);
        }
 
        if (isset($sections[AvailableSections::Additional->value])) {
            $additional_section = $sections[AvailableSections::Additional->value];
            unset($sections[AvailableSections::Additional->value]);
            $sections[AvailableSections::Additional->value] = $additional_section;
        }
        return $sections;
    }

◆ retrieveValueFromInputs()

ILIAS\User\Settings\SettingsImplementation::retrieveValueFromInputs	(	\ilPropertyFormGUI\|array	$form,
		Setting	$setting
	)

private

Definition at line 360 of file SettingsImplementation.php.

     : mixed {
        if ($form instanceof \ilPropertyFormGUI) {
            return $form->getInput($setting->getIdentifier());
        }
 
        $section_key = $this->buildSectionKey($setting);
 
        if ($section_key === AvailableSections::Main->value) {
            return $form[$setting->getIdentifier()];
        }
        return $form[$section_key][$setting->getIdentifier()];
    }

References ILIAS\User\Settings\Setting\getIdentifier().

Here is the call graph for this function:

◆ saveForm()

ILIAS\User\Settings\SettingsImplementation::saveForm	(	\ilPropertyFormGUI\|array	$form,
		array	$pages,
		Context	$context,
		\ilObjUser	$user
	)

If it is possible to set the preference on the user, this is what will be done, the user needs to be updated/stored after calling this function.

Parameters

array<AvailablePages> $pages

Definition at line 123 of file SettingsImplementation.php.

     : \ilObjUser {
        foreach ($this->getSettingsForPagesBySections($pages) as $section => $settings) {
            $available_settings = $this->filterSettingsInSectionForAvailability($context, $settings);
            $set_settings_to_default = false;
            if ($section !== 0
                && (
                    is_array($form) && $form[$section] === null
                    || $form instanceof \ilPropertyFormGUI
                        && (($input = $form->getInput($section)) === '' || $input === '0')
                )
            ) {
                $set_settings_to_default = true;
            }
            foreach ($available_settings as $setting) {
                $setting->persistUserInput(
                    $user,
                    $context,
                    $set_settings_to_default ? null : $this->retrieveValueFromInputs($form, $setting),
                    $form instanceof \ilPropertyFormGUI ? $form : null
                );
            }
        }
 
        $user->update();
        return $user;
    }

◆ settingAvailableToUser()

ILIAS\User\Settings\SettingsImplementation::settingAvailableToUser ( string $definition_class )

Implements ILIAS\User\Settings\Settings.

Definition at line 174 of file SettingsImplementation.php.

     : bool {
        return Context::User->isSettingAvailable(
            $this->getSettingByDefinitionClass($definition_class)
        );
    }

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

components/ILIAS/User/src/Settings/SettingsImplementation.php

Public Member Functions

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAdditionalInputsToLegacyForm()

◆ addDefaultInputsToLegacyForm()

◆ addSectionsToLegacyForm()

◆ addSectionToLegacyForm()

◆ buildFormInputs()

◆ buildInputsForSection()

◆ buildSectionKey()

◆ checkStartingPointValue()

◆ filterSettingsInSectionForAvailability()

◆ getExportableSettings()

◆ getSettingByDefinitionClass()

◆ getSettingsForPagesBySections()

◆ getSettingValueFor()

◆ getValueFromLegacyFormByDefinitionClass()

◆ performAdditionalChecks()

◆ reorderSections()

◆ retrieveValueFromInputs()

◆ saveForm()

◆ settingAvailableToUser()