modules/EmailMan/EmailMan.php

   1 <?php
   2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
   3 /*********************************************************************************
   4  * SugarCRM Community Edition is a customer relationship management program developed by
   5  * SugarCRM, Inc. Copyright (C) 2004-2012 SugarCRM Inc.
   6  *
   7  * This program is free software; you can redistribute it and/or modify it under
   8  * the terms of the GNU Affero General Public License version 3 as published by the
   9  * Free Software Foundation with the addition of the following permission added
  10  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
  11  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
  12  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
  13  *
  14  * This program is distributed in the hope that it will be useful, but WITHOUT
  15  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  16  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
  17  * details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License along with
  20  * this program; if not, see http://www.gnu.org/licenses or write to the Free
  21  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  22  * 02110-1301 USA.
  23  *
  24  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
  25  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
  26  *
  27  * The interactive user interfaces in modified source and object code versions
  28  * of this program must display Appropriate Legal Notices, as required under
  29  * Section 5 of the GNU Affero General Public License version 3.
  30  *
  31  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
  32  * these Appropriate Legal Notices must retain the display of the "Powered by
  33  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
  34  * technical reasons, the Appropriate Legal Notices must display the words
  35  * "Powered by SugarCRM".
  36  ********************************************************************************/
  37
  38
  39
  40 class EmailMan extends SugarBean{
  41         var $id;
  42         var $deleted;
  43         var $date_created;
  44         var $date_modified;
  45         var $module;
  46         var $module_id;
  47         var $marketing_id;
  48         var $campaign_id;
  49         var $user_id;
  50         var $list_id;
  51         var $invalid_email;
  52         var $from_name;
  53         var $from_email;
  54         var $in_queue;
  55         var $in_queue_date;
  56         var $template_id;
  57         var $send_date_time;
  58         var $table_name = "emailman";
  59         var $object_name = "EmailMan";
  60         var $module_dir = "EmailMan";
  61         var $send_attempts;
  62         var $related_id;
  63         var $related_type;
  64         var $test=false;
  65         var $notes_array = array();
  66     var $verified_email_marketing_ids =  array();
  67         function toString(){
  68                 return "EmailMan:\nid = $this->id ,user_id= $this->user_id module = $this->module , related_id = $this->related_id , related_type = $this->related_type ,list_id = $this->list_id, send_date_time= $this->send_date_time\n";
  69         }
  70
  71     // This is used to retrieve related fields from form posts.
  72         var $additional_column_fields = array();
  73
  74         function EmailMan() {
  75                 parent::SugarBean();
  76
  77         }
  78
  79         var $new_schema = true;
  80
  81     function create_new_list_query($order_by, $where,$filter=array(),$params=array(), $show_deleted = 0,$join_type='', $return_array = false,$parentbean=null, $singleSelect = false) {
  82                 $query = array('select' => '', 'from' => '', 'where' => '', 'order_by' => '');
  83
  84
  85
  86                 $query['select'] = "SELECT $this->table_name.* ,
  87                                         campaigns.name as campaign_name,
  88                                         email_marketing.name as message_name,
  89                                         (CASE related_type
  90                                                 WHEN 'Contacts' THEN ".$this->db->concat('contacts', array('first_name', 'last_name'), '&nbsp;')."
  91                                                 WHEN 'Leads' THEN ".$this->db->concat('leads', array('first_name', 'last_name'), '&nbsp;')."
  92                                                 WHEN 'Accounts' THEN accounts.name
  93                                                 WHEN 'Users' THEN ".$this->db->concat('users', array('first_name', 'last_name'), '&nbsp;')."
  94                                                 WHEN 'Prospects' THEN ".$this->db->concat('prospects', array('first_name', 'last_name'), '&nbsp;')."
  95                                         END) recipient_name";
  96                 $query['from'] = "      FROM $this->table_name
  97                                         LEFT JOIN users ON users.id = $this->table_name.related_id and $this->table_name.related_type ='Users'
  98                                         LEFT JOIN contacts ON contacts.id = $this->table_name.related_id and $this->table_name.related_type ='Contacts'
  99                                         LEFT JOIN leads ON leads.id = $this->table_name.related_id and $this->table_name.related_type ='Leads'
 100                                         LEFT JOIN accounts ON accounts.id = $this->table_name.related_id and $this->table_name.related_type ='Accounts'
 101                                         LEFT JOIN prospects ON prospects.id = $this->table_name.related_id and $this->table_name.related_type ='Prospects'
 102                                         LEFT JOIN prospect_lists ON prospect_lists.id = $this->table_name.list_id
 103                     LEFT JOIN email_addr_bean_rel ON email_addr_bean_rel.bean_id = $this->table_name.related_id and $this->table_name.related_type = email_addr_bean_rel.bean_module and email_addr_bean_rel.primary_address = 1 and email_addr_bean_rel.deleted=0
 104                                         LEFT JOIN campaigns ON campaigns.id = $this->table_name.campaign_id
 105                                         LEFT JOIN email_marketing ON email_marketing.id = $this->table_name.marketing_id ";
 106
 107                 $where_auto = " $this->table_name.deleted=0";
 108
 109         if($where != "")
 110                         $query['where'] = "WHERE $where AND ".$where_auto;
 111                 else
 112                         $query['where'] = "WHERE ".$where_auto;
 113
 114         if(isset($params['group_by'])) {
 115                         $query['order_by'] .= " GROUP BY {$params['group_by']}";
 116                 }
 117
 118                 if($order_by != "")
 119                 {
 120                         $query['order_by'] = ' ORDER BY ' . $this->process_order_by($order_by, null);
 121                 }
 122
 123                 if ($return_array) {
 124                         return $query;
 125                 }
 126
 127                 return  $query['select'] . $query['from'] . $query['where']. $query['order_by'];
 128
 129     } // if
 130
 131     function create_queue_items_query($order_by, $where,$filter=array(),$params=array(), $show_deleted = 0,$join_type='', $return_array = false,$parentbean=null, $singleSelect = false) {
 132
 133                 if ($return_array) {
 134                         return parent::create_new_list_query($order_by, $where,$filter,$params, $show_deleted,$join_type, $return_array,$parentbean, $singleSelect);
 135                 }
 136
 137                 $query = "SELECT $this->table_name.* ,
 138                                         campaigns.name as campaign_name,
 139                                         email_marketing.name as message_name,
 140                                         (CASE related_type
 141                                                 WHEN 'Contacts' THEN ".$this->db->concat('contacts', array('first_name', 'last_name'), '&nbsp;')."
 142                                                 WHEN 'Leads' THEN ".$this->db->concat('leads', array('first_name', 'last_name'), '&nbsp;')."
 143                                                 WHEN 'Accounts' THEN accounts.name
 144                                                 WHEN 'Users' THEN ".$this->db->concat('users', array('first_name', 'last_name'), '&nbsp;')."
 145                                                 WHEN 'Prospects' THEN ".$this->db->concat('prospects', array('first_name', 'last_name'), '&nbsp;')."
 146                                         END) recipient_name";
 147
 148                  $query .= " FROM $this->table_name
 149                             LEFT JOIN users ON users.id = $this->table_name.related_id and $this->table_name.related_type ='Users'
 150                                         LEFT JOIN contacts ON contacts.id = $this->table_name.related_id and $this->table_name.related_type ='Contacts'
 151                                         LEFT JOIN leads ON leads.id = $this->table_name.related_id and $this->table_name.related_type ='Leads'
 152                                         LEFT JOIN accounts ON accounts.id = $this->table_name.related_id and $this->table_name.related_type ='Accounts'
 153                                         LEFT JOIN prospects ON prospects.id = $this->table_name.related_id and $this->table_name.related_type ='Prospects'
 154                                         LEFT JOIN prospect_lists ON prospect_lists.id = $this->table_name.list_id
 155                     LEFT JOIN email_addr_bean_rel ON email_addr_bean_rel.bean_id = $this->table_name.related_id and $this->table_name.related_type = email_addr_bean_rel.bean_module and email_addr_bean_rel.primary_address = 1 and email_addr_bean_rel.deleted=0
 156                                         LEFT JOIN campaigns ON campaigns.id = $this->table_name.campaign_id
 157                                         LEFT JOIN email_marketing ON email_marketing.id = $this->table_name.marketing_id ";
 158
 159                  //B.F. #37943
 160                 if( isset($params['group_by']) )
 161                 {
 162                         $group_by = str_replace("emailman", "em", $params['group_by']);
 163                     $query .= "INNER JOIN (select min(id) as id from emailman  em GROUP BY $group_by  ) secondary
 164                                    on {$this->table_name}.id = secondary.id     ";
 165                 }
 166
 167                 $where_auto = " $this->table_name.deleted=0";
 168
 169         if($where != "")
 170                         $query .= "WHERE $where AND ".$where_auto;
 171                 else
 172                         $query .= "WHERE ".$where_auto;
 173
 174
 175                 if($order_by != "")
 176                 {
 177                         $query .= ' ORDER BY ' . $this->process_order_by($order_by, null);
 178                 }
 179
 180                 return $query;
 181
 182     }
 183
 184         function create_list_query($order_by, $where, $show_deleted = 0){
 185
 186                 $query = "SELECT $this->table_name.* ,
 187                                         campaigns.name as campaign_name,
 188                                         email_marketing.name as message_name,
 189                                         (CASE related_type
 190                                                 WHEN 'Contacts' THEN ".$this->db->concat('contacts', array('first_name', 'last_name'), '&nbsp;')."
 191                                                 WHEN 'Leads' THEN ".$this->db->concat('leads', array('first_name', 'last_name'), '&nbsp;')."
 192                                                 WHEN 'Accounts' THEN accounts.name
 193                                                 WHEN 'Users' THEN ".$this->db->concat('users', array('first_name', 'last_name'), '&nbsp;')."
 194                                                 WHEN 'Prospects' THEN ".$this->db->concat('prospects', array('first_name', 'last_name'), '&nbsp;')."
 195                                         END) recipient_name";
 196                 $query .= "     FROM $this->table_name
 197                                         LEFT JOIN users ON users.id = $this->table_name.related_id and $this->table_name.related_type ='Users'
 198                                         LEFT JOIN contacts ON contacts.id = $this->table_name.related_id and $this->table_name.related_type ='Contacts'
 199                                         LEFT JOIN leads ON leads.id = $this->table_name.related_id and $this->table_name.related_type ='Leads'
 200                                         LEFT JOIN accounts ON accounts.id = $this->table_name.related_id and $this->table_name.related_type ='Accounts'
 201                                         LEFT JOIN prospects ON prospects.id = $this->table_name.related_id and $this->table_name.related_type ='Prospects'
 202                                         LEFT JOIN prospect_lists ON prospect_lists.id = $this->table_name.list_id
 203                     LEFT JOIN email_addr_bean_rel ON email_addr_bean_rel.bean_id = $this->table_name.related_id and $this->table_name.related_type = email_addr_bean_rel.bean_module and email_addr_bean_rel.primary_address = 1 and email_addr_bean_rel.deleted=0
 204                                         LEFT JOIN campaigns ON campaigns.id = $this->table_name.campaign_id
 205                                         LEFT JOIN email_marketing ON email_marketing.id = $this->table_name.marketing_id ";
 206
 207                 $where_auto = " $this->table_name.deleted=0";
 208
 209         if($where != "")
 210                         $query .= "where $where AND ".$where_auto;
 211                 else
 212                         $query .= "where ".$where_auto;
 213
 214                 if($order_by != "")
 215                 {
 216                         $query .= ' ORDER BY ' . $this->process_order_by($order_by, null);
 217                 }
 218                 return $query;
 219         }
 220
 221     function get_list_view_data()
 222     {
 223         global $locale, $current_user;
 224         $temp_array = parent::get_list_view_array();
 225
 226         $related_type = $temp_array['RELATED_TYPE'];
 227         $related_id = $temp_array['RELATED_ID'];
 228         $is_person = SugarModule::get($related_type)->moduleImplements('Person');
 229
 230         if($is_person)
 231         {
 232             $query = "SELECT first_name, last_name FROM ". strtolower($related_type) ." WHERE id ='". $related_id ."'";
 233         } else {
 234             $query = "SELECT name FROM ". strtolower($related_type) ." WHERE id ='". $related_id ."'";
 235         }
 236
 237         $result=$this->db->query($query);
 238         $row=$this->db->fetchByAssoc($result);
 239
 240         if($row)
 241         {
 242                 $temp_array['RECIPIENT_NAME'] = $is_person ? $locale->getLocaleFormattedName($row['first_name'], $row['last_name'], '') : $row['name'];
 243         }
 244
 245         //also store the recipient_email address
 246         $query = "SELECT addr.email_address FROM email_addresses addr,email_addr_bean_rel eb WHERE eb.deleted=0 AND addr.id=eb.email_address_id AND bean_id ='". $related_id ."' AND primary_address = '1'";
 247
 248         $result=$this->db->query($query);
 249         $row=$this->db->fetchByAssoc($result);
 250         if ($row)
 251         {
 252             $temp_array['RECIPIENT_EMAIL']=$row['email_address'];
 253         }
 254
 255         $this->email1 = $temp_array['RECIPIENT_EMAIL'];
 256                 $temp_array['EMAIL1_LINK'] = $current_user->getEmailLink('email1', $this, '', '', 'ListView');
 257
 258         return $temp_array;
 259     }
 260
 261
 262         function set_as_sent($email_address, $delete= true,$email_id=null, $email_type=null,$activity_type=null){
 263
 264                 global $timedate;
 265
 266                 $this->send_attempts++;
 267                 $this->id = (int)$this->id;
 268                 if($delete || $this->send_attempts > 5){
 269
 270                         //create new campaign log record.
 271
 272                         $campaign_log = new CampaignLog();
 273                         $campaign_log->campaign_id=$this->campaign_id;
 274                         $campaign_log->target_tracker_key=$this->target_tracker_key;
 275                         $campaign_log->target_id= $this->related_id;
 276                         $campaign_log->target_type=$this->related_type;
 277             $campaign_log->marketing_id=$this->marketing_id;
 278                         //if test suppress duplicate email address checking.
 279                         if (!$this->test) {
 280                                 $campaign_log->more_information=$email_address;
 281                         }
 282                         $campaign_log->activity_type=$activity_type;
 283                         $campaign_log->activity_date=$timedate->now();
 284                         $campaign_log->list_id=$this->list_id;
 285                         $campaign_log->related_id= $email_id;
 286                         $campaign_log->related_type=$email_type;
 287             $campaign_log->save();
 288
 289                         $query = "DELETE FROM emailman WHERE id = $this->id";
 290                         $this->db->query($query);
 291                 }else{
 292                         //try to send the email again a day later.
 293                         $query = 'UPDATE ' . $this->table_name . " SET in_queue='1', send_attempts='$this->send_attempts', in_queue_date=". $this->db->now() ." WHERE id = $this->id";
 294                         $this->db->query($query);
 295                 }
 296         }
 297
 298     /**
 299      * Function finds the reference email for the campaign. Since a campaign can have multiple email templates
 300      * the reference email has same id as the marketing id.
 301      * this function will create an email if one does not exist. also the function will load these relationships leads, accounts, contacts
 302      * users and targets
 303      *
 304      * @param varchar marketing_id message id
 305      * @param string $subject email subject
 306      * @param string $body_text Email Body Text
 307      * @param string $body_html Email Body HTML
 308      * @param string $campaign_name Campaign Name
 309      * @param string from_address Email address of the sender, usually email address of the configured inbox.
 310      * @param string sender_id If of the user sending the campaign.
 311      * @param array  macro_nv array of name value pair, one row for each replacable macro in email template text.
 312      * @param string from_address_name The from address eg markeing <marketing@sugar.net>
 313      * @return
 314      */
 315     function create_ref_email($marketing_id,$subject,$body_text,$body_html,$campagin_name,$from_address,$sender_id,$notes,$macro_nv,$newmessage,$from_address_name) {
 316
 317        global $mod_Strings, $timedate;
 318        $upd_ref_email=false;
 319        if ($newmessage or empty($this->ref_email->id)) {
 320            $this->ref_email = new Email();
 321            $this->ref_email->retrieve($marketing_id, true, false);
 322
 323            //the reference email should be updated when user swithces from test mode to regular mode,and, for every run in test mode, and is user
 324            //switches back to test mode.
 325            //this is to account for changes to email template.
 326            $upd_ref_email=(!empty($this->ref_email->id) and $this->ref_email->parent_type=='test' and $this->ref_email->parent_id=='test');
 327           //following condition is for switching back to test mode.
 328            if (!$upd_ref_email) $upd_ref_email=($this->test and !empty($this->ref_email->id) and empty($this->ref_email->parent_type) and empty($this->ref_email->parent_id));
 329            if (empty($this->ref_email->id) or $upd_ref_email) {
 330                 //create email record.
 331                 $this->ref_email->id=$marketing_id;
 332                 $this->ref_email->date_sent = '';
 333
 334                 if ($upd_ref_email==false) {
 335                     $this->ref_email->new_with_id=true;
 336                 }
 337
 338                 $this->ref_email->to_addrs= '';
 339                 $this->ref_email->to_addrs_ids = '';
 340                 $this->ref_email->to_addrs_names = '';
 341                 $this->ref_email->to_addrs_emails ='';
 342                 $this->ref_email->type= 'campaign';
 343                 $this->ref_email->deleted = '0';
 344                 $this->ref_email->name = $campagin_name.': '.$subject ;
 345                 $this->ref_email->description_html = $body_html;
 346                 $this->ref_email->description = $body_text;
 347                 $this->ref_email->from_addr = $from_address;
 348                 $this->ref_email->from_addr_name = $from_address_name;
 349                 $this->ref_email->assigned_user_id = $sender_id;
 350                 if ($this->test) {
 351                     $this->ref_email->parent_type = 'test';
 352                     $this->ref_email->parent_id =  'test';
 353                 } else {
 354                     $this->ref_email->parent_type = '';
 355                     $this->ref_email->parent_id =  '';
 356                 }
 357                 $this->ref_email->date_start = $timedate->nowDate();
 358                 $this->ref_email->time_start = $timedate->asUserTime($timedate->getNow(true));
 359
 360                 $this->ref_email->status='sent';
 361                 $retId = $this->ref_email->save();
 362
 363                 foreach($notes as $note) {
 364                     if($note->object_name == 'Note') {
 365                         if (! empty($note->file->temp_file_location) && is_file($note->file->temp_file_location)) {
 366                             $file_location = $note->file->temp_file_location;
 367                             $filename = $note->file->original_file_name;
 368                             $mime_type = $note->file->mime_type;
 369                         } else {
 370                             $file_location = "upload://{$note->id}";
 371                             $filename = $note->id.$note->filename;
 372                             $mime_type = $note->file_mime_type;
 373                         }
 374                     } elseif($note->object_name == 'DocumentRevision') { // from Documents
 375                         $filename = $note->id.$note->filename;
 376                         $file_location = "upload://$filename";
 377                         $mime_type = $note->file_mime_type;
 378                     }
 379
 380                     $noteAudit = new Note();
 381                     $noteAudit->parent_id = $retId;
 382                     $noteAudit->parent_type = $this->ref_email->module_dir;
 383                     $noteAudit->description = "[".$note->filename."] ".$mod_strings['LBL_ATTACHMENT_AUDIT'];
 384                     $noteAudit->filename=$filename;
 385                     $noteAudit->file_mime_type=$mime_type;
 386                     $noteAudit_id=$noteAudit->save();
 387
 388                     UploadFile::duplicate_file($note->id, $noteAudit_id, $filename);
 389                 }
 390             }
 391
 392             //load relationships.
 393             $this->ref_email->load_relationship('users');
 394             $this->ref_email->load_relationship('prospects');
 395             $this->ref_email->load_relationship('contacts');
 396             $this->ref_email->load_relationship('leads');
 397             $this->ref_email->load_relationship('accounts');
 398        }
 399
 400        if (!empty($this->related_id ) && !empty($this->related_type)) {
 401
 402             //save relationships.
 403             switch ($this->related_type)  {
 404                 case 'Users':
 405                     $rel_name="users";
 406                     break;
 407
 408                 case 'Prospects':
 409                     $rel_name="prospects";
 410                     break;
 411
 412                 case 'Contacts':
 413                     $rel_name="contacts";
 414                     break;
 415
 416                 case 'Leads':
 417                     $rel_name="leads";
 418                     break;
 419
 420                 case 'Accounts':
 421                     $rel_name="accounts";
 422                     break;
 423             }
 424
 425             //required for one email per campaign per marketing message.
 426             $this->ref_email->$rel_name->add($this->related_id,array('campaign_data'=>serialize($macro_nv)));
 427        }
 428        return $this->ref_email->id;
 429     }
 430
 431    /**
 432     * The function creates a copy of email send to each target.
 433     */
 434     function create_indiv_email($module,$mail) {
 435
 436         global $locale, $timedate;
 437         $email = new Email();
 438         $email->to_addrs= $module->name . '&lt;'.$module->email1.'&gt;';
 439         $email->to_addrs_ids = $module->id .';';
 440         $email->to_addrs_names = $module->name . ';';
 441         $email->to_addrs_emails = $module->email1 . ';';
 442         $email->type= 'archived';
 443         $email->deleted = '0';
 444         $email->name = $this->current_campaign->name.': '.$mail->Subject ;
 445         if ($mail->ContentType == "text/plain") {
 446             $email->description = $mail->Body;
 447             $email->description_html =null;
 448         } else {
 449             $email->description_html = $mail->Body;
 450             $email->description = $mail->AltBody;
 451         }
 452         $email->from_addr = $mail->From;
 453         $email->assigned_user_id = $this->user_id;
 454         $email->parent_type = $this->related_type;
 455         $email->parent_id = $this->related_id ;
 456
 457         $email->date_start = $timedate->nowDbDate();
 458         $email->time_start = $timedate->asDbTime($timedate->getNow());
 459         $email->status='sent';
 460         $retId = $email->save();
 461
 462         foreach($this->notes_array as $note) {
 463             if(!class_exists('Note')) {
 464
 465             }
 466             // create "audit" email without duping off the file to save on disk space
 467             $noteAudit = new Note();
 468             $noteAudit->parent_id = $retId;
 469             $noteAudit->parent_type = $email->module_dir;
 470             $noteAudit->description = "[".$note->filename."] ".$mod_strings['LBL_ATTACHMENT_AUDIT'];
 471             $noteAudit->save();
 472         }
 473
 474         if (!empty($this->related_id ) && !empty($this->related_type)) {
 475
 476                 //save relationships.
 477                 switch ($this->related_type)  {
 478                     case 'Users':
 479                         $rel_name="users";
 480                         break;
 481
 482                     case 'Prospects':
 483                         $rel_name="prospects";
 484                         break;
 485
 486                     case 'Contacts':
 487                         $rel_name="contacts";
 488                         break;
 489
 490                     case 'Leads':
 491                         $rel_name="leads";
 492                         break;
 493
 494                     case 'Accounts':
 495                         $rel_name="accounts";
 496                         break;
 497                 }
 498
 499                 if (!empty($rel_name)) {
 500                     $email->load_relationship($rel_name);
 501                     $email->$rel_name->add($this->related_id);
 502                 }
 503         }
 504         return $email->id;
 505     }
 506     /*
 507      * Call this function to verify the email_marketing message and email_template configured
 508      * for the campaign. If issues are found a fatal error will be logged but processing will not stop.
 509      * @return Boolean Returns true if all campaign parameters are set correctly
 510      */
 511     function verify_campaign($marketing_id) {
 512
 513         if (!isset($this->verified_email_marketing_ids[$marketing_id])) {
 514             if (!class_exists('EmailMarketing')) {
 515
 516             }
 517             $email_marketing = new EmailMarketing();
 518             $ret=$email_marketing->retrieve($marketing_id);
 519             if (empty($ret)) {
 520                 $GLOBALS['log']->fatal('Error retrieving marketing message for the email campaign. marketing_id = ' .$marketing_id);
 521                 return false;
 522             }
 523
 524             //verify the email template.
 525             if (empty($email_marketing->template_id)) {
 526                 $GLOBALS['log']->fatal('Error retrieving template for the email campaign. marketing_id = ' .$marketing_id);
 527                 return false;
 528             }
 529
 530             if (!class_exists('EmailTemplate')) {
 531
 532             }
 533             $emailtemplate= new EmailTemplate();
 534
 535             $ret=$emailtemplate->retrieve($email_marketing->template_id);
 536             if (empty($ret)) {
 537                 $GLOBALS['log']->fatal('Error retrieving template for the email campaign. template_id = ' .$email_marketing->template_id);
 538                 return false;
 539             }
 540
 541             if (empty($emailtemplate->subject) and empty($emailtemplate->body) and empty($emailtemplate->body_html)) {
 542                 $GLOBALS['log']->fatal('Email template is empty. email_template_id=' .$email_marketing->template_id);
 543                                 return false;
 544             }
 545
 546         }
 547         $this->verified_email_marketing_ids[$marketing_id]=1;
 548
 549         return true;
 550     }
 551         function sendEmail($mail,$save_emails=1,$testmode=false){
 552             $this->test=$testmode;
 553
 554                 global $beanList, $beanFiles, $sugar_config;
 555                 global $mod_strings;
 556         global $locale;
 557         $OBCharset = $locale->getPrecedentPreference('default_email_charset');
 558                 $mod_strings = return_module_language( $sugar_config['default_language'], 'EmailMan');
 559
 560                 //get tracking entities locations.
 561                 if (!isset($this->tracking_url)) {
 562                         if (!class_exists('Administration')) {
 563
 564                         }
 565                         $admin=new Administration();
 566                         $admin->retrieveSettings('massemailer'); //retrieve all admin settings.
 567                     if (isset($admin->settings['massemailer_tracking_entities_location_type']) and $admin->settings['massemailer_tracking_entities_location_type']=='2'  and isset($admin->settings['massemailer_tracking_entities_location']) ) {
 568                                 $this->tracking_url=$admin->settings['massemailer_tracking_entities_location'];
 569                     } else {
 570                                 $this->tracking_url=$sugar_config['site_url'];
 571                     }
 572                 }
 573
 574         //make sure tracking url ends with '/' character
 575         $strLen = strlen($this->tracking_url);
 576         if($this->tracking_url{$strLen-1} !='/'){
 577             $this->tracking_url .='/';
 578         }
 579
 580                 if(!isset($beanList[$this->related_type])){
 581                         return false;
 582                 }
 583                 $class = $beanList[$this->related_type];
 584                 if (!class_exists($class)) {
 585                         require_once($beanFiles[$class]);
 586                 }
 587
 588                 if (!class_exists('Email')) {
 589
 590                 }
 591
 592                 $module = new $class();
 593                 $module->retrieve($this->related_id);
 594                 $module->emailAddress->handleLegacyRetrieve($module);
 595
 596         //check to see if bean has a primary email address
 597         if (!$this->is_primary_email_address($module)) {
 598             //no primary email address designated, do not send out email, create campaign log
 599             //of type send error to denote that this user was not emailed
 600             $this->set_as_sent($module->email1, true,null,null,'send error');
 601             //create fatal logging for easy review of cause.
 602             $GLOBALS['log']->fatal('Email Address provided is not Primary Address for email with id ' . $module->email1 . "' Emailman id=$this->id");
 603             return true;
 604         }
 605
 606                 if (!$this->valid_email_address($module->email1)) {
 607                         $this->set_as_sent($module->email1, true,null,null,'invalid email');
 608                         $GLOBALS['log']->fatal('Encountered invalid email address' . $module->email1 . " Emailman id=$this->id");
 609                         return true;
 610                 }
 611
 612         if ((!isset($module->email_opt_out)
 613                     || ($module->email_opt_out !== 'on'
 614                         && $module->email_opt_out !== 1
 615                         && $module->email_opt_out !== '1'))
 616             && (!isset($module->invalid_email)
 617                     || ($module->invalid_email !== 'on'
 618                         && $module->invalid_email !== 1
 619                         && $module->invalid_email !== '1'))){
 620             $lower_email_address=strtolower($module->email1);
 621                         //test against indivdual address.
 622                         if (isset($this->restricted_addresses) and isset($this->restricted_addresses[$lower_email_address])) {
 623                                 $this->set_as_sent($lower_email_address, true,null,null,'blocked');
 624                                 return true;
 625                         }
 626                         //test against restricted domains
 627                         $at_pos=strrpos($lower_email_address,'@');
 628                         if ($at_pos !== false) {
 629                                 foreach ($this->restricted_domains as $domain=>$value) {
 630                                         $pos=strrpos($lower_email_address,$domain);
 631                                         if ($pos !== false && $pos > $at_pos) {
 632                                                 //found
 633                                                 $this->set_as_sent($lower_email_address, true,null,null,'blocked');
 634                                                 return true;
 635                                         }
 636                                 }
 637                         }
 638
 639                         //test for duplicate email address by marketing id.
 640             $dup_query="select id from campaign_log where more_information='".$module->email1."' and marketing_id='".$this->marketing_id."'";
 641                         $dup=$this->db->query($dup_query);
 642                         $dup_row=$this->db->fetchByAssoc($dup);
 643                         if (!empty($dup_row)) {
 644                                 //we have seen this email address before
 645                                 $this->set_as_sent($module->email1,true,null,null,'blocked');
 646                                 return true;
 647                         }
 648
 649                         $this->target_tracker_key=create_guid();
 650
 651                         //fetch email marketing.
 652                         if (empty($this->current_emailmarketing) or !isset($this->current_emailmarketing)) {
 653                                 if (!class_exists('EmailMarketing')) {
 654
 655                                 }
 656
 657                                 $this->current_emailmarketing=new EmailMarketing();
 658
 659                         }
 660                         if (empty($this->current_emailmarketing->id) or $this->current_emailmarketing->id !== $this->marketing_id) {
 661                                 $this->current_emailmarketing->retrieve($this->marketing_id);
 662
 663                 $this->newmessage = true;
 664                         }
 665                         //fetch email template associate with the marketing message.
 666                         if (empty($this->current_emailtemplate) or $this->current_emailtemplate->id !== $this->current_emailmarketing->template_id) {
 667                                 if (!class_exists('EmailTemplate')) {
 668
 669                                 }
 670                                 $this->current_emailtemplate= new EmailTemplate();
 671
 672                                 $this->current_emailtemplate->retrieve($this->current_emailmarketing->template_id);
 673
 674                                 //escape email template contents.
 675                                 $this->current_emailtemplate->subject=from_html($this->current_emailtemplate->subject);
 676                                 $this->current_emailtemplate->body_html=from_html($this->current_emailtemplate->body_html);
 677                                 $this->current_emailtemplate->body=from_html($this->current_emailtemplate->body);
 678
 679                                 $q = "SELECT * FROM notes WHERE parent_id = '".$this->current_emailtemplate->id."' AND deleted = 0";
 680                                 $r = $this->db->query($q);
 681
 682                                 // cn: bug 4684 - initialize the notes array, else old data is still around for the next round
 683                                 $this->notes_array = array();
 684                 if (!class_exists('Note')){
 685                         require_once('modules/Notes/Note.php');
 686                                 }
 687                                 while($a = $this->db->fetchByAssoc($r)) {
 688                                         $noteTemplate = new Note();
 689                                         $noteTemplate->retrieve($a['id']);
 690                                         $this->notes_array[] = $noteTemplate;
 691                                 }
 692                         }
 693
 694                         // fetch mailbox details..
 695                         if(empty($this->current_mailbox)) {
 696                                 if (!class_exists('InboundEmail')) {
 697
 698                                 }
 699                                 $this->current_mailbox= new InboundEmail();
 700                         }
 701                         if (empty($this->current_mailbox->id) or $this->current_mailbox->id !== $this->current_emailmarketing->inbound_email_id) {
 702                                 $this->current_mailbox->retrieve($this->current_emailmarketing->inbound_email_id);
 703                                 //extract the email address.
 704                                 $this->mailbox_from_addr=$this->current_mailbox->get_stored_options('from_addr','nobody@example.com',null);
 705                         }
 706
 707                         // fetch campaign details..
 708                         if (empty($this->current_campaign)) {
 709                                 if (!class_exists('Campaign')) {
 710
 711                                 }
 712                                 $this->current_campaign= new Campaign();
 713                         }
 714                         if (empty($this->current_campaign->id) or $this->current_campaign->id !== $this->current_emailmarketing->campaign_id) {
 715                                 $this->current_campaign->retrieve($this->current_emailmarketing->campaign_id);
 716
 717                                 //load defined tracked_urls
 718                                 $this->current_campaign->load_relationship('tracked_urls');
 719                                 $query_array=$this->current_campaign->tracked_urls->getQuery(true);
 720                                 $query_array['select']="SELECT tracker_name, tracker_key, id, is_optout ";
 721                                 $result=$this->current_campaign->db->query(implode(' ',$query_array));
 722
 723                                 $this->has_optout_links=false;
 724                                 $this->tracker_urls=array();
 725                                 while (($row=$this->current_campaign->db->fetchByAssoc($result)) != null) {
 726                                         $this->tracker_urls['{'.$row['tracker_name'].'}']=$row;
 727                                         //has the user defined opt-out links for the campaign.
 728                                         if ($row['is_optout']==1) {
 729                                                 $this->has_optout_links=true;
 730                                         }
 731                                 }
 732                         }
 733
 734                         $mail->ClearAllRecipients();
 735                         $mail->ClearReplyTos();
 736                         $mail->Sender   = $this->mailbox_from_addr;
 737                         $mail->From     = $this->mailbox_from_addr;
 738                         $mail->FromName = $this->current_emailmarketing->from_name;
 739                         $mail->ClearCustomHeaders();
 740             $mail->AddCustomHeader('X-CampTrackID:'.$this->target_tracker_key);
 741             //CL - Bug 25256 Check if we have a reply_to_name/reply_to_addr value from the email marketing table.  If so use email marketing entry; otherwise current mailbox (inbound email) entry
 742                         $replyToName = empty($this->current_emailmarketing->reply_to_name) ? $this->current_mailbox->get_stored_options('reply_to_name',$mail->FromName,null) : $this->current_emailmarketing->reply_to_name;
 743                         $replyToAddr = empty($this->current_emailmarketing->reply_to_addr) ? $this->current_mailbox->get_stored_options('reply_to_addr',$mail->From,null) : $this->current_emailmarketing->reply_to_addr;
 744
 745                         $mail->AddReplyTo($replyToAddr,$locale->translateCharsetMIME(trim($replyToName), 'UTF-8', $OBCharset));
 746
 747                         //parse and replace bean variables.
 748             $macro_nv=array();
 749             $focus_name = 'Contacts';
 750             if($module->module_dir == 'Accounts')
 751             {
 752                 $focus_name = 'Accounts';
 753             }
 754
 755
 756                         $template_data=  $this->current_emailtemplate->parse_email_template(array('subject'=>$this->current_emailtemplate->subject,
 757                                                                                                                                                                           'body_html'=>$this->current_emailtemplate->body_html,
 758                                                                                                                                                                           'body'=>$this->current_emailtemplate->body,
 759                                                                                                                                                                           )
 760                                                                                                                                                                           ,$focus_name, $module
 761                                                                                       ,$macro_nv);
 762
 763             //add email address to this list.
 764             $macro_nv['sugar_to_email_address']=$module->email1;
 765             $macro_nv['email_template_id']=$this->current_emailmarketing->template_id;
 766
 767             //parse and replace urls.
 768                         //this is new style of adding tracked urls to a campaign.
 769                         $tracker_url_template= $this->tracking_url . 'index.php?entryPoint=campaign_trackerv2&track=%s'.'&identifier='.$this->target_tracker_key;
 770                         $removeme_url_template=$this->tracking_url . 'index.php?entryPoint=removeme&identifier='.$this->target_tracker_key;
 771                         $template_data=  $this->current_emailtemplate->parse_tracker_urls($template_data,$tracker_url_template,$this->tracker_urls,$removeme_url_template);
 772                         $mail->AddAddress($module->email1,$locale->translateCharsetMIME(trim($module->name), 'UTF-8', $OBCharset) );
 773
 774             //refetch strings in case they have been changed by creation of email templates or other beans.
 775             $mod_strings = return_module_language( $sugar_config['default_language'], 'EmailMan');
 776
 777             if($this->test){
 778                 $mail->Subject =  $mod_strings['LBL_PREPEND_TEST'] . $template_data['subject'];
 779             }else{
 780                 $mail->Subject =  $template_data['subject'];
 781             }
 782
 783             //check if this template is meant to be used as "text only"
 784             $text_only = false;
 785             if(isset($this->current_emailtemplate->text_only) && $this->current_emailtemplate->text_only){$text_only =true;}
 786             //if this template is textonly, then just send text body.  Do not add tracker, opt out,
 787             //or perform other processing as it will not show up in text only email
 788             if($text_only){
 789                 $this->description_html = '';
 790                 $mail->IsHTML(false);
 791                 $mail->Body = $template_data['body'];
 792
 793             }else{
 794                 $mail->Body = wordwrap($template_data['body_html'], 900);
 795                 //BEGIN:this code will trigger for only campaigns pending before upgrade to 4.2.0.
 796                 //will be removed for the next release.
 797                 if(!isset($btracker)) $btracker=false;
 798                 if ($btracker) {
 799                     $mail->Body .= "<br /><br /><a href='". $tracker_url ."'>" . $tracker_text . "</a><br /><br />";
 800                 } else {
 801                     if (!empty($tracker_url)) {
 802                         $mail->Body = str_replace('TRACKER_URL_START', "<a href='" . $tracker_url ."'>", $mail->Body);
 803                         $mail->Body = str_replace('TRACKER_URL_END', "</a>", $mail->Body);
 804                         $mail->AltBody = str_replace('TRACKER_URL_START', "<a href='" . $tracker_url ."'>", $mail->AltBody);
 805                         $mail->AltBody = str_replace('TRACKER_URL_END', "</a>", $mail->AltBody);
 806                     }
 807                 }
 808                 //END
 809
 810                 //do not add the default remove me link if the campaign has a trackerurl of the opotout link
 811                 if ($this->has_optout_links==false) {
 812                     $mail->Body .= "<br /><span style='font-size:0.8em'>{$mod_strings['TXT_REMOVE_ME']} <a href='". $this->tracking_url . "index.php?entryPoint=removeme&identifier={$this->target_tracker_key}'>{$mod_strings['TXT_REMOVE_ME_CLICK']}</a></span>";
 813                 }
 814                 // cn: bug 11979 - adding single quote to comform with HTML email RFC
 815                 $mail->Body .= "<br /><img alt='' height='1' width='1' src='{$this->tracking_url}index.php?entryPoint=image&identifier={$this->target_tracker_key}' />";
 816
 817                 $mail->AltBody = $template_data['body'];
 818                 if ($btracker) {
 819                     $mail->AltBody .="\n". $tracker_url;
 820                 }
 821                 if ($this->has_optout_links==false) {
 822                     $mail->AltBody .="\n\n\n{$mod_strings['TXT_REMOVE_ME_ALT']} ". $this->tracking_url . "index.php?entryPoint=removeme&identifier=$this->target_tracker_key";
 823                 }
 824
 825             }
 826
 827                         // cn: bug 4684, handle attachments in email templates.
 828                         $mail->handleAttachments($this->notes_array);
 829                         $tmp_Subject = $mail->Subject;
 830                         $mail->prepForOutbound();
 831
 832                 $success = $mail->Send();
 833                 //Do not save the encoded subject.
 834             $mail->Subject = $tmp_Subject;
 835                         if($success ){
 836                 $email_id=null;
 837                 if ($save_emails==1) {
 838                     $email_id=$this->create_indiv_email($module,$mail);
 839                 } else {
 840                     //find/create reference email record. all campaign targets reveiving this message will be linked with this message.
 841                     $decodedFromName = mb_decode_mimeheader($this->current_emailmarketing->from_name);
 842                     $fromAddressName= "{$decodedFromName} <{$this->mailbox_from_addr}>";
 843
 844                     $email_id=$this->create_ref_email($this->marketing_id,
 845                                             $this->current_emailtemplate->subject,
 846                                             $this->current_emailtemplate->body,
 847                                             $this->current_emailtemplate->body_html,
 848                                             $this->current_campaign->name,
 849                                             $this->mailbox_from_addr,
 850                                             $this->user_id,
 851                                             $this->notes_array,
 852                                             $macro_nv,
 853                                             $this->newmessage,
 854                                             $fromAddressName
 855                      );
 856                     $this->newmessage = false;
 857                 }
 858             }
 859
 860                         if ($success) {
 861                                 $this->set_as_sent($module->email1, true, $email_id, 'Emails', 'targeted');
 862                         } else {
 863
 864                                 if(!empty($layout_def['parent_id'])) {
 865                         if (isset($layout_def['fields'][strtoupper($layout_def['parent_id'])])) {
 866                             $parent.="&parent_id=".$layout_def['fields'][strtoupper($layout_def['parent_id'])];
 867                         }
 868                     }
 869                     if(!empty($layout_def['parent_module'])) {
 870                         if (isset($layout_def['fields'][strtoupper($layout_def['parent_module'])])) {
 871                             $parent.="&parent_module=".$layout_def['fields'][strtoupper($layout_def['parent_module'])];
 872                         }
 873                     }
 874                                 //log send error. save for next attempt after 24hrs. no campaign log entry will be created.
 875                                 $this->set_as_sent($module->email1,false,null,null,'send error');
 876                         }
 877                 }else{
 878             $success = false;
 879             $this->target_tracker_key=create_guid();
 880
 881                         if (isset($module->email_opt_out) && ($module->email_opt_out === 'on' || $module->email_opt_out == '1' || $module->email_opt_out == 1)) {
 882                                 $this->set_as_sent($module->email1,true,null,null,'removed');
 883                         } else {
 884                                 if (isset($module->invalid_email) && ($module->invalid_email == 1 || $module->invalid_email == '1')) {
 885                                         $this->set_as_sent($module->email1,true,null,null,'invalid email');
 886                                 } else {
 887                                         $this->set_as_sent($module->email1,true, null,null,'send error');
 888                                 }
 889                         }
 890                 }
 891
 892                 return $success;
 893         }
 894
 895         /*
 896          * Validates the passed email address.
 897          * Limitations of this algorithm: does not validate email addressess that end with .meuseum
 898          *
 899          */
 900         function valid_email_address($email_address) {
 901
 902                 $email_address=trim($email_address);
 903                 if (empty($email_address)) {
 904                         return false;
 905                 }
 906
 907                 $pattern='/[A-Z0-9\._%-]+@[A-Z0-9\.-]+\.[A-Za-z]{2,}$/i';
 908                 $ret=preg_match($pattern, $email_address);
 909                 echo $ret;
 910                 if ($ret===false or $ret==0) {
 911                         return false;
 912                 }
 913                 return true;
 914         }
 915
 916     /*
 917      * This function takes in the given bean and searches for a related email address
 918      * that has been designated as primary.  If one is found, true is returned
 919      * If no primary email address is found, then false is returned
 920      *
 921      */
 922     function is_primary_email_address($bean){
 923         $email_address=trim($bean->email1);
 924
 925         if (empty($email_address)) {
 926             return false;
 927         }
 928         //query for this email address rel and see if this is primary address
 929         $primary_qry = "select email_address_id from email_addr_bean_rel where bean_id = '".$bean->id."' and email_addr_bean_rel.primary_address=1 and deleted=0";
 930         $res = $bean->db->query($primary_qry);
 931         $prim_row=$this->db->fetchByAssoc($res);
 932         //return true if this is primary
 933         if (!empty($prim_row)) {
 934             return true;
 935         }
 936         return false;
 937
 938      }
 939
 940     function create_export_query(&$order_by, &$where) {
 941         $custom_join = $this->custom_fields->getJOIN(true, true,$where);
 942         $query = "SELECT emailman.*";
 943         if($custom_join){
 944             $query .= $custom_join['select'];
 945         }
 946
 947         $query .= " FROM emailman ";
 948
 949         if($custom_join){
 950             $query .= $custom_join['join'];
 951         }
 952
 953         $where_auto = "( emailman.deleted IS NULL OR emailman.deleted=0 )";
 954
 955         if($where != "")
 956             $query .= "where ($where) AND ".$where_auto;
 957         else
 958             $query .= "where ".$where_auto;
 959
 960         if(!empty($order_by))
 961         {
 962             $query .=  ' ORDER BY '. $this->process_order_by($order_by, null);
 963         }
 964
 965         return $query;
 966     }
 967
 968     /**
 969      * Actuall deletes the emailman record
 970      * @param int $id
 971      */
 972     public function mark_deleted($id)
 973         {
 974             $this->db->query("DELETE FROM {$this->table_name} WHERE id=".intval($id));
 975         }
 976 }