df/d64/class_8ilGroupMembershipMailNotification_8php_source.html

 <?php
 /* Copyright (c) 1998-2009 ILIAS open source, Extended GPL, see docs/LICENSE */

 include_once './Services/Mail/classes/class.ilMailNotification.php';

 class ilGroupMembershipMailNotification extends ilMailNotification
 {
     // v Notifications affect members & co. v
     const TYPE_ADMISSION_MEMBER = 20;
     const TYPE_DISMISS_MEMBER = 21;

     const TYPE_ACCEPTED_SUBSCRIPTION_MEMBER = 22;
     const TYPE_REFUSED_SUBSCRIPTION_MEMBER = 23;

     const TYPE_STATUS_CHANGED = 24;

     const TYPE_BLOCKED_MEMBER = 25;
     const TYPE_UNBLOCKED_MEMBER = 26;

     const TYPE_UNSUBSCRIBE_MEMBER = 27;
     const TYPE_SUBSCRIBE_MEMBER = 28;
     const TYPE_WAITING_LIST_MEMBER = 29;

     // v Notifications affect admins v
     const TYPE_NOTIFICATION_REGISTRATION = 30;
     const TYPE_NOTIFICATION_REGISTRATION_REQUEST = 31;
     const TYPE_NOTIFICATION_UNSUBSCRIBE = 32;

     protected $permanent_enabled_notifications = array(
         self::TYPE_NOTIFICATION_REGISTRATION,
         self::TYPE_NOTIFICATION_REGISTRATION_REQUEST,
         self::TYPE_NOTIFICATION_UNSUBSCRIBE
     );

     private $force_sending_mail = false;


     public function __construct()
     {
         parent::__construct();
     }

     public function forceSendingMail($a_status)
     {
         $this->force_sending_mail = $a_status;
     }


     public function send()
     {
         global $DIC;

         $logger = $DIC->logger()->grp();

         if (!$this->isNotificationTypeEnabled($this->getType())) {
             $logger->info('Membership mail disabled globally.');
             return false;
         }

         if (
             $this->getType() == self::TYPE_ADMISSION_MEMBER
         ) {
             $obj = \ilObjectFactory::getInstanceByRefId($this->getRefId());
             if (!$obj instanceof \ilObjGroup) {
                 $logger->warning('Refid: ' . $this->getRefId() . ' is not of type grp.');
                 return false;
             }
             if (!$obj->getAutoNotification()) {
                 if (!$this->force_sending_mail) {
                     $logger->info('Sending welcome mail disabled locally.');
                     return false;
                 }
             }
         }

         // parent::send();

         switch ($this->getType()) {
             case self::TYPE_ADMISSION_MEMBER:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_admission_new_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('grp_mail_admission_new_bod'), $this->getObjectTitle())
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_mail_permanent_link'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink());
                     $this->getMail()->appendInstallationSignature(true);

                     $this->sendMail(array($rcp));
                 }
                 break;

             case self::TYPE_DISMISS_MEMBER:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_dismiss_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('grp_mail_dismiss_bod'), $this->getObjectTitle())
                     );
                     $this->getMail()->appendInstallationSignature(true);
                     $this->sendMail(array($rcp));
                 }
                 break;


             case self::TYPE_NOTIFICATION_REGISTRATION:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_notification_reg_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");

                     $info = $this->getAdditionalInformation();
                     $this->appendBody(
                         sprintf(
                             $this->getLanguageText('grp_mail_notification_reg_bod'),
                             $this->userToString($info['usr_id']),
                             $this->getObjectTitle()
                         )
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_mail_permanent_link'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink(array(), '_mem'));

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_notification_explanation_admin'));

                     $this->getMail()->appendInstallationSignature(true);
                     $this->sendMail(array($rcp));
                 }
                 break;

             case self::TYPE_UNSUBSCRIBE_MEMBER:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_unsubscribe_member_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('grp_mail_unsubscribe_member_bod'), $this->getObjectTitle())
                     );
                     $this->getMail()->appendInstallationSignature(true);
                     $this->sendMail(array($rcp));
                 }
                 break;

             case self::TYPE_NOTIFICATION_UNSUBSCRIBE:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_notification_unsub_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");

                     $info = $this->getAdditionalInformation();
                     $this->appendBody(
                         sprintf(
                             $this->getLanguageText('grp_mail_notification_unsub_bod'),
                             $this->userToString($info['usr_id']),
                             $this->getObjectTitle()
                         )
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_mail_notification_unsub_bod2'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink(array(), '_mem'));

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_notification_explanation_admin'));

                     $this->getMail()->appendInstallationSignature(true);
                     $this->sendMail(array($rcp));
                 }
                 break;


             case self::TYPE_SUBSCRIBE_MEMBER:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_subscribe_member_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('grp_mail_subscribe_member_bod'), $this->getObjectTitle())
                     );

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_mail_permanent_link'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink());
                     $this->getMail()->appendInstallationSignature(true);

                     $this->sendMail(array($rcp));
                 }
                 break;


             case self::TYPE_NOTIFICATION_REGISTRATION_REQUEST:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_notification_reg_req_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");

                     $info = $this->getAdditionalInformation();
                     $this->appendBody(
                         sprintf(
                             $this->getLanguageText('grp_mail_notification_reg_req_bod'),
                             $this->userToString($info['usr_id']),
                             $this->getObjectTitle()
                         )
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_mail_notification_reg_req_bod2'));
                     $this->appendBody("\n");
                     $this->appendBody($this->createPermanentLink(array(), '_mem'));

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_notification_explanation_admin'));

                     $this->getMail()->appendInstallationSignature(true);
                     $this->sendMail(array($rcp));
                 }
                 break;

             case self::TYPE_REFUSED_SUBSCRIPTION_MEMBER:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_sub_dec_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('grp_mail_sub_dec_bod'), $this->getObjectTitle())
                     );

                     $this->getMail()->appendInstallationSignature(true);

                     $this->sendMail(array($rcp));
                 }
                 break;

             case self::TYPE_ACCEPTED_SUBSCRIPTION_MEMBER:

                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_sub_acc_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('grp_mail_sub_acc_bod'), $this->getObjectTitle())
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_mail_permanent_link'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink());
                     $this->getMail()->appendInstallationSignature(true);

                     $this->sendMail(array($rcp));
                 }
                 break;

             case self::TYPE_WAITING_LIST_MEMBER:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_wl_sub'), $this->getObjectTitle(true))
                     );

                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));

                     $info = $this->getAdditionalInformation();
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf(
                             $this->getLanguageText('grp_mail_wl_bod'),
                             $this->getObjectTitle(),
                             $info['position']
                             )
                     );
                     $this->getMail()->appendInstallationSignature(true);
                     $this->sendMail(array($rcp));
                 }
                 break;


             case self::TYPE_STATUS_CHANGED:
                 foreach ($this->getRecipients() as $rcp) {
                     $this->initLanguage($rcp);
                     $this->initMail();
                     $this->setSubject(
                         sprintf($this->getLanguageText('grp_mail_status_sub'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('grp_mail_status_bod'), $this->getObjectTitle())
                     );

                     $this->appendBody("\n\n");
                     $this->appendBody($this->createGroupStatus($rcp));

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('grp_mail_permanent_link'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink());

                     $this->getMail()->appendInstallationSignature(true);

                     $this->sendMail(array($rcp));
                 }
                 break;

         }
         return true;
     }

     protected function initLanguage($a_usr_id)
     {
         parent::initLanguage($a_usr_id);
         $this->getLanguage()->loadLanguageModule('grp');
     }

     protected function createGroupStatus($a_usr_id)
     {
         $part = ilGroupParticipants::_getInstanceByObjId($this->getObjId());

         $body = $this->getLanguageText('grp_new_status') . "\n";
         $body .= $this->getLanguageText('role') . ': ';


         if ($part->isAdmin($a_usr_id)) {
             $body .= $this->getLanguageText('il_grp_admin') . "\n";
         } else {
             $body .= $this->getLanguageText('il_grp_member') . "\n";
         }

         if ($part->isAdmin($a_usr_id)) {
             $body .= $this->getLanguageText('grp_notification') . ': ';

             if ($part->isNotificationEnabled($a_usr_id)) {
                 $body .= $this->getLanguageText('grp_notify_on') . "\n";
             } else {
                 $body .= $this->getLanguageText('grp_notify_off') . "\n";
             }
         }
         return $body;
     }

     protected function isNotificationTypeEnabled($a_type)
     {
         global $DIC;

         $ilSetting = $DIC['ilSetting'];

         return
             $this->force_sending_mail ||
             $ilSetting->get('mail_grp_member_notification', true) ||
             in_array($a_type, $this->permanent_enabled_notifications);
     }
 }
