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.
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.
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
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
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.
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.
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 ********************************************************************************/
38 /*********************************************************************************
41 ********************************************************************************/
43 class Campaign extends SugarBean {
50 var $modified_user_id;
51 var $assigned_user_id;
55 var $modified_by_name;
63 var $expected_revenue;
74 var $assigned_user_name;
76 // module name definitions and table relations
77 var $table_name = "campaigns";
78 var $rel_prospect_list_table = "prospect_list_campaigns";
79 var $object_name = "Campaign";
80 var $module_dir = 'Campaigns';
81 var $importable = true;
83 // This is used to retrieve related fields from form posts.
84 var $additional_column_fields = array(
85 'assigned_user_name', 'assigned_user_id',
88 var $relationship_fields = Array('prospect_list_id'=>'prospect_lists');
90 var $new_schema = true;
92 function list_view_parse_additional_sections(&$listTmpl) {
95 // take $assigned_user_id and get the Username value to assign
96 $assId = $this->getFieldValue('assigned_user_id');
98 $query = "SELECT first_name, last_name FROM users WHERE id = '".$assId."'";
99 $result = $this->db->query($query);
100 $user = $this->db->fetchByAssoc($result);
104 $fullName = $locale->getLocaleFormattedName($user->first_name, $user->last_name);
105 $listTmpl->assign('ASSIGNED_USER_NAME', $fullName);
110 function get_summary_text()
115 function create_export_query(&$order_by, &$where, $relate_link_join='')
117 $custom_join = $this->custom_fields->getJOIN(true, true,$where);
119 $custom_join['join'] .= $relate_link_join;
122 users.user_name as assigned_user_name ";
124 $query .= $custom_join['select'];
126 $query .= " FROM campaigns ";
127 $query .= "LEFT JOIN users
128 ON campaigns.assigned_user_id=users.id";
130 $query .= $custom_join['join'];
133 $where_auto = " campaigns.deleted=0";
136 $query .= " where $where AND ".$where_auto;
138 $query .= " where ".$where_auto;
141 $query .= " ORDER BY $order_by";
143 $query .= " ORDER BY campaigns.name";
149 function clear_campaign_prospect_list_relationship($campaign_id, $prospect_list_id='')
151 if(!empty($prospect_list_id))
152 $prospect_clause = " and prospect_list_id = '$prospect_list_id' ";
154 $prospect_clause = '';
156 $query = "DELETE FROM $this->rel_prospect_list_table WHERE campaign_id='$campaign_id' AND deleted = '0' " . $prospect_clause;
157 $this->db->query($query, true, "Error clearing campaign to prospect_list relationship: ");
162 function mark_relationships_deleted($id)
164 $this->clear_campaign_prospect_list_relationship($id);
167 function fill_in_additional_list_fields()
169 parent::fill_in_additional_list_fields();
172 function fill_in_additional_detail_fields()
174 parent::fill_in_additional_detail_fields();
177 //don't need additional formatting here.
178 //$this->budget=format_number($this->budget);
179 //$this->expected_cost=format_number($this->expected_cost);
180 //$this->actual_cost=format_number($this->actual_cost);
181 //$this->expected_revenue=format_number($this->expected_revenue);
185 function update_currency_id($fromid, $toid){
189 function get_list_view_data(){
191 $temp_array = $this->get_list_view_array();
192 if ($this->campaign_type != 'Email') {
193 $temp_array['OPTIONAL_LINK']="display:none";
195 $temp_array['TRACK_CAMPAIGN_TITLE'] = translate("LBL_TRACK_BUTTON_TITLE",'Campaigns');
196 $temp_array['TRACK_CAMPAIGN_IMAGE'] = SugarThemeRegistry::current()->getImageURL('view_status.gif');
197 $temp_array['LAUNCH_WIZARD_TITLE'] = translate("LBL_TO_WIZARD_TITLE",'Campaigns');
198 $temp_array['LAUNCH_WIZARD_IMAGE'] = SugarThemeRegistry::current()->getImageURL('edit_wizard.gif');
199 $temp_array['TRACK_VIEW_ALT_TEXT'] = translate("LBL_TRACK_BUTTON_TITLE",'Campaigns');
200 $temp_array['LAUNCH_WIZ_ALT_TEXT'] = translate("LBL_TO_WIZARD_TITLE",'Campaigns');
205 builds a generic search based on the query string using or
206 do not include any $this-> because this is called on without having the class instantiated
208 function build_generic_where_clause ($the_query_string)
210 $where_clauses = Array();
211 $the_query_string = $this->db->quote($the_query_string);
212 array_push($where_clauses, "campaigns.name like '$the_query_string%'");
215 foreach($where_clauses as $clause)
217 if($the_where != "") $the_where .= " or ";
218 $the_where .= $clause;
225 function save($check_notify = FALSE) {
228 if(isset($this->amount) && !empty($this->amount)){
230 $currency = new Currency();
231 $currency->retrieve($this->currency_id);
232 $this->amount_usdollar = $currency->convertToDollar($this->amount);
236 $this->unformat_all_fields();
238 return parent::save($check_notify);
243 function mark_deleted($id){
244 $query = "update contacts set campaign_id = null where campaign_id = '{$id}' ";
245 $this->db->query($query);
246 $query = "update accounts set campaign_id = null where campaign_id = '{$id}' ";
247 $this->db->query($query);
248 return parent::mark_deleted($id);
251 function set_notification_body($xtpl, $camp)
253 $xtpl->assign("CAMPAIGN_NAME", $camp->name);
254 $xtpl->assign("CAMPAIGN_AMOUNT", $camp->budget);
255 $xtpl->assign("CAMPAIGN_CLOSEDATE", $camp->end_date);
256 $xtpl->assign("CAMPAIGN_STATUS", $camp->status);
257 $xtpl->assign("CAMPAIGN_DESCRIPTION", $camp->content);
262 function track_log_entries($type=array()) {
263 //get arguments being passed in
264 $args = func_get_args();
267 $this->load_relationship('log_entries');
268 $query_array = $this->log_entries->getQuery(true);
270 //if one of the arguments is marketing ID, then we need to filter by it
271 foreach($args as $arg){
272 if(isset($arg['EMAIL_MARKETING_ID_VALUE'])){
273 $mkt_id = $arg['EMAIL_MARKETING_ID_VALUE'];
276 if(isset($arg['group_by'])) {
277 $query_array['group_by'] = $arg['group_by'];
286 $query_array['select'] ="SELECT campaign_log.* ";
287 $query_array['where'] = $query_array['where']. " AND activity_type='{$type[0]}' AND archived=0";
288 //add filtering by marketing id, if it exists
289 if (!empty($mkt_id)) $query_array['where'] = $query_array['where']. " AND marketing_id ='$mkt_id' ";
292 if( isset($query_array['group_by']))
294 //perform the inner join with the group by if a marketing id is defined, which means we need to filter out duplicates.
295 //if no marketing id is specified then we are displaying results from multiple marketing emails and it is understood there might be duplicate target entries
296 if (!empty($mkt_id)){
297 $group_by = str_replace("campaign_log", "cl", $query_array['group_by']);
298 $join_where = str_replace("campaign_log", "cl", $query_array['where']);
299 $query_array['from'] .= " INNER JOIN (select min(id) as id from campaign_log cl $join_where GROUP BY $group_by ) secondary
300 on campaign_log.id = secondary.id ";
302 unset($query_array['group_by']);
303 } else if(isset($query_array['group_by'])) {
304 $query_array['where'] = $query_array['where'] . ' GROUP BY ' . $query_array['group_by'];
305 unset($query_array['group_by']);
308 $query = (implode(" ",$query_array));
313 function get_queue_items() {
314 //get arguments being passed in
315 $args = func_get_args();
318 $this->load_relationship('queueitems');
319 $query_array = $this->queueitems->getQuery(true);
321 //if one of the arguments is marketing ID, then we need to filter by it
322 foreach($args as $arg){
323 if(isset($arg['EMAIL_MARKETING_ID_VALUE'])){
324 $mkt_id = $arg['EMAIL_MARKETING_ID_VALUE'];
327 if(isset($arg['group_by'])) {
328 $query_array['group_by'] = $arg['group_by'];
332 //add filtering by marketing id, if it exists, and if where key is not empty
333 if (!empty($mkt_id) && !empty($query_array['where'])){
334 $query_array['where'] = $query_array['where']. " AND marketing_id ='$mkt_id' ";
337 //get select query from email man
338 $man = new EmailMan();
339 $listquery= $man->create_queue_items_query('',str_replace(array("WHERE","where"),"",$query_array['where']),null,$query_array);
343 // function get_prospect_list_entries() {
344 // $this->load_relationship('prospectlists');
345 // $query_array = $this->prospectlists->getQuery(true);
348 // SELECT distinct prospect_lists.*,
349 // (case when (email_marketing.id is null) then default_message.id else email_marketing.id end) marketing_id,
350 // (case when (email_marketing.id is null) then default_message.name else email_marketing.name end) marketing_name
352 // FROM prospect_lists
354 // INNER JOIN prospect_list_campaigns ON (prospect_lists.id=prospect_list_campaigns.prospect_list_id AND prospect_list_campaigns.campaign_id='{$this->id}')
356 // LEFT JOIN email_marketing on email_marketing.message_for = prospect_lists.id and email_marketing.campaign_id = '{$this->id}'
357 // and email_marketing.deleted =0 and email_marketing.status='active'
359 // LEFT JOIN email_marketing default_message on default_message.message_for = prospect_list_campaigns.campaign_id and
360 // default_message.campaign_id = '{$this->id}' and default_message.deleted =0
361 // and default_message.status='active'
363 // WHERE prospect_list_campaigns.deleted=0 AND prospect_lists.deleted=0
369 function bean_implements($interface){
371 case 'ACL':return true;
378 * create_list_count_query
379 * Overrode this method from SugarBean to handle the distinct parameter used to filter out
380 * duplicate entries for some of the subpanel listivews. Without the distinct filter, the
381 * list count would be inaccurate because one-to-many email_marketing entries may be associated
384 * @param string $query Select query string
385 * @param array $param array of arguments
386 * @return string count query
389 function create_list_count_query($query, $params=array())
391 //include the distinct filter if a marketing id is defined, which means we need to filter out duplicates by the passed in group by.
392 //if no marketing id is specified, it is understood there might be duplicate target entries so no need to filter out
393 if((strpos($query,'marketing_id') !== false )&& isset($params['distinct'])) {
394 $pattern = '/SELECT(.*?)(\s){1}FROM(\s){1}/is'; // ignores the case
395 $replacement = 'SELECT COUNT(DISTINCT ' . $params['distinct'] . ') c FROM ';
396 $query = preg_replace($pattern, $replacement, $query, 1);
400 //If distinct parameter not found, default to SugarBean's function
401 return parent::create_list_count_query($query);