Class ilMailOptions this class handles user mails. More...

Collaboration diagram for ilMailOptions:

Public Member Functions
	__construct (int $usrId, ilMailTransportSettings $mailTransportSettings=null, ilSetting $settings=null, ilDBInterface $db=null)

	createMailOptionsEntry ()
	create entry in table_mail_options for a new user this method should only be called from createUser() More...

	mayModifyIndividualTransportSettings ()

	maySeeIndividualTransportSettings ()

	mayManageInvididualSettings ()

	updateOptions ()

	getLinebreak ()

	getSignature ()

	getIncomingType ()

	setLinebreak (int $linebreak)

	setSignature (string $signature)

	setIncomingType (int $incomingType)

	setIsCronJobNotificationStatus (bool $isCronJobNotificationEnabled)

	isCronJobNotificationEnabled ()

	getEmailAddressMode ()

	setEmailAddressMode (int $emailAddressMode)

	getExternalEmailAddresses ()

Data Fields
const	INCOMING_LOCAL = 0

const	INCOMING_EMAIL = 1

const	INCOMING_BOTH = 2

const	FIRST_EMAIL = 3

const	SECOND_EMAIL = 4

const	BOTH_EMAIL = 5

const	DEFAULT_LINE_BREAK = 60

Protected Member Functions
	read ()

	lookupNotificationSetting (int $usrId)

Protected Attributes
	$ilias

	$db

	$usrId = 0

	$settings

	$table_mail_options = 'mail_options'

	$linebreak = 0

	$signature = ''

	$isCronJobNotificationEnabled = false

	$incomingType = self::INCOMING_LOCAL

	$default_incoming_type = self::INCOMING_LOCAL

	$emailAddressMode = self::FIRST_EMAIL

	$default_email_address_mode = self::FIRST_EMAIL

	$mailTransportSettings

	$firstEmailAddress = ''

	$secondEmailAddress = ''

Detailed Description

Class ilMailOptions this class handles user mails.

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Version: $Id$

Definition at line 10 of file class.ilMailOptions.php.

Constructor & Destructor Documentation

◆ __construct()

ilMailOptions::__construct	(	int	$usrId,
		ilMailTransportSettings	$mailTransportSettings = `null`,
		ilSetting	$settings = `null`,
		ilDBInterface	$db = `null`
	)

Parameters

int	$usrId
ilMailTransportSettings \| null	$mailTransportSettings

Definition at line 57 of file class.ilMailOptions.php.

      {
        global $DIC;
 
        $this->usrId = $usrId;
 
        $this->db = $db ?? $DIC->database();
        $this->settings = $settings ?? $DIC->settings();
 
        $this->incomingType = self::INCOMING_LOCAL;
        $default_incoming_type = $this->settings->get('mail_incoming_mail', '');
        if ($default_incoming_type !== '') {
            $this->default_incoming_type = (int) $default_incoming_type;
            $this->incomingType = $this->default_incoming_type;
        }
 
        $this->emailAddressMode = self::FIRST_EMAIL;
        $default_email_address_mode = $this->settings->get('mail_address_option', '');
        if ($default_email_address_mode !== '') {
            $this->default_email_address_mode = (int) $default_email_address_mode;
            $this->emailAddressMode = $this->default_email_address_mode;
        }
 
        $this->linebreak = self::DEFAULT_LINE_BREAK;
        $this->isCronJobNotificationEnabled = false;
        $this->signature = '';
 
        if ($mailTransportSettings === null) {
            $mailTransportSettings = new ilMailTransportSettings($this);
        }
        $this->mailTransportSettings = $mailTransportSettings;
 
        $this->read();
    }

References $db, $default_email_address_mode, $default_incoming_type, $DIC, $mailTransportSettings, $settings, $usrId, DEFAULT_LINE_BREAK, FIRST_EMAIL, INCOMING_LOCAL, isCronJobNotificationEnabled(), read(), and settings().

Here is the call graph for this function:

Member Function Documentation

◆ createMailOptionsEntry()

ilMailOptions::createMailOptionsEntry ( )

