@@ -14,33 +14,34 @@ OpenWISP Notifications sends web notifications to recipients through
14
14
Django's admin site. The following components facilitate browsing web
15
15
notifications:
16
16
17
- Notification Widget
18
- ~~~~~~~~~~~~~~~~~~~
17
+ Widget
18
+ ~~~~~~
19
19
20
20
.. figure :: https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/notification-widget.gif
21
21
:target: https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/notification-widget.gif
22
22
:align: center
23
23
24
- A JavaScript widget has been added to make consuming notifications easy
25
- for users. The notification widget provides the following features:
24
+ The OpenWISP admin includes a notifications widget with the following
25
+ features:
26
26
27
- - User Interface to help users complete tasks quickly.
28
- - Dynamically loads notifications with infinite scrolling to prevent
29
- unnecessary network requests.
30
- - Option to filter unread notifications.
27
+ - Infinite scroll to load notifications dynamically and smoothly.
28
+ - Button to mark all as read.
31
29
- Button to edit :doc: `notification-preferences `.
32
30
33
- Notification Toasts
34
- ~~~~~~~~~~~~~~~~~~~
31
+ Toasts
32
+ ~~~~~~
35
33
36
34
.. figure :: https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/notification-toast.gif
37
35
:target: https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/notification-toast.gif
38
36
:align: center
39
37
40
- Notification toast delivers notifications in real-time, allowing users to
41
- read notifications without opening the notification widget. A notification
42
- bell sound is played each time a notification is displayed through the
43
- notification toast.
38
+ Notification toasts display messages in real time, so users can read them
39
+ without opening the widget. A bell sound plays each time a toast is shown.
40
+
41
+ To prevent overload, an anti-storm mechanism temporarily disables toasts
42
+ when many notifications arrive in a short time. Refer to
43
+ :ref: `openwisp_notifications_notification_storm_prevention ` for more
44
+ information.
44
45
45
46
.. _notifications_email_notifications :
46
47
@@ -65,9 +66,11 @@ Email Batches
65
66
:align: center
66
67
67
68
Batching email notifications helps manage the flow of emails sent to
68
- users, especially during periods of increased alert activity. By grouping
69
- emails into batches, the system minimizes the risk of emails being marked
70
- as spam and prevents inboxes from rejecting alerts due to high volumes.
69
+ users, especially during periods of increased alert activity.
70
+
71
+ By grouping emails into batches, the system minimizes the risk of emails
72
+ being marked as spam and prevents inboxes from rejecting alerts due to
73
+ high volumes.
71
74
72
75
Key aspects of the batch email notification feature include:
73
76
0 commit comments