[feature] Added generic message notification type (shown in dialg box)

README.rst

@@ -527,11 +527,61 @@ value you want but it needs to be unique. For more details read `preventing dupl
 Notification Types
 ------------------
 
-**OpenWISP Notifications** simplifies configuring individual notification by
-using notification types. You can think of a notification type as a template
+**OpenWISP Notifications** allows defining notification types for
+recurring events. Think of a notification type as a template
 for notifications.
 
-These properties can be configured for each notification type:
+``generic_message``
+~~~~~~~~~~~~~~~~~~~
+
+.. figure:: https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/1.1/generic_message.png
+   :target: https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/1.1/generic_message.png
+   :align: center
+
+This module includes a notification type called ``generic_message``.
+
+This notification type is designed to deliver custom messages in the
+user interface for infrequent events or errors that occur during
+background operations and cannot be communicated easily to the user
+in other ways.
+
+These messages may require longer explanations and are therefore
+displayed in a dialog overlay, as shown in the screenshot above.
+This notification type does not send emails.
+
+The following code example demonstrates how to send a notification
+of this type:
+
+.. code-block:: python
+
+    from openwisp_notifications.signals import notify
+    notify.send(
+        type='generic_message',
+        level='error',
+        message='An unexpected error happened!',
+        sender=User.objects.first(),
+        target=User.objects.last(),
+        description="""Lorem Ipsum is simply dummy text
+    of the printing and typesetting industry.
+
+    ### Heading 3
+
+    Lorem Ipsum has been the industry's standard dummy text ever since the 1500s,
+    when an unknown printer took a galley of type and scrambled it to make a
+    type specimen book.
+
+    It has survived not only **five centuries**, but also the leap into
+    electronic typesetting, remaining essentially unchanged.
+
+    It was popularised in the 1960s with the release of Letraset sheets
+    containing Lorem Ipsum passages, and more recently with desktop publishing
+    software like Aldus PageMaker including versions of *Lorem Ipsum*."""
+    )
+
+Properties of Notification Types
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following properties can be configured for each notification type:
 
 +------------------------+----------------------------------------------------------------+
 | **Property**           | **Description**                                                |
@@ -569,8 +619,15 @@ These properties can be configured for each notification type:
 +------------------------+----------------------------------------------------------------+
 
 
-**Note**: A notification type configuration should contain atleast one of ``message`` or ``message_template``
-settings. If both of them are present, ``message`` is given preference over ``message_template``.
+**Note**: It is recommended that a notification type configuration
+for recurring events contains either the ``message`` or
+``message_template`` properties. If both are present,
+``message`` is given preference over ``message_template``.
+
+If you don't plan on using ``message`` or ``message_template``,
+it may be better to use the existing ``generic_message`` type.
+However, it's advised to do so only if the event being notified
+is infrequent.
 
 **Note**: The callable for ``actor_link``, ``action_object_link`` and ``target_link`` should
 have the following signature:

openwisp_notifications/api/serializers.py

@@ -55,10 +55,13 @@ def data(self):
 
 
 class NotificationListSerializer(NotificationSerializer):
+    description = serializers.CharField(source='rendered_description')
+
     class Meta(NotificationSerializer.Meta):
         fields = [
             'id',
             'message',
+            'description',
             'unread',
             'target_url',
             'email_subject',

openwisp_notifications/base/models.py

@@ -105,36 +105,74 @@ def target_url(self):
     def message(self):
         return self.get_message()
 
+    @cached_property
+    def rendered_description(self):
+        if not self.description:
+            return
+        md_description = self._get_formatted_string(self.description)
+        return mark_safe(markdown(md_description))
+
     @property
     def email_message(self):
         return self.get_message(email_message=True)
 
+    def _set_extra_attributes(self, email_message=False):
+        """
+        This method sets extra attributes for the notification
+        which are required to render the notification correctly.
+        """
+        self.actor_link = self.actor_url
+        self.action_link = self.action_url
+        self.target_link = (
+            self.target_url if not email_message else self.redirect_view_url
+        )
+
+    def _delete_extra_attributes(self):
+        """
+        This method removes the extra_attributes set by
+        _set_extra_attributes
+        """
+        for attr in ('actor_link', 'action_link', 'target_link'):
+            delattr(self, attr)
+
+    def _get_formatted_string(self, string, email_message=False):
+        self._set_extra_attributes(email_message=email_message)
+        data = self.data or {}
+        try:
+            formatted_output = string.format(notification=self, **data)
+        except AttributeError as exception:
+            self._invalid_notification(
+                self.pk,
+                exception,
+                'Error encountered in rendering notification message',
+            )
+        self._delete_extra_attributes()
+        return formatted_output
+
     def get_message(self, email_message=False):
         if self.type:
-            # setting links in notification object for message rendering
-            self.actor_link = self.actor_url
-            self.action_link = self.action_url
-            self.target_link = (
-                self.target_url if not email_message else self.redirect_view_url
-            )
             try:
                 config = get_notification_configuration(self.type)
                 data = self.data or {}
-                if 'message' in config:
-                    md_text = config['message'].format(notification=self, **data)
+                if 'message' in data:
+                    md_text = data['message']
+                elif 'message' in config:
+                    md_text = config['message']
                 else:
+                    self._set_extra_attributes(email_message=email_message)
                     md_text = render_to_string(
                         config['message_template'], context=dict(notification=self)
                     ).strip()
-            except (AttributeError, KeyError, NotificationRenderException) as exception:
+                    self._delete_extra_attributes()
+            except (KeyError, NotificationRenderException) as exception:
                 self._invalid_notification(
                     self.pk,
                     exception,
                     'Error encountered in rendering notification message',
                 )
-            # clean up
-            self.actor_link = self.action_link = self.target_link = None
-            return mark_safe(markdown(md_text))
+            return mark_safe(
+                markdown(self._get_formatted_string(md_text, email_message))
+            )
         else:
             return self.description
 

openwisp_notifications/handlers.py

@@ -57,8 +57,8 @@ def notify_handler(**kwargs):
     except NotificationRenderException as error:
         logger.error(f'Error encountered while creating notification: {error}')
         return
-    level = notification_template.get(
-        'level', kwargs.pop('level', Notification.LEVELS.info)
+    level = kwargs.pop(
+        'level', notification_template.get('level', Notification.LEVELS.info)
     )
     verb = notification_template.get('verb', kwargs.pop('verb', None))
     user_app_name = User._meta.app_label

openwisp_notifications/static/openwisp-notifications/css/notifications.css

@@ -257,6 +257,7 @@
 .ow-notification-level-text {
   padding: 0px 6px;
   text-transform: uppercase;
+  font-weight: bold;
 }
 .ow-notification-elem .icon,
 .ow-notification-toast .icon {
@@ -300,6 +301,66 @@
 }
 .ow-notification-elem:last-child .ow-notification-inner { border-bottom: none }
 
+/* Generic notification dialog */
+.ow-overlay-notification {
+  background-color: rgba(0, 0, 0, 0.6);
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  transition: opacity 0.3s;
+}
+.ow-dialog-notification {
+  position: relative;
+  background-color: white;
+  padding: 20px;
+  padding-top: 20px;
+  border-radius: 10px;
+  box-shadow: 0 5px 15px rgba(0, 0, 0, 0.3);
+  width: 90%;
+  max-width: 500px;
+  text-align: left;
+}
+.ow-dialog-notification .ow-notification-date {
+  padding-right: 15px;
+}
+.ow-dialog-notification .button {
+  margin-right: 10px;
+}
+.ow-dialog-notification-level-wrapper {
+  display: flex;
+  justify-content: space-between;
+}
+.ow-dialog-notification .icon {
+  min-height: 15;
+  min-width: 15px;
+  background-repeat: no-repeat;
+}
+.ow-dialog-close-x {
+  cursor: pointer;
+  font-size: 1.75em;
+  position: absolute;
+  display: block;
+  font-weight: bold;
+  top: 3px;
+  right: 10px;
+}
+.ow-dialog-close-x:hover {
+  color: #df5d43;
+}
+.ow-message-title {
+  color: #333;
+  margin-bottom: 10px;
+}
+.ow-message-title a {
+  color: #df5d43;
+}
+.ow-message-title a:hover {
+  text-decoration: underline;
+}
+.ow-dialog-buttons {
+  line-height: 3em;
+}
+
 @media screen and (max-width: 600px) {
   .ow-notification-dropdown {
     width: 98%;