]> CyberLeo.Net >> Repos - Github/sugarcrm.git/blob - modules/Meetings/Meeting.php
Release 6.5.0
[Github/sugarcrm.git] / 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-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 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
110         /**
111          * sole constructor
112          */
113         function Meeting() {
114                 parent::SugarBean();
115                 $this->setupCustomFields('Meetings');
116                 foreach($this->field_defs as $field) {
117                         $this->field_name_map[$field['name']] = $field;
118                 }
119 //              $this->fill_in_additional_detail_fields();
120         if(!empty($GLOBALS['app_list_strings']['duration_intervals'])) {
121             $this->minutes_values = $GLOBALS['app_list_strings']['duration_intervals'];
122         }
123         }
124         
125         /**
126          * Disable edit if meeting is recurring and source is not Sugar. It should be edited only from Outlook.
127          * @param $view string
128          * @param $is_owner bool
129          */
130         function ACLAccess($view,$is_owner = 'not_set'){
131                 // don't check if meeting is being synced from Outlook
132                 if($this->syncing == false){
133                         $view = strtolower($view);
134                         switch($view){
135                                 case 'edit':
136                                 case 'save':
137                                 case 'editview':
138                                 case 'delete':
139                                         if(!empty($this->recurring_source) && $this->recurring_source != "Sugar"){
140                                                 return false;
141                                         }
142                         }
143                 }
144                 return parent::ACLAccess($view,$is_owner);
145         }
146
147         /**
148          * Stub for integration
149          * @return bool
150          */
151         function hasIntegratedMeeting() {
152                 return false;
153         }
154
155         // save date_end by calculating user input
156         // this is for calendar
157         function save($check_notify = FALSE) {
158                 global $timedate;
159                 global $current_user;
160
161                 global $disable_date_format;
162
163             if(isset($this->date_start) && isset($this->duration_hours) && isset($this->duration_minutes))
164         {
165                 if(isset($this->date_start) && isset($this->duration_hours) && isset($this->duration_minutes))
166                 {
167                     $td = $timedate->fromDb($this->date_start);
168                     if(!$td){
169                                 $this->date_start = $timedate->to_db($this->date_start);
170                                 $td = $timedate->fromDb($this->date_start);
171                     }
172                     if($td)
173                     {
174                                 $this->date_end = $td->modify("+{$this->duration_hours} hours {$this->duration_minutes} mins")->asDb();
175                     }
176                 }
177                 }
178
179                 $check_notify =(!empty($_REQUEST['send_invites']) && $_REQUEST['send_invites'] == '1') ? true : false;
180                 if(empty($_REQUEST['send_invites'])) {
181                         if(!empty($this->id)) {
182                                 $old_record = new Meeting();
183                                 $old_record->retrieve($this->id);
184                                 $old_assigned_user_id = $old_record->assigned_user_id;
185                         }
186                         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']) ){
187                                 $this->special_notification = true;
188                                 $check_notify = true;
189                 if(isset($_REQUEST['assigned_user_name'])) {
190                     $this->new_assigned_user_name = $_REQUEST['assigned_user_name'];
191                 }
192                         }
193                 }
194                 /*nsingh 7/3/08  commenting out as bug #20814 is invalid
195                 if($current_user->getPreference('reminder_time')!= -1 &&  isset($_POST['reminder_checked']) && isset($_POST['reminder_time']) && $_POST['reminder_checked']==0  && $_POST['reminder_time']==-1){
196                         $this->reminder_checked = '1';
197                         $this->reminder_time = $current_user->getPreference('reminder_time');
198                 }*/
199
200                 // prevent a mass mailing for recurring meetings created in Calendar module
201                 if(empty($this->id) && !empty($_REQUEST['module']) && $_REQUEST['module'] == "Calendar" && !empty($_REQUEST['repeat_type']) && !empty($this->repeat_parent_id))
202                         $check_notify = false;
203
204         if (empty($this->status) ) {
205             $this->status = $this->getDefaultStatus();
206         }
207
208         // Do any external API saving
209         // Clear out the old external API stuff if we have changed types
210         if (isset($this->fetched_row) && $this->fetched_row['type'] != $this->type ) {
211             $this->join_url = '';
212             $this->host_url = '';
213             $this->external_id = '';
214             $this->creator = '';
215         }
216
217         if (!empty($this->type) && $this->type != 'Sugar' ) {
218             require_once('include/externalAPI/ExternalAPIFactory.php');
219             $api = ExternalAPIFactory::loadAPI($this->type);
220         }
221
222         if (empty($this->type)) {
223                         $this->type = 'Sugar';
224                 }
225
226         if ( isset($api) && is_a($api,'WebMeeting') && empty($this->in_relationship_update) ) {
227             // Make sure the API initialized and it supports Web Meetings
228             // Also make suer we have an ID, the external site needs something to reference
229             if ( !isset($this->id) || empty($this->id) ) {
230                 $this->id = create_guid();
231                 $this->new_with_id = true;
232             }
233             $response = $api->scheduleMeeting($this);
234             if ( $response['success'] == TRUE ) {
235                 // Need to send out notifications
236                 if ( $api->canInvite ) {
237                     $notifyList = $this->get_notification_recipients();
238                     foreach($notifyList as $person) {
239                         $api->inviteAttendee($this,$person,$check_notify);
240                     }
241
242                 }
243             } else {
244                 SugarApplication::appendErrorMessage($GLOBALS['app_strings']['ERR_EXTERNAL_API_SAVE_FAIL']);
245                 return $this->id;
246             }
247
248             $api->logoff();
249         }
250
251                 $return_id = parent::save($check_notify);
252
253                 if($this->update_vcal) {
254                         vCal::cache_sugar_vcal($current_user);
255                 }
256
257
258
259                 return $return_id;
260         }
261
262         // this is for calendar
263         function mark_deleted($id) {
264
265                 require_once("modules/Calendar/CalendarUtils.php");
266                 CalendarUtils::correctRecurrences($this, $id);          
267                 
268                 global $current_user;
269
270                 parent::mark_deleted($id);
271
272                 if($this->update_vcal) {
273                         vCal::cache_sugar_vcal($current_user);
274                 }
275         }
276
277         function get_summary_text() {
278                 return "$this->name";
279         }
280
281     function create_export_query(&$order_by, &$where, $relate_link_join='')
282     {
283         $custom_join = $this->custom_fields->getJOIN(true, true,$where);
284                 if($custom_join)
285                                 $custom_join['join'] .= $relate_link_join;
286                 $contact_required = stristr($where, "contacts");
287
288                 if($contact_required) {
289                         $query = "SELECT meetings.*, contacts.first_name, contacts.last_name, contacts.assigned_user_id contact_name_owner, users.user_name as assigned_user_name   ";
290                         if($custom_join) {
291                                 $query .= $custom_join['select'];
292                         }
293                         $query .= " FROM contacts, meetings, meetings_contacts ";
294                         $where_auto = " meetings_contacts.contact_id = contacts.id AND meetings_contacts.meeting_id = meetings.id AND meetings.deleted=0 AND contacts.deleted=0";
295                 } else {
296                         $query = 'SELECT meetings.*, users.user_name as assigned_user_name  ';
297                         if($custom_join) {
298                                 $query .= $custom_join['select'];
299                         }
300                         $query .= ' FROM meetings ';
301                         $where_auto = "meetings.deleted=0";
302                 }
303                 $query .= "  LEFT JOIN users ON meetings.assigned_user_id=users.id ";
304
305                 if($custom_join) {
306                         $query .= $custom_join['join'];
307                 }
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                     $start = SugarDateTime::createFromFormat($GLOBALS['timedate']->get_date_time_format(),$this->date_start);
419                     if (!empty($start)) {
420                         if (!empty($this->duration_hours) || !empty($this->duration_minutes)) {
421                             $this->date_end = $start->modify("+{$this->duration_hours} Hours +{$this->duration_minutes} Minutes")
422                             ->format($GLOBALS['timedate']->get_date_time_format());
423                         }
424                     } else {
425                         $GLOBALS['log']->fatal("Meeting::save: Bad date {$this->date_start} for format ".$GLOBALS['timedate']->get_date_time_format());
426                     }
427                 }
428
429                 global $app_list_strings;
430                 $parent_types = $app_list_strings['record_type_display'];
431                 $disabled_parent_types = ACLController::disabledModuleList($parent_types,false, 'list');
432                 foreach($disabled_parent_types as $disabled_parent_type){
433                         if($disabled_parent_type != $this->parent_type){
434                                 unset($parent_types[$disabled_parent_type]);
435                         }
436                 }
437
438                 $this->parent_type_options = get_select_options_with_id($parent_types, $this->parent_type);
439                 if (empty($this->reminder_time)) {
440                         $this->reminder_time = -1;
441                 }
442
443                 if ( empty($this->id) ) {
444                     $reminder_t = $GLOBALS['current_user']->getPreference('reminder_time');
445                     if ( isset($reminder_t) )
446                         $this->reminder_time = $reminder_t;
447                 }
448                 $this->reminder_checked = $this->reminder_time == -1 ? false : true;
449
450                 if (empty($this->email_reminder_time)) {
451                         $this->email_reminder_time = -1;
452                 }
453                 if(empty($this->id)){ 
454                         $reminder_t = $GLOBALS['current_user']->getPreference('email_reminder_time');
455                         if(isset($reminder_t))
456                                 $this->email_reminder_time = $reminder_t;
457                 }
458                 $this->email_reminder_checked = $this->email_reminder_time == -1 ? false : true;
459
460                 if (isset ($_REQUEST['parent_type'])) {
461                         $this->parent_type = $_REQUEST['parent_type'];
462                 } elseif (is_null($this->parent_type)) {
463                         $this->parent_type = $app_list_strings['record_type_default_key'];
464                 }
465
466         }
467
468         function get_list_view_data() {
469                 $meeting_fields = $this->get_list_view_array();
470
471                 global $app_list_strings, $focus, $action, $currentModule;
472                 if(isset($this->parent_type))
473                         $meeting_fields['PARENT_MODULE'] = $this->parent_type;
474                 if($this->status == "Planned") {
475                         //cn: added this if() to deal with sequential Closes in Meetings.       this is a hack to a hack(formbase.php->handleRedirect)
476                         if(empty($action))
477                              $action = "index";
478             $setCompleteUrl = "<a id='{$this->id}' onclick='SUGAR.util.closeActivityPanel.show(\"{$this->module_dir}\",\"{$this->id}\",\"Held\",\"listview\",\"1\");'>";
479                         if ($this->ACLAccess('edit')) {
480                 $meeting_fields['SET_COMPLETE'] = $setCompleteUrl . SugarThemeRegistry::current()->getImage("close_inline"," border='0'",null,null,'.gif',translate('LBL_CLOSEINLINE'))."</a>";
481             } else {
482                 $meeting_fields['SET_COMPLETE'] = '';
483             }                   
484                 }
485                 global $timedate;
486                 $today = $timedate->nowDb();
487                 $nextday = $timedate->asDbDate($timedate->getNow()->get("+1 day"));
488                 $mergeTime = $meeting_fields['DATE_START']; //$timedate->merge_date_time($meeting_fields['DATE_START'], $meeting_fields['TIME_START']);
489                 $date_db = $timedate->to_db($mergeTime);
490                 if($date_db     < $today        ) {
491                         $meeting_fields['DATE_START']= "<font class='overdueTask'>".$meeting_fields['DATE_START']."</font>";
492                 }else if($date_db       < $nextday) {
493                         $meeting_fields['DATE_START'] = "<font class='todaysTask'>".$meeting_fields['DATE_START']."</font>";
494                 } else {
495                         $meeting_fields['DATE_START'] = "<font class='futureTask'>".$meeting_fields['DATE_START']."</font>";
496                 }
497                 $this->fill_in_additional_detail_fields();
498
499                 //make sure we grab the localized version of the contact name, if a contact is provided
500                 if (!empty($this->contact_id)) {
501                         global $locale;
502             // Bug# 46125 - make first name, last name, salutation and title of Contacts respect field level ACLs
503             $contact_temp = new Contact();
504             $contact_temp->retrieve($this->contact_id);
505             $contact_temp->_create_proper_name_field();
506             $this->contact_name = $contact_temp->full_name;
507                 }
508
509         $meeting_fields['CONTACT_ID'] = $this->contact_id;
510         $meeting_fields['CONTACT_NAME'] = $this->contact_name;
511                 $meeting_fields['PARENT_NAME'] = $this->parent_name;
512         $meeting_fields['REMINDER_CHECKED'] = $this->reminder_time==-1 ? false : true;
513         $meeting_fields['EMAIL_REMINDER_CHECKED'] = $this->email_reminder_time==-1 ? false : true;
514
515
516                 return $meeting_fields;
517         }
518
519         function set_notification_body($xtpl, &$meeting) {
520                 global $sugar_config;
521                 global $app_list_strings;
522                 global $current_user;
523                 global $timedate;
524
525
526                 // cn: bug 9494 - passing a contact breaks this call
527                 $notifyUser =($meeting->current_notify_user->object_name == 'User') ? $meeting->current_notify_user : $current_user;
528                 // cn: bug 8078 - fixed call to $timedate
529                 if(strtolower(get_class($meeting->current_notify_user)) == 'contact') {
530                         $xtpl->assign("ACCEPT_URL", $sugar_config['site_url'].
531                                                         '/index.php?entryPoint=acceptDecline&module=Meetings&contact_id='.$meeting->current_notify_user->id.'&record='.$meeting->id);
532                 } elseif(strtolower(get_class($meeting->current_notify_user)) == 'lead') {
533                         $xtpl->assign("ACCEPT_URL", $sugar_config['site_url'].
534                                                         '/index.php?entryPoint=acceptDecline&module=Meetings&lead_id='.$meeting->current_notify_user->id.'&record='.$meeting->id);
535                 } else {
536                         $xtpl->assign("ACCEPT_URL", $sugar_config['site_url'].
537                                                         '/index.php?entryPoint=acceptDecline&module=Meetings&user_id='.$meeting->current_notify_user->id.'&record='.$meeting->id);
538                 }
539                 $xtpl->assign("MEETING_TO", $meeting->current_notify_user->new_assigned_user_name);
540                 $xtpl->assign("MEETING_SUBJECT", trim($meeting->name));
541                 $xtpl->assign("MEETING_STATUS",(isset($meeting->status)? $app_list_strings['meeting_status_dom'][$meeting->status]:""));
542                 $typekey = strtolower($meeting->type);
543                 if(isset($meeting->type)) {
544                     if(!empty($app_list_strings['eapm_list'][$typekey])) {
545                     $typestring = $app_list_strings['eapm_list'][$typekey];
546                 } else {
547                         $typestring = $app_list_strings['meeting_type_dom'][$meeting->type];
548                     }
549                 }
550                 $xtpl->assign("MEETING_TYPE", isset($meeting->type)? $typestring:"");
551                 $startdate = $timedate->fromDb($meeting->date_start);
552                 $xtpl->assign("MEETING_STARTDATE", $timedate->asUser($startdate, $notifyUser)." ".TimeDate::userTimezoneSuffix($startdate, $notifyUser));
553                 $enddate = $timedate->fromDb($meeting->date_end);
554                 $xtpl->assign("MEETING_ENDDATE", $timedate->asUser($enddate, $notifyUser)." ".TimeDate::userTimezoneSuffix($enddate, $notifyUser));             
555                 $xtpl->assign("MEETING_HOURS", $meeting->duration_hours);
556                 $xtpl->assign("MEETING_MINUTES", $meeting->duration_minutes);
557                 $xtpl->assign("MEETING_DESCRIPTION", $meeting->description);
558         if ( !empty($meeting->join_url) ) {
559             $xtpl->assign('MEETING_URL', $meeting->join_url);
560             $xtpl->parse('Meeting.Meeting_External_API');
561         }
562
563                 return $xtpl;
564         }
565         
566         /**
567          * Redefine method to attach ics file to notification email
568          */
569         public function create_notification_email($notify_user){
570                 $notify_mail = parent::create_notification_email($notify_user);
571                                                 
572                 $path = SugarConfig::getInstance()->get('upload_dir','upload/') . $this->id;
573
574                 require_once("modules/vCals/vCal.php");
575                 $content = vCal::get_ical_event($this, $GLOBALS['current_user']);
576                                 
577                 if(file_put_contents($path,$content)){
578                         $notify_mail->AddAttachment($path, 'meeting.ics', 'base64', 'text/calendar');
579                 }
580                 return $notify_mail;            
581         }
582         
583         /**
584          * Redefine method to remove ics after email is sent
585          */
586         public function send_assignment_notifications($notify_user, $admin){
587                 parent::send_assignment_notifications($notify_user, $admin);
588                 
589                 $path = SugarConfig::getInstance()->get('upload_dir','upload/') . $this->id;
590                 unlink($path);
591         }
592
593         function get_meeting_users() {
594                 $template = new User();
595                 // First, get the list of IDs.
596                 $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";
597                 $GLOBALS['log']->debug("Finding linked records $this->object_name: ".$query);
598                 $result = $this->db->query($query, true);
599                 $list = Array();
600
601                 while($row = $this->db->fetchByAssoc($result)) {
602                         $template = new User(); // PHP 5 will retrieve by reference, always over-writing the "old" one
603                         $record = $template->retrieve($row['user_id']);
604                         $template->required = $row['required'];
605                         $template->accept_status = $row['accept_status'];
606
607                         if($record != null) {
608                                 // this copies the object into the array
609                                 $list[] = $template;
610                         }
611                 }
612                 return $list;
613         }
614
615         function get_invite_meetings(&$user) {
616                 $template = $this;
617                 // First, get the list of IDs.
618                 $GLOBALS['log']->debug("Finding linked records $this->object_name: ".$query);
619                 $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";
620                 $result = $this->db->query($query, true);
621                 $list = Array();
622
623                 while($row = $this->db->fetchByAssoc($result)) {
624                         $record = $template->retrieve($row['meeting_id']);
625                         $template->required = $row['required'];
626                         $template->accept_status = $row['accept_status'];
627
628
629                         if($record != null)
630                         {
631                         // this copies the object into the array
632                         $list[] = $template;
633                         }
634                 }
635                 return $list;
636         }
637
638
639         function set_accept_status(&$user,$status)
640         {
641                 if($user->object_name == 'User')
642                 {
643                         $relate_values = array('user_id'=>$user->id,'meeting_id'=>$this->id);
644                         $data_values = array('accept_status'=>$status);
645                         $this->set_relationship($this->rel_users_table, $relate_values, true, true,$data_values);
646                         global $current_user;
647
648                         if($this->update_vcal)
649                         {
650                                 vCal::cache_sugar_vcal($user);
651                         }
652                 }
653                 else if($user->object_name == 'Contact')
654                 {
655                         $relate_values = array('contact_id'=>$user->id,'meeting_id'=>$this->id);
656                         $data_values = array('accept_status'=>$status);
657                         $this->set_relationship($this->rel_contacts_table, $relate_values, true, true,$data_values);
658                 }
659         else if($user->object_name == 'Lead')
660                 {
661                         $relate_values = array('lead_id'=>$user->id,'meeting_id'=>$this->id);
662                         $data_values = array('accept_status'=>$status);
663                         $this->set_relationship($this->rel_leads_table, $relate_values, true, true,$data_values);
664                 }
665         }
666
667
668         function get_notification_recipients() {
669                 if($this->special_notification) {
670                         return parent::get_notification_recipients();
671                 }
672
673                 $list = array();
674                 if(!is_array($this->contacts_arr)) {
675                         $this->contacts_arr =   array();
676                 }
677
678                 if(!is_array($this->users_arr)) {
679                         $this->users_arr =      array();
680                 }
681
682         if(!is_array($this->leads_arr)) {
683                         $this->leads_arr =      array();
684                 }
685
686                 foreach($this->users_arr as $user_id) {
687                         $notify_user = new User();
688                         $notify_user->retrieve($user_id);
689                         $notify_user->new_assigned_user_name = $notify_user->full_name;
690                         $GLOBALS['log']->info("Notifications: recipient is $notify_user->new_assigned_user_name");
691                         $list[$notify_user->id] = $notify_user;
692                 }
693
694                 foreach($this->contacts_arr as $contact_id) {
695                         $notify_user = new Contact();
696                         $notify_user->retrieve($contact_id);
697                         $notify_user->new_assigned_user_name = $notify_user->full_name;
698                         $GLOBALS['log']->info("Notifications: recipient is $notify_user->new_assigned_user_name");
699                         $list[$notify_user->id] = $notify_user;
700                 }
701
702         foreach($this->leads_arr as $lead_id) {
703                         $notify_user = new Lead();
704                         $notify_user->retrieve($lead_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                 return $list;
711         }
712
713
714         function bean_implements($interface) {
715                 switch($interface) {
716                         case 'ACL':return true;
717                 }
718                 return false;
719         }
720
721         function listviewACLHelper() {
722                 $array_assign = parent::listviewACLHelper();
723                 $is_owner = false;
724                 if(!empty($this->parent_name)) {
725
726                         if(!empty($this->parent_name_owner)) {
727                                 global $current_user;
728                                 $is_owner = $current_user->id == $this->parent_name_owner;
729                         }
730                 }
731
732                 if(!ACLController::moduleSupportsACL($this->parent_type) || ACLController::checkAccess($this->parent_type, 'view', $is_owner)) {
733                         $array_assign['PARENT'] = 'a';
734                 } else {
735                         $array_assign['PARENT'] = 'span';
736                 }
737
738                 $is_owner = false;
739
740                 if(!empty($this->contact_name)) {
741                         if(!empty($this->contact_name_owner)) {
742                                 global $current_user;
743                                 $is_owner = $current_user->id == $this->contact_name_owner;
744                         }
745                 }
746
747                 if(ACLController::checkAccess('Contacts', 'view', $is_owner)) {
748                         $array_assign['CONTACT'] = 'a';
749                 } else {
750                         $array_assign['CONTACT'] = 'span';
751                 }
752                 return $array_assign;
753         }
754
755
756         function save_relationship_changes($is_update) {
757                 $exclude = array();
758             if(empty($this->in_workflow)) {
759            if(empty($this->in_import)){//if a meeting is being imported then contact_id  should not be excluded
760            //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
761            //add assigned_user_id to exclude list and let the logic from MeetingFormBase determine whether assigned user id gets added to the relationship
762                 if(!empty($GLOBALS['soap_server_object'])){
763                         $exclude = array('contact_id', 'user_id');
764                 }else{
765                         $exclude = array('contact_id', 'user_id','assigned_user_id');
766                 }
767            }
768            else{
769                 $exclude = array('user_id');
770            }
771         }
772        parent::save_relationship_changes($is_update, $exclude);
773         }
774
775
776         /**
777          * @see SugarBean::afterImportSave()
778          */
779         public function afterImportSave()
780         {
781             if ( $this->parent_type == 'Contacts' ) {
782                 $this->load_relationship('contacts');
783                 if ( !$this->contacts->relationship_exists('contacts',array('id'=>$this->parent_id)) )
784                     $this->contacts->add($this->parent_id);
785             }
786             elseif ( $this->parent_type == 'Leads' ) {
787                 $this->load_relationship('leads');
788                 if ( !$this->leads->relationship_exists('leads',array('id'=>$this->parent_id)) )
789                     $this->leads->add($this->parent_id);
790             }
791
792             parent::afterImportSave();
793         }
794
795     public function getDefaultStatus()
796     {
797          $def = $this->field_defs['status'];
798          if (isset($def['default'])) {
799              return $def['default'];
800          } else {
801             $app = return_app_list_strings_language($GLOBALS['current_language']);
802             if (isset($def['options']) && isset($app[$def['options']])) {
803                 $keys = array_keys($app[$def['options']]);
804                 return $keys[0];
805             }
806         }
807         return '';
808     }
809
810 } // end class def
811
812 // External API integration, for the dropdown list of what external API's are available
813 //TODO: do we really need focus, name and view params for this function
814 function getMeetingsExternalApiDropDown($focus = null, $name = null, $value = null, $view = null)
815 {
816         global $dictionary, $app_list_strings;
817
818         $cacheKeyName = 'meetings_type_drop_down';
819
820     $apiList = sugar_cache_retrieve($cacheKeyName);
821     if ($apiList === null)
822     {
823         require_once('include/externalAPI/ExternalAPIFactory.php');
824
825         $apiList = ExternalAPIFactory::getModuleDropDown('Meetings');
826         $apiList = array_merge(array('Sugar'=>$GLOBALS['app_list_strings']['eapm_list']['Sugar']), $apiList);
827         sugar_cache_put($cacheKeyName, $apiList);
828     }
829
830         if(!empty($value) && empty($apiList[$value]))
831         {
832                 $apiList[$value] = $value;
833     }
834         //bug 46294: adding list of options to dropdown list (if it is not the default list)
835     if ($dictionary['Meeting']['fields']['type']['options'] != "eapm_list")
836     {
837         $apiList = array_merge(getMeetingTypeOptions($dictionary, $app_list_strings), $apiList);
838     }
839
840         return $apiList;
841 }
842
843 /**
844  * Meeting Type Options Array for dropdown list
845  * @param array $dictionary - getting type name
846  * @param array $app_list_strings - getting type options
847  * @return array Meeting Type Options Array for dropdown list
848  */
849 function getMeetingTypeOptions($dictionary, $app_list_strings)
850 {
851         $result = array();
852
853     // getting name of meeting type to fill dropdown list by its values
854     if (isset($dictionary['Meeting']['fields']['type']['options']))
855         {
856         $typeName = $dictionary['Meeting']['fields']['type']['options'];
857
858         if (!empty($app_list_strings[$typeName]))
859                 {
860                 $typeList = $app_list_strings[$typeName];
861
862             foreach ($typeList as $key => $value)
863                         {
864                                 $result[$value] = $value;
865             }
866         }
867     }
868
869     return $result;
870 }