Inheritance diagram for ilMailTemplateContext:

Collaboration diagram for ilMailTemplateContext:

Public Member Functions
	__construct (?OrgUnitUserService $org_unit_user_service=null, ?ilMailEnvironmentHelper $environment_helper=null, ?ilMailUserHelper $user_helper=null, ?ilMailLanguageHelper $language_helper=null)

	getLanguage ()

	getId ()

	getTitle ()

	getDescription ()

	getNestedPlaceholders ()

	getPlaceholders ()

	getSpecificPlaceholders ()

	resolveSpecificPlaceholder (string $placeholder_id, array $context_parameters, ?ilObjUser $recipient=null)

	resolvePlaceholder (string $placeholder_id, array $context_parameters, ?ilObjUser $recipient=null)

Protected Member Functions
	initLanguage (ilObjUser $user)

	initLanguageByIso2Code (string $iso_code)

Protected Attributes
ilLanguage	$language

ilMailEnvironmentHelper	$env_helper

ilMailLanguageHelper	$language_helper

ilMailUserHelper	$user_helper

OrgUnitUserService	$org_unit_user_service

Private Member Functions
	getGenericPlaceholders ()

Detailed Description

Definition at line 24 of file class.ilMailTemplateContext.php.

Constructor & Destructor Documentation

◆ __construct()

ilMailTemplateContext::__construct	(	?OrgUnitUserService	$org_unit_user_service = `null`,
		?ilMailEnvironmentHelper	$environment_helper = `null`,
		?ilMailUserHelper	$user_helper = `null`,
		?ilMailLanguageHelper	$language_helper = `null`
	)

Definition at line 32 of file class.ilMailTemplateContext.php.

       {
         $this->org_unit_user_service = $org_unit_user_service ?? new OrgUnitUserService();
         $this->env_helper = $environment_helper ?? new ilMailEnvironmentHelper();
         $this->user_helper = $user_helper ?? new ilMailUserHelper();
         $this->language_helper = $language_helper ?? new ilMailLanguageHelper();
     }

Member Function Documentation

◆ getDescription()

ilMailTemplateContext::getDescription ( )

abstract

Referenced by getLanguage().

Here is the caller graph for this function:

◆ getGenericPlaceholders()

ilMailTemplateContext::getGenericPlaceholders ( )

private

Returns: array{mail_salutation: array{placeholder: string, label: string, supportsNestedPlaceholders?: true}, first_name: array{placeholder: string, label: string}, last_name: array{placeholder: string, label: string}, login: array{placeholder: string, label: string}, title: array{placeholder: string, label: string, supportsCondition: true}, firstname_lastname_superior: array{placeholder: string, label: string}, ilias_url: array{placeholder: string, label: string}, installation_name: array{placeholder: string, label: string}}

Definition at line 58 of file class.ilMailTemplateContext.php.

References getLanguage().

