modules/Meetings/Meeting.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-2013 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 class Meeting extends SugarBean {
  40         // Stored fields
  41         var $id;
  42         var $date_entered;
  43         var $date_modified;
  44         var $assigned_user_id;
  45         var $modified_user_id;
  46         var $created_by;
  47         var $created_by_name;
  48         var $modified_by_name;
  49         var $description;
  50         var $name;
  51         var $location;
  52         var $status;
  53         var $type;
  54         var $date_start;
  55         var $time_start;
  56         var $date_end;
  57         var $duration_hours;
  58         var $duration_minutes;
  59         var $time_meridiem;
  60         var $parent_type;
  61         var $parent_type_options;
  62         var $parent_id;
  63         var $field_name_map;
  64         var $contact_id;
  65         var $user_id;
  66         var $meeting_id;
  67         var $reminder_time;
  68         var $reminder_checked;
  69         var $email_reminder_time;
  70         var $email_reminder_checked;
  71         var $email_reminder_sent;
  72         var $required;
  73         var $accept_status;
  74         var $parent_name;
  75         var $contact_name;
  76         var $contact_phone;
  77         var $contact_email;
  78         var $account_id;
  79         var $opportunity_id;
  80         var $case_id;
  81         var $assigned_user_name;
  82         var $outlook_id;
  83         var $sequence;
  84         var $syncing = false;
  85         var $recurring_source;
  86
  87         var $update_vcal = true;
  88         var $contacts_arr;
  89         var $users_arr;
  90         var $meetings_arr;
  91         // when assoc w/ a user/contact:
  92         var $minutes_value_default = 15;
  93         var $minutes_values = array('0'=>'00','15'=>'15','30'=>'30','45'=>'45');
  94         var $table_name = "meetings";
  95         var $rel_users_table = "meetings_users";
  96         var $rel_contacts_table = "meetings_contacts";
  97         var $rel_leads_table = "meetings_leads";
  98         var $module_dir = "Meetings";
  99         var $object_name = "Meeting";
 100
 101         var $importable = true;
 102         // This is used to retrieve related fields from form posts.
 103         var $additional_column_fields = array('assigned_user_name', 'assigned_user_id', 'contact_id', 'user_id', 'contact_name', 'accept_status');
 104         var $relationship_fields = array('account_id'=>'accounts','opportunity_id'=>'opportunity','case_id'=>'case',
 105                                                                          'assigned_user_id'=>'users','contact_id'=>'contacts', 'user_id'=>'users', 'meeting_id'=>'meetings');
 106         // so you can run get_users() twice and run query only once
 107         var $cached_get_users = null;
 108         var $new_schema = true;
 109     var $date_changed = false;
 110
 111         /**
 112          * sole constructor
 113          */
 114         function Meeting() {
 115                 parent::SugarBean();
 116                 $this->setupCustomFields('Meetings');
 117                 foreach($this->field_defs as $field) {
 118                         $this->field_name_map[$field['name']] = $field;
 119                 }
 120 //              $this->fill_in_additional_detail_fields();
 121         if(!empty($GLOBALS['app_list_strings']['duration_intervals'])) {
 122             $this->minutes_values = $GLOBALS['app_list_strings']['duration_intervals'];
 123         }
 124         }
 125
 126         /**
 127          * Disable edit if meeting is recurring and source is not Sugar. It should be edited only from Outlook.
 128          * @param $view string
 129          * @param $is_owner bool
 130          */
 131         function ACLAccess($view,$is_owner = 'not_set'){
 132                 // don't check if meeting is being synced from Outlook
 133                 if($this->syncing == false){
 134                         $view = strtolower($view);
 135                         switch($view){
 136                                 case 'edit':
 137                                 case 'save':
 138                                 case 'editview':
 139                                 case 'delete':
 140                                         if(!empty($this->recurring_source) && $this->recurring_source != "Sugar"){
 141                                                 return false;
 142                                         }
 143                         }
 144                 }
 145                 return parent::ACLAccess($view,$is_owner);
 146         }
 147
 148         /**
 149          * Stub for integration
 150          * @return bool
 151          */
 152         function hasIntegratedMeeting() {
 153                 return false;
 154         }
 155
 156         // save date_end by calculating user input
 157         // this is for calendar
 158         function save($check_notify = FALSE) {
 159                 global $timedate;
 160                 global $current_user;
 161
 162                 global $disable_date_format;
 163
 164         if(isset($this->date_start))
 165         {
 166             $td = $timedate->fromDb($this->date_start);
 167             if(!$td){
 168                         $this->date_start = $timedate->to_db($this->date_start);
 169                         $td = $timedate->fromDb($this->date_start);
 170             }
 171             if($td)
 172             {
 173                 if (isset($this->duration_hours) && $this->duration_hours != '')
 174                 {
 175                     $td->modify("+{$this->duration_hours} hours");
 176                 }
 177                 if (isset($this->duration_minutes) && $this->duration_minutes != '')
 178                 {
 179                     $td->modify("+{$this->duration_minutes} mins");
 180                 }
 181                 $this->date_end = $td->asDb();
 182             }
 183         }
 184
 185                 $check_notify =(!empty($_REQUEST['send_invites']) && $_REQUEST['send_invites'] == '1') ? true : false;
 186                 if(empty($_REQUEST['send_invites'])) {
 187                         if(!empty($this->id)) {
 188                                 $old_record = new Meeting();
 189                                 $old_record->retrieve($this->id);
 190                                 $old_assigned_user_id = $old_record->assigned_user_id;
 191                         }
 192                         if((empty($this->id) && isset($_REQUEST['assigned_user_id']) && !empty($_REQUEST['assigned_user_id']) && $GLOBALS['current_user']->id != $_REQUEST['assigned_user_id']) || (isset($old_assigned_user_id) && !empty($old_assigned_user_id) && isset($_REQUEST['assigned_user_id']) && !empty($_REQUEST['assigned_user_id']) && $old_assigned_user_id != $_REQUEST['assigned_user_id']) ){
 193                                 $this->special_notification = true;
 194                                 $check_notify = true;
 195                 if(isset($_REQUEST['assigned_user_name'])) {
 196                     $this->new_assigned_user_name = $_REQUEST['assigned_user_name'];
 197                 }
 198                         }
 199                 }
 200                 /*nsingh 7/3/08  commenting out as bug #20814 is invalid
 201                 if($current_user->getPreference('reminder_time')!= -1 &&  isset($_POST['reminder_checked']) && isset($_POST['reminder_time']) && $_POST['reminder_checked']==0  && $_POST['reminder_time']==-1){
 202                         $this->reminder_checked = '1';
 203                         $this->reminder_time = $current_user->getPreference('reminder_time');
 204                 }*/
 205
 206                 // prevent a mass mailing for recurring meetings created in Calendar module
 207                 if(empty($this->id) && !empty($_REQUEST['module']) && $_REQUEST['module'] == "Calendar" && !empty($_REQUEST['repeat_type']) && !empty($this->repeat_parent_id))
 208                         $check_notify = false;
 209
 210         if (empty($this->status) ) {
 211             $this->status = $this->getDefaultStatus();
 212         }
 213
 214         // Do any external API saving
 215         // Clear out the old external API stuff if we have changed types
 216         if (isset($this->fetched_row) && $this->fetched_row['type'] != $this->type ) {
 217             $this->join_url = '';
 218             $this->host_url = '';
 219             $this->external_id = '';
 220             $this->creator = '';
 221         }
 222
 223         if (!empty($this->type) && $this->type != 'Sugar' ) {
 224             require_once('include/externalAPI/ExternalAPIFactory.php');
 225             $api = ExternalAPIFactory::loadAPI($this->type);
 226         }
 227
 228         if (empty($this->type)) {
 229                         $this->type = 'Sugar';
 230                 }
 231
 232         if ( isset($api) && is_a($api,'WebMeeting') && empty($this->in_relationship_update) ) {
 233             // Make sure the API initialized and it supports Web Meetings
 234             // Also make suer we have an ID, the external site needs something to reference
 235             if ( !isset($this->id) || empty($this->id) ) {
 236                 $this->id = create_guid();
 237                 $this->new_with_id = true;
 238             }
 239             $response = $api->scheduleMeeting($this);
 240             if ( $response['success'] == TRUE ) {
 241                 // Need to send out notifications
 242                 if ( $api->canInvite ) {
 243                     $notifyList = $this->get_notification_recipients();
 244                     foreach($notifyList as $person) {
 245                         $api->inviteAttendee($this,$person,$check_notify);
 246                     }
 247
 248                 }
 249             } else {
 250                 // Generic Message Provides no value to End User - Log the issue with message detail and continue
 251                 // SugarApplication::appendErrorMessage($GLOBALS['app_strings']['ERR_EXTERNAL_API_SAVE_FAIL']);
 252                 $GLOBALS['log']->warn('ERR_EXTERNAL_API_SAVE_FAIL' . ": " . $this->type . " - " .  $response['errorMessage']);
 253             }
 254
 255             $api->logoff();
 256         }
 257
 258                 $return_id = parent::save($check_notify);
 259
 260                 if($this->update_vcal) {
 261                         vCal::cache_sugar_vcal($current_user);
 262                 }
 263
 264
 265
 266                 return $return_id;
 267         }
 268
 269         // this is for calendar
 270         function mark_deleted($id) {
 271
 272                 require_once("modules/Calendar/CalendarUtils.php");
 273                 CalendarUtils::correctRecurrences($this, $id);
 274
 275                 global $current_user;
 276
 277                 parent::mark_deleted($id);
 278
 279                 if($this->update_vcal) {
 280                         vCal::cache_sugar_vcal($current_user);
 281                 }
 282         }
 283
 284         function get_summary_text() {
 285                 return "$this->name";
 286         }
 287
 288     function create_export_query(&$order_by, &$where, $relate_link_join='')
 289     {
 290         $custom_join = $this->getCustomJoin(true, true, $where);
 291         $custom_join['join'] .= $relate_link_join;
 292                 $contact_required = stristr($where, "contacts");
 293
 294                 if($contact_required) {
 295                         $query = "SELECT meetings.*, contacts.first_name, contacts.last_name, contacts.assigned_user_id contact_name_owner, users.user_name as assigned_user_name   ";
 296             $query .= $custom_join['select'];
 297                         $query .= " FROM contacts, meetings, meetings_contacts ";
 298                         $where_auto = " meetings_contacts.contact_id = contacts.id AND meetings_contacts.meeting_id = meetings.id AND meetings.deleted=0 AND contacts.deleted=0";
 299                 } else {
 300                         $query = 'SELECT meetings.*, users.user_name as assigned_user_name  ';
 301             $query .= $custom_join['select'];
 302                         $query .= ' FROM meetings ';
 303                         $where_auto = "meetings.deleted=0";
 304                 }
 305                 $query .= "  LEFT JOIN users ON meetings.assigned_user_id=users.id ";
 306
 307         $query .= $custom_join['join'];
 308
 309                 if($where != "")
 310                         $query .= " where $where AND ".$where_auto;
 311                 else
 312                         $query .= " where ".$where_auto;
 313
 314                 if($order_by != "") {
 315                         $query .= " ORDER BY $order_by";
 316                 } else {
 317                         $alternate_order_by =   $this->process_order_by($order_by, null);
 318                         if($alternate_order_by != "")
 319                                 $query .=       " ORDER BY ". $alternate_order_by;
 320                 }
 321                 return $query;
 322         }
 323
 324
 325
 326         function fill_in_additional_detail_fields() {
 327                 global $locale;
 328                 // Fill in the assigned_user_name
 329                 $this->assigned_user_name = get_assigned_user_name($this->assigned_user_id);
 330
 331                 if (!empty($this->contact_id)) {
 332                         $query  = "SELECT first_name, last_name FROM contacts ";
 333                         $query .= "WHERE id='$this->contact_id' AND deleted=0";
 334                         $result = $this->db->limitQuery($query,0,1,true," Error filling in additional detail fields: ");
 335
 336                         // Get the contact name.
 337                         $row = $this->db->fetchByAssoc($result);
 338                         $GLOBALS['log']->info("additional call fields $query");
 339                         if($row != null)
 340                         {
 341                                 $this->contact_name = $locale->getLocaleFormattedName($row['first_name'], $row['last_name'], '', '');
 342                                 $GLOBALS['log']->debug("Call($this->id): contact_name = $this->contact_name");
 343                                 $GLOBALS['log']->debug("Call($this->id): contact_id = $this->contact_id");
 344                         }
 345                 }
 346
 347
 348
 349                 $this->created_by_name = get_assigned_user_name($this->created_by);
 350                 $this->modified_by_name = get_assigned_user_name($this->modified_user_id);
 351                 $this->fill_in_additional_parent_fields();
 352
 353                 if (!isset($this->time_hour_start)) {
 354                         $this->time_start_hour = intval(substr($this->time_start, 0, 2));
 355                 } //if-else
 356
 357                 if (isset($this->time_minute_start)) {
 358                         $time_start_minutes = $this->time_minute_start;
 359                 } else {
 360                         $time_start_minutes = substr($this->time_start, 3, 5);
 361                         if ($time_start_minutes > 0 && $time_start_minutes < 15) {
 362                                 $time_start_minutes = "15";
 363                         } else if ($time_start_minutes > 15 && $time_start_minutes < 30) {
 364                                 $time_start_minutes = "30";
 365                         } else if ($time_start_minutes > 30 && $time_start_minutes < 45) {
 366                                 $time_start_minutes = "45";
 367                         } else if ($time_start_minutes > 45) {
 368                                 $this->time_start_hour += 1;
 369                                 $time_start_minutes = "00";
 370                     } //if-else
 371                 } //if-else
 372
 373
 374                 if (isset($this->time_hour_start)) {
 375                         $time_start_hour = $this->time_hour_start;
 376                 } else {
 377                         $time_start_hour = intval(substr($this->time_start, 0, 2));
 378                 }
 379
 380                 global $timedate;
 381         $this->time_meridiem = $timedate->AMPMMenu('', $this->time_start, 'onchange="SugarWidgetScheduler.update_time();"');
 382                 $hours_arr = array ();
 383                 $num_of_hours = 13;
 384                 $start_at = 1;
 385
 386                 if (empty ($time_meridiem)) {
 387                         $num_of_hours = 24;
 388                         $start_at = 0;
 389                 } //if
 390
 391                 for ($i = $start_at; $i < $num_of_hours; $i ++) {
 392                         $i = $i."";
 393                         if (strlen($i) == 1) {
 394                                 $i = "0".$i;
 395                         }
 396                         $hours_arr[$i] = $i;
 397                 } //for
 398
 399         if (!isset($this->duration_minutes)) {
 400                         $this->duration_minutes = $this->minutes_value_default;
 401                 }
 402
 403         //setting default date and time
 404                 if (is_null($this->date_start))
 405                         $this->date_start = $timedate->now();
 406                 if (is_null($this->time_start))
 407                         $this->time_start = $timedate->to_display_time(TimeDate::getInstance()->nowDb(), true);
 408                 if (is_null($this->duration_hours)) {
 409                         $this->duration_hours = "0";
 410                 }
 411                 if (is_null($this->duration_minutes))
 412                         $this->duration_minutes = "1";
 413
 414                 if(empty($this->id) && !empty($_REQUEST['date_start'])){
 415                         $this->date_start = $_REQUEST['date_start'];
 416                 }
 417         if(!empty($this->date_start))
 418         {
 419             $td = SugarDateTime::createFromFormat($GLOBALS['timedate']->get_date_time_format(),$this->date_start);
 420             if (!empty($td))
 421             {
 422                 if (!empty($this->duration_hours) && $this->duration_hours != '')
 423                 {
 424                             $td = $td->modify("+{$this->duration_hours} hours");
 425                         }
 426                 if (!empty($this->duration_minutes) && $this->duration_minutes != '')
 427                 {
 428                     $td = $td->modify("+{$this->duration_minutes} mins");
 429                 }
 430                 $this->date_end = $td->format($GLOBALS['timedate']->get_date_time_format());
 431             }
 432             else
 433             {
 434                 $GLOBALS['log']->fatal("Meeting::save: Bad date {$this->date_start} for format ".$GLOBALS['timedate']->get_date_time_format());
 435             }
 436                 }
 437
 438                 global $app_list_strings;
 439                 $parent_types = $app_list_strings['record_type_display'];
 440                 $disabled_parent_types = ACLController::disabledModuleList($parent_types,false, 'list');
 441                 foreach($disabled_parent_types as $disabled_parent_type){
 442                         if($disabled_parent_type != $this->parent_type){
 443                                 unset($parent_types[$disabled_parent_type]);
 444                         }
 445                 }
 446
 447                 $this->parent_type_options = get_select_options_with_id($parent_types, $this->parent_type);
 448                 if (empty($this->reminder_time)) {
 449                         $this->reminder_time = -1;
 450                 }
 451
 452                 if ( empty($this->id) ) {
 453                     $reminder_t = $GLOBALS['current_user']->getPreference('reminder_time');
 454                     if ( isset($reminder_t) )
 455                         $this->reminder_time = $reminder_t;
 456                 }
 457                 $this->reminder_checked = $this->reminder_time == -1 ? false : true;
 458
 459                 if (empty($this->email_reminder_time)) {
 460                         $this->email_reminder_time = -1;
 461                 }
 462                 if(empty($this->id)){
 463                         $reminder_t = $GLOBALS['current_user']->getPreference('email_reminder_time');
 464                         if(isset($reminder_t))
 465                                 $this->email_reminder_time = $reminder_t;
 466                 }
 467                 $this->email_reminder_checked = $this->email_reminder_time == -1 ? false : true;
 468
 469                 if (isset ($_REQUEST['parent_type']) && empty($this->parent_type)) {
 470                         $this->parent_type = $_REQUEST['parent_type'];
 471                 } elseif (is_null($this->parent_type)) {
 472                         $this->parent_type = $app_list_strings['record_type_default_key'];
 473                 }
 474
 475         }
 476
 477         function get_list_view_data() {
 478                 $meeting_fields = $this->get_list_view_array();
 479
 480                 global $app_list_strings, $focus, $action, $currentModule;
 481                 if(isset($this->parent_type))
 482                         $meeting_fields['PARENT_MODULE'] = $this->parent_type;
 483                 if($this->status == "Planned") {
 484                         //cn: added this if() to deal with sequential Closes in Meetings.       this is a hack to a hack(formbase.php->handleRedirect)
 485                         if(empty($action))
 486                              $action = "index";
 487             $setCompleteUrl = "<a id='{$this->id}' onclick='SUGAR.util.closeActivityPanel.show(\"{$this->module_dir}\",\"{$this->id}\",\"Held\",\"listview\",\"1\");'>";
 488                         if ($this->ACLAccess('edit')) {
 489                 $meeting_fields['SET_COMPLETE'] = $setCompleteUrl . SugarThemeRegistry::current()->getImage("close_inline"," border='0'",null,null,'.gif',translate('LBL_CLOSEINLINE'))."</a>";
 490             } else {
 491                 $meeting_fields['SET_COMPLETE'] = '';
 492             }
 493                 }
 494                 global $timedate;
 495                 $today = $timedate->nowDb();
 496                 $nextday = $timedate->asDbDate($timedate->getNow()->get("+1 day"));
 497                 $mergeTime = $meeting_fields['DATE_START']; //$timedate->merge_date_time($meeting_fields['DATE_START'], $meeting_fields['TIME_START']);
 498                 $date_db = $timedate->to_db($mergeTime);
 499                 if($date_db     < $today        ) {
 500                         $meeting_fields['DATE_START']= "<font class='overdueTask'>".$meeting_fields['DATE_START']."</font>";
 501                 }else if($date_db       < $nextday) {
 502                         $meeting_fields['DATE_START'] = "<font class='todaysTask'>".$meeting_fields['DATE_START']."</font>";
 503                 } else {
 504                         $meeting_fields['DATE_START'] = "<font class='futureTask'>".$meeting_fields['DATE_START']."</font>";
 505                 }
 506                 $this->fill_in_additional_detail_fields();
 507
 508         // make sure we grab the localized version of the contact name, if a contact is provided
 509         if (!empty($this->contact_id))
 510         {
 511             $contact_temp = BeanFactory::getBean("Contacts", $this->contact_id);
 512             if (!empty($contact_temp))
 513             {
 514                 // Make first name, last name, salutation and title of Contacts respect field level ACLs
 515                 $contact_temp->_create_proper_name_field();
 516                 $this->contact_name = $contact_temp->full_name;
 517             }
 518         }
 519
 520         $meeting_fields['CONTACT_ID'] = $this->contact_id;
 521         $meeting_fields['CONTACT_NAME'] = $this->contact_name;
 522                 $meeting_fields['PARENT_NAME'] = $this->parent_name;
 523         $meeting_fields['REMINDER_CHECKED'] = $this->reminder_time==-1 ? false : true;
 524         $meeting_fields['EMAIL_REMINDER_CHECKED'] = $this->email_reminder_time==-1 ? false : true;
 525
 526
 527                 return $meeting_fields;
 528         }
 529
 530         function set_notification_body($xtpl, &$meeting) {
 531                 global $sugar_config;
 532                 global $app_list_strings;
 533                 global $current_user;
 534                 global $timedate;
 535
 536
 537                 // cn: bug 9494 - passing a contact breaks this call
 538                 $notifyUser =($meeting->current_notify_user->object_name == 'User') ? $meeting->current_notify_user : $current_user;
 539                 // cn: bug 8078 - fixed call to $timedate
 540                 if(strtolower(get_class($meeting->current_notify_user)) == 'contact') {
 541                         $xtpl->assign("ACCEPT_URL", $sugar_config['site_url'].
 542                                                         '/index.php?entryPoint=acceptDecline&module=Meetings&contact_id='.$meeting->current_notify_user->id.'&record='.$meeting->id);
 543                 } elseif(strtolower(get_class($meeting->current_notify_user)) == 'lead') {
 544                         $xtpl->assign("ACCEPT_URL", $sugar_config['site_url'].
 545                                                         '/index.php?entryPoint=acceptDecline&module=Meetings&lead_id='.$meeting->current_notify_user->id.'&record='.$meeting->id);
 546                 } else {
 547                         $xtpl->assign("ACCEPT_URL", $sugar_config['site_url'].
 548                                                         '/index.php?entryPoint=acceptDecline&module=Meetings&user_id='.$meeting->current_notify_user->id.'&record='.$meeting->id);
 549                 }
 550                 $xtpl->assign("MEETING_TO", $meeting->current_notify_user->new_assigned_user_name);
 551                 $xtpl->assign("MEETING_SUBJECT", trim($meeting->name));
 552                 $xtpl->assign("MEETING_STATUS",(isset($meeting->status)? $app_list_strings['meeting_status_dom'][$meeting->status]:""));
 553                 $typekey = strtolower($meeting->type);
 554                 if(isset($meeting->type)) {
 555                     if(!empty($app_list_strings['eapm_list'][$typekey])) {
 556                     $typestring = $app_list_strings['eapm_list'][$typekey];
 557                 } else {
 558                         $typestring = $app_list_strings['meeting_type_dom'][$meeting->type];
 559                     }
 560                 }
 561                 $xtpl->assign("MEETING_TYPE", isset($meeting->type)? $typestring:"");
 562                 $startdate = $timedate->fromDb($meeting->date_start);
 563                 $xtpl->assign("MEETING_STARTDATE", $timedate->asUser($startdate, $notifyUser)." ".TimeDate::userTimezoneSuffix($startdate, $notifyUser));
 564                 $enddate = $timedate->fromDb($meeting->date_end);
 565                 $xtpl->assign("MEETING_ENDDATE", $timedate->asUser($enddate, $notifyUser)." ".TimeDate::userTimezoneSuffix($enddate, $notifyUser));
 566                 $xtpl->assign("MEETING_HOURS", $meeting->duration_hours);
 567                 $xtpl->assign("MEETING_MINUTES", $meeting->duration_minutes);
 568                 $xtpl->assign("MEETING_DESCRIPTION", $meeting->description);
 569         if ( !empty($meeting->join_url) ) {
 570             $xtpl->assign('MEETING_URL', $meeting->join_url);
 571             $xtpl->parse('Meeting.Meeting_External_API');
 572         }
 573
 574                 return $xtpl;
 575         }
 576
 577         /**
 578          * Redefine method to attach ics file to notification email
 579          */
 580         public function create_notification_email($notify_user){
 581         // reset acceptance status for non organizer if date is changed
 582         if (($notify_user->id != $GLOBALS['current_user']->id) && $this->date_changed) {
 583             $this->set_accept_status($notify_user, 'none');
 584         }
 585
 586                 $notify_mail = parent::create_notification_email($notify_user);
 587
 588                 $path = SugarConfig::getInstance()->get('upload_dir','upload/') . $this->id;
 589
 590                 require_once("modules/vCals/vCal.php");
 591                 $content = vCal::get_ical_event($this, $GLOBALS['current_user']);
 592
 593                 if(file_put_contents($path,$content)){
 594                         $notify_mail->AddAttachment($path, 'meeting.ics', 'base64', 'text/calendar');
 595                 }
 596                 return $notify_mail;
 597         }
 598
 599         /**
 600          * Redefine method to remove ics after email is sent
 601          */
 602         public function send_assignment_notifications($notify_user, $admin){
 603                 parent::send_assignment_notifications($notify_user, $admin);
 604
 605                 $path = SugarConfig::getInstance()->get('upload_dir','upload/') . $this->id;
 606                 unlink($path);
 607         }
 608
 609         function get_meeting_users() {
 610                 $template = new User();
 611                 // First, get the list of IDs.
 612                 $query = "SELECT meetings_users.required, meetings_users.accept_status, meetings_users.user_id from meetings_users where meetings_users.meeting_id='$this->id' AND meetings_users.deleted=0";
 613                 $GLOBALS['log']->debug("Finding linked records $this->object_name: ".$query);
 614                 $result = $this->db->query($query, true);
 615                 $list = Array();
 616
 617                 while($row = $this->db->fetchByAssoc($result)) {
 618                         $template = new User(); // PHP 5 will retrieve by reference, always over-writing the "old" one
 619                         $record = $template->retrieve($row['user_id']);
 620                         $template->required = $row['required'];
 621                         $template->accept_status = $row['accept_status'];
 622
 623                         if($record != null) {
 624                                 // this copies the object into the array
 625                                 $list[] = $template;
 626                         }
 627                 }
 628                 return $list;
 629         }
 630
 631         function get_invite_meetings(&$user) {
 632                 $template = $this;
 633                 // First, get the list of IDs.
 634                 $GLOBALS['log']->debug("Finding linked records $this->object_name: ".$query);
 635                 $query = "SELECT meetings_users.required, meetings_users.accept_status, meetings_users.meeting_id from meetings_users where meetings_users.user_id='$user->id' AND( meetings_users.accept_status IS NULL OR     meetings_users.accept_status='none') AND meetings_users.deleted=0";
 636                 $result = $this->db->query($query, true);
 637                 $list = Array();
 638
 639                 while($row = $this->db->fetchByAssoc($result)) {
 640                         $record = $template->retrieve($row['meeting_id']);
 641                         $template->required = $row['required'];
 642                         $template->accept_status = $row['accept_status'];
 643
 644
 645                         if($record != null)
 646                         {
 647                         // this copies the object into the array
 648                         $list[] = $template;
 649                         }
 650                 }
 651                 return $list;
 652         }
 653
 654
 655         function set_accept_status(&$user,$status)
 656         {
 657                 if($user->object_name == 'User')
 658                 {
 659                         $relate_values = array('user_id'=>$user->id,'meeting_id'=>$this->id);
 660                         $data_values = array('accept_status'=>$status);
 661                         $this->set_relationship($this->rel_users_table, $relate_values, true, true,$data_values);
 662                         global $current_user;
 663
 664                         if($this->update_vcal)
 665                         {
 666                                 vCal::cache_sugar_vcal($user);
 667                         }
 668                 }
 669                 else if($user->object_name == 'Contact')
 670                 {
 671                         $relate_values = array('contact_id'=>$user->id,'meeting_id'=>$this->id);
 672                         $data_values = array('accept_status'=>$status);
 673                         $this->set_relationship($this->rel_contacts_table, $relate_values, true, true,$data_values);
 674                 }
 675         else if($user->object_name == 'Lead')
 676                 {
 677                         $relate_values = array('lead_id'=>$user->id,'meeting_id'=>$this->id);
 678                         $data_values = array('accept_status'=>$status);
 679                         $this->set_relationship($this->rel_leads_table, $relate_values, true, true,$data_values);
 680                 }
 681         }
 682
 683
 684         function get_notification_recipients() {
 685                 if($this->special_notification) {
 686                         return parent::get_notification_recipients();
 687                 }
 688
 689                 $list = array();
 690                 if(!is_array($this->contacts_arr)) {
 691                         $this->contacts_arr =   array();
 692                 }
 693
 694                 if(!is_array($this->users_arr)) {
 695                         $this->users_arr =      array();
 696                 }
 697
 698         if(!is_array($this->leads_arr)) {
 699                         $this->leads_arr =      array();
 700                 }
 701
 702                 foreach($this->users_arr as $user_id) {
 703                         $notify_user = new User();
 704                         $notify_user->retrieve($user_id);
 705                         $notify_user->new_assigned_user_name = $notify_user->full_name;
 706                         $GLOBALS['log']->info("Notifications: recipient is $notify_user->new_assigned_user_name");
 707                         $list[$notify_user->id] = $notify_user;
 708                 }
 709
 710                 foreach($this->contacts_arr as $contact_id) {
 711                         $notify_user = new Contact();
 712                         $notify_user->retrieve($contact_id);
 713                         $notify_user->new_assigned_user_name = $notify_user->full_name;
 714                         $GLOBALS['log']->info("Notifications: recipient is $notify_user->new_assigned_user_name");
 715                         $list[$notify_user->id] = $notify_user;
 716                 }
 717
 718         foreach($this->leads_arr as $lead_id) {
 719                         $notify_user = new Lead();
 720                         $notify_user->retrieve($lead_id);
 721                         $notify_user->new_assigned_user_name = $notify_user->full_name;
 722                         $GLOBALS['log']->info("Notifications: recipient is $notify_user->new_assigned_user_name");
 723                         $list[$notify_user->id] = $notify_user;
 724                 }
 725
 726                 return $list;
 727         }
 728
 729
 730         function bean_implements($interface) {
 731                 switch($interface) {
 732                         case 'ACL':return true;
 733                 }
 734                 return false;
 735         }
 736
 737         function listviewACLHelper() {
 738                 $array_assign = parent::listviewACLHelper();
 739                 $is_owner = false;
 740                 if(!empty($this->parent_name)) {
 741
 742                         if(!empty($this->parent_name_owner)) {
 743                                 global $current_user;
 744                                 $is_owner = $current_user->id == $this->parent_name_owner;
 745                         }
 746                 }
 747
 748                 if(!ACLController::moduleSupportsACL($this->parent_type) || ACLController::checkAccess($this->parent_type, 'view', $is_owner)) {
 749                         $array_assign['PARENT'] = 'a';
 750                 } else {
 751                         $array_assign['PARENT'] = 'span';
 752                 }
 753
 754                 $is_owner = false;
 755
 756                 if(!empty($this->contact_name)) {
 757                         if(!empty($this->contact_name_owner)) {
 758                                 global $current_user;
 759                                 $is_owner = $current_user->id == $this->contact_name_owner;
 760                         }
 761                 }
 762
 763                 if(ACLController::checkAccess('Contacts', 'view', $is_owner)) {
 764                         $array_assign['CONTACT'] = 'a';
 765                 } else {
 766                         $array_assign['CONTACT'] = 'span';
 767                 }
 768                 return $array_assign;
 769         }
 770
 771
 772         function save_relationship_changes($is_update) {
 773                 $exclude = array();
 774             if(empty($this->in_workflow)) {
 775            if(empty($this->in_import)){//if a meeting is being imported then contact_id  should not be excluded
 776            //if the global soap_server_object variable is not empty (as in from a soap/OPI call), then process the assigned_user_id relationship, otherwise
 777            //add assigned_user_id to exclude list and let the logic from MeetingFormBase determine whether assigned user id gets added to the relationship
 778                 if(!empty($GLOBALS['soap_server_object'])){
 779                         $exclude = array('contact_id', 'user_id');
 780                 }else{
 781                         $exclude = array('contact_id', 'user_id','assigned_user_id');
 782                 }
 783            }
 784            else{
 785                 $exclude = array('user_id');
 786            }
 787         }
 788        parent::save_relationship_changes($is_update, $exclude);
 789         }
 790
 791
 792         /**
 793          * @see SugarBean::afterImportSave()
 794          */
 795         public function afterImportSave()
 796         {
 797             if ( $this->parent_type == 'Contacts' ) {
 798                 $this->load_relationship('contacts');
 799                 if ( !$this->contacts->relationship_exists('contacts',array('id'=>$this->parent_id)) )
 800                     $this->contacts->add($this->parent_id);
 801             }
 802             elseif ( $this->parent_type == 'Leads' ) {
 803                 $this->load_relationship('leads');
 804                 if ( !$this->leads->relationship_exists('leads',array('id'=>$this->parent_id)) )
 805                     $this->leads->add($this->parent_id);
 806             }
 807
 808             parent::afterImportSave();
 809         }
 810
 811     public function getDefaultStatus()
 812     {
 813          $def = $this->field_defs['status'];
 814          if (isset($def['default'])) {
 815              return $def['default'];
 816          } else {
 817             $app = return_app_list_strings_language($GLOBALS['current_language']);
 818             if (isset($def['options']) && isset($app[$def['options']])) {
 819                 $keys = array_keys($app[$def['options']]);
 820                 return $keys[0];
 821             }
 822         }
 823         return '';
 824     }
 825
 826 } // end class def
 827
 828 // External API integration, for the dropdown list of what external API's are available
 829 //TODO: do we really need focus, name and view params for this function
 830 function getMeetingsExternalApiDropDown($focus = null, $name = null, $value = null, $view = null)
 831 {
 832         global $dictionary, $app_list_strings;
 833
 834         $cacheKeyName = 'meetings_type_drop_down';
 835
 836     $apiList = sugar_cache_retrieve($cacheKeyName);
 837     if ($apiList === null)
 838     {
 839         require_once('include/externalAPI/ExternalAPIFactory.php');
 840
 841         $apiList = ExternalAPIFactory::getModuleDropDown('Meetings');
 842         $apiList = array_merge(array('Sugar'=>$GLOBALS['app_list_strings']['eapm_list']['Sugar']), $apiList);
 843         sugar_cache_put($cacheKeyName, $apiList);
 844     }
 845
 846         if(!empty($value) && empty($apiList[$value]))
 847         {
 848                 $apiList[$value] = $value;
 849     }
 850         //bug 46294: adding list of options to dropdown list (if it is not the default list)
 851     if ($dictionary['Meeting']['fields']['type']['options'] != "eapm_list")
 852     {
 853         $apiList = array_merge(getMeetingTypeOptions($dictionary, $app_list_strings), $apiList);
 854     }
 855
 856         return $apiList;
 857 }
 858
 859 /**
 860  * Meeting Type Options Array for dropdown list
 861  * @param array $dictionary - getting type name
 862  * @param array $app_list_strings - getting type options
 863  * @return array Meeting Type Options Array for dropdown list
 864  */
 865 function getMeetingTypeOptions($dictionary, $app_list_strings)
 866 {
 867         $result = array();
 868
 869     // getting name of meeting type to fill dropdown list by its values
 870     if (isset($dictionary['Meeting']['fields']['type']['options']))
 871         {
 872         $typeName = $dictionary['Meeting']['fields']['type']['options'];
 873
 874         if (!empty($app_list_strings[$typeName]))
 875                 {
 876                 $typeList = $app_list_strings[$typeName];
 877
 878             foreach ($typeList as $key => $value)
 879                         {
 880                                 $result[$value] = $value;
 881             }
 882         }
 883     }
 884
 885     return $result;
 886 }