Inheritance diagram for ilForumMailNotification:

Collaboration diagram for ilForumMailNotification:

Public Member Functions
	__construct (ilForumNotificationMailData $provider, \ilLogger $logger)
	ilForumMailNotification constructor. More...

	sendMail (array $a_rcp, $a_parse_recipients=true)

	send ()

	isCronjob ()

	setIsCronjob ($is_cronjob)

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

	setType ($a_type)
	Set notification type. More...

	getType ()
	Get notification type. More...

	setSender ($a_usr_id)
	Set sender of mail. More...

	getSender ()
	get sender of mail More...

	setRecipients (array $a_rcp)

	getRecipients ()
	get array of recipients More...

	setAttachments ($a_att)
	Set attachments. More...

	getAttachments ()
	Get attachments. More...

	setLangModules (array $a_modules)
	Set lang modules. More...

	getUserLanguage ($a_usr_id)
	Get user language. More...

	setRefId ($a_id)

	getRefId ()

	getObjId ()

	setObjId ($a_obj_id)

	getObjType ()
	Get object type. More...

	setAdditionalInformation (array $a_info)
	Additional information for creating notification mails. More...

	getAdditionalInformation ()

	sendMail (array $a_rcp, $a_parse_recipients=true)

	getBlockBorder ()
	Get (ascii) block border. More...

Data Fields
const	TYPE_THREAD_DELETED = 54

const	TYPE_POST_NEW = 60

const	TYPE_POST_ACTIVATION = 61

const	TYPE_POST_UPDATED = 62

const	TYPE_POST_CENSORED = 63

const	TYPE_POST_DELETED = 64

const	TYPE_POST_ANSWERED = 65

const	TYPE_POST_UNCENSORED = 66

const	PERMANENT_LINK_POST = 'PL_Post'

const	PERMANENT_LINK_FORUM = 'PL_Forum'

Data Fields inherited from ilMailNotification
const	SUBJECT_TITLE_LENGTH = 60

Protected Member Functions
	initMail ()

	setSubject ($a_subject)

	appendAttachments ()

	initLanguage ($a_usr_id)

Protected Member Functions inherited from ilMailNotification
	setSubject ($a_subject)

	getSubject ()

	setBody ($a_body)

	appendBody ($a_body)
	Append body text. More...

	getBody ()

	initLanguage ($a_usr_id)
	Init language. More...

	initLanguageByIso2Code ($a_code='')
	Init language by ISO2 code. More...

	setLanguage ($a_language)

	getLanguage ()

	getLanguageText ($a_keyword)

	getObjectTitle ($a_shorten=false)

	initMail ()

	getMail ()

	createPermanentLink ($a_params=array(), $a_append='')

	userToString ($a_usr_id)

	isRefIdAccessible ($a_user_id, $a_ref_id, $a_permission="read")
	Check if ref id is accessible for user. More...

Protected Attributes
	$is_cronjob = false

	$provider

	$logger

Protected Attributes inherited from ilMailNotification
	$type = null

	$sender = null

	$mail = null

	$subject = ''

	$body = ''

	$attachments = array()

	$language = null

	$lang_modules = array()

	$recipients = array()

	$ref_id = null

	$obj_id = null

	$obj_type = null

	$additional_info = array()

	$is_in_wsp

	$wsp_tree

	$wsp_access_handler

Private Member Functions
	getPermanentLink ($type=self::PERMANENT_LINK_POST)

	getSecurePostMessage ()

	sendMailWithAttachments (string $subjectLanguageId, int $userId, string $customText, string $action, string $date='')
	Add body and send mail with attachments. More...

	sendMailWithoutAttachments (string $subjectLanguageId, int $userId, string $customText, string $action, string $date='')
	Add body and send mail without attachments. More...

	createMail (string $subject, int $userId, string $customText, string $action, string $date)

	addMailSubject (string $subject)

	createMailDate (string $date)

	addLinkToMail ()

Detailed Description

Author: Nadia Matuschek nmatu.nosp@m.sche.nosp@m.k@dat.nosp@m.abay.nosp@m..de

