User privacy settings (currently located under "Profile and Privacy") More...

Collaboration diagram for ilUserPrivacySettingsGUI:

Public Member Functions
	__construct ()
	constructor More...

	executeCommand ()
	execute command More...

	workWithUserSetting (string $setting)

	userSettingVisible (string $setting)

	showPrivacySettings ($form=null)
	General settings form. More...

	initPrivacySettingsForm ()
	Init form. More...

	shouldDisplayChatSection ()

	savePrivacySettings ()
	Save privacy settings. More...

Data Fields
const	PROP_ENABLE_OSC = 'chat_osc_accept_msg'

const	PROP_ENABLE_BROWSER_NOTIFICATIONS = 'chat_osc_browser_notifications'

const	PROP_ENABLE_SOUND = 'play_invitation_sound'

Protected Member Functions
	isAwarnessSettingVisible ()
	Is awareness tool setting visible. More...

	isContactSettingVisible ()
	Is contact setting visible. More...

	populateWithAwarenessSettingsSection (array &$formSections)

	populateWithContactsSettingsSection (array &$formSections)

	populateWithChatSettingsSection (array &$formSections)

	appendChatJsToTemplate (ilGlobalPageTemplate $pageTemplate)

Protected Attributes
	$lng

	$ctrl

	$main_tpl

	$user_settings_config

	$user

	$settings

	$request

	$checklist_status

	$profile_mode

	$chatSettings = array()

	$notificationSettings = array()

	$event

Private Member Functions
	shouldShowNotificationOptions ()

	shouldShowOnScreenChatOptions ()

Private Attributes
	$uiFactory

	$uiRenderer

	$refinery

Detailed Description

User privacy settings (currently located under "Profile and Privacy")

Author: killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 9 of file class.ilUserPrivacySettingsGUI.php.

Constructor & Destructor Documentation

◆ __construct()

ilUserPrivacySettingsGUI::__construct ( )

constructor

Definition at line 81 of file class.ilUserPrivacySettingsGUI.php.

    {
        global $DIC;
 
        $this->main_tpl = $DIC->ui()->mainTemplate();
        $this->lng = $DIC->language();
        $this->ctrl = $DIC->ctrl();
        $this->lng->loadLanguageModule("user");
        $this->user = $DIC->user();
        $this->refinery = $DIC->refinery();
        $this->uiFactory = $DIC->ui()->factory();
        $this->uiRenderer = $DIC->ui()->renderer();
        $this->chatSettings = new ilSetting('chatroom');
        $this->notificationSettings = new ilSetting('notifications');
        $this->event = $DIC->event();
 
        $this->request = $DIC->http()->request();
 
        $this->user_settings_config = new ilUserSettingsConfig();
        $this->settings = $DIC->settings();
        $this->checklist_status = new ilProfileChecklistStatus();
        $this->profile_mode = new ilPersonalProfileMode($this->user, $this->settings);
    }

References $DIC, settings(), and user().

Here is the call graph for this function:

Member Function Documentation

◆ appendChatJsToTemplate()

ilUserPrivacySettingsGUI::appendChatJsToTemplate ( ilGlobalPageTemplate $pageTemplate )

protected

Parameters

ilGlobalPageTemplate $main_tpl

Returns: ilTemplate

Definition at line 525 of file class.ilUserPrivacySettingsGUI.php.

                                                                                  : ilTemplate
    {
        $tpl = new ilTemplate('tpl.personal_chat_settings_form.html', true, true, 'Modules/Chatroom');
        if ($this->shouldShowOnScreenChatOptions() && $this->chatSettings->get('enable_browser_notifications', false)) {
            $pageTemplate->addJavascript('./Services/Notifications/js/browser_notifications.js');
 
            $tpl->setVariable('ALERT_IMAGE_SRC', ilUtil::getImagePath('icon_alert.svg'));
            $tpl->setVariable('BROWSER_NOTIFICATION_TOGGLE_LABEL', $this->lng->txt('osc_enable_browser_notifications_label'));
 
            $this->lng->toJSMap([
                'osc_browser_noti_no_permission_error' => $this->lng->txt('osc_browser_noti_no_permission_error'),
                'osc_browser_noti_no_support_error' => $this->lng->txt('osc_browser_noti_no_support_error'),
                'osc_browser_noti_req_permission_error' => $this->lng->txt('osc_browser_noti_req_permission_error'),
            ], $pageTemplate);
        }
 
        return $tpl;
    }

