Allow webhook URLs to be set to environment variables or Twig code

Resolves #18

Author: brandonkelly

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release Notes for Webhooks for Craft CMS
 
+## Unreleased
+
+### Added
+- Webhook URLs can now be set to environment variables or Twig code. ([#18](https://github.com/craftcms/webhooks/issues/18))
+
 ## 2.2.0 - 2019-07-29
 
 ### Added

README.md

@@ -70,6 +70,8 @@ Webhooks listen to [events](https://www.yiiframework.com/doc/guide/2.0/en/concep
 
 The Sender Class can be a subclass of the class that triggers the event. For example, all elements fire an [afterSave](https://docs.craftcms.com/api/v3/craft-base-element.html#event-after-save) event after they’ve been saved, courtesy of their base class, [craft\base\Element](https://docs.craftcms.com/api/v3/craft-base-element.html). However if you’re only interested in sending a webhook when an _entry_ gets saved, you can set the Sender Class to [craft\elements\Entry](https://docs.craftcms.com/api/v3/craft-elements-entry.html).
 
+Webhook URLs can be set to an environment variable (`$VARIABLE_NAME`) or Twig code. If you set it to Twig code, you can reference the triggered event via an `event` variable. 
+
 See [Integrating with Task Automation Tools](#integrating-with-task-automation-tools) for examples on how to get a Webhook URL from various task automation tools.
 
 ![Screenshot of the Edit Webhook page](./images/edit-webhook.png)

src/Plugin.php

@@ -180,7 +180,11 @@ public function init()
                 }
 
                 // Queue the send request up
-                $this->request($webhook->method, $webhook->url, $headers, $body, $webhook->id);
+                $url = Craft::parseEnv($webhook->url);
+                $url = $view->renderString($url, [
+                    'event' => $e,
+                ]);
+                $this->request($webhook->method, $url, $headers, $body, $webhook->id);
             });
         }
 

src/templates/_manage/edit.html

@@ -126,7 +126,7 @@
     {{ forms.field({
         label: 'Request Method & URL'|t('webhooks'),
         required: true,
-        instructions: 'The request method and URL that the webhook should send. (The URL will be provided by your [task automation tool][1].)'|t('webhooks') ~ '\n\n[1]: https://github.com/craftcms/webhooks#integration-with-task-automation-tools',
+        instructions: 'The request method and URL that the webhook should send.'|t('webhooks') ~ ' ' ~ 'Can be set to an environment variable (`$VARIABLE_NAME`) or Twig code.'|t('webhooks'),
         id: 'url',
         errors: webhook.getErrors('url')
     }, urlInput) }}