create entry in table_mail_options for a new user this method should only be called from createUser()

Definition at line 100 of file class.ilMailOptions.php.

                                             : void
    {
        $this->db->replace(
            $this->table_mail_options,
            [
                'user_id' => ['integer', $this->usrId],
            ],
            [
                'linebreak' => ['integer', $this->linebreak],
                'signature' => ['text', $this->signature],
                'incoming_type' => ['integer', $this->default_incoming_type],
                'mail_address_option' => ['integer', $this->default_email_address_mode],
                'cronjob_notification' => ['integer', (int) $this->isCronJobNotificationEnabled]
            ]
        );
    }

References isCronJobNotificationEnabled().

Here is the call graph for this function:

◆ getEmailAddressMode()

ilMailOptions::getEmailAddressMode ( )

Returns: int

Definition at line 281 of file class.ilMailOptions.php.

                                          : int
    {
        return $this->emailAddressMode;
    }

References $emailAddressMode.

Referenced by getExternalEmailAddresses(), and updateOptions().

Here is the caller graph for this function:

◆ getExternalEmailAddresses()

ilMailOptions::getExternalEmailAddresses ( )

Returns: string[]

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

                                                : array
    {
        $emailAddresses = [];
 
        switch ($this->getEmailAddressMode()) {
            case self::SECOND_EMAIL:
                if (strlen($this->secondEmailAddress)) {
                    $emailAddresses[] = $this->secondEmailAddress;
                } elseif (strlen($this->firstEmailAddress)) {
                    // fallback, use first email address
                    $emailAddresses[] = $this->firstEmailAddress;
                }
                break;
 
            case self::BOTH_EMAIL:
                if (strlen($this->firstEmailAddress)) {
                    $emailAddresses[] = $this->firstEmailAddress;
                }
                if (strlen($this->secondEmailAddress)) {
                    $emailAddresses[] = $this->secondEmailAddress;
                }
                break;
 
            case self::FIRST_EMAIL:
            default:
                if (strlen($this->firstEmailAddress)) {
                    $emailAddresses[] = $this->firstEmailAddress;
                } elseif (strlen($this->secondEmailAddress)) {
                    // fallback, use first email address
                    $emailAddresses[] = $this->secondEmailAddress;
                }
                break;
        }
 
        return $emailAddresses;
    }

References $firstEmailAddress, $secondEmailAddress, BOTH_EMAIL, FIRST_EMAIL, getEmailAddressMode(), and SECOND_EMAIL.

Here is the call graph for this function:

◆ getIncomingType()

ilMailOptions::getIncomingType ( )

Returns: int

Definition at line 233 of file class.ilMailOptions.php.

                                      : int
    {
        return $this->incomingType;
    }

References $incomingType.

Referenced by updateOptions().

Here is the caller graph for this function:

◆ getLinebreak()

ilMailOptions::getLinebreak ( )

Returns: int

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

                                   : int
    {
        return $this->linebreak;
    }

References $linebreak.

Referenced by updateOptions().

Here is the caller graph for this function:

◆ getSignature()

ilMailOptions::getSignature ( )

Returns: string

Definition at line 225 of file class.ilMailOptions.php.

                                   : string
    {
        return $this->signature;
    }

References $signature.

Referenced by updateOptions().

Here is the caller graph for this function:

◆ isCronJobNotificationEnabled()

ilMailOptions::isCronJobNotificationEnabled ( )

Returns: bool

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

                                                   : bool
    {
        return $this->isCronJobNotificationEnabled;
    }

References $isCronJobNotificationEnabled.

Referenced by __construct(), createMailOptionsEntry(), read(), setIsCronJobNotificationStatus(), and updateOptions().

Here is the caller graph for this function:

◆ lookupNotificationSetting()

ilMailOptions::lookupNotificationSetting ( int $usrId )

protected

Parameters

int $usrId

Returns: int

