]> BookStack Code Mirror - bookstack/commitdiff
Added webhook format example to webhook management views
authorDan Brown <redacted>
Sun, 12 Dec 2021 18:02:08 +0000 (18:02 +0000)
committerDan Brown <redacted>
Sun, 12 Dec 2021 18:02:08 +0000 (18:02 +0000)
resources/lang/en/settings.php
resources/views/settings/webhooks/create.blade.php
resources/views/settings/webhooks/edit.blade.php
resources/views/settings/webhooks/parts/format-example.blade.php [new file with mode: 0644]

index 3556fcf64c7dd091254a3a896d7d422bd9e4d489..1cca516c85d6bef1b0f539d7760094475f76c84f 100755 (executable)
@@ -252,6 +252,8 @@ return [
     'webhooks_delete' => 'Delete Webhook',
     'webhooks_delete_warning' => 'This will fully delete this webhook, with the name \':webhookName\', from the system.',
     'webhooks_delete_confirm' => 'Are you sure you want to delete this webhook?',
+    'webhooks_format_example' => 'Webhook Format Example',
+    'webhooks_format_example_desc' => 'Webhook data is sent as a POST request to the configured endpoint as JSON following the format below. The "related_item" and "url" properties are optional and will depend on the type of event triggered.',
 
     //! If editing translations files directly please ignore this in all
     //! languages apart from en. Content will be auto-copied from en.
index d5fd1d38d799fb47e04846787aadebb0ac3999c3..4f20dd07774be933201cbd2f0a85cedef174ada7 100644 (file)
@@ -11,6 +11,8 @@
         <form action="{{ url("/settings/webhooks/create") }}" method="POST">
             @include('settings.webhooks.parts.form', ['title' => trans('settings.webhooks_create')])
         </form>
+
+        @include('settings.webhooks.parts.format-example')
     </div>
 
 @stop
index a221b4ce7fb3b55dd4d93968ec511263b96cc610..3b297eb7bf0bf7766fa23d48924b31edac7d95f2 100644 (file)
@@ -11,6 +11,8 @@
             {!! method_field('PUT') !!}
             @include('settings.webhooks.parts.form', ['model' => $webhook, 'title' => trans('settings.webhooks_edit')])
         </form>
+
+        @include('settings.webhooks.parts.format-example')
     </div>
 
 @stop
diff --git a/resources/views/settings/webhooks/parts/format-example.blade.php b/resources/views/settings/webhooks/parts/format-example.blade.php
new file mode 100644 (file)
index 0000000..135d319
--- /dev/null
@@ -0,0 +1,34 @@
+<div component="code-highlighter" class="card content-wrap auto-height">
+    <h2 class="list-heading">{{ trans('settings.webhooks_format_example') }}</h2>
+    <p>{{ trans('settings.webhooks_format_example_desc') }}</p>
+    <pre><code class="language-json">{
+    "event": "page_update",
+    "text": "Benny updated page \"My wonderful updated page\"",
+    "triggered_at": "2021-12-11T22:25:10.000000Z",
+    "triggered_by": {
+        "id": 1,
+        "name": "Benny",
+        "slug": "benny"
+    },
+    "triggered_by_profile_url": "https://bookstack.local/user/benny",
+    "webhook_id": 2,
+    "webhook_name": "My page update webhook",
+    "url": "https://bookstack.local/books/my-awesome-book/page/my-wonderful-updated-page",
+    "related_item": {
+        "id": 2432,
+        "book_id": 13,
+        "chapter_id": 554,
+        "name": "My wonderful updated page",
+        "slug": "my-wonderful-updated-page",
+        "priority": 2,
+        "created_at": "2021-12-11T21:53:24.000000Z",
+        "updated_at": "2021-12-11T22:25:10.000000Z",
+        "created_by": 1,
+        "updated_by": 1,
+        "draft": false,
+        "revision_count": 9,
+        "template": false,
+        "owned_by": 1
+    }
+}</code></pre>
+</div>
\ No newline at end of file