ilMailNotification\getLanguage
getLanguage()
Definition: class.ilMailNotification.php:243

ilGroupMembershipMailNotification\isNotificationTypeEnabled
isNotificationTypeEnabled($a_type)
get setting "mail_grp_member_notification" and excludes types which are not affected by this setting ...
Definition: class.ilGroupMembershipMailNotification.php:434

ilMailNotification\getType
getType()
Get notification type.
Definition: class.ilMailNotification.php:77

ilGroupMembershipMailNotification\$force_sending_mail
$force_sending_mail
Definition: class.ilGroupMembershipMailNotification.php:46

ilGroupMembershipMailNotification\forceSendingMail
forceSendingMail($a_status)
Force sending mail independent from global setting.
Definition: class.ilGroupMembershipMailNotification.php:63

ilGroupMembershipMailNotification\TYPE_NOTIFICATION_REGISTRATION_REQUEST
const TYPE_NOTIFICATION_REGISTRATION_REQUEST
Definition: class.ilGroupMembershipMailNotification.php:32

ilGroupMembershipMailNotification\TYPE_NOTIFICATION_UNSUBSCRIBE
const TYPE_NOTIFICATION_UNSUBSCRIBE
Definition: class.ilGroupMembershipMailNotification.php:33

ilMailNotification\setBody
setBody($a_body)
Definition: class.ilMailNotification.php:120

