Class ilTermsOfServiceWithdrawalGUIHelper. More...

Collaboration diagram for ilTermsOfServiceWithdrawalGUIHelper:

Public Member Functions
	__construct (ilObjUser $subjectUser)

	modifyFooter (Footer $footer)

	handleWithdrawalLogoutRequest (ServerRequestInterface $httpRequest, object $guiClass)

	getWithdrawalTextForLogoutScreen (ServerRequestInterface $httpRequest)

	getConsentWithdrawalConfirmation (object $parentObject)

	setWithdrawalInfoForLoginScreen (ServerRequestInterface $httpRequest)

Protected Attributes
ilLanguage	$lng

ilCtrlInterface	$ctrl

ilSetting	$setting

ilObjUser	$user

Factory	$uiFactory

Renderer	$uiRenderer

ilTermsOfServiceHelper	$tosHelper

Private Member Functions
	getWithdrawalSectionForModal ()

Private Attributes
ilGlobalTemplateInterface	$main_tpl

Detailed Description

Class ilTermsOfServiceWithdrawalGUIHelper.

Author: Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Definition at line 30 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

Constructor & Destructor Documentation

◆ __construct()

ilTermsOfServiceWithdrawalGUIHelper::__construct ( ilObjUser $subjectUser )

Definition at line 41 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

    {
        global $DIC;
        $this->main_tpl = $DIC->ui()->mainTemplate();
 
        $this->user = $subjectUser;
 
        $this->lng = $DIC->language();
        $this->ctrl = $DIC->ctrl();
        $this->setting = $DIC->settings();
        $this->uiFactory = $DIC->ui()->factory();
        $this->uiRenderer = $DIC->ui()->renderer();
        $this->tosHelper = new ilTermsOfServiceHelper();
    }

References $DIC, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

Here is the call graph for this function:

Member Function Documentation

◆ getConsentWithdrawalConfirmation()

ilTermsOfServiceWithdrawalGUIHelper::getConsentWithdrawalConfirmation ( object $parentObject )

Definition at line 160 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

                                                                          : string
    {
        $defaultAuth = ilAuthUtils::AUTH_LOCAL;
        if ($this->setting->get('auth_mode')) {
            $defaultAuth = $this->setting->get('auth_mode');
        }
 
        $isLdapUser = (
            $this->user->getAuthMode() == ilAuthUtils::AUTH_LDAP ||
            ($this->user->getAuthMode() === 'default' && $defaultAuth == ilAuthUtils::AUTH_LDAP)
        );
 
        $lng_suffix = '';
        if (!$this->user->getAgreeDate()) {
            $lng_suffix = '_no_consent_yet';
        }
        $question = $this->lng->txt('withdrawal_sure_account' . $lng_suffix);
        if (!$isLdapUser && $this->setting->get('tos_withdrawal_usr_deletion', '0')) {
            $question = $this->lng->txt('withdrawal_sure_account_deletion' . $lng_suffix);
        }
 
        $confirmation = $this->uiFactory->messageBox()->confirmation($question)->withButtons([
            $this->uiFactory->button()->standard(
                $this->lng->txt('confirm'),
                $this->ctrl->getFormAction($parentObject, 'withdrawAcceptance')
            ),
            $this->uiFactory->button()->standard(
                $this->lng->txt('cancel'),
                $this->ctrl->getFormAction($parentObject, 'cancelWithdrawal')
            ),
        ]);
 
        if ($isLdapUser) {
            $message = nl2br(str_ireplace('[BR]', "\n", sprintf(
                $this->lng->txt('withdrawal_mail_info') . $this->lng->txt('withdrawal_mail_text'),
                $this->user->getFullname(),
                $this->user->getLogin(),
                $this->user->getExternalAccount()
            )));
 
            $panelContent = $this->uiFactory->legacy(
                $this->uiRenderer->render([
                    $confirmation,
                    $this->uiFactory->divider()->horizontal(),
                    $this->uiFactory->legacy($message)
                ])
            );
 
            $content = $this->uiRenderer->render(
                $this->uiFactory->panel()->standard($this->lng->txt('withdraw_usr_agreement'), $panelContent)
            );
        } else {
            $content = $this->uiRenderer->render($confirmation);
        }
 
        return $content;
    }

References $message, ilAuthUtils\AUTH_LDAP, ilAuthUtils\AUTH_LOCAL, ILIAS\Repository\ctrl(), ILIAS\Repository\lng(), and ILIAS\Repository\user().

Here is the call graph for this function:

◆ getWithdrawalSectionForModal()

ilTermsOfServiceWithdrawalGUIHelper::getWithdrawalSectionForModal ( )

private

Definition at line 56 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

                                                   : ilTemplate
    {
        $template = new ilTemplate('tpl.tos_withdrawal_section.html', true, true, 'Services/TermsOfService');
        $template->setVariable('TXT_TOS_WITHDRAWAL_HEADLINE', $this->lng->txt('withdraw_consent_header'));
        $template->setVariable('TXT_TOS_WITHDRAWAL', $this->lng->txt('withdraw_consent_description'));
        $template->setVariable(
            'BTN_TOS_WITHDRAWAL',
            $this->uiRenderer->render(
                $this->uiFactory->button()->standard($this->lng->txt('withdraw_consent'), ilStartUpGUI::logoutUrl(['withdraw_consent' => '']))
            )
        );
 
        return $template;
    }

