1.2.3 [2026-06-04]

Bugfixes

• Filtered out soft-deleted notification settings in preferences API #452
• Fixed accidental email delivery for generic_message notifications #478
• Restrict notification preferences page to staff or super users #462
• Create global notification settings for non-org admin staff users #453

1.2.2 [2026-05-12]

Bugfixes

• Fixed multiple bugs affecting notification preferences #448:
  1. Creating a new organization ignored the user's global notification preferences.
  2. Promoting or adding an organization admin did not respect global preferences.
  3. Changes to organization-level settings could overwrite user-specific preferences.

1.2.1 [2025-11-27]

Bugfixes

• Fixed accidental overwriting of user preferences #427

1.2.0 [2025-10-23]

Features

• Added dedicated notification preferences page.
• Added organization notification settings.
• Added Email Batch Summary.
• Added email verification warning #281.

Changes

Other changes

• Improved UI of email notifications.
• Disallowed changing preferences for generic\_message notification type #359.
• Dropped dependency on django-notifications #353.
• Removed deprecated code for updating superuser notification settings #283.

Dependencies

• Bumped openwisp-users~=1.2.0.
• Bumped openwisp-utils~=1.2.0.
• Bumped markdown~=3.9.
• Added support for Django 5.x.
• Added support for Python 3.11, 3.12, and 3.13.
• Dropped support for Django 3.2 and 4.1.
• Dropped support for Python 3.8.

Bugfixes

• Prevented notification toast from appearing while leaving a page #264.
• Ensured notification widget closes only on user-initiated clicks.
• Fixed notification widget loading on non-admin pages #271.
• Allowed overriding openwisp\_users app label in tests.
• Hid notification preferences for disabled organizations #366.
• Fixed JavaScript logic for creating notification toasts.
• Fixed issue with notification widget removing URL fragments.

1.1.1 [2025-01-31]

Bugfixes

• Fixed unnecessary triggering of update_superuser_notification_settings celery task.

1.1.0 [2024-11-20]

Features

• Added support for defining related object links in notification configurations.
• Introduced a "generic_message" notification type to deliver custom notifications in the user interface.
• Enabled filtering of NotificationSetting using organization_slug in the REST API.

Changes

• Only users with verified email addresses will receive email notifications.

Dependencies

• Bumped django-notifications-hq~=1.8.3.
• Bumped markdown~=3.6.0.
• Bumped openwisp-users~=1.1.0.
• Bumped openwisp-utils[rest,celery]~=1.1.1.
• Added support for Python 3.10.
• Dropped support for Python 3.7.
• Added support for Django 4.2.x.
• Dropped support for Django 4.0.x.

Bugfixes

• Fixed issue where users received multiple identical notifications when members of multiple organizations.
• Increased timeoutInterval for the ReconnectingWebSocket to 7 seconds to prevent termination due to timeout on slow network connections.

1.0.3 [2022-08-03]

Bugfixes

• Flagged tests that should not be run on a production environment:
  These tests depend on the static storage backend of the project. In
  a production environment, the filenames could get changed due to
  static minification and cache invalidation. Hence, these tests
  should not be run on the production environment because they’ll
  fail.

1.0.2 [2022-07-01]

Bugfixes

• Fixed hardcoded static image URLs. These created issues when
  static files are served using an external service (e.g. S3 storage
  buckets).
• Fixed "Organization.DoesNotExist" error on creating a new
  organization.

1.0.1 [2022-06-09]

Bugfixes

• Fixed handling of the "OPENWISP_NOTIFICATIONS_SOUND" setting. The code was not passing the sound file path to the utilities of django.contrib.staticfiles and hence the sound file was not loaded properly when using different static storage backend.

1.0.0 [2022-04-28]

Features

• Introduced mechanism to clear cache on specific signals

Changes

Backward incompatible changes

• Removed notification widget and toast template tags: the template
  tags "notification_widget" and "notification_toast" have been
  removed and their HTML is added directly to the admin/base_site.html
  template
• Changed the API URL prefix to make it consistent with other OpenWISP
  modules

Dependencies

• Dropped support for Python 3.6
• Added support for Python 3.8 and 3.9
• Dropped support for Django 2.2
• Added support for Django 3.2 and 4.0
• Updated django channels to 3.0.x
• Upgraded celery to 5.2.x
• Upgraded openwisp-utils to 1.0.x

Other changes

• Restyled widget to new OpenWISP theme plus various UI fixes and
  improvements
• Restyled notification email template
• When clicking on the mark as read button, the notification widget
  now instantaneously marks notification as read instead of waiting
  for the API response
• Added models parameter to register_notification_type
• Switch to openwisp-utils email template
• Optimized query for flagging all notification as read via API
• Added celery time limits to tasks except delete_old_notifications
  (which may take a long time to finish in big installations)
• Changed wording of "unsubscribe" button, which has been renamed to
  "Silence notifications"
• Added dedicated channel layer group for each user to avoid
  generating warnings like
  63 of 67 channels over capacity in group ow_notification

Bugfixes

• Fixed a bug which caused to lose notification preferences of users
• Fixed extensibility of openwisp-users: removed openwisp-users as a
  direct dependency from migrations file because it was creating
  issues when extending openwisp-users
• Fixed multiple jquery inclusions in base_site.html
• Fixed WSS connection error when running on http
• Fixed creation of notification settings for superuser
• Fixed unregistered notification type breaking API
• Fixed closing notification toast on slow connections
• Fixed notification storms: when many notifications are created due
  to severe network outages, the UI is not flooded anymore
• Fixed browsable API view for NotificationReadAllView
• Added error handling for sending emails when notification settings
  for a specific user are not present
• Fixed unsubscribe / silence notifications button alignment
• Fixed Swagger API doc issues
• Fixed create_notification command to honor organization
  notification preferences