init doc

Author: ismail1432

notifier/events.rst

@@ -0,0 +1,38 @@
+.. index::
+    single: Notifier; Events
+
+Using Events
+============
+
+The Transport class of the Notifier component allows you to optionally hook
+into the lifecycle via events. Instead of reinventing
+the wheel, it uses the Symfony EventDispatcher component to do the work::
+
+
+The ``MessageEvent`` Event
+--------------------------
+
+**Typical Purposes**: Doing something before the message is send (like logging
+which message is going to be send), or displaying something about the event
+to be executed.
+
+Just before executing any command, the ``MessageEvent`` event is
+dispatched. Listeners receive a
+:class:`Symfony\\Component\\Notifier\\Event\\MessageEvent` event::
+
+    use Symfony\Component\Notifier\Event\MessageEvent;
+
+    $dispatcher->addListener(MessageEvent::class, function (MessageEvent $event) {
+        // gets the message instance
+        $message = $event->getMessage();
+
+       // log something
+       $this->logger(sprintf("Message with subject: %s will be send to %s, $message->getSubject(), $message->getRecipientId()");
+    });
+
+The ``SentMessageEvent`` Event
+--------------------------
+
+**Typical Purposes**: Doing something when the message is sent (like retrieve the id returned
+when the message is sent).
+