Collaboration diagram for ilAccountMail:

Public Member Functions
	__construct ()

	useLangVariablesAsFallback (bool $a_status)

	areLangVariablesUsedAsFallback ()

	shouldAttachConfiguredFiles ()

	setAttachConfiguredFiles (bool $attachConfiguredFiles)

	setUserPassword (string $a_pwd)

	getUserPassword ()

	setUser (ilObjUser $a_user)

	getUser ()

	getTarget ()

	reset ()

	send ()
	Sends the mail with its object properties as MimeMail It first tries to read the mail body, subject and sender address from posted named formular fields. More...

	replacePlaceholders (string $a_string, ilObjUser $a_user, array $a_amail, string $a_lang)

	addAttachment (string $a_filename, string $a_display_name)

Data Fields
string	$u_password = ''

ilObjUser	$user = null

string	$target = ''

Private Member Functions
	ensureValidMailDataShape (array $mailData)

	readAccountMail (string $a_lang)

	addAttachments (array $mailData)

Private Attributes
GlobalHttpState	$http

ilSetting	$settings

Refinery	$refinery

ilTree	$repositoryTree

ilMailMimeSenderFactory	$senderFactory

bool	$lang_variables_as_fallback = false

array	$attachments = []

bool	$attachConfiguredFiles = false

array	$amail = []

Detailed Description

Class ilAccountMail.

Sends e-mail to newly created accounts.

Author: Stefan Schneider stefa.nosp@m.n.sc.nosp@m.hneid.nosp@m.er@h.nosp@m.rz.un.nosp@m.i-gi.nosp@m.essen.nosp@m..de; Alex Killing alex..nosp@m.kill.nosp@m.ing@h.nosp@m.rz.u.nosp@m.ni-gi.nosp@m.esse.nosp@m.n.de

Definition at line 33 of file class.ilAccountMail.php.

Constructor & Destructor Documentation

◆ __construct()

ilAccountMail::__construct ( )

Definition at line 49 of file class.ilAccountMail.php.

    {
        global $DIC;
        $this->http = $DIC->http();
        $this->refinery = $DIC->refinery();
        $this->settings = $DIC->settings();
        $this->repositoryTree = $DIC->repositoryTree();
        $this->senderFactory = $DIC['mail.mime.sender.factory'];
    }

References $DIC, ILIAS\FileDelivery\http(), ILIAS\Repository\refinery(), ILIAS\Repository\repositoryTree(), and ILIAS\Repository\settings().

Here is the call graph for this function:

Member Function Documentation

◆ addAttachment()

ilAccountMail::addAttachment	(	string	$a_filename,
		string	$a_display_name
	)

Definition at line 381 of file class.ilAccountMail.php.

                                                                             : void
    {
        $this->attachments[$a_filename] = $a_display_name;
    }

Referenced by addAttachments().

Here is the caller graph for this function:

◆ addAttachments()

ilAccountMail::addAttachments ( array $mailData )

private

Parameters

array{lang? string, subject?: string, body?: string, sal_f?: string, sal_g?: string, sal_m?: string, type?: string, att_file?: string} $mailData

Returns: void

Exceptions

ILIAS\Filesystem\Exception\IOException

Definition at line 155 of file class.ilAccountMail.php.

                                                    : void
    {
        if (isset($mailData['att_file']) && $this->shouldAttachConfiguredFiles()) {
            $fs = new ilFSStorageUserFolder(USER_FOLDER_ID);
            $fs->create();
 
            $pathToFile = '/' . implode('/', array_map(static function (string $pathPart): string {
                return trim($pathPart, '/');
            }, [
                $fs->getAbsolutePath(),
                $mailData['lang'],
            ]));
 
            $this->addAttachment($pathToFile, $mailData['att_file']);
        }
    }

References addAttachment(), shouldAttachConfiguredFiles(), and USER_FOLDER_ID.

Referenced by send().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ areLangVariablesUsedAsFallback()

ilAccountMail::areLangVariablesUsedAsFallback ( )

Definition at line 64 of file class.ilAccountMail.php.

                                                    : bool
    {
        return $this->lang_variables_as_fallback;
    }

References $lang_variables_as_fallback.

