class.ilMailNotification.php

Go to the documentation of this file.

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


include_once './Services/Language/classes/class.ilLanguageFactory.php';
include_once './Services/Mail/classes/class.ilMail.php';

abstract class ilMailNotification
{
        const SUBJECT_TITLE_LENGTH = 60;
        
        private $type = null;
        private $sender = null;
        
        private $mail = null;
        private $subject = '';
        private $body = '';

        private $attachments = array();
        
        protected $language = null;
        
        private $recipients = array();
        
        private $ref_id = null;
        private $obj_id = null;
        private $obj_type = null;
        
        private $additional_info = array();
        
        public function __construct()
        {
                global $lng;

                $this->setSender(ANONYMOUS_USER_ID);
                $this->language = ilLanguageFactory::_getLanguage($lng->getDefaultLanguage());
        }
        
        public function setType($a_type)
        {
                $this->type = $a_type;
        }
        
        public function getType()
        {
                return $this->type;
        }
        
        public function setSender($a_usr_id)
        {
                $this->sender = $a_usr_id;
        }
        
        public function getSender()
        {
                return $this->sender;
        }
        
        protected function setSubject($a_subject)
        {
                return $this->subject = $a_subject;
        }
        
        protected function getSubject()
        {
                return $this->subject;
        }
        
        protected function setBody($a_body)
        {
                $this->body = $a_body;
        }
        
        protected function appendBody($a_body)
        {
                return $this->body .= $a_body;
        }
        
        protected function getBody()
        {
                return $this->body;
        }
        
        public function setRecipients($a_rcp)
        {
                $this->recipients = $a_rcp;
        }
        
        public function getRecipients()
        {
                return $this->recipients;
        }

        public function setAttachments($a_att)
        {
                $this->attachments = $a_att;
        }

        public function getAttachments()
        {
                return (array) $this->attachments;
        }

        protected function initLanguage($a_usr_id)
        {
                $this->language = ilLanguageFactory::_getLanguageOfUser($a_usr_id);
                $this->language->loadLanguageModule('mail');
        }

        protected function initLanguageByIso2Code($a_code = '')
        {
                $this->language = ilLanguageFactory::_getLanguage($a_code);
                $this->language->loadLanguageModule('mail');
        }
        
        protected function setLanguage($a_language)
        {
                $this->language = $a_language;
        }
        
        protected function getLanguage()
        {
                return $this->language;
        }
        
        protected function getLanguageText($a_keyword)
        {
                return str_replace('\n', "\n", $this->getLanguage()->txt($a_keyword));
        }
        
        public function setRefId($a_id)
        {
                $this->ref_id = $a_id;
                $this->obj_id = ilObject::_lookupObjId($this->ref_id);
                $this->obj_type = ilObject::_lookupType($this->obj_id);
        }
        
        public function getRefId()
        {
                return $this->ref_id;
        }
        
        public function getObjId()
        {
                return $this->obj_id;
        }
        
        public function setObjId($a_obj_id)
        {
                $this->obj_id = $a_obj_id;
        }
        
        public function getObjType()
        {
                return $this->obj_type;
        }
        
        public function setAdditionalInformation($a_info)
        {
                $this->additional_info = $a_info;
        }
        
        public function getAdditionalInformation()
        {
                return (array) $this->additional_info; 
        }
        
        protected function getObjectTitle($a_shorten = false)
        {
                if(!$this->getObjId())
                {
                        return '';
                }
                return ilUtil::shortenText(ilObject::_lookupTitle($this->getObjId()), self::SUBJECT_TITLE_LENGTH,true);
        }
        
        
        public function send()
        {
                switch($this->getType())
                {
                        
                }
        }
        
        public function sendMail($a_rcp,$a_type,$a_parse_recipients = true)
        {
                $recipients = array();
                foreach($a_rcp as $rcp)
                {
                        if($a_parse_recipients)
                        {
                                $recipients[] = ilObjUser::_lookupLogin($rcp);
                        }
                        else
                        {
                                $recipients[] = $rcp;
                        }
                }
                $recipients = implode(',',$recipients);
                $error = $this->getMail()->sendMail(
                        $recipients,
                        '',
                        '',
                        $this->getSubject(),
                        $this->getBody(),
                        $this->getAttachments(),
                        $a_type
                );

                if(strlen($error))
                {
                        $GLOBALS['ilLog']->write(__METHOD__.': '.$error);
                }
        }
        
        protected function initMail()
        {
                return $this->mail = new ilMail($this->getSender());
        }
        
        protected function getMail()
        {
                return is_object($this->mail) ? $this->mail : $this->initMail();
        }
        
        protected function createPermanentLink($a_params = array(),$a_append = '')
        {
                include_once './Services/Link/classes/class.ilLink.php';
                
                if($this->getRefId())
                {
                        return ilLink::_getLink($this->ref_id,$this->getObjType(),$a_params,$a_append);
                }
                else
                {
                        // Return root
                        return ilLink::_getLink(ROOT_FOLDER_ID,'root');
                }
        }
        
        
        protected function userToString($a_usr_id)
        {
                $name = ilObjUser::_lookupName($a_usr_id);
                return ($name['title'] ? $name['title'].' ' : '').
                        ($name['firstname'] ? $name['firstname'].' ' : '').
                        ($name['lastname'] ? $name['lastname'].' ' : '');
        }
}
?>