Merge pull request #24304 from mattwire/participantcontacthook

dev/core#3778 Add code hook to set civicrm_participant.created_id

CRM/Event/BAO/Participant.php

@@ -14,7 +14,7 @@
  * @package CRM
  * @copyright CiviCRM LLC https://civicrm.org/licensing
  */
-class CRM_Event_BAO_Participant extends CRM_Event_DAO_Participant {
+class CRM_Event_BAO_Participant extends CRM_Event_DAO_Participant implements \Civi\Core\HookInterface {
 
   /**
    * Static field for all the participant information that we can potentially import.
@@ -1904,4 +1904,36 @@ public static function getSelfServiceEligibility(int $participantId, string $url
     return $details;
   }
 
+  /**
+   * Callback for hook_civicrm_pre().
+   * @param \Civi\Core\Event\PreEvent $event
+   * @throws CRM_Core_Exception
+   */
+  public static function self_hook_civicrm_pre(\Civi\Core\Event\PreEvent $event) {
+    if ($event->entity === 'Participant' && $event->action === 'create' && empty($event->params['created_id'])) {
+      // Set the "created_id" field if not already set.
+      // The created_id should always be the person that actually did the registration.
+      // That might be the first participant, but it might be someone registering someone without registering themselves.
+      // 1. Prefer logged in contact id
+      // 2. Fall back to 'registered_by_id' param.
+      // 3. Fall back to participant contact_id (for anonymous person registering themselves)
+      $event->params['created_id'] = CRM_Core_Session::getLoggedInContactID();
+      if (empty($event->params['created_id'])) {
+        if (!empty($event->params['registered_by_id'])) {
+          // No logged in contact but participant was registered by someone else.
+          // Look up the contact ID of that participant and record
+          $participant = \Civi\Api4\Participant::get(FALSE)
+            ->addSelect('contact_id')
+            ->addWhere('id', '=', $event->params['registered_by_id'])
+            ->execute()
+            ->first();
+          $event->params['created_id'] = $participant['contact_id'];
+        }
+        else {
+          $event->params['created_id'] = $event->params['contact_id'];
+        }
+      }
+    }
+  }
+
 }

tests/phpunit/CRM/Event/BAO/ParticipantTest.php

@@ -102,7 +102,7 @@ public function testgetValuesWithValidParams() {
       'cart_id' => NULL,
       'must_wait' => NULL,
       'transferred_to_contact_id' => NULL,
-      'created_id' => NULL,
+      'created_id' => $this->_contactId,
     ];
 
     foreach ($compareValues as $key => $value) {

tests/phpunit/CRM/Utils/TokenConsistencyTest.php

@@ -577,16 +577,16 @@ protected function getMembershipID(): int {
    *
    * @return string
    */
-  protected function getExpectedParticipantTokenOutput(): string {
-    return 'participant.status_id :2
+  protected function getExpectedParticipantTokenOutput(int $participantCreatedID = NULL): string {
+    return "participant.status_id :2
 participant.role_id :1
 participant.register_date :February 19th, 2007
 participant.source :Wimbeldon
 participant.fee_level :steep
 participant.fee_amount :$50.00
 participant.registered_by_id :
 participant.transferred_to_contact_id :
-participant.created_id :
+participant.created_id :{$participantCreatedID}
 participant.role_id:label :Attendee
 participant.balance :
 participant.custom_2 :99999
@@ -598,7 +598,7 @@ protected function getExpectedParticipantTokenOutput(): string {
 participant.role_id:name :Attendee
 participant.is_test:label :No
 participant.must_wait :
-';
+";
   }
 
   /**
@@ -666,7 +666,7 @@ public function testParticipantTokenConsistency(): void {
     $this->assertEquals(array_merge($tokens, $this->getEventTokens(), $this->getDomainTokens()), $tokenProcessor->listTokens());
 
     $this->callAPISuccess('job', 'send_reminder', []);
-    $expected = $this->getExpectedParticipantTokenOutput();
+    $expected = $this->getExpectedParticipantTokenOutput(3);
     $mut->checkMailLog([$expected]);
 
     $tokenProcessor->addMessage('html', $this->getTokenString(array_keys($this->getParticipantTokens())), 'text/plain');
@@ -836,7 +836,7 @@ public function testEventTokenConsistency(): void {
 
     $expectedEventString = $this->getExpectedEventTokenOutput();
     $this->callAPISuccess('job', 'send_reminder', []);
-    $expectedParticipantString = $this->getExpectedParticipantTokenOutput();
+    $expectedParticipantString = $this->getExpectedParticipantTokenOutput(5);
     $toCheck = array_merge(explode("\n", $expectedEventString), explode("\n", $expectedParticipantString));
     $toCheck[] = $expectedEventString;
     $toCheck[] = $expectedParticipantString;