Class ilAccountRegistrationMail. More...

Inheritance diagram for ilAccountRegistrationMail:

Collaboration diagram for ilAccountRegistrationMail:

Public Member Functions
	__construct (private readonly ilRegistrationSettings $settings, private readonly ilLogger $logger, private readonly NewAccountMailRepository $account_mail_repository)

	getMode ()

	withPermanentLinkTarget (string $permanent_link_target)

	withDirectRegistrationMode ()

	withEmailConfirmationRegistrationMode ()

	send (ilObjUser $user, string $rawPassword='', bool $usedRegistrationCode=false)

Public Member Functions inherited from ilMimeMailNotification
	__construct (bool $a_is_personal_workspace=false)

	sendMimeMail (string $a_rcp)

	setCurrentRecipient (string $current_recipient)

	getCurrentRecipient ()

	setMimeMail (ilMimeMail $mime_mail)

	getMimeMail ()

Public Member Functions inherited from ilMailNotification
	__construct (protected bool $is_in_wsp=false)

	setType (int $a_type)

	getType ()

	setSender (int $a_usr_id)

	getSender ()

	setRecipients (array $a_rcp)

	getRecipients ()

	setAttachments (array $a_att)

	getAttachments ()

	setLangModules (array $a_modules)

	getUserLanguage (int $a_usr_id)

	setRefId (int $a_id)

	getRefId ()

	getObjId ()

	setObjId (int $a_obj_id)

	getObjType ()

	setAdditionalInformation (array $a_info)

	getAdditionalInformation ()

	sendMail (array $a_rcp, bool $a_parse_recipients=true)

	getBlockBorder ()

Protected Attributes
const	MODE_DIRECT_REGISTRATION = 1

const	MODE_REGISTRATION_WITH_EMAIL_CONFIRMATION = 2

Protected Attributes inherited from ilMimeMailNotification
ilMimeMail	$mime_mail

string	$current_recipient

ilMailMimeSenderFactory	$sender_factory

Protected Attributes inherited from ilMailNotification
int	$type

int	$sender

ilMail	$mail = null

string	$subject = ''

string	$body = ''

array	$attachments = []

ilLanguage	$language

array	$lang_modules = []

array	$recipients = []

int	$ref_id

int	$obj_id = 0

string	$obj_type = ''

array	$additional_info = []

ilWorkspaceTree	$wsp_tree

ilWorkspaceAccessHandler	$wsp_access_handler

Private Member Functions
	isEmptyMailConfigurationData (array $mailData)

	trySendingUserDefinedAccountMail (ilObjUser $user, string $rawPassword)

	sendLanguageVariableBasedAccountMail (ilObjUser $user, string $rawPassword, bool $usedRegistrationCode)

Private Attributes
int	$mode = self::MODE_DIRECT_REGISTRATION

string	$permanent_link_target = null

Additional Inherited Members
Data Fields inherited from ilMailNotification
final const int	SUBJECT_TITLE_LENGTH = 60

Protected Member Functions inherited from ilMimeMailNotification
	setSubject (string $a_subject)

	initMimeMail ()

	initLanguageByIso2Code (string $a_code='')

	initLanguage (int $a_usr_id)

Protected Member Functions inherited from ilMailNotification
	setSubject (string $a_subject)

	getSubject ()

	setBody (string $a_body)

	appendBody (string $a_body)

	getBody ()

	initLanguage (int $a_usr_id)

	initLanguageByIso2Code (string $a_code='')

	setLanguage (ilLanguage $a_language)

	getLanguage ()

	getLanguageText (string $a_keyword)

	getObjectTitle (bool $a_shorten=false)

	initMail ()

	getMail ()

	createPermanentLink (array $a_params=[], string $a_append='')

	userToString (int $a_usr_id)

	isRefIdAccessible (int $a_user_id, int $a_ref_id, string $a_permission='read')

Detailed Description

Class ilAccountRegistrationMail.

Author: Michael Jansen mjans.nosp@m.en@d.nosp@m.ataba.nosp@m.y.de

Definition at line 27 of file class.ilAccountRegistrationMail.php.

Constructor & Destructor Documentation

◆ __construct()

ilAccountRegistrationMail::__construct	(	private readonly ilRegistrationSettings	$settings,
		private readonly ilLogger	$logger,
		private readonly NewAccountMailRepository	$account_mail_repository
	)

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

      {
        parent::__construct(false);
    }

References ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

◆ getMode()

ilAccountRegistrationMail::getMode ( )

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

                             : int
    {
        return $this->mode;
    }

References $mode.

◆ isEmptyMailConfigurationData()

ilAccountRegistrationMail::isEmptyMailConfigurationData ( array $mailData )

private

Definition at line 75 of file class.ilAccountRegistrationMail.php.

                                                                  : bool
    {
        return !(
            isset($mailData['body'], $mailData['subject']) &&
            is_string($mailData['body']) &&
            $mailData['body'] !== '' &&
            is_string($mailData['subject']) &&
            $mailData['subject'] !== ''
        );
    }

◆ send()

ilAccountRegistrationMail::send	(	ilObjUser	$user,
		string	$rawPassword = `''`,
		bool	$usedRegistrationCode = `false`
	)

Definition at line 191 of file class.ilAccountRegistrationMail.php.

                                                                                                       : void
    {
        if (!$this->trySendingUserDefinedAccountMail($user, $rawPassword)) {
            $this->sendLanguageVariableBasedAccountMail($user, $rawPassword, $usedRegistrationCode);
        }
    }

◆ sendLanguageVariableBasedAccountMail()

ilAccountRegistrationMail::sendLanguageVariableBasedAccountMail	(	ilObjUser	$user,
		string	$rawPassword,
		bool	$usedRegistrationCode
	)

private