ilGroupMembershipMailNotification\TYPE_ACCEPTED_SUBSCRIPTION_MEMBER
const TYPE_ACCEPTED_SUBSCRIPTION_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:18

ilGroupMembershipMailNotification\TYPE_STATUS_CHANGED
const TYPE_STATUS_CHANGED
Definition: class.ilGroupMembershipMailNotification.php:21

ilGroupMembershipMailNotification\TYPE_SUBSCRIBE_MEMBER
const TYPE_SUBSCRIBE_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:27

ilGroupMembershipMailNotification\TYPE_DISMISS_MEMBER
const TYPE_DISMISS_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:16

ilMailNotification\getLanguageText
getLanguageText($a_keyword)
Definition: class.ilMailNotification.php:252

ilGroupMembershipMailNotification\TYPE_BLOCKED_MEMBER
const TYPE_BLOCKED_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:23

ilGroupMembershipMailNotification\send
send()
Send notifications.
Definition: class.ilGroupMembershipMailNotification.php:74

ilGroupMembershipMailNotification\createGroupStatus
createGroupStatus($a_usr_id)
Get course status body.
Definition: class.ilGroupMembershipMailNotification.php:401

ilGroupMembershipMailNotification\__construct
__construct()
Definition: class.ilGroupMembershipMailNotification.php:54

ilMailNotification\getObjId
getObjId()
Definition: class.ilMailNotification.php:284