References $tpl, ilUtil\getImagePath(), and shouldShowOnScreenChatOptions().

Referenced by showPrivacySettings().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ executeCommand()

ilUserPrivacySettingsGUI::executeCommand ( )

execute command

Definition at line 108 of file class.ilUserPrivacySettingsGUI.php.

    {
        $next_class = $this->ctrl->getNextClass();
 
        switch ($next_class) {
            default:
                $cmd = $this->ctrl->getCmd("showPrivacySettings");
                $this->$cmd();
                break;
        }
        $this->main_tpl->printToStdout();
    }

◆ initPrivacySettingsForm()

ilUserPrivacySettingsGUI::initPrivacySettingsForm ( )

Init form.

Returns: \ILIAS\UI\Component\Input\Container\Form\Standard

Definition at line 217 of file class.ilUserPrivacySettingsGUI.php.

    {
        $sections = [];
 
        $this->populateWithAwarenessSettingsSection($sections);
        $this->populateWithContactsSettingsSection($sections);
        $this->populateWithChatSettingsSection($sections);
 
        $form_action = $this->ctrl->getLinkTarget($this, "savePrivacySettings");
 
        return $this->uiFactory->input()
            ->container()
            ->form()
            ->standard($form_action, $sections)
            ->withAdditionalTransformation($this->refinery->custom()->transformation(static function ($values) : array {
                return call_user_func_array('array_merge', $values);
            }));
    }

References populateWithAwarenessSettingsSection(), populateWithChatSettingsSection(), and populateWithContactsSettingsSection().

Referenced by savePrivacySettings(), and showPrivacySettings().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isAwarnessSettingVisible()

ilUserPrivacySettingsGUI::isAwarnessSettingVisible ( )

protected

Is awareness tool setting visible.

Returns: bool

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

                                                  : bool
    {
        $awrn_set = new ilSetting("awrn");
        if ($awrn_set->get("awrn_enabled", false) && $this->userSettingVisible("hide_own_online_status")) {
            return true;
        }
        return false;
    }

Referenced by populateWithAwarenessSettingsSection(), and savePrivacySettings().

Here is the caller graph for this function:

◆ isContactSettingVisible()

ilUserPrivacySettingsGUI::isContactSettingVisible ( )

protected

Is contact setting visible.

Returns: bool

Definition at line 205 of file class.ilUserPrivacySettingsGUI.php.

                                                 : bool
    {
        if (ilBuddySystem::getInstance()->isEnabled() && $this->userSettingVisible('bs_allow_to_contact_me')) {
            return true;
        }
        return false;
    }

References ilBuddySystem\getInstance(), and userSettingVisible().

Referenced by populateWithContactsSettingsSection(), and savePrivacySettings().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateWithAwarenessSettingsSection()

ilUserPrivacySettingsGUI::populateWithAwarenessSettingsSection ( array & $formSections )

protected

Parameters

array $formSections

Definition at line 273 of file class.ilUserPrivacySettingsGUI.php.

                                                                                  : void
    {
        if (!$this->isAwarnessSettingVisible()) {
            return;
        }
 
        $this->lng->loadLanguageModule("awrn");
 
        $default = ($this->settings->get('hide_own_online_status') == "n")
            ? $this->lng->txt("user_awrn_show")
            : $this->lng->txt("user_awrn_hide");
 
        $options = array(
            "x" => $this->lng->txt("user_awrn_default") . " (" . $default . ")",
            "n" => $this->lng->txt("user_awrn_show"),
            "y" => $this->lng->txt("user_awrn_hide")
        );
        $val = $this->user->prefs["hide_own_online_status"];
        if ($val == "") {
            $val = "x";
        }
 
        $fields["hide_own_online_status"] = $this->uiFactory->input()
            ->field()
            ->select(
                $this->lng->txt("awrn_user_show"),
                $options,
                $this->lng->txt("awrn_hide_from_awareness_info")
            )
            ->withValue($val)
            ->withRequired(true)
            ->withDisabled(
                $this->settings->get('usr_settings_disable_hide_own_online_status', '0') === '1' ? true : false
            );
 
        $formSections['awrn_sec'] = $this->uiFactory->input()->field()->section($fields, $this->lng->txt('obj_awra'));
    }

References isAwarnessSettingVisible(), settings(), and user().

Referenced by initPrivacySettingsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateWithChatSettingsSection()

ilUserPrivacySettingsGUI::populateWithChatSettingsSection ( array & $formSections )

protected

Parameters

array $formSections

