modules/Notes/Note.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-2011 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  * Description:  TODO: To be written.
  41  * Portions created by SugarCRM are Copyright (C) SugarCRM, Inc.
  42  * All Rights Reserved.
  43  * Contributor(s): ______________________________________..
  44  ********************************************************************************/
  45
  46
  47
  48
  49
  50 require_once('include/upload_file.php');
  51
  52 // Note is used to store customer information.
  53 class Note extends SugarBean {
  54         var $field_name_map;
  55         // Stored fields
  56         var $id;
  57         var $date_entered;
  58         var $date_modified;
  59         var $modified_user_id;
  60         var $assigned_user_id;
  61         var $created_by;
  62         var $created_by_name;
  63         var $modified_by_name;
  64         var $description;
  65         var $name;
  66         var $filename;
  67         // handle to an upload_file object
  68         // used in emails
  69         var $file;
  70         var $embed_flag; // inline image flag
  71         var $parent_type;
  72         var $parent_id;
  73         var $contact_id;
  74         var $portal_flag;
  75
  76         var $parent_name;
  77         var $contact_name;
  78         var $contact_phone;
  79         var $contact_email;
  80         var $file_mime_type;
  81         var $module_dir = "Notes";
  82         var $default_note_name_dom = array('Meeting notes', 'Reminder');
  83         var $table_name = "notes";
  84         var $new_schema = true;
  85         var $object_name = "Note";
  86         var $importable = true;
  87
  88         // This is used to retrieve related fields from form posts.
  89         var $additional_column_fields = Array('contact_name', 'contact_phone', 'contact_email', 'parent_name','first_name','last_name');
  90
  91
  92
  93         function Note() {
  94                 parent::SugarBean();
  95         }
  96
  97         function safeAttachmentName() {
  98                 global $sugar_config;
  99
 100                 //get position of last "." in file name
 101                 $file_ext_beg = strrpos($this->filename, ".");
 102                 $file_ext = "";
 103
 104                 //get file extension
 105                 if($file_ext_beg !== false) {
 106                         $file_ext = substr($this->filename, $file_ext_beg + 1);
 107                 }
 108
 109                 //check to see if this is a file with extension located in "badext"
 110                 foreach($sugar_config['upload_badext'] as $badExt) {
 111                         if(strtolower($file_ext) == strtolower($badExt)) {
 112                                 //if found, then append with .txt and break out of lookup
 113                                 $this->name = $this->name . ".txt";
 114                                 $this->file_mime_type = 'text/';
 115                                 $this->filename = $this->filename . ".txt";
 116                                 break; // no need to look for more
 117                         }
 118                 }
 119
 120         }
 121
 122         /**
 123          * overrides SugarBean's method.
 124          * If a system setting is set, it will mark all related notes as deleted, and attempt to delete files that are
 125          * related to those notes
 126          * @param string id ID
 127          */
 128         function mark_deleted($id) {
 129                 global $sugar_config;
 130
 131                 if($this->parent_type == 'Emails') {
 132                         if(isset($sugar_config['email_default_delete_attachments']) && $sugar_config['email_default_delete_attachments'] == true) {
 133                                 $removeFile = "upload://$id";
 134                                 if(file_exists($removeFile)) {
 135                                         if(!unlink($removeFile)) {
 136                                                 $GLOBALS['log']->error("*** Could not unlink() file: [ {$removeFile} ]");
 137                                         }
 138                                 }
 139                         }
 140                 }
 141
 142                 // delete note
 143                 parent::mark_deleted($id);
 144         }
 145
 146         function deleteAttachment($isduplicate="false"){
 147                 if($this->ACLAccess('edit')){
 148                         if($isduplicate=="true"){
 149                                 return true;
 150                         }
 151                         $removeFile = "upload://{$this->id}";
 152                 }
 153                 if(!empty($this->doc_type) && !empty($this->doc_id)){
 154             $document = ExternalAPIFactory::loadAPI($this->doc_type);
 155
 156                 $response = $document->deleteDoc($this);
 157             $this->doc_type = '';
 158             $this->doc_id = '';
 159             $this->doc_url = '';
 160             $this->filename = '';
 161             $this->file_mime_type = '';
 162                 }
 163                 if(file_exists($removeFile)) {
 164                         if(!unlink($removeFile)) {
 165                                 $GLOBALS['log']->error("*** Could not unlink() file: [ {$removeFile} ]");
 166                         }else{
 167                                 $this->filename = '';
 168                                 $this->file_mime_type = '';
 169                                 $this->file = '';
 170                                 $this->save();
 171                                 return true;
 172                         }
 173                 } else {
 174                         $this->filename = '';
 175                         $this->file_mime_type = '';
 176                         $this->file = '';
 177                         $this->doc_id = '';
 178                         $this->save();
 179                         return true;
 180                 }
 181                 return false;
 182         }
 183
 184
 185         function get_summary_text() {
 186                 return "$this->name";
 187         }
 188
 189     function create_export_query(&$order_by, &$where, $relate_link_join='')
 190     {
 191         $custom_join = $this->custom_fields->getJOIN(true, true,$where);
 192                 if($custom_join)
 193                                 $custom_join['join'] .= $relate_link_join;
 194                 $query = "SELECT notes.*, contacts.first_name, contacts.last_name, users.user_name as assigned_user_name ";
 195
 196                 if($custom_join) {
 197                         $query .= $custom_join['select'];
 198                 }
 199
 200         $query .= " FROM notes ";
 201
 202                 $query .= "     LEFT JOIN contacts ON notes.contact_id=contacts.id ";
 203                 $query .= "  LEFT JOIN users ON notes.assigned_user_id=users.id ";
 204
 205                 if($custom_join) {
 206                         $query .= $custom_join['join'];
 207                 }
 208
 209                 $where_auto = " notes.deleted=0 AND (contacts.deleted IS NULL OR contacts.deleted=0)";
 210
 211         if($where != "")
 212                         $query .= "where $where AND ".$where_auto;
 213         else
 214                         $query .= "where ".$where_auto;
 215
 216         if($order_by != "")
 217                         $query .=  " ORDER BY ". $this->process_order_by($order_by, null);
 218         else
 219                         $query .= " ORDER BY notes.name";
 220
 221                 return $query;
 222         }
 223
 224         function fill_in_additional_list_fields() {
 225                 $this->fill_in_additional_detail_fields();
 226         }
 227
 228         function fill_in_additional_detail_fields() {
 229                 parent::fill_in_additional_detail_fields();
 230                 //TODO:  Seems odd we need to clear out these values so that list views don't show the previous rows value if current value is blank
 231                 $this->getRelatedFields('Contacts', $this->contact_id, array('name'=>'contact_name', 'phone_work'=>'contact_phone') );
 232                 if(!empty($this->contact_name)){
 233
 234                         $emailAddress = new SugarEmailAddress();
 235                         $this->contact_email = $emailAddress->getPrimaryAddress(false, $this->contact_id, 'Contacts');
 236                 }
 237
 238                 if(isset($this->contact_id) && $this->contact_id != '') {
 239                     $contact = new Contact();
 240                     $contact->retrieve($this->contact_id);
 241                     if(isset($contact->id)) {
 242                         $this->contact_name = $contact->full_name;
 243                     }
 244                 }
 245         }
 246
 247
 248         function get_list_view_data()
 249         {
 250                 $note_fields = $this->get_list_view_array();
 251                 global $app_list_strings, $focus, $action, $currentModule,$mod_strings, $sugar_config;
 252
 253                 if(isset($this->parent_type)) {
 254                         $note_fields['PARENT_MODULE'] = $this->parent_type;
 255                 }
 256
 257                 if(!empty($this->filename)) {
 258             if(file_exists("upload://{$this->id}")){
 259                 $note_fields['FILENAME'] = $this->filename;
 260                 $note_fields['FILE_URL'] = UploadFile::get_upload_url($this);
 261             }
 262         }
 263         if(isset($this->contact_id) && $this->contact_id != '') {
 264                         $contact = new Contact();
 265                         $contact->retrieve($this->contact_id);
 266                         if(isset($contact->id)) {
 267                             $this->contact_name = $contact->full_name;
 268                         }
 269                 }
 270         if(isset($this->contact_name)){
 271                 $note_fields['CONTACT_NAME'] = $this->contact_name;
 272         }
 273
 274                 global $current_language;
 275                 $mod_strings = return_module_language($current_language, 'Notes');
 276                 $note_fields['STATUS']=$mod_strings['LBL_NOTE_STATUS'];
 277
 278
 279                 return $note_fields;
 280         }
 281
 282         function listviewACLHelper() {
 283                 $array_assign = parent::listviewACLHelper();
 284                 $is_owner = false;
 285                 if(!empty($this->parent_name)) {
 286                         if(!empty($this->parent_name_owner)) {
 287                                 global $current_user;
 288                                 $is_owner = $current_user->id == $this->parent_name_owner;
 289                         }
 290                 }
 291
 292                 if(!ACLController::moduleSupportsACL($this->parent_type) || ACLController::checkAccess($this->parent_type, 'view', $is_owner)) {
 293                         $array_assign['PARENT'] = 'a';
 294                 } else {
 295                         $array_assign['PARENT'] = 'span';
 296                 }
 297
 298                 $is_owner = false;
 299                 if(!empty($this->contact_name)) {
 300                         if(!empty($this->contact_name_owner)) {
 301                                 global $current_user;
 302                                 $is_owner = $current_user->id == $this->contact_name_owner;
 303                         }
 304                 }
 305
 306                 if( ACLController::checkAccess('Contacts', 'view', $is_owner)) {
 307                         $array_assign['CONTACT'] = 'a';
 308                 } else {
 309                         $array_assign['CONTACT'] = 'span';
 310                 }
 311
 312                 return $array_assign;
 313         }
 314
 315         function bean_implements($interface) {
 316                 switch($interface) {
 317                         case 'ACL':return true;
 318                 }
 319                 return false;
 320         }
 321 }
 322
 323 ?>