d2/d48/class_8ilCourseMembershipMailNotification_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 ilCourseMembershipMailNotification 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();
     }

     protected function initMail() : ilMail
     {
         parent::initMail();
         $this->mail = $this->mail->withContextParameters([
             ilMail::PROP_CONTEXT_SUBJECT_PREFIX => ilContainer::_lookupContainerSetting(
                 ilObject::_lookupObjId($this->getRefId()),
                 ilObjectServiceSettingsGUI::EXTERNAL_MAIL_PREFIX,
                 ''
             ),
         ]);

         return $this->mail;
     }

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

     public function send()
     {
         if (
             (int) $this->getRefId() &&
             in_array($this->getType(), array(self::TYPE_ADMISSION_MEMBER))) {
             $obj = ilObjectFactory::getInstanceByRefId((int) $this->getRefId());

             if ($obj->getAutoNotification() == false) {
                 if (!$this->force_sending_mail) {
                     return false;
                 }
             }
         }

         if (!$this->isNotificationTypeEnabled($this->getType())) {
             return false;
         }

         // #11359
         // 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('crs_added_member'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('crs_added_member_body'), $this->getObjectTitle())
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('crs_mail_permanent_link'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink());
                     $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('crs_accept_subscriber'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('crs_accept_subscriber_body'), $this->getObjectTitle())
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('crs_mail_permanent_link'));
                     $this->appendBody("\n\n");
                     $this->appendBody($this->createPermanentLink());
                     $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('crs_reject_subscriber'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('crs_reject_subscriber_body'), $this->getObjectTitle())
                     );

                     $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('crs_status_changed'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('crs_status_changed_body'), $this->getObjectTitle())
                     );

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

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('crs_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('crs_dismiss_member'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('crs_dismiss_member_body'), $this->getObjectTitle())
                     );
                     $this->getMail()->appendInstallationSignature(true);
                     $this->sendMail(array($rcp));
                 }
                 break;


             case self::TYPE_BLOCKED_MEMBER:

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

             case self::TYPE_UNBLOCKED_MEMBER:

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

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('crs_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:

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

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

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

                     $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('crs_new_subscription_request'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");

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

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

                     $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('crs_cancel_subscription'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");

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

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('crs_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('crs_unsubscribe_member'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('crs_unsubscribe_member_body'), $this->getObjectTitle())
                     );
                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('crs_unsubscribe_member_explanation'));
                     $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('crs_subscribe_member'), $this->getObjectTitle(true))
                     );
                     $this->setBody(ilMail::getSalutation($rcp, $this->getLanguage()));
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf($this->getLanguageText('crs_subscribe_member_body'), $this->getObjectTitle())
                     );

                     $this->appendBody("\n\n");
                     $this->appendBody($this->getLanguageText('crs_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('crs_subscribe_wl'), $this->getObjectTitle(true))
                     );

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

                     $info = $this->getAdditionalInformation();
                     $this->appendBody("\n\n");
                     $this->appendBody(
                         sprintf(
                             $this->getLanguageText('crs_subscribe_wl_body'),
                             $this->getObjectTitle(),
                             $info['position']
                             )
                     );
                     $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('crs');
     }

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

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


         if ($part->isAdmin($a_usr_id)) {
             $body .= $this->getLanguageText('crs_admin') . "\n";
         } elseif ($part->isTutor($a_usr_id)) {
             $body .= $this->getLanguageText('crs_tutor') . "\n";
         } else {
             $body .= $this->getLanguageText('crs_member') . "\n";
         }

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

             if ($part->isNotificationEnabled($a_usr_id)) {
                 $body .= $this->getLanguageText('crs_notify') . "\n";
             } else {
                 $body .= $this->getLanguageText('crs_no_notify') . "\n";
             }
         } else {
             $body .= $this->getLanguageText('crs_access') . ': ';

             if ($part->isBlocked($a_usr_id)) {
                 $body .= $this->getLanguageText('crs_blocked') . "\n";
             } else {
                 $body .= $this->getLanguageText('crs_unblocked') . "\n";
             }
         }

         $body .= $this->getLanguageText('crs_passed') . ': ';

         if ($part->hasPassed($a_usr_id)) {
             $body .= $this->getLanguageText('yes');
         } else {
             $body .= $this->getLanguageText('no');
         }
         return $body;
     }

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

         $ilSetting = $DIC['ilSetting'];

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

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

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

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

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

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

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

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

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

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

ilMail\PROP_CONTEXT_SUBJECT_PREFIX
const PROP_CONTEXT_SUBJECT_PREFIX
Definition: class.ilMail.php:13

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

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

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

ilCourseParticipants\_getInstanceByObjId
static _getInstanceByObjId($a_obj_id)
Get singleton instance.
Definition: class.ilCourseParticipants.php:77

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

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

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

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

ilCourseMembershipMailNotification\initLanguage
initLanguage($a_usr_id)
Add language module crs.
Definition: class.ilCourseMembershipMailNotification.php:436

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

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

ilObjectServiceSettingsGUI\EXTERNAL_MAIL_PREFIX
const EXTERNAL_MAIL_PREFIX
Definition: class.ilObjectServiceSettingsGUI.php:42

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

ilCourseMembershipMailNotification
Definition: class.ilCourseMembershipMailNotification.php:12

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

ilCourseMembershipMailNotification\__construct
__construct()
Definition: class.ilCourseMembershipMailNotification.php:52

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

ilMail
Definition: class.ilMail.php:10

ilObject\_lookupObjId
static _lookupObjId($a_id)
Definition: class.ilObject.php:1110

$DIC
global $DIC
Definition: goto.php:24

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

ilCourseMembershipMailNotification\createCourseStatus
createCourseStatus($a_usr_id)
Get course status body.
Definition: class.ilCourseMembershipMailNotification.php:447

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

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

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

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

ilCourseMembershipMailNotification\initMail
initMail()
Definition: class.ilCourseMembershipMailNotification.php:60

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

ilCourseMembershipMailNotification\send
send()
Send notifications.
Definition: class.ilCourseMembershipMailNotification.php:87

ilCourseMembershipMailNotification\isNotificationTypeEnabled
isNotificationTypeEnabled($a_type)
get setting "mail_crs_member_notification" and excludes types which are not affected by this setting ...
Definition: class.ilCourseMembershipMailNotification.php:498

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:131

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

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

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

ilMailNotification\$mail
$mail
Definition: class.ilMailNotification.php:23

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

ilContainer\_lookupContainerSetting
static _lookupContainerSetting($a_id, $a_keyword, $a_default_value=null)
Lookup a container setting.
Definition: class.ilContainer.php:395

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