Definition at line 338 of file class.ilUserPrivacySettingsGUI.php.

                                                                             : void
    {
        if (!$this->shouldDisplayChatSection()) {
            return;
        }
 
        $fieldFactory = $this->uiFactory->input()->field();
        $fields = [];
 
        $this->lng->loadLanguageModule('chatroom_adm');
        $checkboxStateToBooleanTrafo = $this->refinery->custom()->transformation(static function ($v) {
            if (is_array($v)) {
                return $v;
            }
 
            if (is_bool($v)) {
                return $v;
            }
 
            return $v === 'checked';
        });
 
        if ($this->shouldShowOnScreenChatOptions()) {
            $oscAvailable = $this->settings->get('usr_settings_disable_chat_osc_accept_msg', '0') === '1' ? true : false;
            $oscSubFormGroup = [];
 
            if ($this->chatSettings->get('enable_browser_notifications', false)) {
                $enabledBrowserNotifications = $fieldFactory
                    ->checkbox(
                        $this->lng->txt('osc_enable_browser_notifications_label'),
                        sprintf(
                            $this->lng->txt('osc_enable_browser_notifications_info'),
                            (int) $this->chatSettings->get('conversation_idle_state_in_minutes')
                        )
                    )
                    ->withAdditionalTransformation($checkboxStateToBooleanTrafo)
                    ->withDisabled($oscAvailable);
 
                $oscSubFormGroup[self::PROP_ENABLE_BROWSER_NOTIFICATIONS] = $enabledBrowserNotifications;
 
                $groupValue = null;
                if (ilUtil::yn2tf($this->user->getPref('chat_osc_accept_msg'))) {
                    $groupValue = [
                        self::PROP_ENABLE_BROWSER_NOTIFICATIONS => ilUtil::yn2tf($this->user->getPref('chat_osc_browser_notifications')),
                    ];
                }
                $enabledOsc = $fieldFactory
                    ->optionalGroup(
                        $oscSubFormGroup,
                        $this->lng->txt('chat_osc_accept_msg'),
                        $this->lng->txt('chat_osc_accept_msg_info')
                    )
                    ->withAdditionalTransformation($checkboxStateToBooleanTrafo)
                    ->withDisabled($oscAvailable)
                    ->withValue($groupValue);
            } else {
                $enabledOsc = $fieldFactory
                    ->checkbox(
                        $this->lng->txt('chat_osc_accept_msg'),
                        $this->lng->txt('chat_osc_accept_msg_info')
                    )
                    ->withAdditionalTransformation($checkboxStateToBooleanTrafo)
                    ->withDisabled($oscAvailable)
                    ->withValue(ilUtil::yn2tf($this->user->getPref('chat_osc_accept_msg')));
            }
 
            $fields[self::PROP_ENABLE_OSC] = $enabledOsc;
        }
 
        if ($this->shouldShowNotificationOptions()) {
            $fields[self::PROP_ENABLE_SOUND] = $fieldFactory
                ->checkbox($this->lng->txt('play_invitation_sound'), $this->lng->txt('play_invitation_sound_info'))
                ->withAdditionalTransformation($checkboxStateToBooleanTrafo)
                ->withValue((bool) $this->user->getPref('chat_play_invitation_sound'));
        }
 
        $formSections['chat_sec'] = $this->uiFactory->input()->field()->section($fields, $this->lng->txt('chat_settings'));
    }

References PROP_ENABLE_BROWSER_NOTIFICATIONS, PROP_ENABLE_OSC, PROP_ENABLE_SOUND, settings(), shouldDisplayChatSection(), shouldShowNotificationOptions(), shouldShowOnScreenChatOptions(), true, user(), and ilUtil\yn2tf().

Referenced by initPrivacySettingsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ populateWithContactsSettingsSection()

ilUserPrivacySettingsGUI::populateWithContactsSettingsSection ( array & $formSections )

protected

Parameters

array $formSections

Definition at line 314 of file class.ilUserPrivacySettingsGUI.php.

                                                                                 : void
    {
        if (!$this->isContactSettingVisible()) {
            return;
        }
 
        $this->lng->loadLanguageModule('buddysystem');
        $fields["bs_allow_to_contact_me"] = $this->uiFactory->input()
            ->field()
            ->checkbox(
                $this->lng->txt("buddy_allow_to_contact_me"),
                $this->lng->txt("buddy_allow_to_contact_me_info")
            )
            ->withValue($this->user->prefs['bs_allow_to_contact_me'] == 'y')
            ->withDisabled(
                $this->settings->get('usr_settings_disable_bs_allow_to_contact_me', '0') === '1' ? true : false
            );
 
        $formSections['contacts_sec'] = $this->uiFactory->input()->field()->section($fields, $this->lng->txt('mm_contacts'));
    }