Referenced by getPlaceholders(), and resolvePlaceholder().

                                              : array
     {
         return [
             'mail_salutation' => [
                 'placeholder' => 'MAIL_SALUTATION',
                 'label' => $this->getLanguage()->txt('mail_nacc_salutation'),
                 'supportsNestedPlaceholders' => true,
             ],
             'first_name' => [
                 'placeholder' => 'FIRST_NAME',
                 'label' => $this->getLanguage()->txt('firstname'),
             ],
             'last_name' => [
                 'placeholder' => 'LAST_NAME',
                 'label' => $this->getLanguage()->txt('lastname'),
             ],
             'login' => [
                 'placeholder' => 'LOGIN',
                 'label' => $this->getLanguage()->txt('mail_nacc_login'),
             ],
             'title' => [
                 'placeholder' => 'TITLE',
                 'label' => $this->getLanguage()->txt('mail_nacc_title'),
                 'supportsCondition' => true,
             ],
             'firstname_lastname_superior' => [
                 'placeholder' => 'FIRSTNAME_LASTNAME_SUPERIOR',
                 'label' => $this->getLanguage()->txt('mail_firstname_last_name_superior'),
             ],
             'ilias_url' => [
                 'placeholder' => 'ILIAS_URL',
                 'label' => $this->getLanguage()->txt('mail_nacc_ilias_url'),
             ],
             'installation_name' => [
                 'placeholder' => 'INSTALLATION_NAME',
                 'label' => $this->getLanguage()->txt('mail_nacc_installation_name'),
             ],
         ];
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getId()

ilMailTemplateContext::getId ( )

abstract

Referenced by ilMailTemplateContextService\createEntry(), and getLanguage().

Here is the caller graph for this function:

◆ getLanguage()

ilMailTemplateContext::getLanguage ( )

Definition at line 44 of file class.ilMailTemplateContext.php.

References getDescription(), getId(), getTitle(), and ILIAS\UI\examples\Symbol\Glyph\Language\language().

Referenced by ilCourseMailTemplateTutorContext\getCachedPeriodByObjId(), ilMailTemplateGenericContext\getDescription(), ilScormMailTemplateLPContext\getDescription(), getGenericPlaceholders(), ilMailTemplateGenericContext\getTitle(), and resolvePlaceholder().

                                  : ilLanguage
     {
         return $this->language ?? $this->language_helper->getCurrentLanguage();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNestedPlaceholders()

ilMailTemplateContext::getNestedPlaceholders ( )

Returns: list<string>

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

References getPlaceholders().

                                            : array
     {
         $nested_placeholders = [];
         foreach ($this->getPlaceholders() as $key => $ph) {
             if (isset($ph['supportsNestedPlaceholders']) && $ph['supportsNestedPlaceholders']) {
                 $nested_placeholders[] = $ph['placeholder'];
             }
         }
 
         return $nested_placeholders;
     }

Here is the call graph for this function:

◆ getPlaceholders()

ilMailTemplateContext::getPlaceholders ( )

final

Returns: array<string, array{placeholder: string, crs_period_end_mail_placeholder: string}>

Definition at line 116 of file class.ilMailTemplateContext.php.

References getGenericPlaceholders(), getSpecificPlaceholders(), null, and resolveSpecificPlaceholder().

Referenced by getNestedPlaceholders().

                                            : array
     {
         $placeholders = $this->getGenericPlaceholders();
         $specific = $this->getSpecificPlaceholders();
 
         return array_merge($placeholders, $specific);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSpecificPlaceholders()

ilMailTemplateContext::getSpecificPlaceholders ( )

abstract

Returns: array<string, array{placeholder: string, crs_period_end_mail_placeholder: string}>

Referenced by ilScormMailTemplateLPContext\getDescription(), ilCourseMailTemplateTutorContext\getDescription(), ilCourseMailTemplateMemberContext\getDescription(), ilSurveyMailTemplateReminderContext\getDescription(), and getPlaceholders().

Here is the caller graph for this function:

◆ getTitle()

ilMailTemplateContext::getTitle ( )

abstract

Referenced by getLanguage().

Here is the caller graph for this function:

◆ initLanguage()

ilMailTemplateContext::initLanguage ( ilObjUser $user )

protected

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

References ilObjUser\getLanguage(), and initLanguageByIso2Code().

Referenced by resolvePlaceholder().

                                                     : void
     {
         $this->initLanguageByIso2Code($user->getLanguage());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initLanguageByIso2Code()

ilMailTemplateContext::initLanguageByIso2Code ( string $iso_code )

protected

Definition at line 230 of file class.ilMailTemplateContext.php.

References ILIAS\UI\examples\Symbol\Glyph\Language\language().

Referenced by initLanguage().

                                                                : void
     {
         $this->language = $this->language_helper->getLanguageByIsoCode($iso_code);
         $this->language->loadLanguageModule('mail');
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resolvePlaceholder()

ilMailTemplateContext::resolvePlaceholder	(	string	$placeholder_id,
		array	$context_parameters,
		?ilObjUser	$recipient = `null`
	)

Parameters

array<string,mixed> $context_parameters

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

References getGenericPlaceholders(), getLanguage(), ilDatePresentation\getLanguage(), OrgUnit\User\ilOrgUnitUser\getUserId(), initLanguage(), null, resolveSpecificPlaceholder(), and ilDatePresentation\setLanguage().

      : string {
         if ($recipient !== null) {
             $this->initLanguage($recipient);
         }
 
         $placeholder_id = strtolower($placeholder_id);
         $resolved = '';
         switch (true) {
             case ($placeholder_id === 'mail_salutation' && $recipient !== null):
                 $resolved = $this->getLanguage()->txt('mail_salutation_n');
                 switch ($recipient->getGender()) {
                     case 'f':
                         $resolved = $this->getLanguage()->txt('mail_salutation_f');
                         break;
 
                     case 'm':
                         $resolved = $this->getLanguage()->txt('mail_salutation_m');
                         break;
 
                     case 'n':
                         $resolved = $this->getLanguage()->txt('mail_salutation_n');
                         break;
                 }
                 break;
 
             case ($placeholder_id === 'first_name' && $recipient !== null):
                 $resolved = $recipient->getFirstname();
                 break;
 
             case ($placeholder_id === 'last_name' && $recipient !== null):
                 $resolved = $recipient->getLastname();
                 break;
 
             case ($placeholder_id === 'login' && $recipient !== null):
                 $resolved = $recipient->getLogin();
                 break;
 
             case ($placeholder_id === 'title' && $recipient !== null):
                 $resolved = $recipient->getUTitle();
                 break;
 
             case $placeholder_id === 'ilias_url':
                 $resolved = $this->env_helper->getHttpPath() . ' ';
                 break;
 
             case $placeholder_id === 'installation_name':
                 $resolved = $this->env_helper->getClientId();
                 break;
 
             case $placeholder_id === 'firstname_lastname_superior' && $recipient !== null:
                 $ou_users = $this->org_unit_user_service->getUsers([$recipient->getId()], true);
                 foreach ($ou_users as $ou_user) {
                     $superiors = $ou_user->getSuperiors();
 
                     $superior_usr_ids = array_map(static fn(ilOrgUnitUser $ou_user): int => $ou_user->getUserId(), $superiors);
 
                     $usr_id_by_name_map = $this->user_helper->getUsernameMapForIds($superior_usr_ids);
 
                     $resolved = implode(', ', $usr_id_by_name_map);
                     break;
                 }
                 break;
 
             case !array_key_exists($placeholder_id, $this->getGenericPlaceholders()):
                 $date_presentation_language = ilDatePresentation::getLanguage();
                 ilDatePresentation::setLanguage($this->getLanguage());
 
                 $resolved = $this->resolveSpecificPlaceholder(
                     $placeholder_id,
                     $context_parameters,
                     $recipient
                 );
 
                 ilDatePresentation::setLanguage($date_presentation_language);
                 break;
         }
 
         return $resolved;
     }