settings: Configure 'enable_followed_topic_desktop_notifications'.

This commit makes it possible for users to control the
visual 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`
-  and `enable_followed_topic_wildcard_mentions_notify` boolean fields to control email, push
+  , `enable_followed_topic_wildcard_mentions_notify` and `enable_followed_topic_desktop_notifications`
-  and wildcard mention notifications, respectively, for messages sent to followed topics.
+  boolean fields to control email, push, wildcard mention, and visual desktop notifications, respectively,
+  for messages sent to followed topics.
 
 **Feature level 188**
 

zerver/models.py

@@ -1723,6 +1723,7 @@ class UserBaseSettings(models.Model):
 
     modern_notification_settings: Dict[str, Any] = dict(
         # Add new notification settings here.
+        enable_followed_topic_desktop_notifications=bool,
         enable_followed_topic_email_notifications=bool,
         enable_followed_topic_push_notifications=bool,
         enable_followed_topic_wildcard_mentions_notify=bool,

zerver/openapi/zulip.yaml

@@ -9748,6 +9748,15 @@ paths:
           schema:
             type: boolean
           example: true
+        - name: enable_followed_topic_desktop_notifications
+          in: query
+          description: |
+            Enable visual desktop notifications for messages sent to followed topics.
+
+            **Changes**: New in Zulip 8.0 (feature level 189).
+          schema:
+            type: boolean
+          example: true
         - name: enable_followed_topic_email_notifications
           in: query
           description: |
@@ -11868,6 +11877,12 @@ paths:
                             description: |
                               Enable audible desktop notifications for private messages and
                               @-mentions.
+                          enable_followed_topic_desktop_notifications:
+                            type: boolean
+                            description: |
+                              Enable visual desktop notifications for messages sent to followed topics.
+
+                              **Changes**: New in Zulip 8.0 (feature level 189).
                           enable_followed_topic_email_notifications:
                             type: boolean
                             description: |
@@ -13947,6 +13962,12 @@ paths:
                             description: |
                               Enable mobile notification for private messages and @-mentions received
                               when the user is online.
+                          enable_followed_topic_desktop_notifications:
+                            type: boolean
+                            description: |
+                              Enable visual desktop notifications for messages sent to followed topics.
+
+                              **Changes**: New in Zulip 8.0 (feature level 189).
                           enable_followed_topic_email_notifications:
                             type: boolean
                             description: |
@@ -15099,6 +15120,15 @@ paths:
           schema:
             type: boolean
           example: true
+        - name: enable_followed_topic_desktop_notifications
+          in: query
+          description: |
+            Enable visual desktop notifications for messages sent to followed topics.
+
+            **Changes**: New in Zulip 8.0 (feature level 189).
+          schema:
+            type: boolean
+          example: true
         - name: enable_followed_topic_email_notifications
           in: query
           description: |

zerver/views/realm.py

@@ -426,6 +426,9 @@ def update_realm_user_settings_defaults(
         json_validator=check_bool, default=None
     ),
     wildcard_mentions_notify: Optional[bool] = REQ(json_validator=check_bool, default=None),
+    enable_followed_topic_desktop_notifications: Optional[bool] = REQ(
+        json_validator=check_bool, default=None
+    ),
     enable_followed_topic_email_notifications: Optional[bool] = REQ(
         json_validator=check_bool, default=None
     ),

zerver/views/user_settings.py

@@ -193,6 +193,9 @@ def json_change_settings(
         json_validator=check_bool, default=None
     ),
     wildcard_mentions_notify: Optional[bool] = REQ(json_validator=check_bool, default=None),
+    enable_followed_topic_desktop_notifications: Optional[bool] = REQ(
+        json_validator=check_bool, default=None
+    ),
     enable_followed_topic_email_notifications: Optional[bool] = REQ(
         json_validator=check_bool, default=None
     ),