References isContactSettingVisible(), settings(), and user().

Referenced by initPrivacySettingsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ savePrivacySettings()

ilUserPrivacySettingsGUI::savePrivacySettings ( )

Save privacy settings.

Definition at line 420 of file class.ilUserPrivacySettingsGUI.php.

    {
        $request = $this->request;
        $form = $this->initPrivacySettingsForm();
        $lng = $this->lng;
        $user = $this->user;
        $ctrl = $this->ctrl;
 
        if ($request->getMethod() == "POST") {
            $form = $form->withRequest($request);
            $formData = $form->getData();
 
            if ($this->isAwarnessSettingVisible() && $this->workWithUserSetting("hide_own_online_status")) {
                $val = $formData["hide_own_online_status"] ?? 'x';
                if ($val == "x") {
                    $val = "";
                }
                $user->setPref(
                    "hide_own_online_status",
                    $val
                );
            }
            if ($this->isContactSettingVisible() && $this->workWithUserSetting("bs_allow_to_contact_me")) {
                if ($formData["bs_allow_to_contact_me"]) {
                    $user->setPref("bs_allow_to_contact_me", "y");
                } else {
                    $user->setPref("bs_allow_to_contact_me", "n");
                }
            }
 
            $user->update();
 
            if ($this->shouldDisplayChatSection()) {
                $preferencesUpdated = false;
 
                if ($this->shouldShowNotificationOptions()) {
                    $oldPlaySoundValue = (int) $this->user->getPref('chat_play_invitation_sound');
                    $playASound = (int) ($formData[self::PROP_ENABLE_SOUND] ?? 0);
 
                    if ($oldPlaySoundValue !== $playASound) {
                        $this->user->setPref('chat_play_invitation_sound', $playASound);
                        $preferencesUpdated = true;
                    }
                }
 
                if ($this->shouldShowOnScreenChatOptions()) {
                    $oldEnableOscValue = ilUtil::yn2tf($this->user->getPref('chat_osc_accept_msg'));
                    $enableOsc = $formData[self::PROP_ENABLE_OSC] ?? null;
                    if (!is_bool($enableOsc)) {
                        $enableOsc = is_array($enableOsc);
                    }
 
                    if ($this->settings->get('usr_settings_disable_chat_osc_accept_msg', '0') !== '1') {
                        $preferencesUpdated = true;
                        if ($oldEnableOscValue !== $enableOsc) {
                            $this->user->setPref('chat_osc_accept_msg', ilUtil::tf2yn($enableOsc));
                            $preferencesUpdated = true;
                        }
                    }
 
                    if ($this->chatSettings->get('enable_browser_notifications', false) && $enableOsc) {
                        $oldBrowserNotificationValue = ilUtil::yn2tf($this->user->getPref('chat_osc_browser_notifications'));
 
                        $sendBrowserNotifications = false;
                        if (is_array($formData[self::PROP_ENABLE_OSC])) {
                            if (true === $formData[self::PROP_ENABLE_OSC][self::PROP_ENABLE_BROWSER_NOTIFICATIONS]) {
                                $sendBrowserNotifications = true;
                            }
                        }
 
                        if ($oldBrowserNotificationValue !== $sendBrowserNotifications) {
                            $this->user->setPref(
                                'chat_osc_browser_notifications',
                                ilUtil::tf2yn($sendBrowserNotifications)
                            );
                            $preferencesUpdated = true;
                        }
                    }
                }
 
                if ($preferencesUpdated) {
                    $this->user->writePrefs();
 
                    $this->event->raise(
                        'Modules/Chatroom',
                        'chatSettingsChanged',
                        [
                            'user' => $this->user
                        ]
                    );
                }
            }
 
            $this->checklist_status->saveStepSucess(ilProfileChecklistStatus::STEP_VISIBILITY_OPTIONS);
            ilUtil::sendSuccess($lng->txt('msg_obj_modified'), true);
            $ctrl->redirect($this, '');
        }
 
        $this->showPrivacySettings($form);
    }

