settings: Configure 'enable_followed_topic_audible_notifications'.

This commit makes it possible for users to control the
audible desktop notifications for messages sent to followed topics
via a global notification setting.

There is no support for configuring this setting through the UI yet.

api_docs/changelog.md

@@ -25,8 +25,9 @@ format used by the Zulip server that they are interacting with.
 * [`PATCH /realm/user_settings_defaults`](/api/update-realm-user-settings-defaults),
   [`POST /register`](/api/register-queue), [`PATCH /settings`](/api/update-settings):
   Added `enable_followed_topic_email_notifications`, `enable_followed_topic_push_notifications`
-  , `enable_followed_topic_wildcard_mentions_notify` and `enable_followed_topic_desktop_notifications`
-  boolean fields to control email, push, wildcard mention, and visual desktop notifications, respectively,
+  , `enable_followed_topic_wildcard_mentions_notify`, `enable_followed_topic_desktop_notifications`
+  and `enable_followed_topic_audible_notifications` boolean fields to control email,
+  push, wildcard mention, visual desktop and audible desktop notifications, respectively,
   for messages sent to followed topics.
 
 **Feature level 188**

zerver/models.py

@@ -1726,6 +1726,7 @@ class UserBaseSettings(models.Model):
         enable_followed_topic_desktop_notifications=bool,
         enable_followed_topic_email_notifications=bool,
         enable_followed_topic_push_notifications=bool,
+        enable_followed_topic_audible_notifications=bool,
         enable_followed_topic_wildcard_mentions_notify=bool,
     )
 

zerver/openapi/zulip.yaml

@@ -9771,6 +9771,15 @@ paths:
           description: |
             Enable push notifications for messages sent to followed topics.
 
+            **Changes**: New in Zulip 8.0 (feature level 189).
+          schema:
+            type: boolean
+          example: false
+        - name: enable_followed_topic_audible_notifications
+          in: query
+          description: |
+            Enable audible desktop notifications for messages sent to followed topics.
+
             **Changes**: New in Zulip 8.0 (feature level 189).
           schema:
             type: boolean
@@ -11894,6 +11903,12 @@ paths:
                             description: |
                               Enable push notifications for messages sent to followed topics.
 
+                              **Changes**: New in Zulip 8.0 (feature level 189).
+                          enable_followed_topic_audible_notifications:
+                            type: boolean
+                            description: |
+                              Enable audible desktop notifications for messages sent to followed topics.
+
                               **Changes**: New in Zulip 8.0 (feature level 189).
                           email_notifications_batching_period_seconds:
                             type: integer
@@ -13979,6 +13994,12 @@ paths:
                             description: |
                               Enable push notifications for messages sent to followed topics.
 
+                              **Changes**: New in Zulip 8.0 (feature level 189).
+                          enable_followed_topic_audible_notifications:
+                            type: boolean
+                            description: |
+                              Enable audible desktop notifications for messages sent to followed topics.
+
                               **Changes**: New in Zulip 8.0 (feature level 189).
                           enable_digest_emails:
                             type: boolean
@@ -15143,6 +15164,15 @@ paths:
           description: |
             Enable push notifications for messages sent to followed topics.
 
+            **Changes**: New in Zulip 8.0 (feature level 189).
+          schema:
+            type: boolean
+          example: false
+        - name: enable_followed_topic_audible_notifications
+          in: query
+          description: |
+            Enable audible desktop notifications for messages sent to followed topics.
+
             **Changes**: New in Zulip 8.0 (feature level 189).
           schema:
             type: boolean

zerver/views/realm.py

@@ -435,6 +435,9 @@ def update_realm_user_settings_defaults(
     enable_followed_topic_push_notifications: Optional[bool] = REQ(
         json_validator=check_bool, default=None
     ),
+    enable_followed_topic_audible_notifications: Optional[bool] = REQ(
+        json_validator=check_bool, default=None
+    ),
     enable_followed_topic_wildcard_mentions_notify: Optional[bool] = REQ(
         json_validator=check_bool, default=None
     ),

zerver/views/user_settings.py

@@ -202,6 +202,9 @@ def json_change_settings(
     enable_followed_topic_push_notifications: Optional[bool] = REQ(
         json_validator=check_bool, default=None
     ),
+    enable_followed_topic_audible_notifications: Optional[bool] = REQ(
+        json_validator=check_bool, default=None
+    ),
     enable_followed_topic_wildcard_mentions_notify: Optional[bool] = REQ(
         json_validator=check_bool, default=None
     ),