Current File : /var/www/crm/modules/Contacts/Contact.php
<?php
if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
/*********************************************************************************
* SugarCRM Community Edition is a customer relationship management program developed by
* SugarCRM, Inc. Copyright (C) 2004-2012 SugarCRM Inc.
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU Affero General Public License version 3 as published by the
* Free Software Foundation with the addition of the following permission added
* to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
* IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
* OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
* details.
*
* You should have received a copy of the GNU Affero General Public License along with
* this program; if not, see http://www.gnu.org/licenses or write to the Free
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301 USA.
*
* You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
* SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "Powered by
* SugarCRM" logo. If the display of the logo is not reasonably feasible for
* technical reasons, the Appropriate Legal Notices must display the words
* "Powered by SugarCRM".
********************************************************************************/
/*********************************************************************************
* Portions created by SugarCRM are Copyright (C) SugarCRM, Inc.
* All Rights Reserved.
* Contributor(s): ______________________________________..
********************************************************************************/
require_once('include/SugarObjects/templates/person/Person.php');
// Contact is used to store customer information.
class Contact extends Person {
var $field_name_map;
// Stored fields
var $id;
var $name = '';
var $lead_source;
var $date_entered;
var $date_modified;
var $modified_user_id;
var $assigned_user_id;
var $created_by;
var $created_by_name;
var $modified_by_name;
var $description;
var $salutation;
var $first_name;
var $last_name;
var $title;
var $department;
var $birthdate;
var $reports_to_id;
var $do_not_call;
var $phone_home;
var $phone_mobile;
var $phone_work;
var $phone_other;
var $phone_fax;
var $email1;
var $email_and_name1;
var $email_and_name2;
var $email2;
var $assistant;
var $assistant_phone;
var $email_opt_out;
var $primary_address_street;
var $primary_address_city;
var $primary_address_state;
var $primary_address_postalcode;
var $primary_address_country;
var $alt_address_street;
var $alt_address_city;
var $alt_address_state;
var $alt_address_postalcode;
var $alt_address_country;
var $portal_name;
var $portal_app;
var $portal_active;
var $contacts_users_id;
// These are for related fields
var $bug_id;
var $account_name;
var $account_id;
var $report_to_name;
var $opportunity_role;
var $opportunity_rel_id;
var $opportunity_id;
var $case_role;
var $case_rel_id;
var $case_id;
var $task_id;
var $note_id;
var $meeting_id;
var $call_id;
var $email_id;
var $assigned_user_name;
var $accept_status;
var $accept_status_id;
var $accept_status_name;
var $alt_address_street_2;
var $alt_address_street_3;
var $opportunity_role_id;
var $portal_password;
var $primary_address_street_2;
var $primary_address_street_3;
var $campaign_id;
var $sync_contact;
var $full_name; // l10n localized name
var $invalid_email;
var $table_name = "contacts";
var $rel_account_table = "accounts_contacts";
//This is needed for upgrade. This table definition moved to Opportunity module.
var $rel_opportunity_table = "opportunities_contacts";
var $object_name = "Contact";
var $module_dir = 'Contacts';
var $emailAddress;
var $new_schema = true;
var $importable = true;
// This is used to retrieve related fields from form posts.
var $additional_column_fields = Array('bug_id', 'assigned_user_name', 'account_name', 'account_id', 'opportunity_id', 'case_id', 'task_id', 'note_id', 'meeting_id', 'call_id', 'email_id'
);
var $relationship_fields = Array('account_id'=> 'accounts','bug_id' => 'bugs', 'call_id'=>'calls','case_id'=>'cases','email_id'=>'emails',
'meeting_id'=>'meetings','note_id'=>'notes','task_id'=>'tasks', 'opportunity_id'=>'opportunities', 'contacts_users_id' => 'user_sync'
);
function Contact() {
parent::Person();
}
function add_list_count_joins(&$query, $where)
{
// accounts.name
if(stristr($where, "accounts.name"))
{
// add a join to the accounts table.
$query .= "
LEFT JOIN accounts_contacts
ON contacts.id=accounts_contacts.contact_id
LEFT JOIN accounts
ON accounts_contacts.account_id=accounts.id
";
}
$custom_join = $this->custom_fields->getJOIN();
if($custom_join){
$query .= $custom_join['join'];
}
}
function listviewACLHelper(){
$array_assign = parent::listviewACLHelper();
$is_owner = false;
//MFH BUG 18281; JChi #15255
$is_owner = !empty($this->assigned_user_id) && $this->assigned_user_id == $GLOBALS['current_user']->id;
if(!ACLController::moduleSupportsACL('Accounts') || ACLController::checkAccess('Accounts', 'view', $is_owner)){
$array_assign['ACCOUNT'] = 'a';
}else{
$array_assign['ACCOUNT'] = 'span';
}
return $array_assign;
}
function create_new_list_query($order_by, $where,$filter=array(),$params=array(), $show_deleted = 0,$join_type='', $return_array = false,$parentbean=null, $singleSelect = false)
{
//if this is from "contact address popup" action, then process popup list query
if(isset($_REQUEST['action']) && $_REQUEST['action'] == 'ContactAddressPopup'){
return $this->address_popup_create_new_list_query($order_by, $where, $filter, $params, $show_deleted, $join_type, $return_array, $parentbean, $singleSelect);
}else{
//any other action goes to parent function in sugarbean
if(strpos($order_by,'sync_contact') !== false){
//we have found that the user is ordering by the sync_contact field, it would be troublesome to sort by this field
//and perhaps a performance issue, so just remove it
$order_by = '';
}
return parent::create_new_list_query($order_by, $where, $filter, $params, $show_deleted, $join_type, $return_array, $parentbean, $singleSelect);
}
}
function address_popup_create_new_list_query($order_by, $where,$filter=array(),$params=array(), $show_deleted = 0,$join_type='', $return_array = false,$parentbean=null, $singleSelect = false)
{
//if this is any action that is not the contact address popup, then go to parent function in sugarbean
if(isset($_REQUEST['action']) && $_REQUEST['action'] !== 'ContactAddressPopup'){
return parent::create_new_list_query($order_by, $where, $filter, $params, $show_deleted, $join_type, $return_array, $parentbean, $singleSelect);
}
$custom_join = $this->custom_fields->getJOIN();
// MFH - BUG #14208 creates alias name for select
$select_query = "SELECT ";
$select_query .= db_concat($this->table_name,array('first_name','last_name')) . " name, ";
$select_query .= "
$this->table_name.*,
accounts.name as account_name,
accounts.id as account_id,
accounts.assigned_user_id account_id_owner,
users.user_name as assigned_user_name ";
if($custom_join){
$select_query .= $custom_join['select'];
}
$ret_array['select'] = $select_query;
$from_query = "
FROM contacts ";
$from_query .= "LEFT JOIN users
ON contacts.assigned_user_id=users.id
LEFT JOIN accounts_contacts
ON contacts.id=accounts_contacts.contact_id and accounts_contacts.deleted = 0
LEFT JOIN accounts
ON accounts_contacts.account_id=accounts.id AND accounts.deleted=0 ";
$from_query .= "LEFT JOIN email_addr_bean_rel eabl ON eabl.bean_id = contacts.id AND eabl.bean_module = 'Contacts' and eabl.primary_address = 1 and eabl.deleted=0 ";
$from_query .= "LEFT JOIN email_addresses ea ON (ea.id = eabl.email_address_id) ";
if($custom_join){
$from_query .= $custom_join['join'];
}
$ret_array['from'] = $from_query;
$ret_array['from_min'] = 'from contacts';
$where_auto = '1=1';
if($show_deleted == 0){
$where_auto = " $this->table_name.deleted=0 ";
//$where_auto .= " AND accounts.deleted=0 ";
}else if($show_deleted == 1){
$where_auto = " $this->table_name.deleted=1 ";
}
if($where != ""){
$where_query = "where ($where) AND ".$where_auto;
}else{
$where_query = "where ".$where_auto;
}
$ret_array['where'] = $where_query;
$orderby_query = '';
if(!empty($order_by)){
$orderby_query = " ORDER BY ". $this->process_order_by($order_by, null);
}
$ret_array['order_by'] = $orderby_query ;
if($return_array)
{
return $ret_array;
}
return $ret_array['select'] . $ret_array['from'] . $ret_array['where']. $ret_array['order_by'];
}
function create_export_query(&$order_by, &$where, $relate_link_join='')
{
$custom_join = $this->custom_fields->getJOIN(true, true,$where);
if($custom_join)
$custom_join['join'] .= $relate_link_join;
$query = "SELECT
contacts.*,email_addresses.email_address email_address,
accounts.name as account_name,
users.user_name as assigned_user_name ";
if($custom_join){
$query .= $custom_join['select'];
}
$query .= " FROM contacts ";
$query .= "LEFT JOIN users
ON contacts.assigned_user_id=users.id ";
$query .= "LEFT JOIN accounts_contacts
ON ( contacts.id=accounts_contacts.contact_id and (accounts_contacts.deleted is null or accounts_contacts.deleted = 0))
LEFT JOIN accounts
ON accounts_contacts.account_id=accounts.id ";
//join email address table too.
$query .= ' LEFT JOIN email_addr_bean_rel on contacts.id = email_addr_bean_rel.bean_id and email_addr_bean_rel.bean_module=\'Contacts\' and email_addr_bean_rel.deleted=0 and email_addr_bean_rel.primary_address=1 ';
$query .= ' LEFT JOIN email_addresses on email_addresses.id = email_addr_bean_rel.email_address_id ' ;
if($custom_join){
$query .= $custom_join['join'];
}
$where_auto = "( accounts.deleted IS NULL OR accounts.deleted=0 )
AND contacts.deleted=0 ";
if($where != "")
$query .= "where ($where) AND ".$where_auto;
else
$query .= "where ".$where_auto;
if(!empty($order_by))
$query .= " ORDER BY ". $this->process_order_by($order_by, null);
return $query;
}
function fill_in_additional_list_fields() {
parent::fill_in_additional_list_fields();
$this->_create_proper_name_field();
// cn: bug 8586 - l10n names for Contacts in Email TO: field
$this->email_and_name1 = "{$this->full_name} <".$this->email1.">";
$this->email_and_name2 = "{$this->full_name} <".$this->email2.">";
if($this->force_load_details == true) {
$this->fill_in_additional_detail_fields();
}
}
function fill_in_additional_detail_fields() {
parent::fill_in_additional_detail_fields();
if(empty($this->id)) return;
global $locale, $app_list_strings, $current_user;
// retrieve the account information and the information about the person the contact reports to.
$query = "SELECT acc.id, acc.name, con_reports_to.first_name, con_reports_to.last_name
from contacts
left join accounts_contacts a_c on a_c.contact_id = '".$this->id."' and a_c.deleted=0
left join accounts acc on a_c.account_id = acc.id and acc.deleted=0
left join contacts con_reports_to on con_reports_to.id = contacts.reports_to_id
where contacts.id = '".$this->id."'";
// Bug 43196 - If a contact is related to multiple accounts, make sure we pull the one we are looking for
// Bug 44730 was introduced due to this, fix is to simply clear any whitespaces around the account_id first
$clean_account_id = trim($this->account_id);
if ( !empty($clean_account_id) ) {
$query .= " and acc.id = '{$this->account_id}'";
}
$query .= " ORDER BY a_c.date_modified DESC";
$result = $this->db->query($query,true," Error filling in additional detail fields: ");
// Get the id and the name.
$row = $this->db->fetchByAssoc($result);
if($row != null)
{
$this->account_name = $row['name'];
$this->account_id = $row['id'];
$this->report_to_name = $locale->getLocaleFormattedName($row['first_name'], $row['last_name'],'','','',null,true);
}
else
{
$this->account_name = '';
$this->account_id = '';
$this->report_to_name = '';
}
$this->load_contacts_users_relationship();
/** concating this here because newly created Contacts do not have a
* 'name' attribute constructed to pass onto related items, such as Tasks
* Notes, etc.
*/
$this->name = $locale->getLocaleFormattedName($this->first_name, $this->last_name);
if(!empty($this->contacts_users_id)) {
$this->sync_contact = true;
}
if(!empty($this->portal_active) && $this->portal_active == 1) {
$this->portal_active = true;
}
// Set campaign name if there is a campaign id
if( !empty($this->campaign_id)){
$camp = new Campaign();
$where = "campaigns.id='{$this->campaign_id}'";
$campaign_list = $camp->get_full_list("campaigns.name", $where, true);
$this->campaign_name = $campaign_list[0]->name;
}
}
/**
loads the contacts_users relationship to populate a checkbox
where a user can select if they would like to sync a particular
contact to Outlook
*/
function load_contacts_users_relationship(){
global $current_user;
$this->load_relationship("user_sync");
$beanIDs = $this->user_sync->get();
if( in_array($current_user->id, $beanIDs) )
{
$this->contacts_users_id = $current_user->id;
}
}
function get_list_view_data($filter_fields = array()) {
global $system_config;
global $current_user;
$this->_create_proper_name_field();
$temp_array = $this->get_list_view_array();
$temp_array['NAME'] = $this->name;
$temp_array['ENCODED_NAME'] = $this->name;
if($filter_fields && !empty($filter_fields['sync_contact'])){
$this->load_contacts_users_relationship();
$temp_array['SYNC_CONTACT'] = !empty($this->contacts_users_id) ? 1 : 0;
}
$temp_array['EMAIL1'] = $this->emailAddress->getPrimaryAddress($this);
$this->email1 = $temp_array['EMAIL1'];
$temp_array['EMAIL1_LINK'] = $current_user->getEmailLink('email1', $this, '', '', 'ListView');
$temp_array['EMAIL_AND_NAME1'] = "{$this->full_name} <".$temp_array['EMAIL1'].">";
return $temp_array;
}
/**
builds a generic search based on the query string using or
do not include any $this-> because this is called on without having the class instantiated
*/
function build_generic_where_clause ($the_query_string)
{
$where_clauses = Array();
$the_query_string = $this->db->quote($the_query_string);
array_push($where_clauses, "contacts.last_name like '$the_query_string%'");
array_push($where_clauses, "contacts.first_name like '$the_query_string%'");
array_push($where_clauses, "accounts.name like '$the_query_string%'");
array_push($where_clauses, "contacts.assistant like '$the_query_string%'");
array_push($where_clauses, "ea.email_address like '$the_query_string%'");
if (is_numeric($the_query_string))
{
array_push($where_clauses, "contacts.phone_home like '%$the_query_string%'");
array_push($where_clauses, "contacts.phone_mobile like '%$the_query_string%'");
array_push($where_clauses, "contacts.phone_work like '%$the_query_string%'");
array_push($where_clauses, "contacts.phone_other like '%$the_query_string%'");
array_push($where_clauses, "contacts.phone_fax like '%$the_query_string%'");
array_push($where_clauses, "contacts.assistant_phone like '%$the_query_string%'");
}
$the_where = "";
foreach($where_clauses as $clause)
{
if($the_where != "") $the_where .= " or ";
$the_where .= $clause;
}
return $the_where;
}
function set_notification_body($xtpl, $contact)
{
global $locale;
$xtpl->assign("CONTACT_NAME", trim($locale->getLocaleFormattedName($contact->first_name, $contact->last_name)));
$xtpl->assign("CONTACT_DESCRIPTION", $contact->description);
return $xtpl;
}
function get_contact_id_by_email($email)
{
$email = trim($email);
if(empty($email)){
//email is empty, no need to query, return null
return null;
}
$where_clause = "(email1='$email' OR email2='$email') AND deleted=0";
$query = "SELECT id FROM $this->table_name WHERE $where_clause";
$GLOBALS['log']->debug("Retrieve $this->object_name: ".$query);
$result = $this->db->getOne($query, true, "Retrieving record $where_clause:");
return empty($result)?null:$result;
}
function save_relationship_changes($is_update) {
//if account_id was replaced unlink the previous account_id.
//this rel_fields_before_value is populated by sugarbean during the retrieve call.
if (!empty($this->account_id) and !empty($this->rel_fields_before_value['account_id']) and
(trim($this->account_id) != trim($this->rel_fields_before_value['account_id']))) {
//unlink the old record.
$this->load_relationship('accounts');
$this->accounts->delete($this->id,$this->rel_fields_before_value['account_id']);
}
parent::save_relationship_changes($is_update);
}
function bean_implements($interface)
{
switch($interface){
case 'ACL':return true;
}
return false;
}
function get_unlinked_email_query($type=array())
{
return get_unlinked_email_query($type, $this);
}
/**
* used by import to add a list of users
*
* Parameter can be one of the following:
* - string 'all': add this contact for all users
* - comma deliminated lists of teams and/or users
*
* @param string $list_of_user
*/
function process_sync_to_outlook($list_of_users)
{
static $focus_user;
// cache this object since we'll be reusing it a bunch
if ( !($focus_user instanceof User) ) {
$focus_user = new User();
}
if ( empty($list_of_users) ) {
return;
}
if ( !isset($this->users) ) {
$this->load_relationship('user_sync');
}
if ( strtolower($list_of_users) == 'all' ) {
// add all non-deleted users
$sql = "SELECT id FROM users WHERE deleted=0 AND is_group=0 AND portal_only=0";
$result=$this->db->query($sql);
while ( $hash = $this->db->fetchByAssoc($result) ) {
$this->user_sync->add($hash['id']);
}
}
else {
$theList = explode(",",$list_of_users);
foreach ($theList as $eachItem) {
if ( ($user_id = $focus_user->retrieve_user_id($eachItem))
|| $focus_user->retrieve($eachItem)) {
// it is a user, add user
$this->user_sync->add($user_id ? $user_id : $focus_user->id);
return;
}
}
}
}
}
Mini Shell