feat(accounts): add default notification configuration to settings

Author: michael-smt

docs/admin/config.rst

@@ -809,6 +809,106 @@ DEFAULT_MERGE_STYLE
    * :ref:`component`
    * :ref:`component-merge_style`
 
+.. setting:: DEFAULT_NOTIFICATIONS
+
+DEFAULT_NOTIFICATIONS
+---------------------
+
+Default notification settings for every created user.
+
+A list of 3-tuples consisting of notification scope, notification frequency and notification handler.
+
+Scopes:
+
+``0``
+   :guilabel:`All`
+``10``
+   :guilabel:`Watched`
+``20``
+   :guilabel:`Administered`
+``30``
+   :guilabel:`Project`
+``40``
+   :guilabel:`Component`
+
+Frequencies:
+
+``0``
+   :guilabel:`No notification`
+``1``
+   :guilabel:`Instant notification`
+``2``
+   :guilabel:`Daily digest`
+``3``
+   :guilabel:`Weekly digest`
+``4``
+   :guilabel:`Monthly digest`
+
+Handlers:
+
+``RepositoryNotification``
+   :guilabel:`Operation was performed in the repository`
+``LockNotification``
+   :guilabel:`Component was locked or unlocked`
+``LicenseNotification``
+   :guilabel:`License was changed`
+``ParseErrorNotification``
+   :guilabel:`Parse error occurred`
+``NewStringNotificaton``
+   :guilabel:`String is available for translation`
+``NewContributorNotificaton``
+   :guilabel:`Contributor made their first translation`
+``NewSuggestionNotificaton``
+   :guilabel:`Suggestion was added`
+``LanguageTranslatedNotificaton``
+   :guilabel:`Language was translated`
+``ComponentTranslatedNotificaton``
+   :guilabel:`Component was translated`
+``NewCommentNotificaton``
+   :guilabel:`Comment was added`
+``MentionCommentNotificaton``
+   :guilabel:`You were mentioned in a comment`
+``LastAuthorCommentNotificaton``
+   :guilabel:`Your translation received a comment`
+``TranslatedStringNotificaton``
+   :guilabel:`String was edited by user`
+``ApprovedStringNotificaton``
+   :guilabel:`String was approved`
+``ChangedStringNotificaton``
+   :guilabel:`String was changed`
+``NewTranslationNotificaton``
+   :guilabel:`New language was added or requested`
+``NewComponentNotificaton``
+   :guilabel:`New translation component was created`
+``NewAnnouncementNotificaton``
+   :guilabel:`Announcement was published`
+``NewAlertNotificaton``
+   :guilabel:`New alert emerged in a component`
+``MergeFailureNotification``
+   :guilabel:`Repository operation failed`
+``PendingSuggestionsNotification``
+   :guilabel:`Pending suggestions exist`
+``ToDoStringsNotification``
+   :guilabel:`Unfinished strings exist`
+
+.. note::
+
+   This setting affects only newly created users.
+
+Example:
+
+.. code-block:: python
+
+   DEFAULT_NOTIFICATIONS = [
+       (0, 1, "MentionCommentNotificaton"),
+       (10, 1, "LastAuthorCommentNotificaton"),
+   ]
+
+.. seealso::
+
+   * :ref:`notifications`
+
+
 .. setting:: DEFAULT_SHARED_TM
 
 DEFAULT_SHARED_TM

docs/admin/install/docker.rst

@@ -1090,6 +1090,17 @@ Generic settings
 
    Configures :setting:`DEFAULT_AUTO_WATCH`.
 
+.. envvar:: WEBLATE_DEFAULT_NOTIFICATIONS
+
+   Configures :setting:`DEFAULT_NOTIFICATIONS`.
+
+   **Example:**
+
+   .. code-block:: yaml
+
+       environment:
+         WEBLATE_DEFAULT_NOTIFICATIONS: 0:1:MentionCommentNotificaton,10:1:LastAuthorCommentNotificaton
+
 .. envvar:: WEBLATE_RATELIMIT_ATTEMPTS
 .. envvar:: WEBLATE_RATELIMIT_LOCKOUT
 .. envvar:: WEBLATE_RATELIMIT_WINDOW

docs/changes.rst

@@ -5,6 +5,8 @@ Weblate 2026.7
 
 .. rubric:: New features
 
+* Added :setting:`DEFAULT_NOTIFICATIONS` to configure :ref:`notifications` settings for new users.
+
 .. rubric:: Improvements
 
 * Management interface access control is now more fine-grained with dedicated site-wide permissions.

weblate/accounts/data.py

@@ -4,6 +4,11 @@
 
 from __future__ import annotations
 
+from weblate.accounts.notifications import (
+    NotificationFrequency,
+    NotificationScope,
+)
+
 DEFAULT_ENABLE_AVATARS = True
 DEFAULT_AVATAR_URL_PREFIX = "https://www.gravatar.com/"
 DEFAULT_AVATAR_DEFAULT_IMAGE = "identicon"
@@ -43,3 +48,56 @@
     (10, 3_600),
     (50, 86_400),
 )