Definition at line 298 of file class.ilMailOptions.php.

                                                             : int
    {
        global $DIC;
 
        $row = $DIC->database()->fetchAssoc($DIC->database()->queryF(
            'SELECT cronjob_notification FROM mail_options WHERE user_id = %s',
            ['integer'],
            [$usrId]
        ));
 
        return (int) $row['cronjob_notification'];
    }

References $DIC, and $usrId.

Referenced by updateOptions().

Here is the caller graph for this function:

◆ mayManageInvididualSettings()

ilMailOptions::mayManageInvididualSettings ( )

Definition at line 131 of file class.ilMailOptions.php.

                                                  : bool
    {
        return $this->settings->get('show_mail_settings') === '1';
    }

References settings().

Referenced by mayModifyIndividualTransportSettings(), and read().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ mayModifyIndividualTransportSettings()

ilMailOptions::mayModifyIndividualTransportSettings ( )

Definition at line 117 of file class.ilMailOptions.php.

                                                           : bool
    {
        return (
            $this->mayManageInvididualSettings() &&
            $this->maySeeIndividualTransportSettings() &&
            $this->settings->get('usr_settings_disable_mail_incoming_mail') !== '1'
        );
    }

References mayManageInvididualSettings(), maySeeIndividualTransportSettings(), and settings().

Referenced by read().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ maySeeIndividualTransportSettings()

ilMailOptions::maySeeIndividualTransportSettings ( )

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

                                                        : bool
    {
        return $this->settings->get('usr_settings_hide_mail_incoming_mail') !== '1';
    }

References settings().

Referenced by mayModifyIndividualTransportSettings().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ read()

ilMailOptions::read ( )

protected

Definition at line 136 of file class.ilMailOptions.php.

                              : void
    {
        $query = implode(' ', [
            'SELECT mail_options.cronjob_notification,',
            'mail_options.signature, mail_options.linebreak, mail_options.incoming_type,',
            'mail_options.mail_address_option, usr_data.email, usr_data.second_email',
            'FROM mail_options',
            'INNER JOIN usr_data ON mail_options.user_id = usr_data.usr_id',
            'WHERE mail_options.user_id = %s',
        ]);
        $res = $this->db->queryF(
            $query,
            ['integer'],
            [$this->usrId]
        );
        $row = $this->db->fetchObject($res);
        if ($row === null) {
            $this->mailTransportSettings->adjust($this->firstEmailAddress, $this->secondEmailAddress, false);
            return;
        }
 
        $this->firstEmailAddress = (string) $row->email;
        $this->secondEmailAddress = (string) $row->second_email;
 
        if ($this->mayManageInvididualSettings()) {
            $this->signature = (string) $row->signature;
            $this->linebreak = (int) $row->linebreak;
            $this->isCronJobNotificationEnabled = (bool) $row->cronjob_notification;
        }
 
        if ($this->mayModifyIndividualTransportSettings()) {
            $this->incomingType = (int) $row->incoming_type;
            $this->emailAddressMode = (int) $row->mail_address_option;
 
            if (false === filter_var(
                $this->incomingType,
                FILTER_VALIDATE_INT,
                ['options' => ['min_range' => self::INCOMING_LOCAL, 'max_range' => self::INCOMING_BOTH]]
            )) {
                $this->incomingType = self::INCOMING_LOCAL;
            }
 
            if (false === filter_var(
                $this->emailAddressMode,
                FILTER_VALIDATE_INT,
                ['options' => ['min_range' => self::FIRST_EMAIL, 'max_range' => self::BOTH_EMAIL]]
            )) {
                $this->emailAddressMode = self::FIRST_EMAIL;
            }
        }
 
        $this->mailTransportSettings->adjust($this->firstEmailAddress, $this->secondEmailAddress);
    }

References $query, $res, FIRST_EMAIL, INCOMING_LOCAL, isCronJobNotificationEnabled(), mayManageInvididualSettings(), and mayModifyIndividualTransportSettings().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setEmailAddressMode()

ilMailOptions::setEmailAddressMode ( int $emailAddressMode )

Parameters

int $emailAddressMode

Definition at line 289 of file class.ilMailOptions.php.

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

References $emailAddressMode.

