README about dispatcher option for EventListeners

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).