ilGroupMembershipMailNotification\TYPE_UNBLOCKED_MEMBER
const TYPE_UNBLOCKED_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:24

ilMailNotification\setSubject
setSubject($a_subject)
Definition: class.ilMailNotification.php:104

ilMailNotification\sendMail
sendMail(array $a_rcp, $a_parse_recipients=true)
Definition: class.ilMailNotification.php:344

ilGroupMembershipMailNotification\TYPE_NOTIFICATION_REGISTRATION
const TYPE_NOTIFICATION_REGISTRATION
Definition: class.ilGroupMembershipMailNotification.php:31

$a_type
$a_type
Definition: workflow.php:92

ilMailNotification\getAdditionalInformation
getAdditionalInformation()
Definition: class.ilMailNotification.php:319

ilGroupMembershipMailNotification\TYPE_WAITING_LIST_MEMBER
const TYPE_WAITING_LIST_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:28

ilMailNotification
Base class for course/group mail notifications.
Definition: class.ilMailNotification.php:16

ilGroupMembershipMailNotification
Definition: class.ilGroupMembershipMailNotification.php:12

ilMailNotification\initMail
initMail()
Definition: class.ilMailNotification.php:374

ilMailNotification\$body
$body
Definition: class.ilMailNotification.php:25

ilMailNotification\userToString
userToString($a_usr_id)
Definition: class.ilMailNotification.php:412

ilMailNotification\getObjectTitle
getObjectTitle($a_shorten=false)
Definition: class.ilMailNotification.php:328

ilGroupMembershipMailNotification\TYPE_UNSUBSCRIBE_MEMBER
const TYPE_UNSUBSCRIBE_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:26

ilGroupMembershipMailNotification\initLanguage
initLanguage($a_usr_id)
Add language module crs.
Definition: class.ilGroupMembershipMailNotification.php:390

ilGroupMembershipMailNotification\$permanent_enabled_notifications
$permanent_enabled_notifications
Notifications which are not affected by "mail_grp_member_notification" setting because they addresses...
Definition: class.ilGroupMembershipMailNotification.php:40

ilGroupParticipants\_getInstanceByObjId
static _getInstanceByObjId($a_obj_id)
Get singleton instance.
Definition: class.ilGroupParticipants.php:64

ilGroupMembershipMailNotification\TYPE_REFUSED_SUBSCRIPTION_MEMBER
const TYPE_REFUSED_SUBSCRIPTION_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:19

ilMailNotification\getRefId
getRefId()
Definition: class.ilMailNotification.php:276

ilMailNotification\getRecipients
getRecipients()
get array of recipients
Definition: class.ilMailNotification.php:155

ilMailNotification\createPermanentLink
createPermanentLink($a_params=array(), $a_append='')
Definition: class.ilMailNotification.php:392

$ilSetting
global $ilSetting
Definition: privfeed.php:17

ILIAS\GlobalScreen\Provider\__construct
__construct(Container $dic, ilPlugin $plugin)
Definition: PluginProviderHelper.php:30

$DIC
$DIC
Definition: xapitoken.php:46

ilMailNotification\appendBody
appendBody($a_body)
Append body text.
Definition: class.ilMailNotification.php:130

ilObjectFactory\getInstanceByRefId
static getInstanceByRefId($a_ref_id, $stop_on_error=true)
get an instance of an Ilias object by reference id
Definition: class.ilObjectFactory.php:139

ilObjGroup
Class ilObjGroup.
Definition: class.ilObjGroup.php:33

ilMailNotification\getMail
getMail()
Definition: class.ilMailNotification.php:382

ilGroupMembershipMailNotification\TYPE_ADMISSION_MEMBER
const TYPE_ADMISSION_MEMBER
Definition: class.ilGroupMembershipMailNotification.php:15

ilMail\getSalutation
static getSalutation($a_usr_id, ilLanguage $a_language=null)
Definition: class.ilMail.php:1665