Referenced by send().

Here is the caller graph for this function:

◆ ensureValidMailDataShape()

ilAccountMail::ensureValidMailDataShape ( array $mailData )

private

Parameters

array{lang? string, subject?: string, body?: string, sal_f?: string, sal_g?: string, sal_m?: string, type?: string, att_file?: string} $mailData

Returns: array{lang?: string, subject?: string, body?: string, sal_f?: string, sal_g?: string, sal_m?: string, type?: string, att_file?: string}

Definition at line 122 of file class.ilAccountMail.php.

                                                              : array
    {
        foreach (['lang', 'subject', 'body', 'sal_f', 'sal_g', 'sal_m', 'type'] as $key) {
            if (!isset($mailData[$key])) {
                $mailData[$key] = '';
            }
        }
 
        $mailData['subject'] = trim($mailData['subject']);
        $mailData['body'] = trim($mailData['body']);
 
        return $mailData;
    }

References ILIAS\LTI\ToolProvider\$key.

Referenced by readAccountMail().

Here is the caller graph for this function:

◆ getTarget()

ilAccountMail::getTarget ( )

Definition at line 106 of file class.ilAccountMail.php.

                               : string
    {
        return $this->target;
    }

References $target.

◆ getUser()

ilAccountMail::getUser ( )

Definition at line 101 of file class.ilAccountMail.php.

                             : ?ilObjUser
    {
        return $this->user;
    }

References $user.

Referenced by send().

Here is the caller graph for this function:

◆ getUserPassword()

ilAccountMail::getUserPassword ( )

Definition at line 84 of file class.ilAccountMail.php.

                                     : string
    {
        return $this->u_password;
    }

References $u_password.

Referenced by replacePlaceholders().

Here is the caller graph for this function:

◆ readAccountMail()

ilAccountMail::readAccountMail ( string $a_lang )

private

Returns: array{lang?: string, subject?: string, body?: string, sal_f?: string, sal_g?: string, sal_m?: string, type?: string}

Definition at line 139 of file class.ilAccountMail.php.

                                                    : array
    {
        if (!isset($this->amail[$a_lang]) || !is_array($this->amail[$a_lang])) {
            $this->amail[$a_lang] = $this->ensureValidMailDataShape(
                ilObjUserFolder::_lookupNewAccountMail($a_lang)
            );
        }
 
        return $this->amail[$a_lang];
    }

References ilObjUserFolder\_lookupNewAccountMail(), and ensureValidMailDataShape().

Referenced by send().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ replacePlaceholders()

ilAccountMail::replacePlaceholders	(	string	$a_string,
		ilObjUser	$a_user,
		array	$a_amail,
		string	$a_lang
	)

