Add Integrations::EVENT_MODIFY_FORM_INTEGRATION event

docs/developers/events.md

@@ -1560,7 +1560,7 @@ Event::on(Integrations::class, Integrations::EVENT_REGISTER_INTEGRATIONS, functi
 ```
 
 ### The `modifyFormIntegrations` event
-The event that is triggered when an integration instance is created for a form. If you want to modify the settings of an integration for a form, this would be a good event to do so.
+The event that is triggered when all enabled integrations for a form is prepared for the front-end. This does not change the settings shown for the integration in the form builder.
 
 ```php
 use verbb\formie\events\ModifyFormIntegrationsEvent;
@@ -1573,6 +1573,20 @@ Event::on(Integrations::class, Integrations::EVENT_MODIFY_FORM_INTEGRATIONS, fun
 });
 ```
 
+### The `modifyFormIntegration` event
+The event that is triggered when an integration instance is created for a form. If you want to modify the settings of an integration for a form, this would be a good event to do so.
+
+```php
+use verbb\formie\events\ModifyFormIntegrationEvent;
+use verbb\formie\services\Integrations;
+use yii\base\Event;
+
+Event::on(Integrations::class, Integrations::EVENT_MODIFY_FORM_INTEGRATION, function(ModifyFormIntegrationEvent $event) {
+    $integration = $event->integration;
+    // ...
+});
+```
+
 ### The `beforeSaveIntegration` event
 The event that is triggered before an integration is saved.
 

src/events/ModifyFormIntegrationEvent.php

@@ -0,0 +1,15 @@
+<?php
+namespace verbb\formie\events;
+
+use verbb\formie\base\IntegrationInterface;
+
+use yii\base\Event;
+
+class ModifyFormIntegrationEvent extends Event
+{
+    // Properties
+    // =========================================================================
+
+    public ?IntegrationInterface $integration = null;
+
+}

src/services/Integrations.php

@@ -7,6 +7,7 @@
 use verbb\formie\base\IntegrationInterface;
 use verbb\formie\elements\Form;
 use verbb\formie\events\IntegrationEvent;
+use verbb\formie\events\ModifyFormIntegrationEvent;
 use verbb\formie\events\ModifyFormIntegrationsEvent;
 use verbb\formie\events\RegisterIntegrationsEvent;
 use verbb\formie\integrations\addressproviders;
@@ -49,6 +50,7 @@ class Integrations extends Component
 
     public const EVENT_REGISTER_INTEGRATIONS = 'registerFormieIntegrations';
     public const EVENT_MODIFY_FORM_INTEGRATIONS = 'modifyFormIntegrations';
+    public const EVENT_MODIFY_FORM_INTEGRATION = 'modifyFormIntegration';
     public const EVENT_BEFORE_SAVE_INTEGRATION = 'beforeSaveIntegration';
     public const EVENT_AFTER_SAVE_INTEGRATION = 'afterSaveIntegration';
     public const EVENT_BEFORE_DELETE_INTEGRATION = 'beforeDeleteIntegration';
@@ -614,13 +616,25 @@ public function getAllIntegrationsForForm(): array
 
         foreach ($this->getAllCaptchas() as $key => $captcha) {
             if ($captcha->getEnabled() && $captcha->hasFormSettings()) {
-                $grouped[$captcha->typeName()][] = $captcha;
+                // Fire a 'modifyFormIntegration' event
+                $event = new ModifyFormIntegrationEvent([
+                    'integration' => $captcha,
+                ]);
+                $this->trigger(self::EVENT_MODIFY_FORM_INTEGRATION, $event);
+
+                $grouped[$captcha->typeName()][] = $event->integration;
             }
         }
 
         foreach ($this->getAllIntegrations() as $key => $integration) {
             if ($integration->getEnabled() && $integration->hasFormSettings()) {
-                $grouped[$integration->typeName()][] = $integration;
+                // Fire a 'modifyFormIntegration' event
+                $event = new ModifyFormIntegrationEvent([
+                    'integration' => $integration,
+                ]);
+                $this->trigger(self::EVENT_MODIFY_FORM_INTEGRATION, $event);
+
+                $grouped[$integration->typeName()][] = $event->integration;
             }
         }