Notification Preferences

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/25/notifications/preference-page.png

OpenWISP Notifications enables users to customize their notification preferences by selecting their preferred method of receiving updates—either through web notifications or email. These settings are organized by notification type and organization, allowing users to tailor their notification experience by opting to receive updates only from specific organizations or notification types.

Users can access and manage their notification preferences directly from the notification widget by clicking the button highlighted in the screenshot below:

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/25/notifications/notification-preferences-button.png

Alternatively, you can also visit /notification/preferences/ to manage your settings.

Note

  • You can disable notifications globally while still enabling them for specific organizations.

  • Notification settings are now linked: disabling web notifications will automatically disable email notifications, and enabling email notifications will automatically enable web notifications.

  • Deleting notification settings is no longer possible via the web interface (please use the REST API if removal is needed).

Notification settings are automatically generated for all notification types and organizations for every user. Superusers have the ability to manage notification settings for all users, including adding or deleting them. Meanwhile, staff users can modify their preferred notification delivery methods, choosing between receiving notifications via web, email, or both. Additionally, users have the option to disable notifications entirely by turning off both web and email notification settings.

Note

If a user has not configured their preferences for email or web notifications for a specific notification type, the system will default to using the email_notification or web_notification option defined for that notification type.

Organization Settings

Organization managers can configure default notification settings for their organization. These settings act as the baseline for all users in the organization and can be managed via the organization's admin interface.

Organization managers can access and manage the organization's notification settings from the Organization Admin:

  1. Navigate to USERS & ORGANIZATIONS on the left-hand navigation menu.

  2. Go to Organizations.

  3. Click on the specific organization you want to change.

  4. In the NOTIFICATION SETTINGS section, you can change the notification settings for the organization.

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/25/notifications/organization-preferences.png

Key points:

  • New users inherit these default settings automatically.

  • Changes apply to all existing users. For example, disabling email notifications at the organization level disables them for all users in the organization.

  • Users can override these defaults by customizing their own notification preferences.

  • Organization settings override global defaults defined in Django settings (see OPENWISP_NOTIFICATIONS_WEB_ENABLED and OPENWISP_NOTIFICATIONS_EMAIL_ENABLED).

Silencing Notifications for Specific Objects

https://raw.githubusercontent.com/openwisp/openwisp-notifications/docs/docs/images/silence-notifications.png

OpenWISP Notifications allows users to silence all notifications generated by specific objects they are not interested in for a desired period of time or even permanently, while other users will keep receiving notifications normally.

Using the widget on an object's admin change form, a user can disable all notifications generated by that object for a day, week, month or permanently.

Note

This feature requires configuring "OPENWISP_NOTIFICATIONS_IGNORE_ENABLED_ADMIN" to enable the widget in the admin section of the required models.