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