include/SugarObjects/templates/person/Person.php

   1 <?php
   2 /*********************************************************************************
   3  * SugarCRM Community Edition is a customer relationship management program developed by
   4  * SugarCRM, Inc. Copyright (C) 2004-2012 SugarCRM Inc.
   5  *
   6  * This program is free software; you can redistribute it and/or modify it under
   7  * the terms of the GNU Affero General Public License version 3 as published by the
   8  * Free Software Foundation with the addition of the following permission added
   9  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
  10  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
  11  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
  12  *
  13  * This program is distributed in the hope that it will be useful, but WITHOUT
  14  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  15  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
  16  * details.
  17  *
  18  * You should have received a copy of the GNU Affero General Public License along with
  19  * this program; if not, see http://www.gnu.org/licenses or write to the Free
  20  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  21  * 02110-1301 USA.
  22  *
  23  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
  24  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
  25  *
  26  * The interactive user interfaces in modified source and object code versions
  27  * of this program must display Appropriate Legal Notices, as required under
  28  * Section 5 of the GNU Affero General Public License version 3.
  29  *
  30  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
  31  * these Appropriate Legal Notices must retain the display of the "Powered by
  32  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
  33  * technical reasons, the Appropriate Legal Notices must display the words
  34  * "Powered by SugarCRM".
  35  ********************************************************************************/
  36
  37
  38
  39 require_once('include/SugarObjects/templates/basic/Basic.php');
  40
  41
  42 class Person extends Basic
  43 {
  44     var $picture;
  45     //Variable to control whether or not to invoke the getLocalFormatttedName method with title and salutation
  46     var $createLocaleFormattedName = true;
  47
  48         function Person(){
  49                 parent::Basic();
  50                 $this->emailAddress = new SugarEmailAddress();
  51         }
  52
  53         // need to override to have a name field created for this class
  54         function retrieve($id = -1, $encode=true) {
  55                 $ret_val = parent::retrieve($id, $encode);
  56                 $this->_create_proper_name_field();
  57                 $this->emailAddress->handleLegacyRetrieve($this);
  58                 return $ret_val;
  59         }
  60
  61
  62         /**
  63      * _create_proper_name_field
  64      *
  65          * This function helps generate the name and full_name member field variables from the salutation, title, first_name and last_name fields.
  66      * It takes into account the locale format settings as well as ACL settings if supported.
  67          */
  68         function _create_proper_name_field()
  69         {
  70                 global $locale, $app_list_strings;
  71
  72         // Bug# 46125 - make first name, last name, salutation and title of Contacts respect field level ACLs
  73         $first_name = ""; $last_name = ""; $salutation = ""; $title = "";
  74
  75            // first name has at least read access
  76            $first_name = $this->first_name;
  77
  78             // last name has at least read access
  79             $last_name = $this->last_name;
  80
  81
  82             // salutation has at least read access
  83             if(isset($this->field_defs['salutation']['options'])
  84                           && isset($app_list_strings[$this->field_defs['salutation']['options']])
  85                           && isset($app_list_strings[$this->field_defs['salutation']['options']][$this->salutation]) ) {
  86
  87                                 $salutation = $app_list_strings[$this->field_defs['salutation']['options']][$this->salutation];
  88                         } // if
  89
  90             // last name has at least read access
  91             $title = $this->title;
  92
  93         // Corner Case:
  94         // Both first name and last name cannot be empty, at least one must be shown
  95         // In that case, we can ignore field level ACL and just display last name...
  96         // In the ACL field level access settings, last_name cannot be set to "none"
  97         if (empty($first_name) && empty($last_name)) {
  98             $full_name = $locale->getLocaleFormattedName("", $last_name, $salutation, $title);
  99         } else {
 100                         if($this->createLocaleFormattedName) {
 101                                 $full_name = $locale->getLocaleFormattedName($first_name, $last_name, $salutation, $title);
 102                         } else {
 103                                 $full_name = $locale->getLocaleFormattedName($first_name, $last_name);
 104                         }
 105                 }
 106
 107                 $this->name = $full_name;
 108                 $this->full_name = $full_name; //used by campaigns
 109         }
 110
 111
 112         function save($check_notify=false) {
 113                 //If we are saving due to relationship changes, don't bother trying to update the emails
 114         if(!empty($GLOBALS['resavingRelatedBeans']))
 115         {
 116             parent::save($check_notify);
 117             return $this->id;
 118         }
 119         $this->add_address_streets('primary_address_street');
 120         $this->add_address_streets('alt_address_street');
 121         $ori_in_workflow = empty($this->in_workflow) ? false : true;
 122         $this->emailAddress->handleLegacySave($this, $this->module_dir);
 123         parent::save($check_notify);
 124         $override_email = array();
 125         if(!empty($this->email1_set_in_workflow)) {
 126             $override_email['emailAddress0'] = $this->email1_set_in_workflow;
 127         }
 128         if(!empty($this->email2_set_in_workflow)) {
 129             $override_email['emailAddress1'] = $this->email2_set_in_workflow;
 130         }
 131         if(!isset($this->in_workflow)) {
 132             $this->in_workflow = false;
 133         }
 134         if($ori_in_workflow === false || !empty($override_email)){
 135             $this->emailAddress->save($this->id, $this->module_dir, $override_email,'','','','',$this->in_workflow);
 136         }
 137                 return $this->id;
 138         }
 139
 140         function get_summary_text() {
 141                 $this->_create_proper_name_field();
 142         return $this->name;
 143         }
 144
 145         function get_list_view_data() {
 146
 147                 global $system_config;
 148                 global $current_user;
 149                 $this->_create_proper_name_field();
 150                 $temp_array = $this->get_list_view_array();
 151                 $temp_array['NAME'] = $this->name;
 152                 $temp_array['EMAIL1'] = $this->emailAddress->getPrimaryAddress($this);
 153                 $this->email1 = $temp_array['EMAIL1'];
 154                 $temp_array['EMAIL1_LINK'] = $current_user->getEmailLink('email1', $this, '', '', 'ListView');
 155                 return $temp_array;
 156         }
 157
 158     /**
 159      * @see SugarBean::populateRelatedBean()
 160          */
 161     public function populateRelatedBean(
 162         SugarBean $newbean
 163         )
 164     {
 165         parent::populateRelatedBean($newbean);
 166
 167         if ( $newbean instanceOf Company ) {
 168             $newbean->phone_fax = $this->phone_fax;
 169             $newbean->phone_office = $this->phone_work;
 170             $newbean->phone_alternate = $this->phone_other;
 171             $newbean->email1 = $this->email1;
 172             $this->add_address_streets('primary_address_street');
 173             $newbean->billing_address_street = $this->primary_address_street;
 174             $newbean->billing_address_city = $this->primary_address_city;
 175             $newbean->billing_address_state = $this->primary_address_state;
 176             $newbean->billing_address_postalcode = $this->primary_address_postalcode;
 177             $newbean->billing_address_country = $this->primary_address_country;
 178             $this->add_address_streets('alt_address_street');
 179             $newbean->shipping_address_street = $this->alt_address_street;
 180             $newbean->shipping_address_city = $this->alt_address_city;
 181             $newbean->shipping_address_state = $this->alt_address_state;
 182             $newbean->shipping_address_postalcode = $this->alt_address_postalcode;
 183             $newbean->shipping_address_country = $this->alt_address_country;
 184         }
 185     }
 186 }
 187
 188 ?>