[FEATURE] Assign notification and event instances to email view (#176)

Two new variables become accessible in the template of an email:

- `{notification}` – contains the notification instance
- `{event}` – contains the event instance

Classes/Domain/Notification/Email/Application/EntityEmail/Service/EntityEmailTemplateBuilder.php

@@ -101,6 +101,8 @@ public function getBody()
 
         $view->assign('layout', $layout->getPath());
         $view->assign('markers', $this->markers);
+        $view->assign('notification', $this->notification);
+        $view->assign('event', $this->event);
 
         return $view->renderWithSlots($this->notification->getBodySlots(), $this->markers);
     }

Documentation/04-Notification/Email/01-DynamicBody.rst

@@ -82,6 +82,12 @@ The template below can now be created.
       template; see chapter “:ref:`events-property-marker`” for more
       information.
 
+    - ``{notification}`` – contains the notification instance; see chapter
+      “:ref:`administrator-objects-notification`” for more information.
+
+    - ``{event}`` – contains the event instance; see chapter
+      “:ref:`administrator-objects-event`” for more information.
+
 .. code-block:: html
     :caption: ``EXT:my_extension/Resources/Private/Templates/Mail/ContactEvents/MessageSent.html``
 

Documentation/06-Administrator/06-Objects/Index.rst

@@ -0,0 +1,96 @@
+.. include:: ../../Includes.txt
+
+PHP objects
+===========
+
+.. _administrator-objects-notification:
+
+Notification
+------------
+
+A notification implements the interface
+:php:`\CuyZ\Notiz\Core\Notification\Notification`, giving access to the methods
+below.
+
+.. tip::
+
+    Please note that depending on the type of the notification, even more
+    methods can be available.
+
+.. container:: table-row
+
+    Method
+        :php:`Notification::getTitle()`
+    Return type
+        :php:`string`
+    Description
+        Returns the title of the notification.
+
+.. container:: table-row
+
+    Method
+        :php:`Notification::getNotificationDefinition()`
+    Return type
+        :php:`\CuyZ\Notiz\Core\Definition\Tree\Notification\NotificationDefinition`
+    Description
+        Returns the definition object of the notification.
+
+.. container:: table-row
+
+    Method
+        :php:`Notification::hasEventDefinition()`
+    Return type
+        :php:`bool`
+    Description
+        Returns whether the notification is bound to an event or not.
+
+.. container:: table-row
+
+    Method
+        :php:`Notification::getEventDefinition()`
+    Return type
+        :php:`\CuyZ\Notiz\Core\Definition\Tree\EventGroup\Event\EventDefinition`
+    Description
+        Returns the definition object of the event bound to the notification.
+        If no event is bound, an exception is thrown.
+
+.. container:: table-row
+
+    Method
+        :php:`Notification::getEventConfiguration()`
+    Return type
+        :php:`array`
+    Description
+        Returns the configuration of the event. If no configuration is found, an
+        empty array is returned.
+
+.. _administrator-objects-event:
+
+Event
+-----
+
+An event implements the interface :php:`\CuyZ\Notiz\Core\Event\Event`, giving
+access to the following methods:
+
+.. tip::
+
+    Please note that depending on the type of the event, even more methods can
+    be available.
+
+.. container:: table-row
+
+    Method
+        :php:`Event::getDefinition()`
+    Return type
+        :php:`\CuyZ\Notiz\Core\Definition\Tree\EventGroup\Event\EventDefinition`
+    Description
+        Returns the definition object of the event.
+
+.. container:: table-row
+
+    Method
+        :php:`Event::getNotification()`
+    Return type
+        :php:`\CuyZ\Notiz\Core\Notification\Notification`
+    Description
+        Returns the notification that is being dispatched by this event.