Definition at line 126 of file class.ilAccountRegistrationMail.php.

     : void {
        if (!$user->getEmail()) {
            $this->logger->debug(sprintf(
                'Missing email address, did not send account registration mail for user %s (id: %s) ...',
                $user->getLogin(),
                $user->getId()
            ));
            return;
        }
 
        $this->logger->debug(sprintf(
            'Sending language variable dependent welcome email to user %s (id: %s|language: %s) as fallback ...',
            $user->getLogin(),
            $user->getId(),
            $user->getLanguage()
        ));
 
        $this->initMimeMail();
 
        $this->initLanguageByIso2Code($user->getLanguage());
 
        $this->setSubject($this->language->txt('reg_mail_subject'));
 
        $this->setBody($this->language->txt('reg_mail_body_salutation') . ' ' . $user->getFullname() . ',');
        $this->appendBody("\n\n");
        $this->appendBody($this->language->txt('reg_mail_body_text1'));
        $this->appendBody("\n\n");
        $this->appendBody($this->language->txt('reg_mail_body_text2'));
        $this->appendBody("\n");
        $this->appendBody(ILIAS_HTTP_PATH . '/login.php?client_id=' . CLIENT_ID);
        $this->appendBody("\n");
        $this->appendBody($this->language->txt('login') . ': ' . $user->getLogin());
        $this->appendBody("\n");
 
        if ($this->settings->passwordGenerationEnabled()) {
            $this->appendBody($this->language->txt('passwd') . ': ' . $rawPassword);
            $this->appendBody("\n");
        }
 
        if ($this->getMode() === self::MODE_DIRECT_REGISTRATION) {
            if ($this->settings->getRegistrationType() === ilRegistrationSettings::IL_REG_APPROVE && !$usedRegistrationCode) {
                $this->appendBody("\n");
                $this->appendBody($this->language->txt('reg_mail_body_pwd_generation'));
                $this->appendBody("\n\n");
            }
        } elseif ($this->getMode() === self::MODE_REGISTRATION_WITH_EMAIL_CONFIRMATION) {
            $this->appendBody("\n");
            $this->appendBody($this->language->txt('reg_mail_body_forgot_password_info'));
            $this->appendBody("\n\n");
        }
 
        $this->appendBody($this->language->txt('reg_mail_body_text3'));
        $this->appendBody("\n");
        $this->appendBody($user->getProfileAsString($this->language));
        $this->appendBody(ilMail::_getInstallationSignature());
 
        $this->sendMimeMail($user->getEmail());
 
        $this->logger->debug('Welcome email sent');
    }

References ilObject\getId(), ilObjUser\getLogin(), and ILIAS\Repository\logger().

Here is the call graph for this function:

◆ trySendingUserDefinedAccountMail()

ilAccountRegistrationMail::trySendingUserDefinedAccountMail	(	ilObjUser	$user,
		string	$rawPassword
	)

private

Definition at line 86 of file class.ilAccountRegistrationMail.php.

                                                                                           : bool
    {
        $this->logger->debug(sprintf(
            'Trying to send configurable email dependent welcome email to user %s (id: %s|language: %s) ...',
            $user->getLogin(),
            $user->getId(),
            $user->getLanguage()
        ));
 
        $mailData = $this->account_mail_repository->getFor($user->getLanguage());
 
        if ($mailData->getBody() === '' && $mailData->getSubject() === '') {
            $this->logger->debug(sprintf(
                'Either subject or email missing, trying to determine email configuration via default language: %s',
                $this->language->getDefaultLanguage()
            ));
 
            $mailData = $this->account_mail_repository->getFor($this->language->getDefaultLanguage());
 
            if ($mailData->getBody() === '' && $mailData->getSubject() === '') {
                $this->logger->debug('Did not find any valid email configuration, skipping attempt ...');
                return false;
            }
        }
 
        $accountMail = new ilAccountMail();
        $accountMail->setUser($user);
        $accountMail->setPermanentLinkTarget($this->permanent_link_target);
 
        if ($this->settings->passwordGenerationEnabled()) {
            $accountMail->setUserPassword($rawPassword);
        }
 
        $accountMail->send();
 
        $this->logger->debug('Welcome email sent');
 
        return true;
    }

References ilObject\getId(), ilObjUser\getLanguage(), ilObjUser\getLogin(), ILIAS\UI\examples\Symbol\Glyph\Language\language(), ILIAS\Repository\logger(), and ILIAS\Repository\settings().

Here is the call graph for this function:

◆ withDirectRegistrationMode()

ilAccountRegistrationMail::withDirectRegistrationMode ( )

Definition at line 61 of file class.ilAccountRegistrationMail.php.

                                                : ilAccountRegistrationMail
    {
        $clone = clone $this;
        $clone->mode = self::MODE_DIRECT_REGISTRATION;
        return $clone;
    }

References MODE_DIRECT_REGISTRATION.

◆ withEmailConfirmationRegistrationMode()

ilAccountRegistrationMail::withEmailConfirmationRegistrationMode ( )

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

                                                           : ilAccountRegistrationMail
    {
        $clone = clone $this;
        $clone->mode = self::MODE_REGISTRATION_WITH_EMAIL_CONFIRMATION;
        return $clone;
    }

References MODE_REGISTRATION_WITH_EMAIL_CONFIRMATION.

◆ withPermanentLinkTarget()

ilAccountRegistrationMail::withPermanentLinkTarget ( string $permanent_link_target )

Definition at line 48 of file class.ilAccountRegistrationMail.php.

                                                                          : self
    {
        if ($permanent_link_target === '') {
            throw new InvalidArgumentException(
                'Permanent link target must not be empty'
            );
        }
 
        $clone = clone $this;
        $clone->permanent_link_target = $permanent_link_target;
        return $clone;
    }