Definition at line 252 of file class.ilAccountMail.php.

                                                                                                            : string
    {
        switch ($a_user->getGender()) {
            case 'f':
                $gender_salut = $a_amail['sal_f'];
                break;
            case 'm':
                $gender_salut = $a_amail['sal_m'];
                break;
            default:
                $gender_salut = $a_amail['sal_g'];
        }
        $gender_salut = trim($gender_salut);
 
        $a_string = str_replace(
            [
                '[MAIL_SALUTATION]',
                '[LOGIN]',
                '[FIRST_NAME]',
                '[LAST_NAME]',
                '[EMAIL]',
                '[PASSWORD]',
                '[ILIAS_URL]',
                '[INSTALLATION_NAME]',
                '[ADMIN_MAIL]',
            ],
            [
                $gender_salut,
                $a_user->getLogin(),
                $a_user->getFirstname(),
                $a_user->getLastname(),
                $a_user->getEmail(),
                $this->getUserPassword(),
                ILIAS_HTTP_PATH . '/login.php?client_id=' . CLIENT_ID,
                CLIENT_NAME,
                $this->settings->get('admin_email', ''),
            ],
            $a_string
        );
 
        // (no) password sections
        if ($this->getUserPassword() === '') {
            // #12232
            $a_string = preg_replace(
                "/\[IF_PASSWORD\].*\[\/IF_PASSWORD\]/imsU",
                "",
                $a_string
            );
            $a_string = preg_replace(
                "/\[IF_NO_PASSWORD\](.*)\[\/IF_NO_PASSWORD\]/imsU",
                "$1",
                $a_string
            );
        } else {
            $a_string = preg_replace(
                "/\[IF_NO_PASSWORD\].*\[\/IF_NO_PASSWORD\]/imsU",
                "",
                $a_string
            );
            $a_string = preg_replace(
                "/\[IF_PASSWORD\](.*)\[\/IF_PASSWORD\]/imsU",
                "$1",
                $a_string
            );
        }
 
        // #13346
        if (!$a_user->getTimeLimitUnlimited()) {
            // #6098
            $a_string = preg_replace(
                "/\[IF_TIMELIMIT\](.*)\[\/IF_TIMELIMIT\]/imsU",
                "$1",
                $a_string
            );
            $timelimit_from = new ilDateTime($a_user->getTimeLimitFrom(), IL_CAL_UNIX);
            $timelimit_until = new ilDateTime($a_user->getTimeLimitUntil(), IL_CAL_UNIX);
            $timelimit = ilDatePresentation::formatPeriod($timelimit_from, $timelimit_until);
            $a_string = str_replace("[TIMELIMIT]", $timelimit, $a_string);
        } else {
            $a_string = preg_replace(
                "/\[IF_TIMELIMIT\](.*)\[\/IF_TIMELIMIT\]/imsU",
                "",
                $a_string
            );
        }
 
        // target
        $tar = false;
        if ($this->http->wrapper()->query()->has('target') &&
            $this->http->wrapper()->query()->retrieve('target', $this->refinery->kindlyTo()->string()) !== ''
        ) {
            $target = $this->http->wrapper()->query()->retrieve('target', $this->refinery->kindlyTo()->string());
            $tarr = explode('_', $target);
            if ($this->repositoryTree->isInTree((int) $tarr[1])) {
                $obj_id = ilObject::_lookupObjId((int) $tarr[1]);
                $type = ilObject::_lookupType($obj_id);
                if ($type === $tarr[0]) {
                    $a_string = str_replace(
                        ['[TARGET_TITLE]', '[TARGET]'],
                        [
                            ilObject::_lookupTitle($obj_id),
                            ILIAS_HTTP_PATH . '/goto.php?client_id=' . CLIENT_ID . '&target=' . $target
                        ],
                        $a_string
                    );
 
                    // this looks complicated, but we may have no initiliased $lng object here
                    // if mail is send during user creation in authentication
                    $a_string = str_replace(
                        '[TARGET_TYPE]',
                        ilLanguage::_lookupEntry($a_lang, 'common', 'obj_' . $tarr[0]),
                        $a_string
                    );
 
                    $tar = true;
                }
            }
        }
 
        // (no) target section
        if (!$tar) {
            $a_string = preg_replace("/\[IF_TARGET\].*\[\/IF_TARGET\]/imsU", '', $a_string);
        } else {
            $a_string = preg_replace("/\[IF_TARGET\](.*)\[\/IF_TARGET\]/imsU", "$1", $a_string);
        }
 
        return $a_string;
    }

References $target, $type, ilLanguage\_lookupEntry(), ilObject\_lookupObjId(), ilObject\_lookupTitle(), ilObject\_lookupType(), CLIENT_ID, CLIENT_NAME, ilDatePresentation\formatPeriod(), ilObjUser\getEmail(), ilObjUser\getFirstname(), ilObjUser\getGender(), ilObjUser\getLastname(), ilObjUser\getLogin(), ilObjUser\getTimeLimitFrom(), ilObjUser\getTimeLimitUnlimited(), ilObjUser\getTimeLimitUntil(), getUserPassword(), ILIAS\FileDelivery\http(), IL_CAL_UNIX, ILIAS\Repository\refinery(), and ILIAS\Repository\repositoryTree().

Referenced by send().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ reset()

ilAccountMail::reset ( )

Definition at line 111 of file class.ilAccountMail.php.

                           : void
    {
        $this->user = null;
        $this->u_password = '';
        $this->target = '';
    }

References ILIAS\Repository\user().

Here is the call graph for this function:

◆ send()

ilAccountMail::send ( )

Sends the mail with its object properties as MimeMail It first tries to read the mail body, subject and sender address from posted named formular fields.

If no field values found the defaults are used. Placehoders will be replaced by the appropriate data.

Returns: bool

Exceptions

RuntimeException

Definition at line 180 of file class.ilAccountMail.php.

                          : bool
    {
        $user = $this->getUser();
        if (null === $user) {
            throw new RuntimeException('A user instance must be passed when sending emails');
        }
 
        if (!$user->getEmail()) {
            return false;
        }
 
        // determine language and get account mail data
        // fall back to default language if acccount mail data is not given for user language.
        $amail = $this->readAccountMail($user->getLanguage());
        $lang = $user->getLanguage();
        if ($amail['body'] === '' || $amail['subject'] === '') {
            $fallback_language = 'en';
            $amail = $this->readAccountMail($this->settings->get('language', $fallback_language));
            $lang = $this->settings->get('language', $fallback_language);
        }
 
        // fallback if mail data is still not given
        if (($amail['body'] === '' || $amail['subject'] === '') && $this->areLangVariablesUsedAsFallback()) {
            $lang = $user->getLanguage();
            $tmp_lang = new ilLanguage($lang);
 
            $mail_subject = $tmp_lang->txt('reg_mail_subject');
 
            $timelimit = "";
            if (!$user->checkTimeLimit()) {
                $tmp_lang->loadLanguageModule("registration");
 
                // #6098
                $timelimit_from = new ilDateTime($user->getTimeLimitFrom(), IL_CAL_UNIX);
                $timelimit_until = new ilDateTime($user->getTimeLimitUntil(), IL_CAL_UNIX);
                $timelimit = ilDatePresentation::formatPeriod($timelimit_from, $timelimit_until);
                $timelimit = "\n" . sprintf($tmp_lang->txt('reg_mail_body_timelimit'), $timelimit) . "\n\n";
            }
 
            // mail body
            $mail_body = $tmp_lang->txt('reg_mail_body_salutation') . ' ' . $user->getFullname() . ",\n\n" .
                $tmp_lang->txt('reg_mail_body_text1') . "\n\n" .
                $tmp_lang->txt('reg_mail_body_text2') . "\n" .
                ILIAS_HTTP_PATH . '/login.php?client_id=' . CLIENT_ID . "\n";
            $mail_body .= $tmp_lang->txt('login') . ': ' . $user->getLogin() . "\n";
            $mail_body .= $tmp_lang->txt('passwd') . ': ' . $this->u_password . "\n";
            $mail_body .= "\n" . $timelimit;
            $mail_body .= $tmp_lang->txt('reg_mail_body_text3') . "\n\r";
            $mail_body .= $user->getProfileAsString($tmp_lang);
        } else {
            $this->addAttachments($amail);
 
            // replace placeholders
            $mail_subject = $this->replacePlaceholders($amail['subject'], $user, $amail, $lang);
            $mail_body = $this->replacePlaceholders($amail['body'], $user, $amail, $lang);
        }
 
        $mmail = new ilMimeMail();
        $mmail->From($this->senderFactory->system());
        $mmail->Subject($mail_subject, true);
        $mmail->To($user->getEmail());
        $mmail->Body($mail_body);
 
        foreach ($this->attachments as $filename => $display_name) {
            $mmail->Attach($filename, '', 'attachment', $display_name);
        }
 
        $mmail->Send();
 
        return true;
    }

References $amail, $filename, $lang, $user, addAttachments(), areLangVariablesUsedAsFallback(), ilObjUser\checkTimeLimit(), CLIENT_ID, ilDatePresentation\formatPeriod(), ilObjUser\getEmail(), ilObjUser\getFullname(), ilObjUser\getLanguage(), ilObjUser\getLogin(), ilObjUser\getTimeLimitFrom(), ilObjUser\getTimeLimitUntil(), getUser(), IL_CAL_UNIX, readAccountMail(), replacePlaceholders(), and ILIAS\Repository\settings().

Here is the call graph for this function:

◆ setAttachConfiguredFiles()

ilAccountMail::setAttachConfiguredFiles ( bool $attachConfiguredFiles )