◆ setIncomingType()

ilMailOptions::setIncomingType ( int $incomingType )

Parameters

int $incomingType

Definition at line 257 of file class.ilMailOptions.php.

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

References $incomingType.

◆ setIsCronJobNotificationStatus()

ilMailOptions::setIsCronJobNotificationStatus ( bool $isCronJobNotificationEnabled )

Parameters

bool $isCronJobNotificationEnabled

Definition at line 265 of file class.ilMailOptions.php.

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

References $isCronJobNotificationEnabled, and isCronJobNotificationEnabled().

Here is the call graph for this function:

◆ setLinebreak()

ilMailOptions::setLinebreak ( int $linebreak )

Parameters

int $linebreak

Definition at line 241 of file class.ilMailOptions.php.

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

References $linebreak.

◆ setSignature()

ilMailOptions::setSignature ( string $signature )

Parameters

string $signature

Definition at line 249 of file class.ilMailOptions.php.

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

References $signature.

◆ updateOptions()

ilMailOptions::updateOptions ( )

Definition at line 190 of file class.ilMailOptions.php.

    {
        $data = [
            'signature' => ['text', $this->getSignature()],
            'linebreak' => ['integer', (int) $this->getLinebreak()],
            'incoming_type' => ['integer', $this->getIncomingType()],
            'mail_address_option' => ['integer', $this->getEmailAddressMode()]
        ];
 
        if ($this->settings->get('mail_notification')) {
            $data['cronjob_notification'] = ['integer', (int) $this->isCronJobNotificationEnabled()];
        } else {
            $data['cronjob_notification'] = ['integer', $this->lookupNotificationSetting($this->usrId)];
        }
 
        return $this->db->replace(
            $this->table_mail_options,
            [
                'user_id' => ['integer', $this->usrId]
            ],
            $data
        );
    }

References $data, getEmailAddressMode(), getIncomingType(), getLinebreak(), getSignature(), isCronJobNotificationEnabled(), lookupNotificationSetting(), and settings().

Here is the call graph for this function:

Field Documentation

◆ $db

ilMailOptions::$db

protected

Definition at line 25 of file class.ilMailOptions.php.

Referenced by __construct().

◆ $default_email_address_mode

ilMailOptions::$default_email_address_mode = self::FIRST_EMAIL

protected

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

Referenced by __construct().

◆ $default_incoming_type

ilMailOptions::$default_incoming_type = self::INCOMING_LOCAL

protected

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

Referenced by __construct().

◆ $emailAddressMode

ilMailOptions::$emailAddressMode = self::FIRST_EMAIL

protected

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

Referenced by getEmailAddressMode(), and setEmailAddressMode().

◆ $firstEmailAddress

ilMailOptions::$firstEmailAddress = ''

protected

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

Referenced by getExternalEmailAddresses().

◆ $ilias

ilMailOptions::$ilias

protected

Definition at line 23 of file class.ilMailOptions.php.

◆ $incomingType

ilMailOptions::$incomingType = self::INCOMING_LOCAL

protected

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

Referenced by getIncomingType(), and setIncomingType().

◆ $isCronJobNotificationEnabled

ilMailOptions::$isCronJobNotificationEnabled = false

protected

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

Referenced by isCronJobNotificationEnabled(), and setIsCronJobNotificationStatus().

◆ $linebreak

ilMailOptions::$linebreak = 0

protected

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

Referenced by getLinebreak(), and setLinebreak().

◆ $mailTransportSettings

ilMailOptions::$mailTransportSettings

protected

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

Referenced by __construct().

◆ $secondEmailAddress

ilMailOptions::$secondEmailAddress = ''

protected

Definition at line 51 of file class.ilMailOptions.php.

Referenced by getExternalEmailAddresses().

◆ $settings

ilMailOptions::$settings

protected

Definition at line 29 of file class.ilMailOptions.php.

Referenced by __construct().

◆ $signature

ilMailOptions::$signature = ''

protected

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

Referenced by getSignature(), and setSignature().

◆ $table_mail_options