References $ctrl, $lng, $request, $user, initPrivacySettingsForm(), isAwarnessSettingVisible(), isContactSettingVisible(), PROP_ENABLE_OSC, settings(), shouldDisplayChatSection(), shouldShowNotificationOptions(), shouldShowOnScreenChatOptions(), showPrivacySettings(), ilProfileChecklistStatus\STEP_VISIBILITY_OPTIONS, ilUtil\tf2yn(), user(), workWithUserSetting(), and ilUtil\yn2tf().

Here is the call graph for this function:

◆ shouldDisplayChatSection()

ilUserPrivacySettingsGUI::shouldDisplayChatSection ( )

Returns: bool

Definition at line 239 of file class.ilUserPrivacySettingsGUI.php.

                                               : bool
    {
        return (
            $this->chatSettings->get('chat_enabled', false) && (
                $this->shouldShowNotificationOptions() || $this->shouldShowOnScreenChatOptions()
            )
        );
    }

Referenced by populateWithChatSettingsSection(), and savePrivacySettings().

Here is the caller graph for this function:

◆ shouldShowNotificationOptions()

ilUserPrivacySettingsGUI::shouldShowNotificationOptions ( )

private

Returns: bool

Definition at line 251 of file class.ilUserPrivacySettingsGUI.php.

                                                     : bool
    {
        return (
            $this->notificationSettings->get('enable_osd', false) &&
            $this->chatSettings->get('play_invitation_sound', false)
        );
    }

Referenced by populateWithChatSettingsSection(), and savePrivacySettings().

Here is the caller graph for this function:

◆ shouldShowOnScreenChatOptions()

ilUserPrivacySettingsGUI::shouldShowOnScreenChatOptions ( )

private

Returns: bool

Definition at line 262 of file class.ilUserPrivacySettingsGUI.php.

                                                     : bool
    {
        return (
            $this->chatSettings->get('enable_osc', false) &&
            !(bool) $this->settings->get('usr_settings_hide_chat_osc_accept_msg', false)
        );
    }

Referenced by appendChatJsToTemplate(), populateWithChatSettingsSection(), and savePrivacySettings().

Here is the caller graph for this function:

◆ showPrivacySettings()

ilUserPrivacySettingsGUI::showPrivacySettings ( $form = null )

General settings form.

Parameters

null $form

Definition at line 150 of file class.ilUserPrivacySettingsGUI.php.

    {
        $main_tpl = $this->main_tpl;
        $user = $this->user;
        $lng = $this->lng;
 
        $html = "";
        if ($this->checklist_status->anyVisibilitySettings()
            && ($this->isAwarnessSettingVisible()
                || $this->isContactSettingVisible()
                || $this->shouldDisplayChatSection())) {
            if (is_null($form)) {
                $form = $this->initPrivacySettingsForm();
            }
            $html = $this->uiRenderer->render([$form]);
        }
 
        $pub_profile = new ilPublicUserProfileGUI($user->getId());
        if ($this->profile_mode->isEnabled()) {
            $pub_profile_legacy = $this->uiFactory->legacy($pub_profile->getEmbeddable());
            $html .= $this->uiRenderer->render($this->uiFactory->panel()->standard(
                $this->lng->txt('user_profile_preview'),
                $pub_profile_legacy
            ));
        } else {
            if (!$this->checklist_status->anyVisibilitySettings()) {
                $html .= $this->uiRenderer->render(
                    [$this->uiFactory->messageBox()->info($lng->txt("usr_public_profile_disabled"))]
                );
            }
        }
 
 
        $chat_tpl = $this->appendChatJsToTemplate($main_tpl);
 
        $main_tpl->setContent($html . $chat_tpl->get());
    }

References $lng, $main_tpl, $user, appendChatJsToTemplate(), and initPrivacySettingsForm().

Referenced by savePrivacySettings().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ userSettingVisible()

ilUserPrivacySettingsGUI::userSettingVisible ( string $setting )

Parameters

string $setting

Returns: bool

Definition at line 141 of file class.ilUserPrivacySettingsGUI.php.

                                                        : bool
    {
        return $this->user_settings_config->isVisible($setting);
    }

Referenced by isContactSettingVisible().

Here is the caller graph for this function:

◆ workWithUserSetting()

ilUserPrivacySettingsGUI::workWithUserSetting ( string $setting )

Parameters

string $setting

Returns: bool

Definition at line 132 of file class.ilUserPrivacySettingsGUI.php.

                                                         : bool
    {
        return $this->user_settings_config->isVisibleAndChangeable($setting);
    }

Referenced by savePrivacySettings().

Here is the caller graph for this function: