Initial Delay setting

Resolves #53

Author: brandonkelly

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 - Added new “Element is being saved for the first time” and “Element is a provisional draft” webhook filters.
 - Some webhook filters now disable other mutually-exclusive filters when active and enabled.
+- Added the “Initial Delay” setting. ([#53](https://github.com/craftcms/webhooks/discussions/53))
 - Added `craft\webhooks\filters\ExclusiveFilterInterface`.
 
 ### Changed

src/Plugin.php

@@ -323,8 +323,9 @@ public function request(string $method, string $url, array $headers = null, stri
      */
     public function pushPendingJobs()
     {
+        $settings = $this->getSettings();
         while ($job = array_shift($this->_pendingJobs)) {
-            Queue::push($job);
+            Queue::push($job, null, $settings->initialDelay);
         }
     }
 

src/Settings.php

@@ -18,6 +18,12 @@ class Settings extends Model
      */
     public $maxAttempts = 1;
 
+    /**
+     * @var int|null The time delay in seconds that initial webhook request attempts should have.
+     * @since 2.4.0
+     */
+    public $initialDelay;
+
     /**
      * @var int The time delay in seconds between request retries.
      * @since 2.3.0
@@ -40,6 +46,10 @@ public function setAttributes($values, $safeOnly = true)
             $values['retryDelay'] = $retryDelay;
         }
 
+        if (empty($values['initialDelay'])) {
+            $values['initialDelay'] = null;
+        }
+
         parent::setAttributes($values, $safeOnly);
     }
 
@@ -50,7 +60,7 @@ protected function defineRules(): array
     {
         return [
             [['maxDepth', 'maxAttempts'], 'number', 'integerOnly' => true, 'min' => 1],
-            [['retryDelay'], 'number', 'integerOnly' => true, 'min' => 0],
+            [['initialDelay', 'retryDelay'], 'number', 'integerOnly' => true, 'min' => 0],
         ];
     }
 

src/templates/_settings.twig

@@ -19,6 +19,15 @@
   value: settings.maxAttempts,
 }) }}
 
+{{ forms.textField({
+  id: 'initial-delay',
+  label: 'Initial Delay'|t('webhooks'),
+  instructions: 'The time delay in seconds that initial webhook requests should have.'|t('webhooks'),
+  size: 5,
+  name: 'initialDelay',
+  value: settings.initialDelay,
+}) }}
+
 {{ forms.textField({
   id: 'retry-delay',
   label: 'Retry Delay'|t('webhooks'),