ilMailOptions::$table_mail_options = 'mail_options'

protected

Definition at line 31 of file class.ilMailOptions.php.

◆ $usrId

ilMailOptions::$usrId = 0

protected

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

Referenced by __construct(), and lookupNotificationSetting().

◆ BOTH_EMAIL

const ilMailOptions::BOTH_EMAIL = 5

Definition at line 18 of file class.ilMailOptions.php.

Referenced by ilIncomingMailInputGUI\addSubOptions(), and getExternalEmailAddresses().

◆ DEFAULT_LINE_BREAK

const ilMailOptions::DEFAULT_LINE_BREAK = 60

Definition at line 20 of file class.ilMailOptions.php.

Referenced by __construct(), and ilMailOptionsTest\testConstructor().

◆ FIRST_EMAIL

const ilMailOptions::FIRST_EMAIL = 3

Definition at line 16 of file class.ilMailOptions.php.

Referenced by __construct(), ilIncomingMailInputGUI\addSubOptions(), ilMailTransportSettings\adjust(), getExternalEmailAddresses(), ilObjMailGUI\populateGeneralSettingsForm(), read(), and ilObjMailGUI\saveObject().

◆ INCOMING_BOTH

const ilMailOptions::INCOMING_BOTH = 2

Definition at line 14 of file class.ilMailOptions.php.

Referenced by ilIncomingMailInputGUI\addSubOptions(), ilMailOptionsFormGUI\save(), ilObjMailGUI\saveObject(), and ilMail\sendChanneledMails().

◆ INCOMING_EMAIL

const ilMailOptions::INCOMING_EMAIL = 1

Definition at line 13 of file class.ilMailOptions.php.

Referenced by ilIncomingMailInputGUI\addSubOptions(), ilMailOptionsFormGUI\save(), ilObjMailGUI\saveObject(), ilMail\sendChanneledMails(), and ilMailTest\testExternalMailDeliveryToLocalRecipientsWorksAsExpected().

◆ INCOMING_LOCAL

const ilMailOptions::INCOMING_LOCAL = 0

Definition at line 12 of file class.ilMailOptions.php.

Referenced by __construct(), ilIncomingMailInputGUI\addSubOptions(), ilMailTransportSettings\adjust(), read(), ilMailAddressTypeHelperImpl\receivesInternalMailsOnly(), ilAuthProviderECS\resetMailOptions(), and ilMailOptionsTest\testConstructor().

◆ SECOND_EMAIL

const ilMailOptions::SECOND_EMAIL = 4

Definition at line 17 of file class.ilMailOptions.php.

Referenced by ilIncomingMailInputGUI\addSubOptions(), ilMailTransportSettings\adjust(), and getExternalEmailAddresses().

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

Services/Mail/classes/class.ilMailOptions.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ createMailOptionsEntry()

◆ getEmailAddressMode()

◆ getExternalEmailAddresses()

◆ getIncomingType()

◆ getLinebreak()

◆ getSignature()

◆ isCronJobNotificationEnabled()

◆ lookupNotificationSetting()

◆ mayManageInvididualSettings()

◆ mayModifyIndividualTransportSettings()

◆ maySeeIndividualTransportSettings()

◆ read()

◆ setEmailAddressMode()

◆ setIncomingType()

◆ setIsCronJobNotificationStatus()

◆ setLinebreak()

◆ setSignature()

◆ updateOptions()

Field Documentation

◆ $db

◆ $default_email_address_mode

◆ $default_incoming_type

◆ $emailAddressMode

◆ $firstEmailAddress

◆ $ilias

◆ $incomingType

◆ $isCronJobNotificationEnabled

◆ $linebreak

◆ $mailTransportSettings

◆ $secondEmailAddress

◆ $settings

◆ $signature

◆ $table_mail_options

◆ $usrId

◆ BOTH_EMAIL

◆ DEFAULT_LINE_BREAK

◆ FIRST_EMAIL

◆ INCOMING_BOTH

◆ INCOMING_EMAIL

◆ INCOMING_LOCAL

◆ SECOND_EMAIL