Slack notifier actions documentation

savvasal · wouterj · commit b9d0d7f261d5 · 2020-02-03T22:17:20.000+01:00
diff --git a/components/notifier.rst b/components/notifier.rst
@@ -177,3 +177,44 @@ Messages higher-level API::
     $message = new ChatMessage('Default Text', $options);
 
     $dsn = 'all(slack://TOKEN@default?channel=CHANNEL telegram://TOKEN@default?channel=CHAT_ID)';
+
+Slack Actions Block for Slack Message
+-------------------------------------
+
+With a Slack Message you can add some interactive options called `Block elements`_::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+    use Symfony\Component\Notifier\Chatter;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackTransport;
+
+    // Initialize a chatter with Slack Transport
+    $chatter = new Chatter(new SlackTransport('token'));
+
+    // Create a message
+    $chatMessage = (new ChatMessage())
+        ->subject('Contribute To Symfony');
+
+    // Create Slack Actions Block and add some buttons
+    $contributeToSymfonyBlocks = (new SlackActionsBlock())
+        ->button(
+            'Improve Documentation',
+            'https://symfony.com/doc/current/contributing/documentation/standards.html',
+            'primary'
+        )
+        ->button(
+            'Report bugs',
+            'https://symfony.com/doc/current/contributing/code/bugs.html',
+            'danger'
+        );
+    $contributeToSymfonyOptions = (new SlackOptions())->block($contributeToSymfonyBlocks);
+
+    // Add the Buttons as Options to the Message
+    $chatMessage->options($contributeToSymfonyOptions);
+
+    // And then send the Message
+    $chatter->send($chatMessage);
+
+
+.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
