From 352837fd611329fc498c081455b4fa42c3289383 Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <alexander.menshchikov@yandex.ru>
Date: Wed, 22 Mar 2023 09:27:43 +0300
Subject: [PATCH] README about `dispatcher` option for EventListeners

---
 README.md | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 5fb3503..33409fb 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,8 @@
 [OneLogin SAML](https://github.com/onelogin/php-saml) Symfony Bundle.
 
 > This bundle depends on Symfony 6 and newer. <br>
-> For older Symfony versions you can use [hslavich/oneloginsaml-bundle](https://github.com/hslavich/OneloginSamlBundle)
+> For older Symfony versions you can
+> use [hslavich/oneloginsaml-bundle](https://github.com/hslavich/OneloginSamlBundle)
 > which this bundle based on.
 
 ## Installation
@@ -42,7 +43,8 @@ To configure the bundle you need to add configuration in `config/packages/nbgrp_
 You can use any configuration format (yaml, xml, or php), but for convenience in this document will
 be used yaml.
 
-> Check https://github.com/onelogin/php-saml#settings for more info about OneLogin PHP SAML settings.
+> Check https://github.com/onelogin/php-saml#settings for more info about OneLogin PHP SAML
+> settings.
 
 ``` yaml
 nbgrp_onelogin_saml:
@@ -382,4 +384,27 @@ and `Nbgrp\OneloginSamlBundle\EventListener\User\UserModifiedListener` that can
 need to override the default behavior.
 
 Also, you can make your own listeners for `Nbgrp\OneloginSamlBundle\Event\UserCreatedEvent`
-and `Nbgrp\OneloginSamlBundle\Event\UserModifiedEvent` events.
+and `Nbgrp\OneloginSamlBundle\Event\UserModifiedEvent` events:
+
+``` php
+<?php
+
+namespace App\Security;
+
+use Nbgrp\OneloginSamlBundle\Event\UserCreatedEvent;
+use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+#[AsEventListener(event: UserCreatedEvent::class, dispatcher: 'security.event_dispatcher.main')]
+class UserCreatedListener
+{
+    public function __invoke(UserCreatedEvent $event): void
+    {
+        // ...
+    }
+}
+
+```
+
+**Important:** you must specify the `dispatcher` option corresponding the firewall which will
+trigger the event (`main` in the example above). Read more
+about [Security Events](https://symfony.com/doc/current/security.html#security-events).