ilMailTemplateContext Class Reference

Class ilMailTemplateContext. More...

Inheritance diagram for ilMailTemplateContext:

Collaboration diagram for ilMailTemplateContext:

Public Member Functions
	setLanguage ($language)
	getId ()
	Returns a unique (in the context of mail template contexts) id. More...
	getTitle ()
	Returns a translated title (depending on the current language) which is displayed in the user interface. More...
	getDescription ()
	Returns a translated description (depending on the current language) which is displayed in the user interface. More...
	getPlaceholders ()
	Return an array of placeholders. More...
	getSpecificPlaceholders ()
	Return an array of placeholders. More...
	resolveSpecificPlaceholder ($placeholder_id, array $context_parameters, ilObjUser $recipient=null, $html_markup=false)
	resolvePlaceholder ($placeholder_id, array $context_parameters, ilObjUser $recipient=null, $html_markup=false)

Protected Member Functions
	initLanguage (ilObjUser $user)
	initLanguageByIso2Code ($a_code)
	Init language by ISO2 code. More...

Protected Attributes
	$language

Detailed Description

Class ilMailTemplateContext.

Author

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

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

Member Function Documentation

getDescription()

ilMailTemplateContext::getDescription ( )

abstract

Returns a translated description (depending on the current language) which is displayed in the user interface.

Returns

string

Reimplemented in ilCourseMailTemplateMemberContext, ilCourseMailTemplateTutorContext, and ilScormMailTemplateLPContext.

getId()

ilMailTemplateContext::getId ( )

abstract

Returns a unique (in the context of mail template contexts) id.

Returns

string

Reimplemented in ilCourseMailTemplateMemberContext, ilCourseMailTemplateTutorContext, ilScormMailTemplateLPContext, and ilMailTemplateGenericContext.

Referenced by ilMailTemplateService\createEntry().

Here is the caller graph for this function:

getPlaceholders()

ilMailTemplateContext::getPlaceholders ( )

final

Return an array of placeholders.

Returns

array

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

        {
                $placeholders = self::getGenericPlaceholders();
                $specific     = $this->getSpecificPlaceholders();
 
                return $placeholders + $specific;
        }

References getSpecificPlaceholders().

Here is the call graph for this function:

getSpecificPlaceholders()

ilMailTemplateContext::getSpecificPlaceholders ( )

abstract

Return an array of placeholders.

Returns

array

Reimplemented in ilMailTemplateGenericContext.

Referenced by getPlaceholders().

Here is the caller graph for this function:

getTitle()

ilMailTemplateContext::getTitle ( )

abstract

Returns a translated title (depending on the current language) which is displayed in the user interface.

Returns

string

Reimplemented in ilCourseMailTemplateMemberContext, ilCourseMailTemplateTutorContext, and ilScormMailTemplateLPContext.

initLanguage()

ilMailTemplateContext::initLanguage ( ilObjUser  $user )

protected

Parameters

ilObjUser

$user

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

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

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

Referenced by resolvePlaceholder().

Here is the call graph for this function:

Here is the caller graph for this function:

initLanguageByIso2Code()

ilMailTemplateContext::initLanguageByIso2Code (   $a_code )

protected

Init language by ISO2 code.

Parameters

string

$a_code

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

        {
                $this->language = ilLanguageFactory::_getLanguage($a_code);
                $this->language->loadLanguageModule('mail');
        }

References ilLanguageFactory\_getLanguage().

Referenced by initLanguage().

Here is the call graph for this function:

Here is the caller graph for this function:

resolvePlaceholder()

ilMailTemplateContext::resolvePlaceholder	(		$placeholder_id,
		array	$context_parameters,
		ilObjUser	$recipient = null,
			$html_markup = false
	)

Parameters

string	$placeholder_id	The unique (in the context of your class) placeholder id
array	$context_parameters	The context parameters given by the mail system (array of key/value pairs)
ilObjUser | null	$recipient	The recipient for this mail
bool	$html_markup	A flag whether or not the return value may contain HTML markup

Returns

string

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

        {
                if($recipient !== null)
                {
                        $this->initLanguage($recipient);
                }
 
                $old_lang = ilDatePresentation::getLanguage();
                ilDatePresentation::setLanguage($this->getLanguage());
 
                $resolved = '';
 
                switch(true)
                {
                        case ('mail_salutation' == $placeholder_id && $recipient !== null):
                                switch($recipient->getGender())
                                {
                                        case 'f':
                                                $resolved = $this->getLanguage()->txt('salutation_f');
                                                break;
 
                                        case 'm':
                                                $resolved = $this->getLanguage()->txt('salutation_m');
                                                break;
 
                                        default:
                                                $resolved = $this->getLanguage()->txt('salutation');
                                }
                                break;
                        
                        case ('first_name' == $placeholder_id && $recipient !== null):
                                $resolved = $recipient->getFirstname();
                                break;
 
                        case ('last_name' == $placeholder_id && $recipient !== null):
                                $resolved = $recipient->getLastname();
                                break;
 
                        case ('login' == $placeholder_id && $recipient !== null):
                                $resolved = $recipient->getLogin();
                                break;
                        
                        case 'ilias_url' == $placeholder_id:
                                $resolved = ILIAS_HTTP_PATH . '/login.php?client_id=' . CLIENT_ID;
                                break;
 
                        case 'client_name' == $placeholder_id:
                                $resolved = CLIENT_NAME;
                                break;
 
                        case !in_array($placeholder_id, array_keys(self::getGenericPlaceholders())):
                                $resolved = $this->resolveSpecificPlaceholder($placeholder_id, $context_parameters, $recipient, $html_markup);
                                break;
                }
 
                ilDatePresentation::setLanguage($old_lang);
 
                return $resolved;
        }

References ilDatePresentation\getLanguage(), initLanguage(), resolveSpecificPlaceholder(), and ilDatePresentation\setLanguage().

Here is the call graph for this function:

resolveSpecificPlaceholder()

ilMailTemplateContext::resolveSpecificPlaceholder (   $placeholder_id, array  $context_parameters, ilObjUser  $recipient = null,   $html_markup = false  )

abstract

Parameters

string	$placeholder_id
array	$context_parameters
ilObjUser | null	$recipient
bool	$html_markup

Returns

string

Reimplemented in ilMailTemplateGenericContext.

Referenced by resolvePlaceholder().

Here is the caller graph for this function:

setLanguage()

ilMailTemplateContext::setLanguage

(

$language

)

Parameters

ilLanguage | null

$language

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

        {
                $this->language = $language;
        }

References $language.

Field Documentation

$language

ilMailTemplateContext::$language

protected

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

Referenced by setLanguage().

---

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

• Services/Mail/classes/class.ilMailTemplateContext.php