Definition at line 74 of file class.ilAccountMail.php.

                                                                         : void
    {
        $this->attachConfiguredFiles = $attachConfiguredFiles;
    }

References $attachConfiguredFiles.

◆ setUser()

ilAccountMail::setUser ( ilObjUser $a_user )

Definition at line 89 of file class.ilAccountMail.php.

                                              : void
    {
        if (
            $this->user instanceof ilObjUser &&
            $a_user->getId() !== $this->user->getId()
        ) {
            $this->attachments = [];
        }
 
        $this->user = $a_user;
    }

References ilObject\getId(), and ILIAS\Repository\user().

Here is the call graph for this function:

◆ setUserPassword()

ilAccountMail::setUserPassword ( string $a_pwd )

Definition at line 79 of file class.ilAccountMail.php.

                                                  : void
    {
        $this->u_password = $a_pwd;
    }

◆ shouldAttachConfiguredFiles()

ilAccountMail::shouldAttachConfiguredFiles ( )

Definition at line 69 of file class.ilAccountMail.php.

                                                 : bool
    {
        return $this->attachConfiguredFiles;
    }

References $attachConfiguredFiles.

Referenced by addAttachments().

Here is the caller graph for this function:

◆ useLangVariablesAsFallback()

ilAccountMail::useLangVariablesAsFallback ( bool $a_status )

Definition at line 59 of file class.ilAccountMail.php.

                                                              : void
    {
        $this->lang_variables_as_fallback = $a_status;
    }

Field Documentation

◆ $amail

array ilAccountMail::$amail = []

private

Definition at line 47 of file class.ilAccountMail.php.

Referenced by send().

◆ $attachConfiguredFiles

bool ilAccountMail::$attachConfiguredFiles = false

private

Definition at line 46 of file class.ilAccountMail.php.

Referenced by setAttachConfiguredFiles(), and shouldAttachConfiguredFiles().

◆ $attachments

array ilAccountMail::$attachments = []

private

Definition at line 45 of file class.ilAccountMail.php.

◆ $http

GlobalHttpState ilAccountMail::$http

private

Definition at line 35 of file class.ilAccountMail.php.

◆ $lang_variables_as_fallback

bool ilAccountMail::$lang_variables_as_fallback = false

private

Definition at line 43 of file class.ilAccountMail.php.

Referenced by areLangVariablesUsedAsFallback().

◆ $refinery

Refinery ilAccountMail::$refinery

private

Definition at line 37 of file class.ilAccountMail.php.

◆ $repositoryTree

ilTree ilAccountMail::$repositoryTree

private

Definition at line 38 of file class.ilAccountMail.php.

◆ $senderFactory

ilMailMimeSenderFactory ilAccountMail::$senderFactory

private

Definition at line 39 of file class.ilAccountMail.php.

◆ $settings

ilSetting ilAccountMail::$settings

private

Definition at line 36 of file class.ilAccountMail.php.

◆ $target

string ilAccountMail::$target = ''

Definition at line 42 of file class.ilAccountMail.php.

Referenced by getTarget(), and replacePlaceholders().

◆ $u_password

string ilAccountMail::$u_password = ''

Definition at line 40 of file class.ilAccountMail.php.

Referenced by getUserPassword().

◆ $user

ilObjUser ilAccountMail::$user = null

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

Referenced by getUser(), and send().

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

Services/Mail/classes/class.ilAccountMail.php

Public Member Functions

Data Fields

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addAttachment()

◆ addAttachments()

◆ areLangVariablesUsedAsFallback()

◆ ensureValidMailDataShape()

◆ getTarget()

◆ getUser()

◆ getUserPassword()

◆ readAccountMail()

◆ replacePlaceholders()

◆ reset()

◆ send()

◆ setAttachConfiguredFiles()

◆ setUser()

◆ setUserPassword()

◆ shouldAttachConfiguredFiles()

◆ useLangVariablesAsFallback()

Field Documentation

◆ $amail

◆ $attachConfiguredFiles

◆ $attachments

◆ $http

◆ $lang_variables_as_fallback

◆ $refinery

◆ $repositoryTree

◆ $senderFactory

◆ $settings

◆ $target

◆ $u_password

◆ $user