References ILIAS\Repository\lng(), and ilStartUpGUI\logoutUrl().

Here is the call graph for this function:

◆ getWithdrawalTextForLogoutScreen()

ilTermsOfServiceWithdrawalGUIHelper::getWithdrawalTextForLogoutScreen ( ServerRequestInterface $httpRequest )

Definition at line 143 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

                                                                                         : string
    {
        $withdrawalStatus = ($httpRequest->getQueryParams()['withdrawal_relogin_content'] ?? 0);
 
        $text = '';
        if ($withdrawalStatus !== 0) {
            $text = $this->uiRenderer->render($this->uiFactory->divider()->horizontal());
            if ($withdrawalStatus === 'internal') {
                $text .= $this->lng->txt('withdraw_consent_description_internal');
            } else {
                $text .= $this->lng->txt('withdraw_consent_description_external');
            }
        }
 
        return $text;
    }

References ILIAS\Repository\lng().

Here is the call graph for this function:

◆ handleWithdrawalLogoutRequest()

ilTermsOfServiceWithdrawalGUIHelper::handleWithdrawalLogoutRequest	(	ServerRequestInterface	$httpRequest,
		object	$guiClass
	)

Definition at line 107 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

     : void {
        if (!isset($httpRequest->getQueryParams()['withdraw_consent'])) {
            return;
        }
 
        if (!$this->tosHelper->isGloballyEnabled() || !$this->tosHelper->isIncludedUser($this->user)) {
            return;
        }
 
        $defaultAuth = ilAuthUtils::AUTH_LOCAL;
        if ($this->setting->get('auth_mode')) {
            $defaultAuth = $this->setting->get('auth_mode');
        }
 
        $external = false;
        if (
            $this->user->getAuthMode() == ilAuthUtils::AUTH_PROVIDER_LTI ||
            $this->user->getAuthMode() == ilAuthUtils::AUTH_ECS ||
            ($this->user->getAuthMode() === 'default' && $defaultAuth == ilAuthUtils::AUTH_PROVIDER_LTI) ||
            ($this->user->getAuthMode() === 'default' && $defaultAuth == ilAuthUtils::AUTH_ECS)
        ) {
            $external = true;
        }
 
        $this->user->writePref('consent_withdrawal_requested', '1');
 
        if ($external) {
            $this->ctrl->setParameter($guiClass, 'withdrawal_relogin_content', 'external');
        } else {
            $this->ctrl->setParameter($guiClass, 'withdrawal_relogin_content', 'internal');
        }
    }

◆ modifyFooter()

ilTermsOfServiceWithdrawalGUIHelper::modifyFooter ( Footer $footer )

Parameters

Footer $footer

Returns: Footer

Exceptions

ilTermsOfServiceMissingDatabaseAdapterException

Definition at line 76 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

                                                : Footer
    {
        if (
            $this->tosHelper->isGloballyEnabled() &&
            $this->tosHelper->isIncludedUser($this->user) &&
            $this->user->getAgreeDate()
        ) {
            $entity = $this->tosHelper->getCurrentAcceptanceForUser($this->user);
            if ($entity->getId()) {
                $footer = $footer->withAdditionalModalAndTrigger(
                    $this->uiFactory->modal()->roundtrip(
                        $entity->getTitle(),
                        [
                            $this->uiFactory->legacy($this->lng->txt('usr_agreement_footer_intro')),
                            $this->uiFactory->divider()->horizontal(),
                            $this->uiFactory->legacy(
                                implode('', [
                                    $entity->getText(),
                                    $this->getWithdrawalSectionForModal()->get()
                                ])
                            )
                        ]
                    ),
                    $this->uiFactory->button()->shy($this->lng->txt('usr_agreement'), '#')
                );
            }
        }
 
        return $footer;
    }

References ILIAS\Repository\user(), and ILIAS\UI\Component\MainControls\Footer\withAdditionalModalAndTrigger().

Here is the call graph for this function:

◆ setWithdrawalInfoForLoginScreen()

ilTermsOfServiceWithdrawalGUIHelper::setWithdrawalInfoForLoginScreen ( ServerRequestInterface $httpRequest )

Definition at line 218 of file class.ilTermsOfServiceWithdrawalGUIHelper.php.

                                                                                        : void
    {
        if (isset($httpRequest->getQueryParams()['tos_withdrawal_type'])) {
            $withdrawalType = (int) $httpRequest->getQueryParams()['tos_withdrawal_type'];
            if (1 === $withdrawalType) {
                $this->main_tpl->setOnScreenMessage('info', $this->lng->txt('withdrawal_complete_deleted'));
            } elseif (2 === $withdrawalType) {
                $this->main_tpl->setOnScreenMessage('info', $this->lng->txt('withdrawal_complete_redirect'));
            } else {
                $this->main_tpl->setOnScreenMessage('info', $this->lng->txt('withdrawal_complete'));
            }
        }
    }