Merge pull request #17147 from kartik1000/Fix#1650
[civicrm-core.git] / CRM / Event / Form / Participant.php
1 <?php
2 /*
3 +--------------------------------------------------------------------+
4 | Copyright CiviCRM LLC. All rights reserved. |
5 | |
6 | This work is published under the GNU AGPLv3 license with some |
7 | permitted exceptions and without any warranty. For full license |
8 | and copyright information, see https://civicrm.org/licensing |
9 +--------------------------------------------------------------------+
10 */
11
12 /**
13 * Back office participant form.
14 *
15 * @package CRM
16 * @copyright CiviCRM LLC https://civicrm.org/licensing
17 */
18
19 /**
20 * Back office participant form.
21 */
22 class CRM_Event_Form_Participant extends CRM_Contribute_Form_AbstractEditPayment {
23
24 /**
25 * Participant ID - use getParticipantID.
26 *
27 * @var int
28 */
29 public $_pId;
30
31 /**
32 * ID of discount record.
33 *
34 * @var int
35 */
36 public $_discountId;
37
38 public $useLivePageJS = TRUE;
39
40 /**
41 * The values for the contribution db object.
42 *
43 * @var array
44 */
45 public $_values;
46
47 /**
48 * The values for the quickconfig for priceset.
49 *
50 * @var bool
51 */
52 public $_quickConfig = NULL;
53
54 /**
55 * Price Set ID, if the new price set method is used
56 *
57 * @var int
58 */
59 public $_priceSetId;
60
61 /**
62 * Array of fields for the price set.
63 *
64 * @var array
65 */
66 public $_priceSet;
67
68 /**
69 * The id of the participation that we are processing.
70 *
71 * @var int
72 */
73 public $_id;
74
75 /**
76 * The id of the note.
77 *
78 * @var int
79 */
80 protected $_noteId = NULL;
81
82 /**
83 *
84 * Use parent $this->contactID
85 *
86 * The id of the contact associated with this participation.
87 *
88 * @var int
89 * @deprecated
90 */
91 public $_contactId;
92
93 /**
94 * Array of event values.
95 *
96 * @var array
97 */
98 protected $_event;
99
100 /**
101 * Are we operating in "single mode", i.e. adding / editing only
102 * one participant record, or is this a batch add operation
103 *
104 * @var bool
105 */
106 public $_single = FALSE;
107
108 /**
109 * If event is paid or unpaid.
110 *
111 * @var bool
112 */
113 public $_isPaidEvent;
114
115 /**
116 * Page action.
117 *
118 * @var int
119 */
120 public $_action;
121
122 /**
123 * Event Type Id.
124 *
125 * @var int
126 */
127 protected $_eventTypeId = NULL;
128
129 /**
130 * Participant status Id.
131 *
132 * @var int
133 */
134 protected $_statusId = NULL;
135
136 /**
137 * Cache all the participant statuses.
138 *
139 * @var array
140 */
141 protected $_participantStatuses;
142
143 /**
144 * Participant mode.
145 *
146 * @var string
147 */
148 public $_mode = NULL;
149
150 /**
151 * Event ID preselect.
152 *
153 * @var int
154 */
155 public $_eID = NULL;
156
157 /**
158 * Line Item for Price Set.
159 *
160 * @var array
161 */
162 public $_lineItem = NULL;
163
164 /**
165 * Contribution mode for event registration for offline mode.
166 *
167 * @var string
168 * @deprecated
169 */
170 public $_contributeMode = 'direct';
171
172 public $_online;
173
174 /**
175 * Store id of role custom data type ( option value )
176 *
177 * @var int
178 */
179 protected $_roleCustomDataTypeID;
180
181 /**
182 * Store id of event Name custom data type ( option value)
183 *
184 * @var int
185 */
186 protected $_eventNameCustomDataTypeID;
187
188 /**
189 * Selected discount id.
190 *
191 * @var int
192 */
193 public $_originalDiscountId = NULL;
194
195 /**
196 * Event id.
197 *
198 * @var int
199 */
200 public $_eventId = NULL;
201
202 /**
203 * Id of payment, if any
204 *
205 * @var int
206 */
207 public $_paymentId = NULL;
208
209 /**
210 * @var null
211 * @todo add explanatory note about this
212 */
213 public $_onlinePendingContributionId = NULL;
214
215 /**
216 * Stored participant record.
217 *
218 * @var array
219 */
220 protected $participantRecord;
221
222 /**
223 * Params for creating a payment to add to the contribution.
224 *
225 * @var array
226 */
227 protected $createPaymentParams = [];
228
229 /**
230 * Get params to create payments.
231 *
232 * @return array
233 */
234 public function getCreatePaymentParams(): array {
235 return $this->createPaymentParams;
236 }
237
238 /**
239 * Set params to create payments.
240 *
241 * @param array $createPaymentParams
242 */
243 public function setCreatePaymentParams(array $createPaymentParams) {
244 $this->createPaymentParams = $createPaymentParams;
245 }
246
247 /**
248 * Explicitly declare the entity api name.
249 */
250 public function getDefaultEntity() {
251 return 'Participant';
252 }
253
254 /**
255 * Default form context used as part of addField()
256 */
257 public function getDefaultContext() {
258 return 'create';
259 }
260
261 /**
262 * Set variables up before form is built.
263 *
264 * @throws \CRM_Core_Exception
265 * @throws \CiviCRM_API3_Exception
266 */
267 public function preProcess() {
268 parent::preProcess();
269 $this->_showFeeBlock = $_GET['eventId'] ?? NULL;
270 $this->assign('showFeeBlock', FALSE);
271 $this->assign('feeBlockPaid', FALSE);
272
273 // @todo eliminate this duplication.
274 $this->_contactId = $this->_contactID;
275 $this->_eID = CRM_Utils_Request::retrieve('eid', 'Positive', $this);
276 $this->_context = CRM_Utils_Request::retrieve('context', 'Alphanumeric', $this);
277 $this->assign('context', $this->_context);
278
279 if ($this->_contactID) {
280 $this->setPageTitle(ts('Event Registration for %1', [1 => $this->userDisplayName]));
281 }
282 else {
283 $this->setPageTitle(ts('Event Registration'));
284 }
285
286 // check the current path, if search based, then dont get participantID
287 // CRM-5792
288 $path = CRM_Utils_System::currentPath();
289 if (
290 strpos($path, 'civicrm/contact/search') === 0 ||
291 strpos($path, 'civicrm/group/search') === 0
292 ) {
293 $this->_id = NULL;
294 }
295 else {
296 $this->_id = CRM_Utils_Request::retrieve('id', 'Positive', $this);
297 }
298
299 if ($this->_id) {
300 $this->assign('participantId', $this->_id);
301
302 $this->_paymentId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_ParticipantPayment',
303 $this->_id, 'id', 'participant_id'
304 );
305
306 $this->assign('hasPayment', $this->_paymentId);
307 $this->assign('componentId', $this->_id);
308 $this->assign('component', 'event');
309
310 // CRM-12615 - Get payment information from the primary registration
311 if ((!$this->_paymentId) && ($this->_action == CRM_Core_Action::UPDATE)) {
312 $registered_by_id = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Participant',
313 $this->_id, 'registered_by_id', 'id'
314 );
315 if ($registered_by_id) {
316 $this->_paymentId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_ParticipantPayment',
317 $registered_by_id, 'id', 'participant_id'
318 );
319 $this->assign('registeredByParticipantId', $registered_by_id);
320 }
321 }
322 }
323 $this->setCustomDataTypes();
324
325 if ($this->_mode) {
326 $this->assign('participantMode', $this->_mode);
327 }
328
329 if ($this->_showFeeBlock) {
330 $this->assign('showFeeBlock', TRUE);
331 $isMonetary = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event', $this->_showFeeBlock, 'is_monetary');
332 if ($isMonetary) {
333 $this->assign('feeBlockPaid', TRUE);
334 }
335 return CRM_Event_Form_EventFees::preProcess($this);
336 }
337
338 //check the mode when this form is called either single or as
339 //search task action
340 if ($this->_id || $this->_contactId || $this->_context == 'standalone') {
341 $this->_single = TRUE;
342 $this->assign('urlPath', 'civicrm/contact/view/participant');
343 if (!$this->_id && !$this->_contactId) {
344 $breadCrumbs = [
345 [
346 'title' => ts('CiviEvent Dashboard'),
347 'url' => CRM_Utils_System::url('civicrm/event', 'reset=1'),
348 ],
349 ];
350
351 CRM_Utils_System::appendBreadCrumb($breadCrumbs);
352 }
353 }
354 else {
355 //set the appropriate action
356 $context = $this->get('context');
357 $urlString = 'civicrm/contact/search';
358 $this->_action = CRM_Core_Action::BASIC;
359 switch ($context) {
360 case 'advanced':
361 $urlString = 'civicrm/contact/search/advanced';
362 $this->_action = CRM_Core_Action::ADVANCED;
363 break;
364
365 case 'builder':
366 $urlString = 'civicrm/contact/search/builder';
367 $this->_action = CRM_Core_Action::PROFILE;
368 break;
369
370 case 'basic':
371 $urlString = 'civicrm/contact/search/basic';
372 $this->_action = CRM_Core_Action::BASIC;
373 break;
374
375 case 'custom':
376 $urlString = 'civicrm/contact/search/custom';
377 $this->_action = CRM_Core_Action::COPY;
378 break;
379 }
380 CRM_Contact_Form_Task::preProcessCommon($this);
381
382 $this->_single = FALSE;
383 $this->_contactId = NULL;
384
385 //set ajax path, this used for custom data building
386 $this->assign('urlPath', $urlString);
387 $this->assign('urlPathVar', "_qf_Participant_display=true&qfKey={$this->controller->_key}");
388 }
389
390 $this->assign('single', $this->_single);
391
392 if (!$this->_id) {
393 $this->_action = CRM_Utils_Request::retrieve('action', 'String', $this, FALSE, 'add');
394 }
395 $this->assign('action', $this->_action);
396
397 // check for edit permission
398 if (!CRM_Core_Permission::checkActionPermission('CiviEvent', $this->_action)) {
399 CRM_Core_Error::statusBounce(ts('You do not have permission to access this page.'));
400 }
401
402 if ($this->_action & CRM_Core_Action::DELETE) {
403 // check delete permission for contribution
404 if ($this->_id && $this->_paymentId && !CRM_Core_Permission::checkActionPermission('CiviContribute', $this->_action)) {
405 CRM_Core_Error::statusBounce(ts("This Participant is linked to a contribution. You must have 'delete in CiviContribute' permission in order to delete this record."));
406 }
407 return;
408 }
409
410 if ($this->_id) {
411 // assign participant id to the template
412 $this->assign('participantId', $this->_id);
413 }
414
415 // when fee amount is included in form
416 if (!empty($_POST['hidden_feeblock']) || !empty($_POST['send_receipt'])) {
417 CRM_Event_Form_EventFees::preProcess($this);
418 $this->buildEventFeeForm($this);
419 CRM_Event_Form_EventFees::setDefaultValues($this);
420 }
421
422 // when custom data is included in this page
423 if (!empty($_POST['hidden_custom'])) {
424 $eventId = (int) ($_POST['event_id'] ?? 0);
425 // Custom data of type participant role
426 // Note: Some earlier commits imply $_POST['role_id'] could be a comma separated string,
427 // not sure if that ever really happens
428 if (!empty($_POST['role_id'])) {
429 foreach ($_POST['role_id'] as $roleID) {
430 CRM_Custom_Form_CustomData::preProcess($this, $this->_roleCustomDataTypeID, $roleID, 1, 'Participant', $this->_id);
431 CRM_Custom_Form_CustomData::buildQuickForm($this);
432 CRM_Custom_Form_CustomData::setDefaultValues($this);
433 }
434 }
435
436 //custom data of type participant event
437 CRM_Custom_Form_CustomData::preProcess($this, $this->_eventNameCustomDataTypeID, $eventId, 1, 'Participant', $this->_id);
438 CRM_Custom_Form_CustomData::buildQuickForm($this);
439 CRM_Custom_Form_CustomData::setDefaultValues($this);
440
441 // custom data of type participant event type
442 $eventTypeId = NULL;
443 if ($eventId) {
444 $eventTypeId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event', $eventId, 'event_type_id', 'id');
445 }
446 CRM_Custom_Form_CustomData::preProcess($this, $this->_eventTypeCustomDataTypeID, $eventTypeId,
447 1, 'Participant', $this->_id
448 );
449 CRM_Custom_Form_CustomData::buildQuickForm($this);
450 CRM_Custom_Form_CustomData::setDefaultValues($this);
451
452 //custom data of type participant, ( we 'null' to reset subType and subName)
453 CRM_Custom_Form_CustomData::preProcess($this, 'null', 'null', 1, 'Participant', $this->_id);
454 CRM_Custom_Form_CustomData::buildQuickForm($this);
455 CRM_Custom_Form_CustomData::setDefaultValues($this);
456 }
457
458 // CRM-4395, get the online pending contribution id.
459 $this->_onlinePendingContributionId = NULL;
460 if (!$this->_mode && $this->_id && ($this->_action & CRM_Core_Action::UPDATE)) {
461 $this->_onlinePendingContributionId = CRM_Contribute_BAO_Contribution::checkOnlinePendingContribution($this->_id,
462 'Event'
463 );
464 }
465 $this->set('onlinePendingContributionId', $this->_onlinePendingContributionId);
466 }
467
468 /**
469 * This function sets the default values for the form in edit/view mode
470 * the default values are retrieved from the database
471 *
472 * @return array
473 * @throws \CRM_Core_Exception
474 */
475 public function setDefaultValues() {
476 if ($this->_showFeeBlock) {
477 return CRM_Event_Form_EventFees::setDefaultValues($this);
478 }
479
480 $defaults = [];
481
482 if ($this->_action & CRM_Core_Action::DELETE) {
483 return $defaults;
484 }
485
486 if ($this->_id) {
487 $ids = [];
488 $params = ['id' => $this->_id];
489
490 CRM_Event_BAO_Participant::getValues($params, $defaults, $ids);
491 $sep = CRM_Core_DAO::VALUE_SEPARATOR;
492 if ($defaults[$this->_id]['role_id']) {
493 $roleIDs = explode($sep, $defaults[$this->_id]['role_id']);
494 }
495 $this->_contactId = $defaults[$this->_id]['contact_id'];
496 $this->_statusId = $defaults[$this->_id]['participant_status_id'];
497
498 //set defaults for note
499 $noteDetails = CRM_Core_BAO_Note::getNote($this->_id, 'civicrm_participant');
500 $defaults[$this->_id]['note'] = array_pop($noteDetails);
501
502 // Check if this is a primaryParticipant (registered for others) and retrieve additional participants if true (CRM-4859)
503 if (CRM_Event_BAO_Participant::isPrimaryParticipant($this->_id)) {
504 $this->assign('additionalParticipants', CRM_Event_BAO_Participant::getAdditionalParticipants($this->_id));
505 }
506
507 // Get registered_by contact ID and display_name if participant was registered by someone else (CRM-4859)
508 if (!empty($defaults[$this->_id]['participant_registered_by_id'])) {
509 $registered_by_contact_id = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Participant',
510 $defaults[$this->_id]['participant_registered_by_id'],
511 'contact_id', 'id'
512 );
513 $this->assign('participant_registered_by_id', $defaults[$this->_id]['participant_registered_by_id']);
514 $this->assign('registered_by_contact_id', $registered_by_contact_id);
515 $this->assign('registered_by_display_name', CRM_Contact_BAO_Contact::displayName($registered_by_contact_id));
516 }
517 }
518 elseif ($this->_contactID) {
519 $defaults[$this->_id]['contact_id'] = $this->_contactID;
520 }
521
522 //setting default register date
523 if ($this->_action == CRM_Core_Action::ADD) {
524 $statuses = array_flip(CRM_Event_PseudoConstant::participantStatus());
525 $defaults[$this->_id]['status_id'] = $statuses['Registered'] ?? NULL;
526 if (!empty($defaults[$this->_id]['event_id'])) {
527 $contributionTypeId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event',
528 $defaults[$this->_id]['event_id'],
529 'financial_type_id'
530 );
531 if ($contributionTypeId) {
532 $defaults[$this->_id]['financial_type_id'] = $contributionTypeId;
533 }
534 }
535
536 if ($this->_mode) {
537 $fields["email-{$this->_bltID}"] = 1;
538 $fields['email-Primary'] = 1;
539
540 if ($this->_contactId) {
541 CRM_Core_BAO_UFGroup::setProfileDefaults($this->_contactId, $fields, $defaults);
542 }
543
544 if (empty($defaults["email-{$this->_bltID}"]) &&
545 !empty($defaults['email-Primary'])
546 ) {
547 $defaults[$this->_id]["email-{$this->_bltID}"] = $defaults['email-Primary'];
548 }
549 }
550
551 $submittedRole = $this->getElementValue('role_id');
552 if (!empty($submittedRole[0])) {
553 $roleID = $submittedRole[0];
554 }
555 $submittedEvent = $this->getElementValue('event_id');
556 if (!empty($submittedEvent[0])) {
557 $eventID = $submittedEvent[0];
558 }
559 $defaults[$this->_id]['register_date'] = date('Y-m-d H:i:s');
560 }
561 else {
562 $defaults[$this->_id]['record_contribution'] = 0;
563
564 if ($defaults[$this->_id]['participant_is_pay_later']) {
565 $this->assign('participant_is_pay_later', TRUE);
566 }
567
568 $this->assign('participant_status_id', $defaults[$this->_id]['participant_status_id']);
569 $eventID = $defaults[$this->_id]['event_id'];
570
571 $this->_eventTypeId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event', $eventID, 'event_type_id', 'id');
572
573 $this->_discountId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Participant', $this->_id, 'discount_id');
574 if ($this->_discountId) {
575 $this->set('discountId', $this->_discountId);
576 }
577 }
578
579 //assign event and role id, this is needed for Custom data building
580 $sep = CRM_Core_DAO::VALUE_SEPARATOR;
581 if (!empty($defaults[$this->_id]['participant_role_id'])) {
582 $roleIDs = explode($sep, $defaults[$this->_id]['participant_role_id']);
583 }
584 if (isset($_POST['event_id'])) {
585 $eventID = $_POST['event_id'];
586 }
587
588 if ($this->_eID) {
589 $eventID = $this->_eID;
590 //@todo - rationalise the $this->_eID with $POST['event_id'], $this->_eid is set when eid=x is in the url
591 $roleID = CRM_Core_DAO::getFieldValue(
592 'CRM_Event_DAO_Event',
593 $this->_eID,
594 'default_role_id'
595 );
596 if (empty($roleIDs)) {
597 $roleIDs = (array) $defaults[$this->_id]['participant_role_id'] = $roleID;
598 }
599 $defaults[$this->_id]['event_id'] = $eventID;
600 }
601 if (!empty($eventID)) {
602 $this->_eventTypeId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event', $eventID, 'event_type_id', 'id');
603 }
604 //these should take precedence so we state them last
605 $urlRoleIDS = CRM_Utils_Request::retrieve('roles', 'String');
606 if ($urlRoleIDS) {
607 $roleIDs = explode(',', $urlRoleIDS);
608 }
609 if (isset($roleIDs)) {
610 $defaults[$this->_id]['role_id'] = implode(',', $roleIDs);
611 }
612
613 if (isset($eventID)) {
614 $this->assign('eventID', $eventID);
615 $this->set('eventId', $eventID);
616 }
617
618 if (isset($this->_eventTypeId)) {
619 $this->assign('eventTypeID', $this->_eventTypeId);
620 }
621
622 $this->assign('event_is_test', CRM_Utils_Array::value('event_is_test', $defaults[$this->_id]));
623 return $defaults[$this->_id];
624 }
625
626 /**
627 * Build the form object.
628 *
629 * @return void
630 * @throws \CRM_Core_Exception
631 * @throws \CiviCRM_API3_Exception
632 */
633 public function buildQuickForm() {
634
635 $participantStatuses = CRM_Event_PseudoConstant::participantStatus();
636 $partiallyPaidStatusId = array_search('Partially paid', $participantStatuses);
637 $this->assign('partiallyPaidStatusId', $partiallyPaidStatusId);
638
639 if ($this->_showFeeBlock) {
640 return $this->buildEventFeeForm($this);
641 }
642
643 //need to assign custom data type to the template
644 $this->assign('customDataType', 'Participant');
645
646 $this->applyFilter('__ALL__', 'trim');
647
648 if ($this->_action & CRM_Core_Action::DELETE) {
649 if ($this->_single) {
650 $additionalParticipant = count(CRM_Event_BAO_Event::buildCustomProfile($this->_id,
651 NULL,
652 $this->_contactId,
653 FALSE,
654 TRUE
655 )) - 1;
656 if ($additionalParticipant) {
657 $deleteParticipants = [
658 1 => ts('Delete this participant record along with associated participant record(s).'),
659 2 => ts('Delete only this participant record.'),
660 ];
661 $this->addRadio('delete_participant', NULL, $deleteParticipants, NULL, '<br />');
662 $this->setDefaults(['delete_participant' => 1]);
663 $this->assign('additionalParticipant', $additionalParticipant);
664 }
665 }
666 $this->addButtons([
667 [
668 'type' => 'next',
669 'name' => ts('Delete'),
670 'spacing' => '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;',
671 'isDefault' => TRUE,
672 ],
673 [
674 'type' => 'cancel',
675 'name' => ts('Cancel'),
676 ],
677 ]);
678 return;
679 }
680
681 if ($this->_single) {
682 $contactField = $this->addEntityRef('contact_id', ts('Participant'), ['create' => TRUE, 'api' => ['extra' => ['email']]], TRUE);
683 if ($this->_context != 'standalone') {
684 $contactField->freeze();
685 }
686 }
687
688 $eventFieldParams = [
689 'entity' => 'Event',
690 'select' => ['minimumInputLength' => 0],
691 'api' => [
692 'extra' => ['campaign_id', 'default_role_id', 'event_type_id'],
693 ],
694 ];
695
696 if ($this->_mode) {
697 // exclude events which are not monetary when credit card registration is used
698 $eventFieldParams['api']['params']['is_monetary'] = 1;
699 }
700 $this->addPaymentProcessorSelect(TRUE, FALSE, FALSE);
701
702 $element = $this->addEntityRef('event_id', ts('Event'), $eventFieldParams, TRUE);
703
704 //frozen the field fix for CRM-4171
705 if ($this->_action & CRM_Core_Action::UPDATE && $this->_id) {
706 if (CRM_Core_DAO::getFieldValue('CRM_Event_DAO_ParticipantPayment',
707 $this->_id, 'contribution_id', 'participant_id'
708 )
709 ) {
710 $element->freeze();
711 }
712 }
713
714 //CRM-7362 --add campaigns.
715 $campaignId = NULL;
716 if ($this->_id) {
717 $campaignId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Participant', $this->_id, 'campaign_id');
718 }
719 if (!$campaignId) {
720 $eventId = CRM_Utils_Request::retrieve('eid', 'Positive', $this);
721 if ($eventId) {
722 $campaignId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event', $eventId, 'campaign_id');
723 }
724 }
725 CRM_Campaign_BAO_Campaign::addCampaign($this, $campaignId);
726 $this->add('datepicker', 'register_date', ts('Registration Date'), [], TRUE, ['time' => TRUE]);
727
728 if ($this->_id) {
729 $this->assign('entityID', $this->_id);
730 }
731
732 $this->addSelect('role_id', ['multiple' => TRUE, 'class' => 'huge'], TRUE);
733
734 // CRM-4395
735 $checkCancelledJs = ['onchange' => "return sendNotification( );"];
736 $confirmJS = NULL;
737 if ($this->_onlinePendingContributionId) {
738 $cancelledparticipantStatusId = array_search('Cancelled', CRM_Event_PseudoConstant::participantStatus());
739 $cancelledContributionStatusId = array_search('Cancelled',
740 CRM_Contribute_PseudoConstant::contributionStatus(NULL, 'name')
741 );
742 $checkCancelledJs = [
743 'onchange' => "checkCancelled( this.value, {$cancelledparticipantStatusId},{$cancelledContributionStatusId});",
744 ];
745
746 $participantStatusId = array_search('Pending from pay later',
747 CRM_Event_PseudoConstant::participantStatus()
748 );
749 $contributionStatusId = array_search('Completed',
750 CRM_Contribute_PseudoConstant::contributionStatus(NULL, 'name')
751 );
752 $confirmJS = ['onclick' => "return confirmStatus( {$participantStatusId}, {$contributionStatusId} );"];
753 }
754
755 // get the participant status names to build special status array which is used to show notification
756 // checkbox below participant status select
757 $participantStatusName = CRM_Event_PseudoConstant::participantStatus();
758 $notificationStatuses = [
759 'Cancelled',
760 'Pending from waitlist',
761 'Pending from approval',
762 'Expired',
763 ];
764
765 // get the required status and then implode only ids
766 $notificationStatusIds = implode(',', array_keys(array_intersect($participantStatusName, $notificationStatuses)));
767 $this->assign('notificationStatusIds', $notificationStatusIds);
768
769 $this->_participantStatuses = $statusOptions = CRM_Event_BAO_Participant::buildOptions('status_id', 'create');
770
771 // Only show refund status when editing
772 if ($this->_action & CRM_Core_Action::ADD) {
773 $pendingRefundStatusId = array_search('Pending refund', $participantStatusName);
774 if ($pendingRefundStatusId) {
775 unset($statusOptions[$pendingRefundStatusId]);
776 }
777 }
778
779 $this->addSelect('status_id', $checkCancelledJs + [
780 'options' => $statusOptions,
781 'option_url' => 'civicrm/admin/participant_status',
782 ], TRUE);
783
784 $this->addElement('checkbox', 'is_notify', ts('Send Notification'), NULL);
785
786 $this->addField('source', ['entity' => 'Participant', 'name' => 'source']);
787 $noteAttributes = CRM_Core_DAO::getAttribute('CRM_Core_DAO_Note');
788 $this->add('textarea', 'note', ts('Notes'), $noteAttributes['note']);
789
790 $buttons[] = [
791 'type' => 'upload',
792 'name' => ts('Save'),
793 'isDefault' => TRUE,
794 'js' => $confirmJS,
795 ];
796
797 $path = CRM_Utils_System::currentPath();
798 $excludeForPaths = [
799 'civicrm/contact/search',
800 'civicrm/group/search',
801 ];
802 if (!in_array($path, $excludeForPaths)) {
803 $buttons[] = [
804 'type' => 'upload',
805 'name' => ts('Save and New'),
806 'subName' => 'new',
807 'js' => $confirmJS,
808 ];
809 }
810
811 $buttons[] = [
812 'type' => 'cancel',
813 'name' => ts('Cancel'),
814 ];
815
816 $this->addButtons($buttons);
817 if ($this->_action == CRM_Core_Action::VIEW) {
818 $this->freeze();
819 }
820 }
821
822 /**
823 * Add local and global form rules.
824 *
825 * @return void
826 */
827 public function addRules() {
828 $this->addFormRule(['CRM_Event_Form_Participant', 'formRule'], $this);
829 }
830
831 /**
832 * Global validation rules for the form.
833 *
834 * @param array $values
835 * Posted values of the form.
836 * @param $files
837 * @param $self
838 *
839 * @return array
840 * list of errors to be posted back to the form
841 */
842 public static function formRule($values, $files, $self) {
843 // If $values['_qf_Participant_next'] is Delete or
844 // $values['event_id'] is empty, then return
845 // instead of proceeding further.
846
847 if ((CRM_Utils_Array::value('_qf_Participant_next', $values) == 'Delete') ||
848 (!$values['event_id'])
849 ) {
850 return TRUE;
851 }
852
853 $errorMsg = [];
854
855 if (!empty($values['payment_processor_id'])) {
856 // make sure that payment instrument values (e.g. credit card number and cvv) are valid
857 CRM_Core_Payment_Form::validatePaymentInstrument($values['payment_processor_id'], $values, $errorMsg, NULL);
858 }
859
860 if (!empty($values['record_contribution'])) {
861 if (empty($values['financial_type_id'])) {
862 $errorMsg['financial_type_id'] = ts('Please enter the associated Financial Type');
863 }
864 if (empty($values['payment_instrument_id'])) {
865 $errorMsg['payment_instrument_id'] = ts('Payment Method is a required field.');
866 }
867 if (!empty($values['priceSetId'])) {
868 CRM_Price_BAO_PriceField::priceSetValidation($values['priceSetId'], $values, $errorMsg);
869 }
870 }
871
872 // validate contribution status for 'Failed'.
873 if ($self->_onlinePendingContributionId && !empty($values['record_contribution']) &&
874 (CRM_Utils_Array::value('contribution_status_id', $values) ==
875 array_search('Failed', CRM_Contribute_PseudoConstant::contributionStatus(NULL, 'name'))
876 )
877 ) {
878 $errorMsg['contribution_status_id'] = ts('Please select a valid payment status before updating.');
879 }
880
881 // do the amount validations.
882 //skip for update mode since amount is freeze, CRM-6052
883 if ((!$self->_id && empty($values['total_amount']) &&
884 empty($self->_values['line_items'])
885 ) ||
886 ($self->_id && !$self->_paymentId && isset($self->_values['line_items']) && is_array($self->_values['line_items']))
887 ) {
888 if ($priceSetId = CRM_Utils_Array::value('priceSetId', $values)) {
889 CRM_Price_BAO_PriceField::priceSetValidation($priceSetId, $values, $errorMsg, TRUE);
890 }
891 }
892 // For single additions - show validation error if the contact has already been registered
893 // for this event.
894 if ($self->_single && ($self->_action & CRM_Core_Action::ADD)) {
895 if ($self->_context == 'standalone') {
896 $contactId = $values['contact_id'] ?? NULL;
897 }
898 else {
899 $contactId = $self->_contactId;
900 }
901
902 $eventId = $values['event_id'] ?? NULL;
903
904 $event = new CRM_Event_DAO_Event();
905 $event->id = $eventId;
906 $event->find(TRUE);
907
908 if (!$event->allow_same_participant_emails && !empty($contactId) && !empty($eventId)) {
909 $cancelledStatusID = CRM_Core_PseudoConstant::getKey('CRM_Event_BAO_Participant', 'status_id', 'Cancelled');
910 $dupeCheck = new CRM_Event_BAO_Participant();
911 $dupeCheck->contact_id = $contactId;
912 $dupeCheck->event_id = $eventId;
913 $dupeCheck->whereAdd("status_id != {$cancelledStatusID} ");
914 $dupeCheck->find(TRUE);
915 if (!empty($dupeCheck->id)) {
916 $errorMsg['event_id'] = ts("This contact has already been assigned to this event.");
917 }
918 }
919 }
920 return CRM_Utils_Array::crmIsEmptyArray($errorMsg) ? TRUE : $errorMsg;
921 }
922
923 /**
924 * Process the form submission.
925 */
926 public function postProcess() {
927 // get the submitted form values.
928 $params = $this->controller->exportValues($this->_name);
929
930 if ($this->_action & CRM_Core_Action::DELETE) {
931 if (CRM_Utils_Array::value('delete_participant', $params) == 2) {
932 $additionalId = (CRM_Event_BAO_Participant::getAdditionalParticipantIds($this->_id));
933 $participantLinks = (CRM_Event_BAO_Participant::getAdditionalParticipantUrl($additionalId));
934 }
935 if (CRM_Utils_Array::value('delete_participant', $params) == 1) {
936 $additionalIds = CRM_Event_BAO_Participant::getAdditionalParticipantIds($this->_id);
937 foreach ($additionalIds as $value) {
938 CRM_Event_BAO_Participant::deleteParticipant($value);
939 }
940 }
941 CRM_Event_BAO_Participant::deleteParticipant($this->_id);
942 CRM_Core_Session::setStatus(ts('Selected participant was deleted successfully.'), ts('Record Deleted'), 'success');
943 if (!empty($participantLinks)) {
944 $status = ts('The following participants no longer have an event fee recorded. You can edit their registration and record a replacement contribution by clicking the links below:') . '<br/>' . $participantLinks;
945 CRM_Core_Session::setStatus($status, ts('Group Payment Deleted'));
946 }
947 return;
948 }
949 // When adding a single contact, the formRule prevents you from adding duplicates
950 // (See above in formRule()). When adding more than one contact, the duplicates are
951 // removed automatically and the user receives one notification.
952 if ($this->_action & CRM_Core_Action::ADD) {
953 $event_id = $this->_eventId;
954 if (empty($event_id) && !empty($params['event_id'])) {
955 $event_id = $params['event_id'];
956 }
957 if (!$this->_single && !empty($event_id)) {
958 $duplicateContacts = 0;
959 foreach ($this->_contactIds as $k => $dupeCheckContactId) {
960 // Eliminate contacts that have already been assigned to this event.
961 $dupeCheck = new CRM_Event_BAO_Participant();
962 $dupeCheck->contact_id = $dupeCheckContactId;
963 $dupeCheck->event_id = $event_id;
964 $dupeCheck->find(TRUE);
965 if (!empty($dupeCheck->id)) {
966 $duplicateContacts++;
967 unset($this->_contactIds[$k]);
968 }
969 }
970 if ($duplicateContacts > 0) {
971 $msg = ts(
972 "%1 contacts have already been assigned to this event. They were not added a second time.",
973 [1 => $duplicateContacts]
974 );
975 CRM_Core_Session::setStatus($msg);
976 }
977 if (count($this->_contactIds) == 0) {
978 CRM_Core_Session::setStatus(ts("No participants were added."));
979 return;
980 }
981 // We have to re-key $this->_contactIds so each contact has the same
982 // key as their corresponding record in the $participants array that
983 // will be created below.
984 $this->_contactIds = array_values($this->_contactIds);
985 }
986 }
987
988 $statusMsg = $this->submit($params);
989 CRM_Core_Session::setStatus($statusMsg, ts('Saved'), 'success');
990 $session = CRM_Core_Session::singleton();
991 $buttonName = $this->controller->getButtonName();
992 if ($this->_context == 'standalone') {
993 if ($buttonName == $this->getButtonName('upload', 'new')) {
994 $urlParams = 'reset=1&action=add&context=standalone';
995 if ($this->_mode) {
996 $urlParams .= '&mode=' . $this->_mode;
997 }
998 if ($this->_eID) {
999 $urlParams .= '&eid=' . $this->_eID;
1000 }
1001 $session->replaceUserContext(CRM_Utils_System::url('civicrm/participant/add', $urlParams));
1002 }
1003 else {
1004 $session->replaceUserContext(CRM_Utils_System::url('civicrm/contact/view',
1005 "reset=1&cid={$this->_contactId}&selectedChild=participant"
1006 ));
1007 }
1008 }
1009 elseif ($buttonName == $this->getButtonName('upload', 'new')) {
1010 $session->replaceUserContext(CRM_Utils_System::url('civicrm/contact/view/participant',
1011 "reset=1&action=add&context={$this->_context}&cid={$this->_contactId}"
1012 ));
1013 }
1014 }
1015
1016 /**
1017 * Submit form.
1018 *
1019 * @param array $params
1020 *
1021 * @return string
1022 * @throws \CRM_Core_Exception
1023 * @throws \CiviCRM_API3_Exception
1024 */
1025 public function submit($params) {
1026 if ($this->_mode && !$this->_isPaidEvent) {
1027 CRM_Core_Error::statusBounce(ts('Selected Event is not Paid Event '));
1028 }
1029 $participantStatus = CRM_Event_PseudoConstant::participantStatus();
1030 // set the contact, when contact is selected
1031 if (!empty($params['contact_id'])) {
1032 $this->_contactID = $this->_contactId = $params['contact_id'];
1033 }
1034 if (!$this->_priceSetId && $this->_isPaidEvent) {
1035 CRM_Core_Error::deprecatedFunctionWarning('this should never be true, handling to be removed');
1036 }
1037 if ($this->_priceSetId && $isQuickConfig = CRM_Core_DAO::getFieldValue('CRM_Price_DAO_PriceSet', $this->_priceSetId, 'is_quick_config')) {
1038 $this->_quickConfig = $isQuickConfig;
1039 }
1040
1041 if ($this->_id) {
1042 $params['id'] = $this->_id;
1043 }
1044
1045 $config = CRM_Core_Config::singleton();
1046 if (isset($params['total_amount'])) {
1047 $params['total_amount'] = CRM_Utils_Rule::cleanMoney($params['total_amount']);
1048 }
1049 if ($this->_isPaidEvent) {
1050 list($contributionParams, $lineItem, $additionalParticipantDetails, $params) = $this->preparePaidEventProcessing($params);
1051 }
1052
1053 $this->_params = $params;
1054 parent::beginPostProcess();
1055 $amountOwed = NULL;
1056 if (isset($params['amount'])) {
1057 $amountOwed = $params['amount'];
1058 unset($params['amount']);
1059 }
1060 $params['contact_id'] = $this->_contactId;
1061
1062 // overwrite actual payment amount if entered
1063 if (!empty($params['total_amount'])) {
1064 $contributionParams['total_amount'] = $params['total_amount'] ?? NULL;
1065 }
1066
1067 // Retrieve the name and email of the current user - this will be the FROM for the receipt email
1068 $userName = CRM_Core_Session::singleton()->getLoggedInContactDisplayName();
1069
1070 if ($this->_contactId) {
1071 list($this->_contributorDisplayName, $this->_contributorEmail, $this->_toDoNotEmail) = CRM_Contact_BAO_Contact::getContactDetails($this->_contactId);
1072 }
1073
1074 //modify params according to parameter used in create
1075 //participant method (addParticipant)
1076 $this->_params['participant_status_id'] = $params['status_id'];
1077 $this->_params['participant_role_id'] = is_array($params['role_id']) ? $params['role_id'] : explode(',', $params['role_id']);
1078 $roleIdWithSeparator = implode(CRM_Core_DAO::VALUE_SEPARATOR, $this->_params['participant_role_id']);
1079
1080 $now = date('YmdHis');
1081
1082 if ($this->_mode) {
1083 // set source if not set
1084 if (empty($params['source'])) {
1085 $this->_params['participant_source'] = ts('Offline Registration for Event: %2 by: %1', [
1086 1 => $userName,
1087 2 => $this->getEventValue('title'),
1088 ]);
1089 }
1090 else {
1091 $this->_params['participant_source'] = $params['source'];
1092 }
1093 $this->_params['description'] = $this->_params['participant_source'];
1094
1095 $this->_paymentProcessor = CRM_Financial_BAO_PaymentProcessor::getPayment($this->_params['payment_processor_id'],
1096 $this->_mode
1097 );
1098 $fields = [];
1099
1100 // set email for primary location.
1101 $fields['email-Primary'] = 1;
1102 $params['email-Primary'] = $params["email-{$this->_bltID}"] = $this->_contributorEmail;
1103
1104 // now set the values for the billing location.
1105 foreach ($this->_fields as $name => $dontCare) {
1106 $fields[$name] = 1;
1107 }
1108
1109 // also add location name to the array
1110 $params["address_name-{$this->_bltID}"]
1111 = CRM_Utils_Array::value('billing_first_name', $params) . ' ' .
1112 CRM_Utils_Array::value('billing_middle_name', $params) . ' ' .
1113 CRM_Utils_Array::value('billing_last_name', $params);
1114
1115 $params["address_name-{$this->_bltID}"] = trim($params["address_name-{$this->_bltID}"]);
1116 $fields["address_name-{$this->_bltID}"] = 1;
1117 $fields["email-{$this->_bltID}"] = 1;
1118 $ctype = CRM_Core_DAO::getFieldValue('CRM_Contact_DAO_Contact', $this->_contactId, 'contact_type');
1119
1120 $nameFields = ['first_name', 'middle_name', 'last_name'];
1121
1122 foreach ($nameFields as $name) {
1123 $fields[$name] = 1;
1124 if (array_key_exists("billing_$name", $params)) {
1125 $params[$name] = $params["billing_{$name}"];
1126 $params['preserveDBName'] = TRUE;
1127 }
1128 }
1129 $contactID = CRM_Contact_BAO_Contact::createProfileContact($params, $fields, $this->_contactId, NULL, NULL, $ctype);
1130 }
1131
1132 if (!empty($this->_params['participant_role_id'])) {
1133 $customFieldsRole = [];
1134 foreach ($this->_params['participant_role_id'] as $roleKey) {
1135 $customFieldsRole = CRM_Utils_Array::crmArrayMerge(CRM_Core_BAO_CustomField::getFields('Participant',
1136 FALSE, FALSE, $roleKey, $this->_roleCustomDataTypeID), $customFieldsRole);
1137 }
1138 $customFieldsEvent = CRM_Core_BAO_CustomField::getFields('Participant',
1139 FALSE,
1140 FALSE,
1141 CRM_Utils_Array::value('event_id', $params),
1142 $this->_eventNameCustomDataTypeID
1143 );
1144 $customFieldsEventType = CRM_Core_BAO_CustomField::getFields('Participant',
1145 FALSE,
1146 FALSE,
1147 $this->_eventTypeId,
1148 $this->_eventTypeCustomDataTypeID
1149 );
1150 $customFields = CRM_Utils_Array::crmArrayMerge($customFieldsRole,
1151 CRM_Core_BAO_CustomField::getFields('Participant', FALSE, FALSE, NULL, NULL, TRUE)
1152 );
1153 $customFields = CRM_Utils_Array::crmArrayMerge($customFieldsEvent, $customFields);
1154 $customFields = CRM_Utils_Array::crmArrayMerge($customFieldsEventType, $customFields);
1155
1156 $params['custom'] = CRM_Core_BAO_CustomField::postProcess($params, $this->_id, $this->getDefaultEntity());
1157 }
1158
1159 //do cleanup line items if participant edit the Event Fee.
1160 if (($this->_lineItem || !isset($params['proceSetId'])) && !$this->_paymentId && $this->_id) {
1161 CRM_Price_BAO_LineItem::deleteLineItems($this->_id, 'civicrm_participant');
1162 }
1163
1164 if ($this->_mode) {
1165 // add all the additional payment params we need
1166 $this->_params = $this->prepareParamsForPaymentProcessor($this->_params);
1167 $this->_params['amount'] = $params['fee_amount'];
1168 $this->_params['amount_level'] = $params['amount_level'];
1169 $this->_params['currencyID'] = $config->defaultCurrency;
1170 $this->_params['invoiceID'] = md5(uniqid(rand(), TRUE));
1171
1172 // at this point we've created a contact and stored its address etc
1173 // all the payment processors expect the name and address to be in the
1174 // so we copy stuff over to first_name etc.
1175 $paymentParams = $this->_params;
1176 if (!empty($this->_params['send_receipt'])) {
1177 $paymentParams['email'] = $this->_contributorEmail;
1178 }
1179
1180 // The only reason for merging in the 'contact_id' rather than ensuring it is set
1181 // is that this patch is being done around the time of the stable release
1182 // so more conservative approach is called for.
1183 // In fact the use of $params and $this->_params & $this->_contactId vs $contactID
1184 // needs rationalising.
1185 $mapParams = array_merge(['contact_id' => $contactID], $this->_params);
1186 CRM_Core_Payment_Form::mapParams($this->_bltID, $mapParams, $paymentParams, TRUE);
1187
1188 $payment = $this->_paymentProcessor['object'];
1189
1190 // CRM-15622: fix for incorrect contribution.fee_amount
1191 $paymentParams['fee_amount'] = NULL;
1192 try {
1193 $result = $payment->doPayment($paymentParams);
1194 }
1195 catch (\Civi\Payment\Exception\PaymentProcessorException $e) {
1196 // @todo un comment the following line out when we are creating a contribution before we get to this point
1197 // see dev/financial#53 about ensuring we create a pending contribution before we try processing payment
1198 // CRM_Contribute_BAO_Contribution::failPayment($contributionID);
1199 CRM_Core_Session::singleton()->setStatus($e->getMessage());
1200 CRM_Utils_System::redirect(CRM_Utils_System::url('civicrm/contact/view/participant',
1201 "reset=1&action=add&cid={$this->_contactId}&context=participant&mode={$this->_mode}"
1202 ));
1203 }
1204
1205 if ($result) {
1206 $this->_params = array_merge($this->_params, $result);
1207 }
1208
1209 $this->_params['receive_date'] = $now;
1210
1211 if (!empty($this->_params['send_receipt'])) {
1212 $this->_params['receipt_date'] = $now;
1213 }
1214 else {
1215 $this->_params['receipt_date'] = NULL;
1216 }
1217
1218 $this->set('params', $this->_params);
1219 $this->assign('trxn_id', $result['trxn_id']);
1220 $this->assign('receive_date', $this->_params['receive_date']);
1221
1222 //add contribution record
1223 $this->_params['financial_type_id']
1224 = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event', $params['event_id'], 'financial_type_id');
1225 $this->_params['mode'] = $this->_mode;
1226
1227 //add contribution record
1228 $contributions[] = $contribution = $this->processContribution(
1229 $this, $this->_params,
1230 $result, $contactID,
1231 FALSE,
1232 $this->_paymentProcessor
1233 );
1234
1235 // add participant record
1236 $participants = [];
1237 if (!empty($this->_params['role_id']) && is_array($this->_params['role_id'])) {
1238 $this->_params['role_id'] = implode(CRM_Core_DAO::VALUE_SEPARATOR,
1239 $this->_params['role_id']
1240 );
1241 }
1242
1243 //CRM-15372 patch to fix fee amount replacing amount
1244 $this->_params['fee_amount'] = $this->_params['amount'];
1245
1246 $participants[] = $this->addParticipant($this, $this->_params, $contactID);
1247
1248 //add custom data for participant
1249 CRM_Core_BAO_CustomValueTable::postProcess($this->_params,
1250 'civicrm_participant',
1251 $participants[0]->id,
1252 'Participant'
1253 );
1254
1255 // Add participant payment
1256 $participantPaymentParams = [
1257 'participant_id' => $participants[0]->id,
1258 'contribution_id' => $contribution->id,
1259 ];
1260 civicrm_api3('ParticipantPayment', 'create', $participantPaymentParams);
1261
1262 $this->_contactIds[] = $this->_contactId;
1263 }
1264 else {
1265 if ($this->_single) {
1266 $this->_contactIds[] = $this->_contactId;
1267 }
1268 $participants = [];
1269 foreach ($this->_contactIds as $contactID) {
1270 $commonParams = $params;
1271 $commonParams['contact_id'] = $contactID;
1272 $participants[] = CRM_Event_BAO_Participant::create($commonParams);
1273 }
1274
1275 $contributions = [];
1276 if (!empty($params['record_contribution'])) {
1277 if (!empty($params['id'])) {
1278 if ($this->_onlinePendingContributionId) {
1279 $contributionParams['id'] = $this->_onlinePendingContributionId;
1280 }
1281 else {
1282 $contributionParams['id'] = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_ParticipantPayment',
1283 $params['id'],
1284 'contribution_id',
1285 'participant_id'
1286 );
1287 }
1288 }
1289 unset($params['note']);
1290
1291 //build contribution params
1292 if (!$this->_onlinePendingContributionId) {
1293 if (empty($params['source'])) {
1294 $contributionParams['source'] = ts('%1 : Offline registration (by %2)', [
1295 1 => $this->getEventValue('title'),
1296 2 => $userName,
1297 ]);
1298 }
1299 else {
1300 $contributionParams['source'] = $params['source'];
1301 }
1302 }
1303
1304 $contributionParams['currency'] = $config->defaultCurrency;
1305 $contributionParams['non_deductible_amount'] = 'null';
1306 $contributionParams['receipt_date'] = !empty($params['send_receipt']) ? CRM_Utils_Array::value('receive_date', $params) : 'null';
1307 $contributionParams['contact_id'] = $this->_contactID;
1308 $contributionParams['receive_date'] = CRM_Utils_Array::value('receive_date', $params, 'null');
1309
1310 $recordContribution = [
1311 'financial_type_id',
1312 'payment_instrument_id',
1313 'trxn_id',
1314 'contribution_status_id',
1315 'check_number',
1316 'campaign_id',
1317 'pan_truncation',
1318 'card_type_id',
1319 ];
1320
1321 foreach ($recordContribution as $f) {
1322 $contributionParams[$f] = $this->_params[$f] ?? NULL;
1323 if ($f == 'trxn_id') {
1324 $this->assign('trxn_id', $contributionParams[$f]);
1325 }
1326 }
1327
1328 //insert financial type name in receipt.
1329 $this->assign('financialTypeName', CRM_Core_DAO::getFieldValue('CRM_Financial_DAO_FinancialType',
1330 $contributionParams['financial_type_id']));
1331 // legacy support
1332 $this->assign('contributionTypeName', CRM_Core_DAO::getFieldValue('CRM_Financial_DAO_FinancialType', $contributionParams['financial_type_id']));
1333 $contributionParams['skipLineItem'] = 1;
1334 if ($this->_id) {
1335 $contributionParams['contribution_mode'] = 'participant';
1336 $contributionParams['participant_id'] = $this->_id;
1337 }
1338 // Set is_pay_later flag for back-office offline Pending status contributions
1339 if ($contributionParams['contribution_status_id'] == CRM_Core_PseudoConstant::getKey('CRM_Contribute_DAO_Contribution', 'contribution_status_id', 'Pending')) {
1340 $contributionParams['is_pay_later'] = 1;
1341 }
1342 elseif ($contributionParams['contribution_status_id'] == CRM_Core_PseudoConstant::getKey('CRM_Contribute_DAO_Contribution', 'contribution_status_id', 'Completed')) {
1343 $contributionParams['is_pay_later'] = 0;
1344 }
1345
1346 if ($params['status_id'] == array_search('Partially paid', $participantStatus)) {
1347 if (!$amountOwed && $this->_action & CRM_Core_Action::UPDATE) {
1348 $amountOwed = $params['fee_amount'];
1349 }
1350
1351 // if multiple participants are link, consider contribution total amount as the amount Owed
1352 if ($this->_id && CRM_Event_BAO_Participant::isPrimaryParticipant($this->_id)) {
1353 $amountOwed = CRM_Core_DAO::getFieldValue('CRM_Contribute_DAO_Contribution',
1354 $contributionParams['id'],
1355 'total_amount'
1356 );
1357 }
1358
1359 // CRM-13964 partial_payment_total
1360 if ($amountOwed > $params['total_amount']) {
1361 // the owed amount
1362 $contributionParams['total_amount'] = $amountOwed;
1363 $contributionParams['contribution_status_id'] = CRM_Core_PseudoConstant::getKey('CRM_Contribute_BAO_Contribution', 'contribution_status_id', 'Pending');
1364 $this->assign('balanceAmount', $amountOwed - $params['total_amount']);
1365 $this->storePaymentCreateParams($params);
1366 }
1367 }
1368
1369 if (!empty($this->_params['tax_amount'])) {
1370 $contributionParams['tax_amount'] = $this->_params['tax_amount'];
1371 }
1372
1373 if ($this->_single) {
1374 $contributions[] = CRM_Contribute_BAO_Contribution::create($contributionParams);
1375 }
1376 else {
1377 foreach ($this->_contactIds as $contactID) {
1378 $contributionParams['contact_id'] = $contactID;
1379 $contributions[] = CRM_Contribute_BAO_Contribution::create($contributionParams);
1380 }
1381 }
1382
1383 // Insert payment record for this participant
1384 if (empty($contributionParams['id'])) {
1385 foreach ($this->_contactIds as $num => $contactID) {
1386 $participantPaymentParams = [
1387 'participant_id' => $participants[$num]->id,
1388 'contribution_id' => $contributions[$num]->id,
1389 ];
1390 civicrm_api3('ParticipantPayment', 'create', $participantPaymentParams);
1391 }
1392 }
1393
1394 // CRM-11124
1395 if ($this->_params['discount_id']) {
1396 CRM_Event_BAO_Participant::createDiscountTrxn(
1397 $this->_eventId,
1398 $contributionParams,
1399 NULL,
1400 CRM_Price_BAO_PriceSet::parseFirstPriceSetValueIDFromParams($this->_params)
1401 );
1402 }
1403 }
1404 }
1405
1406 // also store lineitem stuff here
1407 if ((($this->_lineItem & $this->_action & CRM_Core_Action::ADD) ||
1408 ($this->_lineItem && CRM_Core_Action::UPDATE && !$this->_paymentId))
1409 ) {
1410 foreach ($this->_contactIds as $num => $contactID) {
1411 foreach ($this->_lineItem as $key => $value) {
1412 if (is_array($value) && $value != 'skip') {
1413 foreach ($value as $lineKey => $line) {
1414 //10117 update the line items for participants if contribution amount is recorded
1415 if ($this->_quickConfig && !empty($params['total_amount']) &&
1416 ($params['status_id'] != array_search('Partially paid', $participantStatus))
1417 ) {
1418 $line['unit_price'] = $line['line_total'] = $params['total_amount'];
1419 if (!empty($params['tax_amount'])) {
1420 $line['unit_price'] = $line['unit_price'] - $params['tax_amount'];
1421 $line['line_total'] = $line['line_total'] - $params['tax_amount'];
1422 }
1423 }
1424 $lineItem[$this->_priceSetId][$lineKey] = $line;
1425 }
1426 CRM_Price_BAO_LineItem::processPriceSet($participants[$num]->id, $lineItem, CRM_Utils_Array::value($num, $contributions, NULL), 'civicrm_participant');
1427 }
1428 }
1429 }
1430 foreach ($contributions as $contribution) {
1431 if (!empty($this->getCreatePaymentParams())) {
1432 civicrm_api3('Payment', 'create', array_merge(['contribution_id' => $contribution->id], $this->getCreatePaymentParams()));
1433 }
1434 }
1435 }
1436
1437 $updateStatusMsg = NULL;
1438 //send mail when participant status changed, CRM-4326
1439 if ($this->_id && $this->_statusId &&
1440 $this->_statusId != CRM_Utils_Array::value('status_id', $params) && !empty($params['is_notify'])
1441 ) {
1442
1443 $updateStatusMsg = CRM_Event_BAO_Participant::updateStatusMessage($this->_id,
1444 $params['status_id'],
1445 $this->_statusId
1446 );
1447 }
1448
1449 $sent = [];
1450 $notSent = [];
1451 if (!empty($params['send_receipt'])) {
1452
1453 $this->assign('module', 'Event Registration');
1454 $this->assignEventDetailsToTpl($params['event_id'], CRM_Utils_Array::value('role_id', $params), CRM_Utils_Array::value('receipt_text', $params), $this->_isPaidEvent);
1455 $this->assign('isAmountzero', 1);
1456
1457 if ($this->_isPaidEvent) {
1458 $paymentInstrument = CRM_Contribute_PseudoConstant::paymentInstrument();
1459 if (!$this->_mode) {
1460 if (isset($params['payment_instrument_id'])) {
1461 $this->assign('paidBy',
1462 CRM_Utils_Array::value($params['payment_instrument_id'],
1463 $paymentInstrument
1464 )
1465 );
1466 }
1467 }
1468
1469 $this->assign('totalAmount', $params['total_amount'] ?? $contributionParams['total_amount']);
1470 $this->assign('isPrimary', 1);
1471 $this->assign('checkNumber', CRM_Utils_Array::value('check_number', $params));
1472 }
1473 if ($this->_mode) {
1474 $this->assignBillingName($params);
1475 $this->assign('address', CRM_Utils_Address::getFormattedBillingAddressFieldsFromParameters(
1476 $this->_params,
1477 $this->_bltID
1478 ));
1479
1480 $date = CRM_Utils_Date::format($params['credit_card_exp_date']);
1481 $date = CRM_Utils_Date::mysqlToIso($date);
1482 $this->assign('credit_card_exp_date', $date);
1483 $this->assign('credit_card_number',
1484 CRM_Utils_System::mungeCreditCard($params['credit_card_number'])
1485 );
1486 $this->assign('credit_card_type', $params['credit_card_type']);
1487 // The concept of contributeMode is deprecated.
1488 $this->assign('contributeMode', 'direct');
1489 $this->assign('isAmountzero', 0);
1490 $this->assign('is_pay_later', 0);
1491 $this->assign('isPrimary', 1);
1492 }
1493
1494 $this->assign('register_date', $params['register_date']);
1495 if (isset($params['receive_date'])) {
1496 $this->assign('receive_date', $params['receive_date']);
1497 }
1498
1499 $customGroup = [];
1500 //format submitted data
1501 foreach ($params['custom'] as $fieldID => $values) {
1502 foreach ($values as $fieldValue) {
1503 $isPublic = CRM_Core_DAO::getFieldValue('CRM_Core_DAO_CustomGroup', $fieldValue['custom_group_id'], 'is_public');
1504 if ($isPublic) {
1505 $customFields[$fieldID]['id'] = $fieldID;
1506 $formattedValue = CRM_Core_BAO_CustomField::displayValue($fieldValue['value'], $fieldID, $participants[0]->id);
1507 $customGroup[$customFields[$fieldID]['groupTitle']][$customFields[$fieldID]['label']] = str_replace('&nbsp;', '', $formattedValue);
1508 }
1509 }
1510 }
1511
1512 foreach ($this->_contactIds as $num => $contactID) {
1513 // Retrieve the name and email of the contact - this will be the TO for receipt email
1514 list($this->_contributorDisplayName, $this->_contributorEmail, $this->_toDoNotEmail) = CRM_Contact_BAO_Contact::getContactDetails($contactID);
1515
1516 $this->_contributorDisplayName = ($this->_contributorDisplayName == ' ') ? $this->_contributorEmail : $this->_contributorDisplayName;
1517
1518 $waitStatus = CRM_Event_PseudoConstant::participantStatus(NULL, "class = 'Waiting'");
1519 if ($waitingStatus = CRM_Utils_Array::value($params['status_id'], $waitStatus)) {
1520 $this->assign('isOnWaitlist', TRUE);
1521 }
1522
1523 $this->assign('customGroup', $customGroup);
1524 $this->assign('contactID', $contactID);
1525 $this->assign('participantID', $participants[$num]->id);
1526
1527 $this->_id = $participants[$num]->id;
1528
1529 if ($this->_isPaidEvent) {
1530 // fix amount for each of participants ( for bulk mode )
1531 $eventAmount = [];
1532 $invoiceSettings = Civi::settings()->get('contribution_invoice_settings');
1533 $invoicing = $invoiceSettings['invoicing'] ?? NULL;
1534 $totalTaxAmount = 0;
1535
1536 //add dataArray in the receipts in ADD and UPDATE condition
1537 $dataArray = [];
1538 if ($this->_action & CRM_Core_Action::ADD) {
1539 $line = $lineItem[0] ?? [];
1540 }
1541 elseif ($this->_action & CRM_Core_Action::UPDATE) {
1542 $line = $this->_values['line_items'];
1543 }
1544 if ($invoicing) {
1545 foreach ($line as $key => $value) {
1546 if (isset($value['tax_amount'])) {
1547 $totalTaxAmount += $value['tax_amount'];
1548 if (isset($dataArray[(string) $value['tax_rate']])) {
1549 $dataArray[(string) $value['tax_rate']] = $dataArray[(string) $value['tax_rate']] + CRM_Utils_Array::value('tax_amount', $value);
1550 }
1551 else {
1552 $dataArray[(string) $value['tax_rate']] = $value['tax_amount'] ?? NULL;
1553 }
1554 }
1555 }
1556 $this->assign('totalTaxAmount', $totalTaxAmount);
1557 $this->assign('taxTerm', $this->getSalesTaxTerm());
1558 $this->assign('dataArray', $dataArray);
1559 }
1560 if (!empty($additionalParticipantDetails)) {
1561 $params['amount_level'] = preg_replace('/\ 1/', '', $params['amount_level']) . ' - ' . $this->_contributorDisplayName;
1562 }
1563
1564 $eventAmount[$num] = [
1565 'label' => preg_replace('/\ 1/', '', $params['amount_level']),
1566 'amount' => $params['fee_amount'],
1567 ];
1568 //as we are using same template for online & offline registration.
1569 //So we have to build amount as array.
1570 $eventAmount = array_merge($eventAmount, $additionalParticipantDetails);
1571 $this->assign('amount', $eventAmount);
1572 }
1573
1574 $sendTemplateParams = [
1575 'groupName' => 'msg_tpl_workflow_event',
1576 'valueName' => 'event_offline_receipt',
1577 'contactId' => $contactID,
1578 'isTest' => !empty($this->_defaultValues['is_test']),
1579 'PDFFilename' => ts('confirmation') . '.pdf',
1580 ];
1581
1582 // try to send emails only if email id is present
1583 // and the do-not-email option is not checked for that contact
1584 if ($this->_contributorEmail and !$this->_toDoNotEmail) {
1585 if (array_key_exists($params['from_email_address'], $this->_fromEmails['from_email_id'])) {
1586 $receiptFrom = $params['from_email_address'];
1587 }
1588 $sendTemplateParams['from'] = $receiptFrom;
1589 $sendTemplateParams['toName'] = $this->_contributorDisplayName;
1590 $sendTemplateParams['toEmail'] = $this->_contributorEmail;
1591 $sendTemplateParams['cc'] = $this->_fromEmails['cc'] ?? NULL;
1592 $sendTemplateParams['bcc'] = $this->_fromEmails['bcc'] ?? NULL;
1593 }
1594
1595 //send email with pdf invoice
1596 $template = CRM_Core_Smarty::singleton();
1597 $taxAmt = $template->get_template_vars('dataArray');
1598 $contributionId = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_ParticipantPayment',
1599 $this->_id, 'contribution_id', 'participant_id'
1600 );
1601 $prefixValue = Civi::settings()->get('contribution_invoice_settings');
1602 $invoicing = $prefixValue['invoicing'] ?? NULL;
1603 if (!empty($taxAmt) && (isset($invoicing) && isset($prefixValue['is_email_pdf']))) {
1604 $sendTemplateParams['isEmailPdf'] = TRUE;
1605 $sendTemplateParams['contributionId'] = $contributionId;
1606 }
1607 list($mailSent, $subject, $message, $html) = CRM_Core_BAO_MessageTemplate::sendTemplate($sendTemplateParams);
1608 if ($mailSent) {
1609 $sent[] = $contactID;
1610 foreach ($participants as $ids => $values) {
1611 if ($values->contact_id == $contactID) {
1612 $values->details = $params['receipt_text'] ?? NULL;
1613 CRM_Activity_BAO_Activity::addActivity($values, 'Email');
1614 break;
1615 }
1616 }
1617 }
1618 else {
1619 $notSent[] = $contactID;
1620 }
1621 }
1622 }
1623
1624 // set the participant id if it is not set
1625 if (!$this->_id) {
1626 $this->_id = $participants[0]->id;
1627 }
1628
1629 return $this->getStatusMsg($params, $sent, $updateStatusMsg, $notSent);
1630 }
1631
1632 /**
1633 * Set the various IDs relating to custom data types.
1634 */
1635 public function setCustomDataTypes() {
1636 $customDataType = CRM_Core_OptionGroup::values('custom_data_type', FALSE, FALSE, FALSE, NULL, 'name');
1637 $this->_roleCustomDataTypeID = array_search('ParticipantRole', $customDataType);
1638 $this->_eventNameCustomDataTypeID = array_search('ParticipantEventName', $customDataType);
1639 $this->_eventTypeCustomDataTypeID = array_search('ParticipantEventType', $customDataType);
1640 $this->assign('roleCustomDataTypeID', $this->_roleCustomDataTypeID);
1641 $this->assign('eventNameCustomDataTypeID', $this->_eventNameCustomDataTypeID);
1642 $this->assign('eventTypeCustomDataTypeID', $this->_eventTypeCustomDataTypeID);
1643 }
1644
1645 /**
1646 * Get status message
1647 *
1648 * @param array $params
1649 * @param int $sent
1650 * @param string $updateStatusMsg
1651 * @param int $notSent
1652 *
1653 * @return string
1654 */
1655 protected function getStatusMsg($params, $sent, $updateStatusMsg, $notSent) {
1656 $statusMsg = '';
1657 if (($this->_action & CRM_Core_Action::UPDATE)) {
1658 $statusMsg = ts('Event registration information for %1 has been updated.', [1 => $this->_contributorDisplayName]);
1659 if (!empty($params['send_receipt']) && count($sent)) {
1660 $statusMsg .= ' ' . ts('A confirmation email has been sent to %1', [1 => $this->_contributorEmail]);
1661 }
1662
1663 if ($updateStatusMsg) {
1664 $statusMsg = "{$statusMsg} {$updateStatusMsg}";
1665 }
1666 }
1667 elseif ($this->_action & CRM_Core_Action::ADD) {
1668 if ($this->_single) {
1669 $statusMsg = ts('Event registration for %1 has been added.', [1 => $this->_contributorDisplayName]);
1670 if (!empty($params['send_receipt']) && count($sent)) {
1671 $statusMsg .= ' ' . ts('A confirmation email has been sent to %1.', [1 => $this->_contributorEmail]);
1672 }
1673 }
1674 else {
1675 $statusMsg = ts('Total Participant(s) added to event: %1.', [1 => count($this->_contactIds)]);
1676 if (count($notSent) > 0) {
1677 $statusMsg .= ' ' . ts('Email has NOT been sent to %1 contact(s) - communication preferences specify DO NOT EMAIL OR valid Email is NOT present. ', [1 => count($notSent)]);
1678 }
1679 elseif (isset($params['send_receipt'])) {
1680 $statusMsg .= ' ' . ts('A confirmation email has been sent to ALL participants');
1681 }
1682 }
1683 }
1684 return $statusMsg;
1685 }
1686
1687 /**
1688 * Build the form object.
1689 *
1690 * @param \CRM_Event_Form_Participant $form
1691 *
1692 * @return bool
1693 * @throws \CRM_Core_Exception
1694 * @throws \Exception
1695 */
1696 public function buildEventFeeForm($form) {
1697 if ($form->_eventId) {
1698 $form->_isPaidEvent = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_Event', $form->_eventId, 'is_monetary');
1699 if ($form->_isPaidEvent) {
1700 $form->addElement('hidden', 'hidden_feeblock', 1);
1701 }
1702
1703 $eventfullMsg = CRM_Event_BAO_Participant::eventFullMessage($form->_eventId, $this->getParticipantID());
1704 $form->addElement('hidden', 'hidden_eventFullMsg', $eventfullMsg, ['id' => 'hidden_eventFullMsg']);
1705 }
1706
1707 if ($form->_isPaidEvent) {
1708 $params = ['id' => $form->_eventId];
1709 CRM_Event_BAO_Event::retrieve($params, $event);
1710
1711 //retrieve custom information
1712 $form->_values = [];
1713 CRM_Event_Form_Registration::initEventFee($form, $event['id']);
1714 CRM_Event_Form_Registration_Register::buildAmount($form, TRUE, $form->_discountId);
1715 $lineItem = [];
1716 $invoiceSettings = Civi::settings()->get('contribution_invoice_settings');
1717 $invoicing = $invoiceSettings['invoicing'] ?? NULL;
1718 $totalTaxAmount = 0;
1719 if (!CRM_Utils_System::isNull(CRM_Utils_Array::value('line_items', $form->_values))) {
1720 $lineItem[] = $form->_values['line_items'];
1721 foreach ($form->_values['line_items'] as $key => $value) {
1722 $totalTaxAmount = $value['tax_amount'] + $totalTaxAmount;
1723 }
1724 }
1725 if ($invoicing) {
1726 $form->assign('totalTaxAmount', $totalTaxAmount);
1727 }
1728 $form->assign('lineItem', empty($lineItem) ? FALSE : $lineItem);
1729 $discounts = [];
1730 if (!empty($form->_values['discount'])) {
1731 foreach ($form->_values['discount'] as $key => $value) {
1732 $value = current($value);
1733 $discounts[$key] = $value['name'];
1734 }
1735
1736 $element = $form->add('select', 'discount_id',
1737 ts('Discount Set'),
1738 [
1739 0 => ts('- select -'),
1740 ] + $discounts,
1741 FALSE,
1742 ['class' => "crm-select2"]
1743 );
1744 }
1745 if (CRM_Financial_BAO_FinancialType::isACLFinancialTypeStatus()
1746 && empty($form->_values['fee'])
1747 && CRM_Utils_Array::value('snippet', $_REQUEST) == CRM_Core_Smarty::PRINT_NOFORM
1748 ) {
1749 CRM_Core_Session::setStatus(ts('You do not have all the permissions needed for this page.'), 'Permission Denied', 'error');
1750 return FALSE;
1751 }
1752
1753 CRM_Core_Payment_Form::buildPaymentForm($form, $form->_paymentProcessor, FALSE, TRUE, self::getDefaultPaymentInstrumentId());
1754 if (!$form->_mode) {
1755 $form->addElement('checkbox', 'record_contribution', ts('Record Payment?'), NULL,
1756 ['onclick' => "return showHideByValue('record_contribution','','payment_information','table-row','radio',false);"]
1757 );
1758 // Check permissions for financial type first
1759 if (CRM_Financial_BAO_FinancialType::isACLFinancialTypeStatus()) {
1760 CRM_Financial_BAO_FinancialType::getAvailableFinancialTypes($financialTypes, $form->_action);
1761 }
1762 else {
1763 $financialTypes = CRM_Contribute_PseudoConstant::financialType();
1764 }
1765
1766 $form->add('select', 'financial_type_id',
1767 ts('Financial Type'),
1768 ['' => ts('- select -')] + $financialTypes
1769 );
1770
1771 $form->add('datepicker', 'receive_date', ts('Received'), [], FALSE, ['time' => TRUE]);
1772
1773 $form->add('select', 'payment_instrument_id',
1774 ts('Payment Method'),
1775 ['' => ts('- select -')] + CRM_Contribute_PseudoConstant::paymentInstrument(),
1776 FALSE, ['onChange' => "return showHideByValue('payment_instrument_id','4','checkNumber','table-row','select',false);"]
1777 );
1778 // don't show transaction id in batch update mode
1779 $path = CRM_Utils_System::currentPath();
1780 $form->assign('showTransactionId', FALSE);
1781 if ($path != 'civicrm/contact/search/basic') {
1782 $form->add('text', 'trxn_id', ts('Transaction ID'));
1783 $form->addRule('trxn_id', ts('Transaction ID already exists in Database.'),
1784 'objectExists', ['CRM_Contribute_DAO_Contribution', $form->_eventId, 'trxn_id']
1785 );
1786 $form->assign('showTransactionId', TRUE);
1787 }
1788
1789 $form->add('select', 'contribution_status_id',
1790 ts('Payment Status'), CRM_Contribute_BAO_Contribution_Utils::getContributionStatuses('participant')
1791 );
1792
1793 $form->add('text', 'check_number', ts('Check Number'),
1794 CRM_Core_DAO::getAttribute('CRM_Contribute_DAO_Contribution', 'check_number')
1795 );
1796
1797 $form->add('text', 'total_amount', ts('Amount'),
1798 CRM_Core_DAO::getAttribute('CRM_Contribute_DAO_Contribution', 'total_amount')
1799 );
1800 }
1801 }
1802 else {
1803 $form->add('text', 'amount', ts('Event Fee(s)'));
1804 }
1805 $form->assign('onlinePendingContributionId', $form->get('onlinePendingContributionId'));
1806
1807 $form->assign('paid', $form->_isPaidEvent);
1808
1809 $form->addElement('checkbox',
1810 'send_receipt',
1811 ts('Send Confirmation?'), NULL,
1812 ['onclick' => "showHideByValue('send_receipt','','notice','table-row','radio',false); showHideByValue('send_receipt','','from-email','table-row','radio',false);"]
1813 );
1814
1815 $form->add('select', 'from_email_address', ts('Receipt From'), $form->_fromEmails['from_email_id']);
1816
1817 $form->add('textarea', 'receipt_text', ts('Confirmation Message'));
1818
1819 // Retrieve the name and email of the contact - form will be the TO for receipt email ( only if context is not standalone)
1820 if ($form->_context != 'standalone') {
1821 if ($form->_contactId) {
1822 list($form->_contributorDisplayName,
1823 $form->_contributorEmail
1824 ) = CRM_Contact_BAO_Contact_Location::getEmailDetails($form->_contactId);
1825 $form->assign('email', $form->_contributorEmail);
1826 }
1827 else {
1828 //show email block for batch update for event
1829 $form->assign('batchEmail', TRUE);
1830 }
1831 }
1832
1833 $mailingInfo = Civi::settings()->get('mailing_backend');
1834 $form->assign('outBound_option', $mailingInfo['outBound_option']);
1835 $form->assign('hasPayment', $form->_paymentId);
1836 }
1837
1838 /**
1839 * Extracted code relating to paid events.
1840 *
1841 * @param $params
1842 *
1843 * @return array
1844 *
1845 * @throws \CiviCRM_API3_Exception
1846 */
1847 protected function preparePaidEventProcessing($params): array {
1848 $participantStatus = CRM_Event_PseudoConstant::participantStatus();
1849 $contributionParams = [
1850 'skipCleanMoney' => TRUE,
1851 'revenue_recognition_date' => $this->getRevenueRecognitionDate(),
1852 ];
1853 $lineItem = [];
1854 $additionalParticipantDetails = [];
1855
1856 if ($this->isPaymentOnExistingContribution()) {
1857 $contributionParams['total_amount'] = $this->getParticipantValue('fee_amount');
1858
1859 $params['discount_id'] = NULL;
1860 //re-enter the values for UPDATE mode
1861 $params['fee_level'] = $params['amount_level'] = $this->getParticipantValue('fee_level');
1862 $params['fee_amount'] = $this->getParticipantValue('fee_amount');
1863 if (isset($params['priceSetId'])) {
1864 CRM_Core_Error::deprecatedFunctionWarning('It seems this line is never hit & can go.');
1865 $lineItem[0] = CRM_Price_BAO_LineItem::getLineItems($this->_id);
1866 }
1867 //also add additional participant's fee level/priceset
1868 if (CRM_Event_BAO_Participant::isPrimaryParticipant($this->_id)) {
1869 $additionalIds = CRM_Event_BAO_Participant::getAdditionalParticipantIds($this->_id);
1870 $hasLineItems = CRM_Utils_Array::value('priceSetId', $params, FALSE);
1871 $additionalParticipantDetails = $this->getFeeDetails($additionalIds, $hasLineItems);
1872 }
1873 }
1874 else {
1875
1876 // check that discount_id is set
1877 if (empty($params['discount_id'])) {
1878 $params['discount_id'] = 'null';
1879 }
1880
1881 //lets carry currency, CRM-4453
1882 $params['fee_currency'] = CRM_Core_Config::singleton()->defaultCurrency;
1883 if (!isset($lineItem[0])) {
1884 $lineItem[0] = [];
1885 }
1886 CRM_Price_BAO_PriceSet::processAmount($this->_values['fee'],
1887 $params, $lineItem[0]
1888 );
1889 //CRM-11529 for quick config backoffice transactions
1890 //when financial_type_id is passed in form, update the
1891 //lineitems with the financial type selected in form
1892 $submittedFinancialType = $params['financial_type_id'] ?? NULL;
1893 $isPaymentRecorded = $params['record_contribution'] ?? NULL;
1894 if ($isPaymentRecorded && $this->_quickConfig && $submittedFinancialType) {
1895 foreach ($lineItem[0] as &$values) {
1896 $values['financial_type_id'] = $submittedFinancialType;
1897 }
1898 }
1899
1900 $params['fee_level'] = $params['amount_level'];
1901 $contributionParams['total_amount'] = $params['amount'];
1902 if ($this->_quickConfig && !empty($params['total_amount']) &&
1903 $params['status_id'] != array_search('Partially paid', $participantStatus)
1904 ) {
1905 $params['fee_amount'] = $params['total_amount'];
1906 }
1907 else {
1908 //fix for CRM-3086
1909 $params['fee_amount'] = $params['amount'];
1910 }
1911 }
1912
1913 if (isset($params['priceSetId'])) {
1914 if (!empty($lineItem[0])) {
1915 $this->set('lineItem', $lineItem);
1916
1917 $this->_lineItem = $lineItem;
1918 $lineItem = array_merge($lineItem, $additionalParticipantDetails);
1919
1920 $participantCount = [];
1921 foreach ($lineItem as $k) {
1922 foreach ($k as $v) {
1923 if (CRM_Utils_Array::value('participant_count', $v) > 0) {
1924 $participantCount[] = $v['participant_count'];
1925 }
1926 }
1927 }
1928 }
1929 if (isset($participantCount)) {
1930 $this->assign('pricesetFieldsCount', $participantCount);
1931 }
1932 $this->assign('lineItem', empty($lineItem[0]) || $this->_quickConfig ? FALSE : $lineItem);
1933 }
1934 else {
1935 $this->assign('amount_level', $params['amount_level']);
1936 }
1937 return [$contributionParams, $lineItem, $additionalParticipantDetails, $params];
1938 }
1939
1940 /**
1941 * @param $eventID
1942 * @param $participantRoles
1943 * @param $receiptText
1944 * @param $isPaidEvent
1945 *
1946 * @return void
1947 */
1948 protected function assignEventDetailsToTpl($eventID, $participantRoles, $receiptText, $isPaidEvent) {
1949 //use of the message template below requires variables in different format
1950 $events = [];
1951 $returnProperties = ['event_type_id', 'fee_label', 'start_date', 'end_date', 'is_show_location', 'title'];
1952
1953 //get all event details.
1954 CRM_Core_DAO::commonRetrieveAll('CRM_Event_DAO_Event', 'id', $eventID, $events, $returnProperties);
1955 $event = $events[$eventID];
1956 unset($event['start_date']);
1957 unset($event['end_date']);
1958
1959 $role = CRM_Event_PseudoConstant::participantRole();
1960
1961 if (is_array($participantRoles)) {
1962 $selectedRoles = [];
1963 foreach ($participantRoles as $roleId) {
1964 $selectedRoles[] = $role[$roleId];
1965 }
1966 $event['participant_role'] = implode(', ', $selectedRoles);
1967 }
1968 else {
1969 $event['participant_role'] = $role[$participantRoles] ?? NULL;
1970 }
1971 $event['is_monetary'] = $isPaidEvent;
1972
1973 if ($receiptText) {
1974 $event['confirm_email_text'] = $receiptText;
1975 }
1976 $this->assign('event', $event);
1977 $this->assign('isShowLocation', $event['is_show_location']);
1978 if (CRM_Utils_Array::value('is_show_location', $event) == 1) {
1979 $locationParams = [
1980 'entity_id' => $eventID,
1981 'entity_table' => 'civicrm_event',
1982 ];
1983 $location = CRM_Core_BAO_Location::getValues($locationParams, TRUE);
1984 $this->assign('location', $location);
1985 }
1986 }
1987
1988 /**
1989 * Process the contribution.
1990 *
1991 * @param CRM_Core_Form $form
1992 * @param array $params
1993 * @param array $result
1994 * @param int $contactID
1995 * @param bool $pending
1996 * @param array $paymentProcessor
1997 *
1998 * @return \CRM_Contribute_BAO_Contribution
1999 *
2000 * @throws \CRM_Core_Exception
2001 * @throws \CiviCRM_API3_Exception
2002 */
2003 public function processContribution(
2004 &$form, $params, $result, $contactID,
2005 $pending = FALSE,
2006 $paymentProcessor = NULL
2007 ) {
2008 $transaction = new CRM_Core_Transaction();
2009
2010 $now = date('YmdHis');
2011 $receiptDate = NULL;
2012
2013 if (!empty($form->_values['event']['is_email_confirm'])) {
2014 $receiptDate = $now;
2015 }
2016
2017 // CRM-20264: fetch CC type ID and number (last 4 digit) and assign it back to $params
2018 CRM_Contribute_Form_AbstractEditPayment::formatCreditCardDetails($params);
2019
2020 $contribParams = [
2021 'contact_id' => $contactID,
2022 'financial_type_id' => !empty($form->_values['event']['financial_type_id']) ? $form->_values['event']['financial_type_id'] : $params['financial_type_id'],
2023 'receive_date' => $now,
2024 'total_amount' => $params['amount'],
2025 'tax_amount' => $params['tax_amount'],
2026 'amount_level' => $params['amount_level'],
2027 'invoice_id' => $params['invoiceID'],
2028 'currency' => $params['currencyID'],
2029 'source' => !empty($params['participant_source']) ? $params['participant_source'] : $params['description'],
2030 'is_pay_later' => CRM_Utils_Array::value('is_pay_later', $params, 0),
2031 'campaign_id' => $params['campaign_id'] ?? NULL,
2032 'card_type_id' => $params['card_type_id'] ?? NULL,
2033 'pan_truncation' => $params['pan_truncation'] ?? NULL,
2034 ];
2035
2036 if ($paymentProcessor) {
2037 $contribParams['payment_instrument_id'] = $paymentProcessor['payment_instrument_id'];
2038 $contribParams['payment_processor'] = $paymentProcessor['id'];
2039 }
2040
2041 if (!$pending && $result) {
2042 $contribParams += [
2043 'fee_amount' => $result['fee_amount'] ?? NULL,
2044 'trxn_id' => $result['trxn_id'],
2045 'receipt_date' => $receiptDate,
2046 ];
2047 }
2048
2049 $allStatuses = CRM_Contribute_PseudoConstant::contributionStatus(NULL, 'name');
2050 $contribParams['contribution_status_id'] = array_search('Completed', $allStatuses);
2051 if ($pending) {
2052 $contribParams['contribution_status_id'] = array_search('Pending', $allStatuses);
2053 }
2054
2055 $contribParams['is_test'] = 0;
2056 if ($form->_action & CRM_Core_Action::PREVIEW || CRM_Utils_Array::value('mode', $params) == 'test') {
2057 $contribParams['is_test'] = 1;
2058 }
2059
2060 if (!empty($contribParams['invoice_id'])) {
2061 $contribParams['id'] = CRM_Core_DAO::getFieldValue('CRM_Contribute_DAO_Contribution',
2062 $contribParams['invoice_id'],
2063 'id',
2064 'invoice_id'
2065 );
2066 }
2067 $contribParams['revenue_recognition_date'] = $this->getRevenueRecognitionDate();
2068
2069 //create an contribution address
2070 // The concept of contributeMode is deprecated. Elsewhere we use the function processBillingAddress() - although
2071 // currently that is only inherited by back-office forms.
2072 if ($form->_contributeMode != 'notify' && empty($params['is_pay_later'])) {
2073 $contribParams['address_id'] = CRM_Contribute_BAO_Contribution::createAddress($params, $form->_bltID);
2074 }
2075
2076 $contribParams['skipLineItem'] = 1;
2077 $contribParams['skipCleanMoney'] = 1;
2078 // create contribution record
2079 $contribution = CRM_Contribute_BAO_Contribution::add($contribParams);
2080 // CRM-11124
2081 CRM_Event_BAO_Participant::createDiscountTrxn($form->_eventId, $contribParams, NULL, CRM_Price_BAO_PriceSet::parseFirstPriceSetValueIDFromParams($params));
2082
2083 // process soft credit / pcp pages
2084 if (!empty($params['pcp_made_through_id'])) {
2085 CRM_Contribute_BAO_ContributionSoft::formatSoftCreditParams($params, $form);
2086 CRM_Contribute_BAO_ContributionSoft::processSoftContribution($params, $contribution);
2087 }
2088
2089 $transaction->commit();
2090
2091 return $contribution;
2092 }
2093
2094 /**
2095 * Process the participant.
2096 *
2097 * @param CRM_Core_Form $form
2098 * @param array $params
2099 * @param int $contactID
2100 *
2101 * @return \CRM_Event_BAO_Participant
2102 * @throws \CRM_Core_Exception
2103 * @throws \CiviCRM_API3_Exception
2104 */
2105 protected function addParticipant(&$form, $params, $contactID) {
2106 $transaction = new CRM_Core_Transaction();
2107
2108 $participantFields = CRM_Event_DAO_Participant::fields();
2109 $participantParams = [
2110 'id' => $params['participant_id'] ?? NULL,
2111 'contact_id' => $contactID,
2112 'event_id' => $form->_eventId ? $form->_eventId : $params['event_id'],
2113 'status_id' => CRM_Utils_Array::value('participant_status',
2114 $params, 1
2115 ),
2116 'role_id' => CRM_Utils_Array::value('participant_role_id', $params) ?: CRM_Event_BAO_Participant::getDefaultRoleID(),
2117 'register_date' => $params['register_date'],
2118 'source' => CRM_Utils_String::ellipsify(
2119 isset($params['participant_source']) ? CRM_Utils_Array::value('participant_source', $params) : CRM_Utils_Array::value('description', $params),
2120 $participantFields['participant_source']['maxlength']
2121 ),
2122 'fee_level' => $params['amount_level'] ?? NULL,
2123 'is_pay_later' => CRM_Utils_Array::value('is_pay_later', $params, 0),
2124 'fee_amount' => $params['fee_amount'] ?? NULL,
2125 'registered_by_id' => $params['registered_by_id'] ?? NULL,
2126 'discount_id' => $params['discount_id'] ?? NULL,
2127 'fee_currency' => $params['currencyID'] ?? NULL,
2128 'campaign_id' => $params['campaign_id'] ?? NULL,
2129 ];
2130
2131 if ($form->_action & CRM_Core_Action::PREVIEW || CRM_Utils_Array::value('mode', $params) == 'test') {
2132 $participantParams['is_test'] = 1;
2133 }
2134 else {
2135 $participantParams['is_test'] = 0;
2136 }
2137
2138 if (!empty($form->_params['note'])) {
2139 $participantParams['note'] = $form->_params['note'];
2140 }
2141 elseif (!empty($form->_params['participant_note'])) {
2142 $participantParams['note'] = $form->_params['participant_note'];
2143 }
2144
2145 // reuse id if one already exists for this one (can happen
2146 // with back button being hit etc)
2147 if (!$participantParams['id'] && !empty($params['contributionID'])) {
2148 $pID = CRM_Core_DAO::getFieldValue('CRM_Event_DAO_ParticipantPayment',
2149 $params['contributionID'],
2150 'participant_id',
2151 'contribution_id'
2152 );
2153 $participantParams['id'] = $pID;
2154 }
2155 $participantParams['discount_id'] = CRM_Core_BAO_Discount::findSet($form->_eventId, 'civicrm_event');
2156
2157 if (!$participantParams['discount_id']) {
2158 $participantParams['discount_id'] = "null";
2159 }
2160
2161 $participant = CRM_Event_BAO_Participant::create($participantParams);
2162
2163 $transaction->commit();
2164
2165 return $participant;
2166 }
2167
2168 /**
2169 * Is a payment being made on an existing contribution.
2170 *
2171 * Note
2172 * 1) ideally we should not permit this on this form! Perhaps we don't & this is just cruft.
2173 * 2) _paymentID is the contribution id.
2174 *
2175 * @return bool
2176 */
2177 protected function isPaymentOnExistingContribution(): bool {
2178 return ($this->getParticipantID() && $this->_action & CRM_Core_Action::UPDATE) && $this->_paymentId;
2179 }
2180
2181 /**
2182 * Get the value for a field relating to the event.
2183 *
2184 * @param string $fieldName
2185 *
2186 * @return mixed
2187 * @throws \CiviCRM_API3_Exception
2188 */
2189 protected function getEventValue(string $fieldName) {
2190 if (!isset($this->_event)) {
2191 $this->_event = civicrm_api3('Event', 'getsingle', ['id' => $this->_eventId]);
2192 }
2193 return $this->_event[$fieldName];
2194 }
2195
2196 /**
2197 * Get a value from the existing participant record (applies to edits).
2198 *
2199 * @param string $fieldName
2200 *
2201 * @return array
2202 * @throws \CiviCRM_API3_Exception
2203 */
2204 protected function getParticipantValue($fieldName) {
2205 if (!$this->participantRecord) {
2206 $this->participantRecord = civicrm_api3('Participant', 'getsingle', ['id' => $this->_id]);
2207 }
2208 return $this->participantRecord[$fieldName] ?? $this->participantRecord['participant_' . $fieldName];
2209 }
2210
2211 /**
2212 * Get id of participant being edited.
2213 *
2214 * @return int|null
2215 */
2216 protected function getParticipantID() {
2217 return $this->_id ?? $this->_pId;
2218 }
2219
2220 /**
2221 * Get the value for the revenue recognition date field.
2222 *
2223 * @return string
2224 *
2225 * @throws \CiviCRM_API3_Exception
2226 */
2227 protected function getRevenueRecognitionDate() {
2228 if (Civi::settings()->get('deferred_revenue_enabled')) {
2229 $eventStartDate = $this->getEventValue('start_date');
2230 if (strtotime($eventStartDate) > strtotime(date('Ymt'))) {
2231 return date('Ymd', strtotime($eventStartDate));
2232 }
2233 }
2234 return '';
2235 }
2236
2237 /**
2238 * Store the parameters to create a payment, if approprite, on the form.
2239 *
2240 * @param array $params
2241 * Params as submitted.
2242 */
2243 protected function storePaymentCreateParams($params) {
2244 if ('Completed' === CRM_Core_PseudoConstant::getName('CRM_Contribute_BAO_Contribution', 'contribution_status_id', $params['contribution_status_id'])) {
2245 $this->setCreatePaymentParams([
2246 'total_amount' => $params['total_amount'],
2247 'is_send_contribution_notification' => FALSE,
2248 'payment_instrument_id' => $params['payment_instrument_id'],
2249 'trxn_date' => $params['receive_date'] ?? date('Y-m-d'),
2250 'trxn_id' => $params['trxn_id'],
2251 'pan_truncation' => $params['pan_truncation'] ?? '',
2252 'card_type_id' => $params['card_type_id'] ?? '',
2253 'check_number' => $params['check_number'] ?? '',
2254 'skipCleanMoney' => TRUE,
2255 ]);
2256 }
2257 }
2258
2259 /**
2260 * Get the event fee info for given participant ids
2261 * either from line item table / participant table.
2262 *
2263 * @param array $participantIds
2264 * Participant ids.
2265 * @param bool $hasLineItems
2266 * Do fetch from line items.
2267 *
2268 * @return array
2269 */
2270 public function getFeeDetails($participantIds, $hasLineItems = FALSE) {
2271 $feeDetails = [];
2272 if (!is_array($participantIds) || empty($participantIds)) {
2273 return $feeDetails;
2274 }
2275
2276 $select = '
2277 SELECT participant.id as id,
2278 participant.fee_level as fee_level,
2279 participant.fee_amount as fee_amount';
2280 $from = 'FROM civicrm_participant participant';
2281 if ($hasLineItems) {
2282 $select .= ' ,
2283 lineItem.id as lineId,
2284 lineItem.label as label,
2285 lineItem.qty as qty,
2286 lineItem.unit_price as unit_price,
2287 lineItem.line_total as line_total,
2288 field.label as field_title,
2289 field.html_type as html_type,
2290 field.id as price_field_id,
2291 value.id as price_field_value_id,
2292 value.description as description,
2293 IF( value.count, value.count, 0 ) as participant_count';
2294 $from .= "
2295 INNER JOIN civicrm_line_item lineItem ON ( lineItem.entity_table = 'civicrm_participant'
2296 AND lineItem.entity_id = participant.id )
2297 INNER JOIN civicrm_price_field field ON ( field.id = lineItem.price_field_id )
2298 INNER JOIN civicrm_price_field_value value ON ( value.id = lineItem.price_field_value_id )
2299 ";
2300 }
2301 $where = 'WHERE participant.id IN ( ' . implode(', ', $participantIds) . ' )';
2302 $query = "$select $from $where";
2303
2304 $feeInfo = CRM_Core_DAO::executeQuery($query);
2305 $feeProperties = ['fee_level', 'fee_amount'];
2306 $lineProperties = [
2307 'lineId',
2308 'label',
2309 'qty',
2310 'unit_price',
2311 'line_total',
2312 'field_title',
2313 'html_type',
2314 'price_field_id',
2315 'participant_count',
2316 'price_field_value_id',
2317 'description',
2318 ];
2319 while ($feeInfo->fetch()) {
2320 if ($hasLineItems) {
2321 foreach ($lineProperties as $property) {
2322 $feeDetails[$feeInfo->id][$feeInfo->lineId][$property] = $feeInfo->$property;
2323 }
2324 }
2325 else {
2326 foreach ($feeProperties as $property) {
2327 $feeDetails[$feeInfo->id][$property] = $feeInfo->$property;
2328 }
2329 }
2330 }
2331
2332 return $feeDetails;
2333 }
2334
2335 }