Version: $Id$

Definition at line 9 of file class.ilForumMailNotification.php.

Constructor & Destructor Documentation

◆ __construct()

ilForumMailNotification::__construct	(	ilForumNotificationMailData	$provider,
		\ilLogger	$logger
	)

ilForumMailNotification constructor.

Parameters

ilForumNotificationMailData	$provider
ilLogger	$logger

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

References $logger, $provider, and ILIAS\GlobalScreen\Provider\__construct().

     {
         parent::__construct(false);
         $this->provider = $provider;
         $this->logger = $logger;
     }

Here is the call graph for this function:

Member Function Documentation

◆ addLinkToMail()

ilForumMailNotification::addLinkToMail ( )

private

Definition at line 424 of file class.ilForumMailNotification.php.

References ilMail\_getInstallationSignature(), ilMailNotification\appendBody(), and getPermanentLink().

Referenced by sendMailWithAttachments(), and sendMailWithoutAttachments().

     {
         $this->appendBody($this->getPermanentLink());
         $this->appendBody(ilMail::_getInstallationSignature());
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addMailSubject()

ilForumMailNotification::addMailSubject ( string $subject )

private

Definition at line 391 of file class.ilForumMailNotification.php.

References ilMailNotification\getLanguageText(), initMail(), and setSubject().

Referenced by createMail().

     {
         $this->initMail();
 
         $this->setSubject(sprintf(
             $this->getLanguageText($subject),
             $this->provider->getForumTitle(),
             $this->provider->getThreadTitle()
         ));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ appendAttachments()

ilForumMailNotification::appendAttachments ( )

protected

Definition at line 87 of file class.ilForumMailNotification.php.

References ilMailNotification\appendBody(), ilMailNotification\getLanguageText(), and ilMailNotification\setAttachments().

Referenced by sendMailWithAttachments().

     {
         if (count($this->provider->getAttachments()) > 0) {
             $this->logger->debug('Adding attachments ...');
             foreach ($this->provider->getAttachments() as $attachment) {
                 $this->appendBody($this->getLanguageText('attachment') . ": " . $attachment . "\n");
             }
             $this->appendBody("\n------------------------------------------------------------\n");
             $this->setAttachments($this->provider->getAttachments());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createMail()

ilForumMailNotification::createMail	(	string	$subject,
		int	$userId,
		string	$customText,
		string	$action,
		string	$date
	)

private

Definition at line 347 of file class.ilForumMailNotification.php.

References $message, addMailSubject(), ilMailNotification\appendBody(), createMailDate(), ilMailNotification\getLanguage(), ilMailNotification\getLanguageText(), ilMail\getSalutation(), getSecurePostMessage(), and ilMailNotification\setBody().

Referenced by sendMailWithAttachments(), and sendMailWithoutAttachments().

       {
         $date = $this->createMailDate($date);
 
         $this->addMailSubject($subject);
 
         $this->setBody(ilMail::getSalutation($userId, $this->getLanguage()));
         $this->appendBody("\n\n");
         $this->appendBody($customText);
         $this->appendBody("\n\n");
         $this->appendBody($this->getLanguageText('forum') . ": " . $this->provider->getForumTitle());
         $this->appendBody("\n\n");
         $this->appendBody($this->getLanguageText('thread') . ": " . $this->provider->getThreadTitle());
         $this->appendBody("\n\n");
         $this->appendBody($this->getLanguageText($action) . ": \n------------------------------------------------------------\n");
 
         $this->appendBody($this->getLanguageText('author') . ": " . $this->provider->getPostUserName($this->getLanguage()));
         $this->appendBody("\n");
         $this->appendBody($this->getLanguageText('date') . ": " . $date);
         $this->appendBody("\n");
         $this->appendBody($this->getLanguageText('subject') . ": " . $this->provider->getPostTitle());
         $this->appendBody("\n");
         $this->appendBody($this->getLanguageText('frm_noti_message'));
         $this->appendBody("\n");
 
         $message = strip_tags($this->getSecurePostMessage());
 
         if ($this->provider->getPostCensored() == 1) {
             $message = $this->provider->getCensorshipComment();
         }
 
         $this->appendBody($message . "\n");
         $this->appendBody("------------------------------------------------------------\n");
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createMailDate()

ilForumMailNotification::createMailDate ( string $date )

private

Definition at line 408 of file class.ilForumMailNotification.php.

References ilDatePresentation\formatDate(), IL_CAL_DATETIME, language(), and ilDatePresentation\setLanguage().

Referenced by createMail().

                                                   : string
     {
         ilDatePresentation::setLanguage($this->language);
 
         if ($date === '') {
             $date = $this->provider->getPostDate();
         }
 
         $date = ilDatePresentation::formatDate(new ilDateTime($date, IL_CAL_DATETIME));
 
         return $date;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPermanentLink()

ilForumMailNotification::getPermanentLink ( $type = self::PERMANENT_LINK_POST )

private

Parameters

string $type

Returns: string

Definition at line 227 of file class.ilForumMailNotification.php.

References $DIC, ilMailNotification\$type, ilUtil\_getHttpPath(), ilMailNotification\getLanguageText(), and isCronjob().

Referenced by addLinkToMail().

     {
         global $DIC;
         $ilClientIniFile = $DIC['ilClientIniFile'];
 
         if ($type == self::PERMANENT_LINK_FORUM) {
             $language_text = $this->getLanguageText("forums_notification_show_frm");
             $forum_parameters = $this->provider->getRefId();
         } else {
             $language_text = $this->getLanguageText("forums_notification_show_post");
             $forum_parameters = $this->provider->getRefId() . "_" . $this->provider->getThreadId() . "_" . $this->provider->getPostId();
         }
 
         $this->logger->debug(sprintf(
             'Building permanent with parameters %s',
             $forum_parameters
         ));
 
         if ($this->isCronjob()) {
             $posting_link = sprintf(
                 $language_text,
                 ilUtil::_getHttpPath() . "/goto.php?target=frm_" . $forum_parameters . '&client_id=' . CLIENT_ID
             ) . "\n\n";
 
             $posting_link .= sprintf(
                 $this->getLanguageText("forums_notification_intro"),
                 $ilClientIniFile->readVariable("client", "name"),
                 ilUtil::_getHttpPath() . '/?client_id=' . CLIENT_ID
             ) . "\n\n";
         } else {
             $posting_link = sprintf(
                 $language_text,
                 ilUtil::_getHttpPath() . "/goto.php?target=frm_" . $forum_parameters . '&client_id=' . CLIENT_ID
             ) . "\n\n";
 
             $posting_link .= sprintf(
                 $this->getLanguageText("forums_notification_intro"),
                 $ilClientIniFile->readVariable("client", "name"),
                 ilUtil::_getHttpPath() . '/?client_id=' . CLIENT_ID
             ) . "\n\n";
         }
 
         $this->logger->debug(sprintf(
             'Link built: %s',
             $posting_link
         ));
 
         return $posting_link;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSecurePostMessage()

ilForumMailNotification::getSecurePostMessage ( )

private

Returns: string

Definition at line 280 of file class.ilForumMailNotification.php.

Referenced by createMail().

     {
         $pos_message = $this->provider->getPostMessage();
         if (strip_tags($pos_message) != $pos_message) {
             $pos_message = preg_replace("/\n/i", "", $pos_message);
             $pos_message = preg_replace("/<li([^>]*)>/i", "\n<li$1>", $pos_message);
             $pos_message = preg_replace("/<\/ul([^>]*)>(?!\s*?(<p|<ul))/i", "</ul$1>\n", $pos_message);
             $pos_message = preg_replace("/<br(\s*)(\/?)>/i", "\n", $pos_message);
             $pos_message = preg_replace("/<p([^>]*)>/i", "\n\n", $pos_message);
             $pos_message = preg_replace("/<\/p([^>]*)>/i", '', $pos_message);
             return $pos_message;
         }
         return strip_tags($pos_message);
     }

Here is the caller graph for this function:

◆ initLanguage()

ilForumMailNotification::initLanguage ( $a_usr_id )

protected

Parameters

int $a_usr_id

Definition at line 201 of file class.ilForumMailNotification.php.

References language().

Referenced by send().

     {
         parent::initLanguage($a_usr_id);
         $this->language->loadLanguageModule('forum');
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ initMail()

ilForumMailNotification::initMail ( )

protected

Definition at line 54 of file class.ilForumMailNotification.php.

References ilMailNotification\$mail.

Referenced by addMailSubject().

     {
         $mail = parent::initMail();
         $this->logger->debug('Initialized mail service');
         return $mail;
     }

Here is the caller graph for this function:

◆ isCronjob()

ilForumMailNotification::isCronjob ( )

Returns: boolean

Definition at line 210 of file class.ilForumMailNotification.php.

References $is_cronjob.

Referenced by getPermanentLink().

     {
         return (bool) $this->is_cronjob;
     }

Here is the caller graph for this function:

◆ send()

ilForumMailNotification::send ( )

Returns: bool

Definition at line 102 of file class.ilForumMailNotification.php.

References $DIC, $ilSetting, $lng, ilMailNotification\getLanguageText(), ilMailNotification\getRecipients(), ilMailNotification\getType(), initLanguage(), sendMailWithAttachments(), sendMailWithoutAttachments(), ilDatePresentation\setLanguage(), ilDatePresentation\setUseRelativeDates(), and ilDatePresentation\useRelativeDates().

     {
         global $DIC;
         $ilSetting = $DIC->settings();
         $lng = $DIC->language();
 
         if (!$ilSetting->get('forum_notification', 0)) {
             $this->logger->debug('Forum notifications are globally disabled');
             return false;
         }
 
         if (!$this->getRecipients()) {
             $this->logger->debug('No notification recipients, nothing to do');
             return false;
         }
 
         $lng->loadLanguageModule('forum');
 
         $date_type = ilDatePresentation::useRelativeDates();
         ilDatePresentation::setUseRelativeDates(false);
 
         switch ($this->getType()) {
             case self::TYPE_THREAD_DELETED:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = sprintf($this->getLanguageText('thread_deleted_by'), $this->provider->getDeletedBy(), $this->provider->getForumTitle());
                     $this->sendMailWithoutAttachments('frm_noti_subject_del_thread', (int) $rcp, (string) $customText, 'content_deleted_thread');
                 }
                 break;
 
             case self::TYPE_POST_NEW:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = sprintf($this->getLanguageText('frm_noti_new_post'), $this->provider->getForumTitle());
                     $this->sendMailWithAttachments('frm_noti_subject_new_post', (int) $rcp, (string) $customText, 'new_post');
                 }
                 break;
 
             case self::TYPE_POST_ACTIVATION:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = $this->getLanguageText('forums_post_activation_mail');
                     $this->sendMailWithAttachments('frm_noti_subject_act_post', (int) $rcp, (string) $customText, 'new_post');
                 }
                 break;
 
             case self::TYPE_POST_ANSWERED:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = $this->getLanguageText('forum_post_replied');
                     $this->sendMailWithAttachments('frm_noti_subject_answ_post', (int) $rcp, (string) $customText, 'new_post');
                 }
                 break;
 
             case self::TYPE_POST_UPDATED:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = sprintf($this->getLanguageText('post_updated_by'), $this->provider->getPostUpdateUserName($this->getLanguage()), $this->provider->getForumTitle());
                     $date = $this->provider->getPostUpdate();
                     $this->sendMailWithAttachments('frm_noti_subject_upt_post', (int) $rcp, (string) $customText, 'content_post_updated', $date);
                 }
                 break;
 
             case self::TYPE_POST_CENSORED:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = sprintf($this->getLanguageText('post_censored_by'), $this->provider->getPostUpdateUserName($this->getLanguage()), $this->provider->getForumTitle());
                     $date = $this->provider->getPostCensoredDate();
                     $this->sendMailWithAttachments('frm_noti_subject_cens_post', (int) $rcp, (string) $customText, 'content_censored_post', $date);
                 }
                 break;
 
             case self::TYPE_POST_UNCENSORED:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = sprintf($this->getLanguageText('post_uncensored_by'), $this->provider->getPostUpdateUserName($this->getLanguage()));
                     $date = $this->provider->getPostCensoredDate();
                     $this->sendMailWithAttachments('frm_noti_subject_uncens_post', (int) $rcp, (string) $customText, 'forums_the_post', $date);
                 }
                 break;
 
             case self::TYPE_POST_DELETED:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $customText = sprintf($this->getLanguageText('post_deleted_by'), $this->provider->getDeletedBy(), $this->provider->getForumTitle());
                     $this->sendMailWithoutAttachments('frm_noti_subject_del_post', (int) $rcp, (string) $customText, 'content_deleted_post');
                 }
                 break;
         }
 
         ilDatePresentation::setLanguage($lng);
         ilDatePresentation::setUseRelativeDates($date_type);
 
         return true;
     }