+
+DEFAULT_NOTIFICATIONS: list[tuple[NotificationScope, NotificationFrequency, str]] = [
+    (
+        NotificationScope.SCOPE_ALL,
+        NotificationFrequency.FREQ_INSTANT,
+        "MentionCommentNotificaton",
+    ),
+    (
+        NotificationScope.SCOPE_WATCHED,
+        NotificationFrequency.FREQ_INSTANT,
+        "LastAuthorCommentNotificaton",
+    ),
+    (
+        NotificationScope.SCOPE_WATCHED,
+        NotificationFrequency.FREQ_INSTANT,
+        "MentionCommentNotificaton",
+    ),
+    (
+        NotificationScope.SCOPE_WATCHED,
+        NotificationFrequency.FREQ_INSTANT,
+        "NewAnnouncementNotificaton",
+    ),
+    (
+        NotificationScope.SCOPE_WATCHED,
+        NotificationFrequency.FREQ_WEEKLY,
+        "TranslationActivitySummaryNotification",
+    ),
+    (
+        NotificationScope.SCOPE_ADMIN,
+        NotificationFrequency.FREQ_INSTANT,
+        "MergeFailureNotification",
+    ),
+    (
+        NotificationScope.SCOPE_ADMIN,
+        NotificationFrequency.FREQ_INSTANT,
+        "ParseErrorNotification",
+    ),
+    (
+        NotificationScope.SCOPE_ADMIN,
+        NotificationFrequency.FREQ_INSTANT,
+        "NewTranslationNotificaton",
+    ),
+    (
+        NotificationScope.SCOPE_ADMIN,
+        NotificationFrequency.FREQ_INSTANT,
+        "NewAlertNotificaton",
+    ),
+    (
+        NotificationScope.SCOPE_ADMIN,
+        NotificationFrequency.FREQ_INSTANT,
+        "NewAnnouncementNotificaton",
+    ),
+]

weblate/accounts/defaults.py

@@ -41,7 +41,6 @@
 from unidecode import unidecode
 
 from weblate.accounts.avatar import get_user_display
-from weblate.accounts.data import create_default_notifications
 from weblate.accounts.notifications import (
     NOTIFICATIONS,
     NotificationFrequency,
@@ -160,6 +159,8 @@ class WeblateAccountsConf(AppConf):
 
     MAXIMAL_PASSWORD_LENGTH = defaults.DEFAULT_MAXIMAL_PASSWORD_LENGTH
 
+    DEFAULT_NOTIFICATIONS = defaults.DEFAULT_NOTIFICATIONS
+
     # Multi-level rate limiting for email notifications
     # Each tuple contains (max_emails, time_window_seconds)
     RATELIMIT_NOTIFICATION_LIMITS: ClassVar[list[tuple[int, int]]] = list(
@@ -1416,3 +1417,13 @@ def create_profile_callback(sender, instance, created=False, **kwargs) -> None:
         # Create subscriptions
         if not instance.is_anonymous and not instance.is_bot:
             create_default_notifications(instance)
+
+
+def create_default_notifications(user: User) -> None:
+    if WeblateAccountsConf.DEFAULT_NOTIFICATIONS:
+        for scope, frequency, notification in WeblateAccountsConf.DEFAULT_NOTIFICATIONS:
+            user.subscription_set.get_or_create(
+                scope=scope,
+                notification=notification,
+                defaults={"frequency": frequency},
+            )

weblate/accounts/models.py

@@ -15,8 +15,7 @@
 from django.test import SimpleTestCase
 from django.test.utils import override_settings
 
-from weblate.accounts.data import DEFAULT_NOTIFICATIONS
-from weblate.accounts.models import AuditLog, Profile, Subscription
+from weblate.accounts.models import AuditLog, Profile, Subscription, WeblateAccountsConf
 from weblate.accounts.notifications import (
     RECIPIENT_USERNAME_HEADER,
     MergeFailureNotification,
@@ -146,15 +145,15 @@ def test_activity_summary_default_notification(self) -> None:
                 NotificationFrequency.FREQ_WEEKLY,
                 "TranslationActivitySummaryNotification",
             ),
-            DEFAULT_NOTIFICATIONS,
+            WeblateAccountsConf.DEFAULT_NOTIFICATIONS,
         )
         self.assertNotIn(
             (
                 NotificationScope.SCOPE_WATCHED,
                 NotificationFrequency.FREQ_WEEKLY,
                 "NewStringNotificaton",
             ),
-            DEFAULT_NOTIFICATIONS,
+            WeblateAccountsConf.DEFAULT_NOTIFICATIONS,
         )
 
 

weblate/accounts/tests/test_notifications.py

@@ -40,6 +40,7 @@
     get_env_ratelimit,
     get_env_redis_url,
     get_env_str,
+    get_notification_config,
     get_saml_idp,
     modify_env_list,
 )
@@ -1494,6 +1495,8 @@
     "WEBLATE_DEFAULT_AUTO_WATCH", accounts_defaults.DEFAULT_AUTO_WATCH
 )
 
+DEFAULT_NOTIFICATIONS = get_notification_config(accounts_defaults.DEFAULT_NOTIFICATIONS)
+
 DEFAULT_SHARED_TM = get_env_bool(
     "WEBLATE_DEFAULT_SHARED_TM", trans_defaults.DEFAULT_SHARED_TM
 )