Table of Contents:
OpenWISP Notifications sends web notifications to recipients through Django's admin site. The following components facilitate browsing web notifications:
A JavaScript widget has been added to make consuming notifications easy for users. The notification widget provides the following features:
- User Interface to help users complete tasks quickly.
- Dynamically loads notifications with infinite scrolling to prevent unnecessary network requests.
- Option to filter unread notifications.
- Option to mark all notifications as read with a single click.
Notification toast delivers notifications in real-time, allowing users to read notifications without opening the notification widget. A notification bell sound is played each time a notification is displayed through the notification toast.
Along with web notifications OpenWISP Notifications also sends email notifications leveraging the :ref:`send_email feature of OpenWISP Utils <utils_send_email>`.
Batching email notifications helps manage the flow of emails sent to users, especially during periods of increased alert activity. By grouping emails into batches, the system minimizes the risk of emails being marked as spam and prevents inboxes from rejecting alerts due to high volumes.
Key aspects of the batch email notification feature include:
- When multiple emails are triggered for the same user within a short time frame, subsequent emails are grouped into a summary.
- The sending of individual emails is paused for a specified batch interval when batching is enabled.
Note
If new alerts are received while a batch is pending, they will be added to the current summary without resetting the timer. The batched email will be sent when the initial batch interval expires.
You can customize the behavior of batch email notifications using the following settings:
- :ref:`OPENWISP_NOTIFICATIONS_EMAIL_BATCH_INTERVAL <openwisp_notifications_email_batch_interval>`.
- :ref:`OPENWISP_NOTIFICATIONS_EMAIL_BATCH_DISPLAY_LIMIT <openwisp_notifications_email_batch_display_limit>`.
In addition to updating notification preferences via the :ref:`preferences page <notification-preferences>`, users can opt out of receiving email notifications using the unsubscribe link included in every notification email.
Furthermore, email notifications include List-Unsubscribe headers, enabling modern email clients to provide an unsubscribe button directly within their interface, offering a seamless opt-out experience.