Here is the call graph for this function:

◆ sendMail()

ilForumMailNotification::sendMail	(	array	$a_rcp,
			$a_parse_recipients = `true`
	)

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

Referenced by sendMailWithAttachments(), and sendMailWithoutAttachments().

     {
         $this->logger->debug(sprintf(
             'Delegating notification transport to mail service for recipients: %s',
             print_r($a_rcp, true)
         ));
         parent::sendMail($a_rcp, $a_parse_recipients);
         $this->logger->debug('Notification transport delegated');
     }

Here is the caller graph for this function:

◆ sendMailWithAttachments()

ilForumMailNotification::sendMailWithAttachments	(	string	$subjectLanguageId,
		int	$userId,
		string	$customText,
		string	$action,
		string	$date = `''`
	)

private

Add body and send mail with attachments.

Parameters

string	$subjectLanguageId	- Language id of subject
int	$userId	- id of the user recipient of the mail
string	$customText	- mail text after salutation
string	$action	- Language id of action
string \| null	$date	- date to be added in mail

Definition at line 304 of file class.ilForumMailNotification.php.

References addLinkToMail(), appendAttachments(), createMail(), and sendMail().

Referenced by send().

       {
         $this->createMail($subjectLanguageId, $userId, $customText, $action, $date);
         $this->appendAttachments();
         $this->addLinkToMail();
         $this->sendMail(array($userId));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sendMailWithoutAttachments()

ilForumMailNotification::sendMailWithoutAttachments	(	string	$subjectLanguageId,
		int	$userId,
		string	$customText,
		string	$action,
		string	$date = `''`
	)

private

Add body and send mail without attachments.

Parameters

string	$subjectLanguageId	- Language id of subject
int	$userId	- id of the user recipient of the mail
string	$customText	- mail text after salutation
string	$action	- Language id of action
string \| null	$date	- date to be added in mail

Definition at line 326 of file class.ilForumMailNotification.php.

References addLinkToMail(), createMail(), and sendMail().

Referenced by send().

       {
         $this->createMail($subjectLanguageId, $userId, $customText, $action, $date);
         $this->addLinkToMail();
         $this->sendMail(array($userId));
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setIsCronjob()

ilForumMailNotification::setIsCronjob ( $is_cronjob )

Parameters

boolean $is_cronjob

Definition at line 218 of file class.ilForumMailNotification.php.

References $is_cronjob.

     {
         $this->is_cronjob = (bool) $is_cronjob;
     }

◆ setSubject()

ilForumMailNotification::setSubject ( $a_subject )

protected

Definition at line 77 of file class.ilForumMailNotification.php.

Referenced by addMailSubject().

     {
         $value = parent::setSubject($a_subject);
         $this->logger->debug(sprintf('Setting subject to: %s', $a_subject));
         return $value;
     }

Here is the caller graph for this function: