Merge pull request #6551 from eileenmcnaughton/CRM-17060
[civicrm-core.git] / CRM / Activity / Form / Activity.php
CommitLineData
6a488035
TO
1<?php
2/*
3 +--------------------------------------------------------------------+
39de6fd5 4 | CiviCRM version 4.6 |
6a488035 5 +--------------------------------------------------------------------+
e7112fa7 6 | Copyright CiviCRM LLC (c) 2004-2015 |
6a488035
TO
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
9 | |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
13 | |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
18 | |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
d25dd0ee 26 */
6a488035
TO
27
28/**
29 *
30 * @package CRM
e7112fa7 31 * @copyright CiviCRM LLC (c) 2004-2015
6a488035
TO
32 * $Id$
33 *
34 */
35
36/**
37 * This class generates form components for Activity
38 *
39 */
40class CRM_Activity_Form_Activity extends CRM_Contact_Form_Task {
41
42 /**
43 * The id of the object being edited / created
44 *
45 * @var int
46 */
47 public $_activityId;
48
52c7b3a2 49 /**
fe482240 50 * Store activity ids when multiple activities are created.
52c7b3a2
KJ
51 *
52 * @var int
53 */
54 public $_activityIds = array();
55
6a488035 56 /**
fe482240 57 * The id of activity type.
6a488035
TO
58 *
59 * @var int
60 */
61 public $_activityTypeId;
62
63 /**
fe482240 64 * The name of activity type.
6a488035
TO
65 *
66 * @var string
67 */
68 public $_activityTypeName;
69
70 /**
fe482240 71 * The id of currently viewed contact.
6a488035
TO
72 *
73 * @var int
74 */
75 public $_currentlyViewedContactId;
76
77 /**
fe482240 78 * The id of source contact and target contact.
6a488035
TO
79 *
80 * @var int
81 */
82 protected $_sourceContactId;
83 protected $_targetContactId;
84 protected $_asigneeContactId;
85
86 protected $_single;
87
88 public $_context;
89 public $_compContext;
90 public $_action;
91 public $_activityTypeFile;
92
93 /**
94 * The id of the logged in user, used when add / edit
95 *
96 * @var int
97 */
98 public $_currentUserId;
99
100 /**
fe482240 101 * The array of form field attributes.
6a488035
TO
102 *
103 * @var array
104 */
105 public $_fields;
106
107 /**
108 * The the directory inside CRM, to include activity type file from
109 *
110 * @var string
111 */
112 protected $_crmDir = 'Activity';
113
c490a46a 114 /**
fe482240 115 * Survey activity.
c490a46a
CW
116 *
117 * @var boolean
118 */
6a488035
TO
119 protected $_isSurveyActivity;
120
121 protected $_values = array();
122
c087eb82 123 protected $unsavedWarn = TRUE;
59d63f8b 124
6a488035
TO
125 /**
126 * The _fields var can be used by sub class to set/unset/edit the
127 * form fields based on their requirement
6a488035 128 */
00be9182 129 public function setFields() {
6a488035
TO
130 $this->_fields = array(
131 'subject' => array(
132 'type' => 'text',
133 'label' => ts('Subject'),
134 'attributes' => CRM_Core_DAO::getAttribute('CRM_Activity_DAO_Activity',
135 'subject'
136 ),
137 ),
138 'duration' => array(
139 'type' => 'text',
140 'label' => ts('Duration'),
141 'attributes' => array('size' => 4, 'maxlength' => 8),
142 'required' => FALSE,
143 ),
144 'location' => array(
145 'type' => 'text',
146 'label' => ts('Location'),
9d72cede 147 'attributes' => CRM_Core_DAO::getAttribute('CRM_Activity_DAO_Activity', 'location'),
21dfd5f5 148 'required' => FALSE,
6a488035
TO
149 ),
150 'details' => array(
151 'type' => 'wysiwyg',
152 'label' => ts('Details'),
153 // forces a smaller edit window
154 'attributes' => array('rows' => 4, 'cols' => 60),
21dfd5f5 155 'required' => FALSE,
6a488035
TO
156 ),
157 'status_id' => array(
158 'type' => 'select',
475e9f44 159 'required' => TRUE,
6a488035
TO
160 ),
161 'priority_id' => array(
162 'type' => 'select',
475e9f44 163 'required' => TRUE,
6a488035
TO
164 ),
165 'source_contact_id' => array(
c27ebe4e 166 'type' => 'entityRef',
6a488035 167 'label' => ts('Added By'),
21dfd5f5 168 'required' => FALSE,
6a488035 169 ),
c27ebe4e
CW
170 'target_contact_id' => array(
171 'type' => 'entityRef',
172 'label' => ts('With Contact'),
21dfd5f5 173 'attributes' => array('multiple' => TRUE, 'create' => TRUE),
c27ebe4e
CW
174 ),
175 'assignee_contact_id' => array(
176 'type' => 'entityRef',
3bd48a28 177 'label' => ts('Assigned to'),
353ffa53
TO
178 'attributes' => array(
179 'multiple' => TRUE,
180 'create' => TRUE,
af9b09df 181 'api' => array('params' => array('is_deceased' => 0)),
353ffa53 182 ),
c27ebe4e
CW
183 ),
184 'followup_assignee_contact_id' => array(
185 'type' => 'entityRef',
3bd48a28 186 'label' => ts('Assigned to'),
353ffa53
TO
187 'attributes' => array(
188 'multiple' => TRUE,
189 'create' => TRUE,
af9b09df 190 'api' => array('params' => array('is_deceased' => 0)),
353ffa53 191 ),
c27ebe4e 192 ),
6a488035
TO
193 'followup_activity_type_id' => array(
194 'type' => 'select',
195 'label' => ts('Followup Activity'),
5e72d8ae
CW
196 'attributes' => array('' => '- ' . ts('select activity') . ' -') + CRM_Core_PseudoConstant::ActivityType(FALSE),
197 'extra' => array('class' => 'crm-select2'),
6a488035
TO
198 ),
199 // Add optional 'Subject' field for the Follow-up Activiity, CRM-4491
200 'followup_activity_subject' => array(
201 'type' => 'text',
202 'label' => ts('Subject'),
203 'attributes' => CRM_Core_DAO::getAttribute('CRM_Activity_DAO_Activity',
204 'subject'
21dfd5f5
TO
205 ),
206 ),
6a488035
TO
207 );
208
209 if (($this->_context == 'standalone') &&
210 ($printPDF = CRM_Utils_Array::key('Print PDF Letter', $this->_fields['followup_activity_type_id']['attributes']))
211 ) {
212 unset($this->_fields['followup_activity_type_id']['attributes'][$printPDF]);
213 }
214 }
215
216 /**
fe482240 217 * Build the form object.
6a488035 218 *
355ba699 219 * @return void
6a488035 220 */
00be9182 221 public function preProcess() {
6a488035
TO
222 $this->_cdType = CRM_Utils_Array::value('type', $_GET);
223 $this->assign('cdType', FALSE);
224 if ($this->_cdType) {
225 $this->assign('cdType', TRUE);
226 return CRM_Custom_Form_CustomData::preProcess($this);
227 }
b334d9ad 228 CRM_Core_Form_RecurringEntity::preProcess('civicrm_activity');
6a488035
TO
229 $this->_atypefile = CRM_Utils_Array::value('atypefile', $_GET);
230 $this->assign('atypefile', FALSE);
231 if ($this->_atypefile) {
232 $this->assign('atypefile', TRUE);
233 }
234
235 $session = CRM_Core_Session::singleton();
236 $this->_currentUserId = $session->get('userID');
237
238 $this->_currentlyViewedContactId = $this->get('contactId');
239 if (!$this->_currentlyViewedContactId) {
240 $this->_currentlyViewedContactId = CRM_Utils_Request::retrieve('cid', 'Positive', $this);
241 }
242 $this->assign('contactId', $this->_currentlyViewedContactId);
243
6a488035
TO
244 //give the context.
245 if (!isset($this->_context)) {
246 $this->_context = CRM_Utils_Request::retrieve('context', 'String', $this);
247 if (CRM_Contact_Form_Search::isSearchContext($this->_context)) {
248 $this->_context = 'search';
249 }
250 elseif (!in_array($this->_context, array('dashlet', 'dashletFullscreen'))
251 && $this->_currentlyViewedContactId
252 ) {
253 $this->_context = 'activity';
254 }
255 $this->_compContext = CRM_Utils_Request::retrieve('compContext', 'String', $this);
256 }
257
258 $this->assign('context', $this->_context);
259
260 $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this);
261
262 if ($this->_action & CRM_Core_Action::DELETE) {
263 if (!CRM_Core_Permission::check('delete activities')) {
0499b0ad 264 CRM_Core_Error::fatal(ts('You do not have permission to access this page.'));
6a488035
TO
265 }
266 }
267
268 //CRM-6957
269 //when we come from contact search, activity id never comes.
270 //so don't try to get from object, it might gives you wrong one.
271
272 // if we're not adding new one, there must be an id to
273 // an activity we're trying to work on.
274 if ($this->_action != CRM_Core_Action::ADD &&
275 get_class($this->controller) != 'CRM_Contact_Controller_Search'
276 ) {
277 $this->_activityId = CRM_Utils_Request::retrieve('id', 'Positive', $this);
278 }
279
280 $this->_activityTypeId = CRM_Utils_Request::retrieve('atype', 'Positive', $this);
281 $this->assign('atype', $this->_activityTypeId);
282
5b7581f1
CW
283 $this->assign('activityId', $this->_activityId);
284
6a488035
TO
285 //check for required permissions, CRM-6264
286 if ($this->_activityId &&
287 in_array($this->_action, array(
19fc6ae4 288 CRM_Core_Action::UPDATE,
21dfd5f5 289 CRM_Core_Action::VIEW,
19fc6ae4 290 )) &&
6a488035
TO
291 !CRM_Activity_BAO_Activity::checkPermission($this->_activityId, $this->_action)
292 ) {
293 CRM_Core_Error::fatal(ts('You do not have permission to access this page.'));
294 }
295 if (($this->_action & CRM_Core_Action::VIEW) &&
296 CRM_Activity_BAO_Activity::checkPermission($this->_activityId, CRM_Core_Action::UPDATE)
297 ) {
298 $this->assign('permission', 'edit');
299 }
300
301 if (!$this->_activityTypeId && $this->_activityId) {
302 $this->_activityTypeId = CRM_Core_DAO::getFieldValue('CRM_Activity_DAO_Activity',
303 $this->_activityId,
304 'activity_type_id'
305 );
306 }
307
308 //Assigning Activity type name
309 if ($this->_activityTypeId) {
ad0121ed 310 $activityTName = CRM_Core_OptionGroup::values('activity_type', FALSE, FALSE, FALSE, 'AND v.value = ' . $this->_activityTypeId, 'label');
6a488035
TO
311 if ($activityTName[$this->_activityTypeId]) {
312 $this->_activityTypeName = $activityTName[$this->_activityTypeId];
313 $this->assign('activityTName', $activityTName[$this->_activityTypeId]);
314 }
315 }
316
a10432db 317 // Set title
6a488035 318 if (isset($activityTName)) {
a10432db 319 $activityName = CRM_Utils_Array::value($this->_activityTypeId, $activityTName);
481a74f4 320 $this->assign('pageTitle', ts('%1 Activity', array(1 => $activityName)));
a10432db
CW
321
322 if ($this->_currentlyViewedContactId) {
323 $displayName = CRM_Contact_BAO_Contact::displayName($this->_currentlyViewedContactId);
324 // Check if this is default domain contact CRM-10482
325 if (CRM_Contact_BAO_Contact::checkDomainContact($this->_currentlyViewedContactId)) {
326 $displayName .= ' (' . ts('default organization') . ')';
327 }
328 CRM_Utils_System::setTitle($displayName . ' - ' . $activityName);
329 }
330 else {
481a74f4 331 CRM_Utils_System::setTitle(ts('%1 Activity', array(1 => $activityName)));
a10432db 332 }
6a488035
TO
333 }
334
335 //check the mode when this form is called either single or as
336 //search task action
337 if ($this->_activityTypeId ||
338 $this->_context == 'standalone' ||
339 $this->_currentlyViewedContactId
340 ) {
341 $this->_single = TRUE;
342 $this->assign('urlPath', 'civicrm/activity');
343 }
344 else {
345 //set the appropriate action
346 $url = CRM_Utils_System::currentPath();
347 $urlArray = explode('/', $url);
50237bc9 348 $searchPath = array_pop($urlArray);
6a488035
TO
349 $searchType = 'basic';
350 $this->_action = CRM_Core_Action::BASIC;
50237bc9 351 switch ($searchPath) {
6a488035 352 case 'basic':
50237bc9 353 $searchType = $searchPath;
6a488035
TO
354 $this->_action = CRM_Core_Action::BASIC;
355 break;
356
357 case 'advanced':
50237bc9 358 $searchType = $searchPath;
6a488035
TO
359 $this->_action = CRM_Core_Action::ADVANCED;
360 break;
361
362 case 'builder':
50237bc9 363 $searchType = $searchPath;
6a488035
TO
364 $this->_action = CRM_Core_Action::PROFILE;
365 break;
366
367 case 'custom':
368 $this->_action = CRM_Core_Action::COPY;
50237bc9 369 $searchType = $searchPath;
6a488035
TO
370 break;
371 }
372
373 parent::preProcess();
374 $this->_single = FALSE;
375
376 $this->assign('urlPath', "civicrm/contact/search/$searchType");
377 $this->assign('urlPathVar', "_qf_Activity_display=true&qfKey={$this->controller->_key}");
378 }
379
380 $this->assign('single', $this->_single);
381 $this->assign('action', $this->_action);
382
383 if ($this->_action & CRM_Core_Action::VIEW) {
384 // get the tree of custom fields
385 $this->_groupTree = &CRM_Core_BAO_CustomGroup::getTree('Activity', $this,
386 $this->_activityId, 0, $this->_activityTypeId
387 );
388 }
389
390 if ($this->_activityTypeId) {
391 //set activity type name and description to template
392 list($this->_activityTypeName, $activityTypeDescription) = CRM_Core_BAO_OptionValue::getActivityTypeDetails($this->_activityTypeId);
393 $this->assign('activityTypeName', $this->_activityTypeName);
394 $this->assign('activityTypeDescription', $activityTypeDescription);
395 }
396
397 // set user context
398 $urlParams = $urlString = NULL;
9479d7d0
DS
399 $qfKey = CRM_Utils_Request::retrieve('key', 'String', $this);
400 if (!$qfKey) {
401 $qfKey = CRM_Utils_Request::retrieve('qfKey', 'String', $this);
402 }
6a488035
TO
403
404 //validate the qfKey
405 if (!CRM_Utils_Rule::qfKey($qfKey)) {
406 $qfKey = NULL;
407 }
408
409 if ($this->_context == 'fulltext') {
19fc6ae4 410 $keyName = '&qfKey';
6a488035
TO
411 $urlParams = 'force=1';
412 $urlString = 'civicrm/contact/search/custom';
413 if ($this->_action == CRM_Core_Action::UPDATE) {
414 $keyName = '&key';
415 $urlParams .= '&context=fulltext&action=view';
416 $urlString = 'civicrm/contact/view/activity';
417 }
418 if ($qfKey) {
419 $urlParams .= "$keyName=$qfKey";
420 }
421 $this->assign('searchKey', $qfKey);
422 }
423 elseif (in_array($this->_context, array(
19fc6ae4 424 'standalone',
425 'home',
426 'dashlet',
21dfd5f5 427 'dashletFullscreen',
19fc6ae4 428 ))
429 ) {
6a488035
TO
430 $urlParams = 'reset=1';
431 $urlString = 'civicrm/dashboard';
432 }
433 elseif ($this->_context == 'search') {
434 $urlParams = 'force=1';
435 if ($qfKey) {
436 $urlParams .= "&qfKey=$qfKey";
437 }
7964ef53 438 $path = CRM_Utils_System::currentPath();
481a74f4 439 if ($this->_compContext == 'advanced') {
6a488035
TO
440 $urlString = 'civicrm/contact/search/advanced';
441 }
a26bae24 442 elseif ($path == 'civicrm/group/search'
353ffa53 443 || $path == 'civicrm/contact/search'
d31f1ab3 444 || $path == 'civicrm/contact/search/advanced'
7a60b836 445 || $path == 'civicrm/contact/search/custom'
353ffa53
TO
446 || $path == 'civicrm/group/search'
447 ) {
d31f1ab3
AH
448 $urlString = $path;
449 }
6a488035 450 else {
d31f1ab3 451 $urlString = 'civicrm/activity/search';
6a488035
TO
452 }
453 $this->assign('searchKey', $qfKey);
454 }
455 elseif ($this->_context != 'caseActivity') {
456 $urlParams = "action=browse&reset=1&cid={$this->_currentlyViewedContactId}&selectedChild=activity";
457 $urlString = 'civicrm/contact/view';
458 }
459
460 if ($urlString) {
461 $session->pushUserContext(CRM_Utils_System::url($urlString, $urlParams));
462 }
463
464 // hack to retrieve activity type id from post variables
465 if (!$this->_activityTypeId) {
466 $this->_activityTypeId = CRM_Utils_Array::value('activity_type_id', $_POST);
467 }
468
469 // when custom data is included in this page
a7488080 470 if (!empty($_POST['hidden_custom'])) {
6a488035
TO
471 // we need to set it in the session for the below code to work
472 // CRM-3014
473 //need to assign custom data subtype to the template
474 $this->set('type', 'Activity');
475 $this->set('subType', $this->_activityTypeId);
476 $this->set('entityId', $this->_activityId);
477 CRM_Custom_Form_CustomData::preProcess($this);
478 CRM_Custom_Form_CustomData::buildQuickForm($this);
479 CRM_Custom_Form_CustomData::setDefaultValues($this);
480 }
481
482 // add attachments part
483 CRM_Core_BAO_File::buildAttachment($this, 'civicrm_activity', $this->_activityId, NULL, TRUE);
484
485 // figure out the file name for activity type, if any
486 if ($this->_activityTypeId &&
6c552737 487 $this->_activityTypeFile = CRM_Activity_BAO_Activity::getFileForActivityTypeId($this->_activityTypeId, $this->_crmDir)
6a488035
TO
488 ) {
489 $this->assign('activityTypeFile', $this->_activityTypeFile);
490 $this->assign('crmDir', $this->_crmDir);
491 }
492
493 $this->setFields();
494
495 if ($this->_activityTypeFile) {
0e6e8724
DL
496 $className = "CRM_{$this->_crmDir}_Form_Activity_{$this->_activityTypeFile}";
497 $className::preProcess($this);
6a488035
TO
498 }
499
500 $this->_values = $this->get('values');
501 if (!is_array($this->_values)) {
502 $this->_values = array();
503 if (isset($this->_activityId) && $this->_activityId) {
504 $params = array('id' => $this->_activityId);
505 CRM_Activity_BAO_Activity::retrieve($params, $this->_values);
506 }
507 $this->set('values', $this->_values);
508 }
59d63f8b 509
78fe87e6 510 if ($this->_action & CRM_Core_Action::UPDATE) {
8cec51b0 511 CRM_Core_Form_RecurringEntity::preProcess('civicrm_activity');
78fe87e6 512 }
6a488035 513 }
59d63f8b 514
6a488035 515 /**
c490a46a 516 * Set default values for the form. For edit/view mode
6a488035
TO
517 * the default values are retrieved from the database
518 *
6a488035 519 *
355ba699 520 * @return void
6a488035 521 */
00be9182 522 public function setDefaultValues() {
6a488035
TO
523 if ($this->_cdType) {
524 return CRM_Custom_Form_CustomData::setDefaultValues($this);
525 }
526
d2a4c29b 527 $defaults = $this->_values + CRM_Core_Form_RecurringEntity::setDefaultValues();
6a488035
TO
528 // if we're editing...
529 if (isset($this->_activityId)) {
a7488080 530 if (empty($defaults['activity_date_time'])) {
6a488035
TO
531 list($defaults['activity_date_time'], $defaults['activity_date_time_time']) = CRM_Utils_Date::setDateDefaults(NULL, 'activityDateTime');
532 }
533 elseif ($this->_action & CRM_Core_Action::UPDATE) {
534 $this->assign('current_activity_date_time', $defaults['activity_date_time']);
535 list($defaults['activity_date_time'],
536 $defaults['activity_date_time_time']
19fc6ae4 537 ) = CRM_Utils_Date::setDateDefaults($defaults['activity_date_time'], 'activityDateTime');
78fe87e6 538 list($defaults['repetition_start_date'], $defaults['repetition_start_date_time']) = CRM_Utils_Date::setDateDefaults($defaults['activity_date_time'], 'activityDateTime');
6a488035
TO
539 }
540
6a488035
TO
541 if ($this->_context != 'standalone') {
542 $this->assign('target_contact_value',
543 CRM_Utils_Array::value('target_contact_value', $defaults)
544 );
545 $this->assign('assignee_contact_value',
546 CRM_Utils_Array::value('assignee_contact_value', $defaults)
547 );
6a488035
TO
548 }
549
c27ebe4e 550 // Fixme: why are we getting the wrong keys from upstream?
28ded762
JP
551 $defaults['target_contact_id'] = CRM_Utils_Array::value('target_contact', $defaults);
552 $defaults['assignee_contact_id'] = CRM_Utils_Array::value('assignee_contact', $defaults);
c27ebe4e 553
6a488035
TO
554 // set default tags if exists
555 $defaults['tag'] = CRM_Core_BAO_EntityTag::getTag($this->_activityId, 'civicrm_activity');
556 }
557 else {
558 // if it's a new activity, we need to set default values for associated contact fields
6a488035
TO
559 $this->_sourceContactId = $this->_currentUserId;
560 $this->_targetContactId = $this->_currentlyViewedContactId;
6a488035 561
f7305cbc 562 $defaults['source_contact_id'] = $this->_sourceContactId;
c27ebe4e 563 $defaults['target_contact_id'] = $this->_targetContactId;
6a488035 564
6c552737
TO
565 list($defaults['activity_date_time'], $defaults['activity_date_time_time'])
566 = CRM_Utils_Date::setDateDefaults(NULL, 'activityDateTime');
6a488035
TO
567 }
568
569 if ($this->_activityTypeId) {
570 $defaults['activity_type_id'] = $this->_activityTypeId;
571 }
572
ab911378
PJ
573 if (!$this->_single && !empty($this->_contactIds)) {
574 $defaults['target_contact_id'] = $this->_contactIds;
575 }
576
33913af6
CW
577 // CRM-15472 - 50 is around the practial limit of how many items a select2 entityRef can handle
578 if (!empty($defaults['target_contact_id'])) {
579 $count = count(is_array($defaults['target_contact_id']) ? $defaults['target_contact_id'] : explode(',', $defaults['target_contact_id']));
580 if ($count > 50) {
581 $this->freeze(array('target_contact_id'));
582 }
583 }
584
6a488035
TO
585 if ($this->_action & (CRM_Core_Action::DELETE | CRM_Core_Action::RENEW)) {
586 $this->assign('delName', CRM_Utils_Array::value('subject', $defaults));
587 }
588
589 if ($this->_activityTypeFile) {
0e6e8724
DL
590 $className = "CRM_{$this->_crmDir}_Form_Activity_{$this->_activityTypeFile}";
591 $defaults += $className::setDefaultValues($this);
6a488035 592 }
a7488080 593 if (empty($defaults['priority_id'])) {
cbf48754 594 $priority = CRM_Core_PseudoConstant::get('CRM_Activity_DAO_Activity', 'priority_id');
6a488035
TO
595 $defaults['priority_id'] = array_search('Normal', $priority);
596 }
a7488080 597 if (empty($defaults['status_id'])) {
343d84fa
DG
598 $defaults['status_id'] = CRM_Core_OptionGroup::getDefaultValue('activity_status');
599 }
6a488035
TO
600 return $defaults;
601 }
602
6a488035
TO
603 public function buildQuickForm() {
604 if ($this->_action & (CRM_Core_Action::DELETE | CRM_Core_Action::RENEW)) {
605 //enable form element (ActivityLinks sets this true)
606 $this->assign('suppressForm', FALSE);
607
608 $button = ts('Delete');
609 if ($this->_action & CRM_Core_Action::RENEW) {
610 $button = ts('Restore');
611 }
612 $this->addButtons(array(
19fc6ae4 613 array(
614 'type' => 'next',
615 'name' => $button,
616 'spacing' => '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;',
21dfd5f5 617 'isDefault' => TRUE,
19fc6ae4 618 ),
619 array(
620 'type' => 'cancel',
21dfd5f5
TO
621 'name' => ts('Cancel'),
622 ),
19fc6ae4 623 ));
6a488035
TO
624 return;
625 }
626
6a488035
TO
627 if ($this->_cdType) {
628 return CRM_Custom_Form_CustomData::buildQuickForm($this);
629 }
630
631 //build other activity links
cfcb7676 632 CRM_Activity_Form_ActivityLinks::commonBuildQuickForm($this);
6a488035
TO
633
634 //enable form element (ActivityLinks sets this true)
635 $this->assign('suppressForm', FALSE);
636
353ffa53 637 $element = &$this->add('select', 'activity_type_id', ts('Activity Type'),
ba6e6f51 638 array('' => '- ' . ts('select') . ' -') + $this->_fields['followup_activity_type_id']['attributes'],
6a488035 639 FALSE, array(
f7305cbc 640 'onchange' => "CRM.buildCustomData( 'Activity', this.value );",
ba6e6f51 641 'class' => 'crm-select2 required',
6a488035
TO
642 )
643 );
644
645 //freeze for update mode.
646 if ($this->_action & CRM_Core_Action::UPDATE) {
647 $element->freeze();
b334d9ad 648 }
649
650 //Call to RecurringEntity buildQuickForm for add/update mode
651 if ($this->_action & (CRM_Core_Action::UPDATE | CRM_Core_Action::ADD)) {
78fe87e6 652 CRM_Core_Form_RecurringEntity::buildQuickForm($this);
6a488035
TO
653 }
654
655 foreach ($this->_fields as $field => $values) {
a7488080 656 if (!empty($this->_fields[$field])) {
475e9f44
CW
657 $attribute = CRM_Utils_Array::value('attributes', $values);
658 $required = !empty($values['required']);
6a488035 659
6a488035
TO
660 if ($values['type'] == 'wysiwyg') {
661 $this->addWysiwyg($field, $values['label'], $attribute, $required);
662 }
475e9f44 663 elseif ($values['type'] == 'select' && empty($attribute)) {
c27ebe4e
CW
664 $this->addSelect($field, array('entity' => 'activity'), $required);
665 }
666 elseif ($values['type'] == 'entityRef') {
667 $this->addEntityRef($field, $values['label'], $attribute, $required);
475e9f44 668 }
c27ebe4e 669 else {
5e72d8ae 670 $this->add($values['type'], $field, $values['label'], $attribute, $required, CRM_Utils_Array::value('extra', $values));
6a488035
TO
671 }
672 }
673 }
674
675 //CRM-7362 --add campaigns.
676 CRM_Campaign_BAO_Campaign::addCampaign($this, CRM_Utils_Array::value('campaign_id', $this->_values));
677
678 //add engagement level CRM-7775
679 $buildEngagementLevel = FALSE;
680 if (CRM_Campaign_BAO_Campaign::isCampaignEnable() &&
681 CRM_Campaign_BAO_Campaign::accessCampaign()
682 ) {
683 $buildEngagementLevel = TRUE;
32864ccf 684 $this->addSelect('engagement_level', array('entity' => 'activity'));
6a488035
TO
685 $this->addRule('engagement_level',
686 ts('Please enter the engagement index as a number (integers only).'),
687 'positiveInteger'
688 );
689 }
690 $this->assign('buildEngagementLevel', $buildEngagementLevel);
691
692 // check for survey activity
693 $this->_isSurveyActivity = FALSE;
694
695 if ($this->_activityId && CRM_Campaign_BAO_Campaign::isCampaignEnable() &&
696 CRM_Campaign_BAO_Campaign::accessCampaign()
697 ) {
698
699 $this->_isSurveyActivity = CRM_Campaign_BAO_Survey::isSurveyActivity($this->_activityId);
700 if ($this->_isSurveyActivity) {
701 $surveyId = CRM_Core_DAO::getFieldValue('CRM_Activity_DAO_Activity',
702 $this->_activityId,
703 'source_record_id'
704 );
705 $responseOptions = CRM_Campaign_BAO_Survey::getResponsesOptions($surveyId);
706 if ($responseOptions) {
707 $this->add('select', 'result', ts('Result'),
708 array('' => ts('- select -')) + array_combine($responseOptions, $responseOptions)
709 );
710 }
711 $surveyTitle = NULL;
712 if ($surveyId) {
713 $surveyTitle = CRM_Core_DAO::getFieldValue('CRM_Campaign_DAO_Survey', $surveyId, 'title');
714 }
715 $this->assign('surveyTitle', $surveyTitle);
716 }
717 }
718 $this->assign('surveyActivity', $this->_isSurveyActivity);
719
52c7b3a2 720 // this option should be available only during add mode
ef89f226 721 if ($this->_action != CRM_Core_Action::UPDATE) {
d82cb206 722 $this->add('advcheckbox', 'is_multi_activity', ts('Create a separate activity for each contact.'));
52c7b3a2
KJ
723 }
724
6a488035
TO
725 $this->addRule('duration',
726 ts('Please enter the duration as number of minutes (integers only).'), 'positiveInteger'
727 );
728 $this->addDateTime('activity_date_time', ts('Date'), TRUE, array('formatType' => 'activityDateTime'));
729
730 //add followup date
f4754509 731 $this->addDateTime('followup_date', ts('in'), FALSE, array('formatType' => 'activityDateTime'));
6a488035 732
f7305cbc
CW
733 // Only admins and case-workers can change the activity source
734 if (!CRM_Core_Permission::check('administer CiviCRM') && $this->_context != 'caseActivity') {
c27ebe4e 735 $this->getElement('source_contact_id')->freeze();
f7305cbc 736 }
6a488035 737
6a488035
TO
738 //need to assign custom data type and subtype to the template
739 $this->assign('customDataType', 'Activity');
740 $this->assign('customDataSubType', $this->_activityTypeId);
741 $this->assign('entityID', $this->_activityId);
742
e0f9d6a2 743 CRM_Core_BAO_Tag::getTags('civicrm_activity', $tags, NULL,
47358d92 744 '&nbsp;&nbsp;', TRUE);
6a488035
TO
745
746 if (!empty($tags)) {
747 $this->add('select', 'tag', ts('Tags'), $tags, FALSE,
f7305cbc 748 array('id' => 'tags', 'multiple' => 'multiple', 'class' => 'crm-select2 huge')
6a488035
TO
749 );
750 }
751
752 // we need to hide activity tagset for special activities
753 $specialActivities = array('Open Case');
754
755 if (!in_array($this->_activityTypeName, $specialActivities)) {
756 // build tag widget
757 $parentNames = CRM_Core_BAO_Tag::getTagSet('civicrm_activity');
95ef220a 758 CRM_Core_Form_Tag::buildQuickForm($this, $parentNames, 'civicrm_activity', $this->_activityId);
6a488035
TO
759 }
760
761 // if we're viewing, we're assigning different buttons than for adding/editing
762 if ($this->_action & CRM_Core_Action::VIEW) {
763 if (isset($this->_groupTree)) {
764 CRM_Core_BAO_CustomGroup::buildCustomDataView($this, $this->_groupTree);
765 }
6a488035
TO
766 // form should be frozen for view mode
767 $this->freeze();
768
5b7581f1 769 $buttons = array();
6a488035
TO
770 $buttons[] = array(
771 'type' => 'cancel',
21dfd5f5 772 'name' => ts('Done'),
6a488035 773 );
6a488035
TO
774 $this->addButtons($buttons);
775 }
776 else {
19fc6ae4 777 $message = array(
778 'completed' => ts('Are you sure? This is a COMPLETED activity with the DATE in the FUTURE. Click Cancel to change the date / status. Otherwise, click OK to save.'),
6a488035
TO
779 'scheduled' => ts('Are you sure? This is a SCHEDULED activity with the DATE in the PAST. Click Cancel to change the date / status. Otherwise, click OK to save.'),
780 );
781 $js = array('onclick' => "return activityStatus(" . json_encode($message) . ");");
782 $this->addButtons(array(
783 array(
784 'type' => 'upload',
785 'name' => ts('Save'),
786 'js' => $js,
21dfd5f5 787 'isDefault' => TRUE,
6a488035
TO
788 ),
789 array(
790 'type' => 'cancel',
21dfd5f5
TO
791 'name' => ts('Cancel'),
792 ),
6a488035
TO
793 )
794 );
795 }
796
797 if ($this->_activityTypeFile) {
0e6e8724 798 $className = "CRM_{$this->_crmDir}_Form_Activity_{$this->_activityTypeFile}";
6a488035 799
0e6e8724
DL
800 $className::buildQuickForm($this);
801 $this->addFormRule(array($className, 'formRule'), $this);
6a488035
TO
802 }
803
804 $this->addFormRule(array('CRM_Activity_Form_Activity', 'formRule'), $this);
6db7e202 805
0086c33d 806 if (CRM_Core_BAO_Setting::getItem(
19fc6ae4 807 CRM_Core_BAO_Setting::SYSTEM_PREFERENCES_NAME,
808 'activity_assignee_notification'
809 )
6db7e202 810 ) {
0086c33d
DL
811 $this->assign('activityAssigneeNotification', TRUE);
812 }
813 else {
814 $this->assign('activityAssigneeNotification', FALSE);
6db7e202 815 }
6a488035
TO
816 }
817
818 /**
fe482240 819 * Global form rule.
6a488035 820 *
041ab3d1
TO
821 * @param array $fields
822 * The input form values.
823 * @param array $files
824 * The uploaded files if any.
2a6da8d7
EM
825 * @param $self
826 *
72b3a70c
CW
827 * @return bool|array
828 * true if no errors, else array of errors
6a488035 829 */
00be9182 830 public static function formRule($fields, $files, $self) {
6a488035
TO
831 // skip form rule if deleting
832 if (CRM_Utils_Array::value('_qf_Activity_next_', $fields) == 'Delete') {
833 return TRUE;
834 }
835 $errors = array();
ba6e6f51 836 if ((array_key_exists('activity_type_id', $fields) || !$self->_single) && empty($fields['activity_type_id'])) {
6a488035
TO
837 $errors['activity_type_id'] = ts('Activity Type is a required field');
838 }
839
6a488035
TO
840 if (CRM_Utils_Array::value('activity_type_id', $fields) == 3 &&
841 CRM_Utils_Array::value('status_id', $fields) == 1
842 ) {
843 $errors['status_id'] = ts('You cannot record scheduled email activity.');
844 }
845 elseif (CRM_Utils_Array::value('activity_type_id', $fields) == 4 &&
846 CRM_Utils_Array::value('status_id', $fields) == 1
847 ) {
848 $errors['status_id'] = ts('You cannot record scheduled SMS activity.');
849 }
850
8cc574cf 851 if (!empty($fields['followup_activity_type_id']) && empty($fields['followup_date'])) {
6a488035
TO
852 $errors['followup_date_time'] = ts('Followup date is a required field.');
853 }
854 //Activity type is mandatory if subject or follow-up date is specified for an Follow-up activity, CRM-4515
8cc574cf 855 if ((!empty($fields['followup_activity_subject']) || !empty($fields['followup_date'])) && empty($fields['followup_activity_type_id'])) {
6a488035
TO
856 $errors['followup_activity_subject'] = ts('Follow-up Activity type is a required field.');
857 }
858 return $errors;
859 }
860
861 /**
fe482240 862 * Process the form submission.
6a488035 863 *
6a488035 864 *
100fef9d
CW
865 * @param array $params
866 * @return array|null
6a488035
TO
867 */
868 public function postProcess($params = NULL) {
869 if ($this->_action & CRM_Core_Action::DELETE) {
870 $deleteParams = array('id' => $this->_activityId);
871 $moveToTrash = CRM_Case_BAO_Case::isCaseActivity($this->_activityId);
872 CRM_Activity_BAO_Activity::deleteActivity($deleteParams, $moveToTrash);
873
874 // delete tags for the entity
875 $tagParams = array(
876 'entity_table' => 'civicrm_activity',
21dfd5f5 877 'entity_id' => $this->_activityId,
6a488035
TO
878 );
879
880 CRM_Core_BAO_EntityTag::del($tagParams);
881
882 CRM_Core_Session::setStatus(ts("Selected Activity has been deleted successfully."), ts('Record Deleted'), 'success');
a1a2a83d 883 return NULL;
6a488035
TO
884 }
885
886 // store the submitted values in an array
887 if (!$params) {
888 $params = $this->controller->exportValues($this->_name);
889 }
890
891 //set activity type id
a7488080 892 if (empty($params['activity_type_id'])) {
6a488035
TO
893 $params['activity_type_id'] = $this->_activityTypeId;
894 }
895
a7488080 896 if (!empty($params['hidden_custom']) &&
6a488035
TO
897 !isset($params['custom'])
898 ) {
899 $customFields = CRM_Core_BAO_CustomField::getFields('Activity', FALSE, FALSE,
900 $this->_activityTypeId
901 );
902 $customFields = CRM_Utils_Array::crmArrayMerge($customFields,
903 CRM_Core_BAO_CustomField::getFields('Activity', FALSE, FALSE,
904 NULL, NULL, TRUE
905 )
906 );
907 $params['custom'] = CRM_Core_BAO_CustomField::postProcess($params,
908 $customFields,
909 $this->_activityId,
910 'Activity'
911 );
912 }
913
914 // store the date with proper format
915 $params['activity_date_time'] = CRM_Utils_Date::processDate($params['activity_date_time'], $params['activity_date_time_time']);
916
c27ebe4e
CW
917 // format params as arrays
918 foreach (array('target', 'assignee', 'followup_assignee') as $name) {
919 if (!empty($params["{$name}_contact_id"])) {
920 $params["{$name}_contact_id"] = explode(',', $params["{$name}_contact_id"]);
921 }
922 else {
923 $params["{$name}_contact_id"] = array();
924 }
6a488035 925 }
6a488035
TO
926
927 // get ids for associated contacts
928 if (!$params['source_contact_id']) {
929 $params['source_contact_id'] = $this->_currentUserId;
930 }
6a488035
TO
931
932 if (isset($this->_activityId)) {
933 $params['id'] = $this->_activityId;
934 }
935
936 // add attachments as needed
937 CRM_Core_BAO_File::formatAttachment($params,
938 $params,
939 'civicrm_activity',
940 $this->_activityId
941 );
942
52c7b3a2 943 $activity = array();
a7488080 944 if (!empty($params['is_multi_activity']) &&
52c7b3a2
KJ
945 !CRM_Utils_Array::crmIsEmptyArray($params['target_contact_id'])
946 ) {
947 $targetContacts = $params['target_contact_id'];
19fc6ae4 948 foreach ($targetContacts as $targetContactId) {
52c7b3a2
KJ
949 $params['target_contact_id'] = array($targetContactId);
950 // save activity
951 $activity[] = $this->processActivity($params);
952 }
953 }
954 else {
955 // save activity
956 $activity = $this->processActivity($params);
957 }
958
7a4bb524 959 $activityIds = empty($this->_activityIds) ? array($this->_activityId) : $this->_activityIds;
960 foreach ($activityIds as $activityId) {
961 // set params for repeat configuration in create mode
962 $params['entity_id'] = $activityId;
963 $params['entity_table'] = 'civicrm_activity';
7a4bb524 964 if (!empty($params['entity_id']) && !empty($params['entity_table'])) {
965 $checkParentExistsForThisId = CRM_Core_BAO_RecurringEntity::getParentFor($params['entity_id'], $params['entity_table']);
966 if ($checkParentExistsForThisId) {
967 $params['parent_entity_id'] = $checkParentExistsForThisId;
968 $scheduleReminderDetails = CRM_Core_BAO_RecurringEntity::getReminderDetailsByEntityId($checkParentExistsForThisId, $params['entity_table']);
969 }
970 else {
971 $params['parent_entity_id'] = $params['entity_id'];
972 $scheduleReminderDetails = CRM_Core_BAO_RecurringEntity::getReminderDetailsByEntityId($params['entity_id'], $params['entity_table']);
973 }
974 if (property_exists($scheduleReminderDetails, 'id')) {
975 $params['schedule_reminder_id'] = $scheduleReminderDetails->id;
976 }
fe87e754 977 }
7a4bb524 978 $params['dateColumns'] = array('activity_date_time');
b334d9ad 979
83f3c8a3
CW
980 // Set default repetition start if it was not provided.
981 if (empty($params['repetition_start_date'])) {
982 $params['repetition_start_date'] = $params['activity_date_time'];
983 }
984
7a4bb524 985 // unset activity id
986 unset($params['id']);
987 $linkedEntities = array(
988 array(
989 'table' => 'civicrm_activity_contact',
990 'findCriteria' => array(
991 'activity_id' => $activityId,
992 ),
993 'linkedColumns' => array('activity_id'),
994 'isRecurringEntityRecord' => FALSE,
b334d9ad 995 ),
7a4bb524 996 );
997 CRM_Core_Form_RecurringEntity::postProcess($params, 'civicrm_activity', $linkedEntities);
998 }
b334d9ad 999
52c7b3a2
KJ
1000 return array('activity' => $activity);
1001 }
1002
1003 /**
fe482240 1004 * Process activity creation.
52c7b3a2 1005 *
041ab3d1
TO
1006 * @param array $params
1007 * Associated array of submitted values.
77b97be7 1008 *
6c552737 1009 * @return self|null|object
52c7b3a2
KJ
1010 */
1011 protected function processActivity(&$params) {
6a488035 1012 $activityAssigned = array();
e7e657f0 1013 $activityContacts = CRM_Core_OptionGroup::values('activity_contacts', FALSE, FALSE, FALSE, NULL, 'name');
034500d4 1014 $assigneeID = CRM_Utils_Array::key('Activity Assignees', $activityContacts);
6a488035
TO
1015 // format assignee params
1016 if (!CRM_Utils_Array::crmIsEmptyArray($params['assignee_contact_id'])) {
1017 //skip those assignee contacts which are already assigned
1018 //while sending a copy.CRM-4509.
1019 $activityAssigned = array_flip($params['assignee_contact_id']);
1020 if ($this->_activityId) {
034500d4 1021 $assigneeContacts = CRM_Activity_BAO_ActivityContact::getNames($this->_activityId, $assigneeID);
6a488035
TO
1022 $activityAssigned = array_diff_key($activityAssigned, $assigneeContacts);
1023 }
1024 }
1025
1026 // call begin post process. Idea is to let injecting file do
1027 // any processing before the activity is added/updated.
1028 $this->beginPostProcess($params);
1029
1030 $activity = CRM_Activity_BAO_Activity::create($params);
1031
1032 // add tags if exists
1033 $tagParams = array();
1034 if (!empty($params['tag'])) {
1035 foreach ($params['tag'] as $tag) {
1036 $tagParams[$tag] = 1;
1037 }
1038 }
1039
1040 //save static tags
1041 CRM_Core_BAO_EntityTag::create($tagParams, 'civicrm_activity', $activity->id);
1042
1043 //save free tags
1044 if (isset($params['activity_taglist']) && !empty($params['activity_taglist'])) {
1045 CRM_Core_Form_Tag::postProcess($params['activity_taglist'], $activity->id, 'civicrm_activity', $this);
1046 }
1047
1048 // call end post process. Idea is to let injecting file do any
1049 // processing needed, after the activity has been added/updated.
1050 $this->endPostProcess($params, $activity);
1051
1052 // CRM-9590
a7488080 1053 if (!empty($params['is_multi_activity'])) {
52c7b3a2
KJ
1054 $this->_activityIds[] = $activity->id;
1055 }
1056 else {
1057 $this->_activityId = $activity->id;
1058 }
6a488035
TO
1059
1060 // create follow up activity if needed
1061 $followupStatus = '';
90b05581 1062 $followupActivity = NULL;
a7488080 1063 if (!empty($params['followup_activity_type_id'])) {
90b05581 1064 $followupActivity = CRM_Activity_BAO_Activity::createFollowupActivity($activity->id, $params);
6a488035
TO
1065 $followupStatus = ts('A followup activity has been scheduled.');
1066 }
1067
1068 // send copy to assignee contacts.CRM-4509
1069 $mailStatus = '';
1070
90b05581 1071 if (CRM_Core_BAO_Setting::getItem(CRM_Core_BAO_Setting::SYSTEM_PREFERENCES_NAME,
353ffa53
TO
1072 'activity_assignee_notification')
1073 ) {
90b05581
DG
1074 $activityIDs = array($activity->id);
1075 if ($followupActivity) {
1076 $activityIDs = array_merge($activityIDs, array($followupActivity->id));
1077 }
1078 $assigneeContacts = CRM_Activity_BAO_ActivityAssignment::getAssigneeNames($activityIDs, TRUE, FALSE);
6a488035 1079
90b05581
DG
1080 if (!CRM_Utils_Array::crmIsEmptyArray($params['assignee_contact_id'])) {
1081 $mailToContacts = array();
1082
1083 //build an associative array with unique email addresses.
1084 foreach ($activityAssigned as $id => $dnc) {
1085 if (isset($id) && array_key_exists($id, $assigneeContacts)) {
1086 $mailToContacts[$assigneeContacts[$id]['email']] = $assigneeContacts[$id];
1087 }
6a488035 1088 }
6a488035 1089
90b05581
DG
1090 if (!CRM_Utils_array::crmIsEmptyArray($mailToContacts)) {
1091 //include attachments while sending a copy of activity.
1092 $attachments = CRM_Core_BAO_File::getEntityFile('civicrm_activity', $activity->id);
1093
1094 $ics = new CRM_Activity_BAO_ICalendar($activity);
1095 $ics->addAttachment($attachments, $mailToContacts);
6a488035 1096
90b05581
DG
1097 // CRM-8400 add param with _currentlyViewedContactId for URL link in mail
1098 CRM_Case_BAO_Case::sendActivityCopy(NULL, $activity->id, $mailToContacts, $attachments, NULL);
6a488035 1099
90b05581 1100 $ics->cleanup();
6a488035 1101
90b05581
DG
1102 $mailStatus .= ts("A copy of the activity has also been sent to assignee contacts(s).");
1103 }
1104 }
77b97be7 1105
90b05581
DG
1106 // Also send email to follow-up activity assignees if set
1107 if ($followupActivity) {
1108 $mailToFollowupContacts = array();
1109 foreach ($assigneeContacts as $values) {
1110 if ($values['activity_id'] == $followupActivity->id) {
1111 $mailToFollowupContacts[$values['email']] = $values;
1112 }
1113 }
1114
1115 if (!CRM_Utils_array::crmIsEmptyArray($mailToFollowupContacts)) {
1116 $ics = new CRM_Activity_BAO_ICalendar($followupActivity);
1117 $attachments = CRM_Core_BAO_File::getEntityFile('civicrm_activity', $followupActivity->id);
1118 $ics->addAttachment($attachments, $mailToFollowupContacts);
6a488035 1119
90b05581
DG
1120 CRM_Case_BAO_Case::sendActivityCopy(NULL, $followupActivity->id, $mailToFollowupContacts, $attachments, NULL);
1121
1122 $ics->cleanup();
1123
1124 $mailStatus .= '<br />' . ts("A copy of the follow-up activity has also been sent to follow-up assignee contacts(s).");
1125 }
6a488035
TO
1126 }
1127 }
1128
1129 // set status message
ef89f226 1130 $subject = '';
a7488080 1131 if (!empty($params['subject'])) {
ef89f226 1132 $subject = "'" . $params['subject'] . "'";
6a488035
TO
1133 }
1134
12e2d503 1135 CRM_Core_Session::setStatus(ts('Activity %1 has been saved. %2 %3',
52c7b3a2 1136 array(
ef89f226 1137 1 => $subject,
52c7b3a2 1138 2 => $followupStatus,
21dfd5f5 1139 3 => $mailStatus,
52c7b3a2
KJ
1140 )
1141 ), ts('Saved'), 'success');
6a488035 1142
52c7b3a2 1143 return $activity;
6a488035
TO
1144 }
1145
1146 /**
1147 * Shorthand for getting id by display name (makes code more readable)
645ee340
EM
1148 * @param $displayName
1149 * @return null|string
6a488035
TO
1150 */
1151 protected function _getIdByDisplayName($displayName) {
1152 return CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact',
1153 $displayName,
1154 'id',
1155 'sort_name'
1156 );
1157 }
1158
1159 /**
1160 * Shorthand for getting display name by id (makes code more readable)
645ee340
EM
1161 * @param $id
1162 * @return null|string
6a488035
TO
1163 */
1164 protected function _getDisplayNameById($id) {
1165 return CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact',
1166 $id,
1167 'sort_name',
1168 'id'
1169 );
1170 }
1171
1172 /**
fe482240 1173 * Let injecting activity type file do any processing.
6a488035
TO
1174 * needed, before the activity is added/updated
1175 *
100fef9d 1176 * @param array $params
6a488035 1177 */
00be9182 1178 public function beginPostProcess(&$params) {
6a488035 1179 if ($this->_activityTypeFile) {
0e6e8724
DL
1180 $className = "CRM_{$this->_crmDir}_Form_Activity_{$this->_activityTypeFile}";
1181 $className::beginPostProcess($this, $params);
6a488035
TO
1182 }
1183 }
1184
1185 /**
100fef9d 1186 * Let injecting activity type file do any processing
6a488035
TO
1187 * needed, after the activity has been added/updated
1188 *
100fef9d
CW
1189 * @param array $params
1190 * @param $activity
6a488035 1191 */
00be9182 1192 public function endPostProcess(&$params, &$activity) {
6a488035 1193 if ($this->_activityTypeFile) {
0e6e8724 1194 $className = "CRM_{$this->_crmDir}_Form_Activity_{$this->_activityTypeFile}";
100fef9d 1195 $className::endPostProcess($this, $params, $activity);
6a488035
TO
1196 }
1197 }
96025800 1198
6a488035 1199}