diff --git a/source/_images/educator_concepts/Notificaitons_grouping_ORA_screenshot.png b/source/_images/educator_concepts/Notificaitons_grouping_ORA_screenshot.png deleted file mode 100644 index 7b105d569..000000000 Binary files a/source/_images/educator_concepts/Notificaitons_grouping_ORA_screenshot.png and /dev/null differ diff --git a/source/_images/educator_concepts/Notification_daily_email_screenshot.png b/source/_images/educator_concepts/Notification_daily_email_screenshot.png deleted file mode 100644 index 47bd8fce8..000000000 Binary files a/source/_images/educator_concepts/Notification_daily_email_screenshot.png and /dev/null differ diff --git a/source/_images/educator_concepts/Notifications_tray_forum_screenshot.png b/source/_images/educator_concepts/Notifications_tray_forum_screenshot.png deleted file mode 100644 index 66033faba..000000000 Binary files a/source/_images/educator_concepts/Notifications_tray_forum_screenshot.png and /dev/null differ diff --git a/source/_images/educator_concepts/Notifications_tray_grading_screenshot.png b/source/_images/educator_concepts/Notifications_tray_grading_screenshot.png deleted file mode 100644 index 8cd0eed78..000000000 Binary files a/source/_images/educator_concepts/Notifications_tray_grading_screenshot.png and /dev/null differ diff --git a/source/_images/educator_concepts/Notifications_tray_screenshot.png b/source/_images/educator_concepts/Notifications_tray_screenshot.png deleted file mode 100644 index 5bea22ac6..000000000 Binary files a/source/_images/educator_concepts/Notifications_tray_screenshot.png and /dev/null differ diff --git a/source/_images/educator_concepts/Notifications_tray_updates_screenshot.png b/source/_images/educator_concepts/Notifications_tray_updates_screenshot.png deleted file mode 100644 index 486eb7565..000000000 Binary files a/source/_images/educator_concepts/Notifications_tray_updates_screenshot.png and /dev/null differ diff --git a/source/_images/learners/Discussions_notification_activity.png b/source/_images/learners/Discussions_notification_activity.png deleted file mode 100644 index c9b1c76f9..000000000 Binary files a/source/_images/learners/Discussions_notification_activity.png and /dev/null differ diff --git a/source/_images/learners/Notification_daily_email_screenshot.png b/source/_images/learners/Notification_daily_email_screenshot.png new file mode 100644 index 000000000..e7a8c70d1 Binary files /dev/null and b/source/_images/learners/Notification_daily_email_screenshot.png differ diff --git a/source/_images/learners/Notification_daily_email_screenshot_learner.png b/source/_images/learners/Notification_daily_email_screenshot_learner.png deleted file mode 100644 index 455c5bc99..000000000 Binary files a/source/_images/learners/Notification_daily_email_screenshot_learner.png and /dev/null differ diff --git a/source/_images/learners/Notification_tray_forum_notifications_learner.png b/source/_images/learners/Notification_tray_forum_notifications_learner.png deleted file mode 100644 index 13815d4ee..000000000 Binary files a/source/_images/learners/Notification_tray_forum_notifications_learner.png and /dev/null differ diff --git a/source/_images/learners/Notifications_preferences.png b/source/_images/learners/Notifications_preferences.png new file mode 100644 index 000000000..a8aec60c6 Binary files /dev/null and b/source/_images/learners/Notifications_preferences.png differ diff --git a/source/_images/learners/Notifications_tray_grading_screenshot_learner.png b/source/_images/learners/Notifications_tray_grading_screenshot_learner.png deleted file mode 100644 index ec1d2df70..000000000 Binary files a/source/_images/learners/Notifications_tray_grading_screenshot_learner.png and /dev/null differ diff --git a/source/_images/learners/Notifications_tray_screenshot.png b/source/_images/learners/Notifications_tray_screenshot.png index 5bea22ac6..d8f31d26f 100644 Binary files a/source/_images/learners/Notifications_tray_screenshot.png and b/source/_images/learners/Notifications_tray_screenshot.png differ diff --git a/source/_images/learners/Notifications_tray_updates_screenshot.png b/source/_images/learners/Notifications_tray_updates_screenshot.png deleted file mode 100644 index 486eb7565..000000000 Binary files a/source/_images/learners/Notifications_tray_updates_screenshot.png and /dev/null differ diff --git a/source/educators/concepts/communication/notifications_preferences.rst b/source/educators/concepts/communication/notifications_preferences.rst index 86894e2dd..63ecf3cbf 100644 --- a/source/educators/concepts/communication/notifications_preferences.rst +++ b/source/educators/concepts/communication/notifications_preferences.rst @@ -6,189 +6,18 @@ Notifications & Preferences .. tags:: educator, concept -.. contents:: - :local: - :depth: 1 +Notifications help you stay informed about activity in your courses. You can view notifications while +on the platform or receive them by email, depending on your preferences. -Notifications keep you informed about activity in your courses. +For details of notifications and preferences available for all users on the platform, +see :ref:`Notifications & Preferences`. -.. _Notification Types: -Notification Types -################## -Discussions Notifications -************************* +**Maintenance chart** -#. Activity notifications: New responses or comments on your posts and the ones you are following, and endorsements to your responses and the ones on your post. -#. New discussion posts: When a new discussion post is created. -#. New question posts: When a new question post is created. -#. Reported content: When content is reported. - - #. This notification is only sent to users having a forum moderator role (discussion admin, discussion moderator, community TA and group community TA). - -#. New posts from instructors: When the instructor creates a post and chooses to notify the learners. - - -.. image:: /_images/educator_concepts/Notifications_tray_forum_screenshot.png - :width: 400 - :align: center - :alt: Clicking the bell on the top right opens the notifications tray. - -Updates -******** - -#. Course updates: When the instructor creates a new course update. - -.. image:: /_images/educator_concepts/Notifications_tray_updates_screenshot.png - :width: 400 - :align: center - :alt: Screenshot of a course update notification in tray. - -Grading -******** - -#. ORA grade received: When your submission for an open response assessment (ORA) receives a grade. -#. ORA new submissions: When a learner submits an ORA that requires staff grading. - - #. This notification is only sent to users having a course staff or course admin role. - -.. image:: /_images/educator_concepts/Notifications_tray_grading_screenshot.png - :width: 400 - :align: center - :alt: Screenshot of all grading notifications in tray. - - -.. _Delivery Channels: - -Delivery Channels -################# - -Tray -**** - -- The intent of notification tray is to keep users informed while they're on the web platform. -- A bell icon in the top-right corner displays the count of unread notifications. -- When clicked, it opens a tray that organizes notifications into tabs based on platform area (Discussions, Grading, Updates). -- Each notification includes the relevant course's name, a red dot to indicate it's unread (not clicked), and a timestamp showing when it was generated. -- A gear icon in the tray's top-right corner links to the preferences center, where users can adjust their notification settings. - -.. image:: /_images/educator_concepts/Notifications_tray_screenshot.png - :width: 700 - :align: center - :alt: Clicking the bell on the top right opens the notifications tray. - -Email Notifications -******************* - -- The intent of notification email is to keep users informed even when they're away from the platform. -- Users can choose to get notified immediately or to receive a daily or weekly summary of notifications. - - - Immediately: Receive the email notification as soon as the activity happens. - - Daily: Receive a summary of notifications for the past 24 hours, everyday at 2200hrs UTC. - - Weekly: Receive a summary of notifications for the past 7 days, everyday Saturday at 2200hrs UTC. - -- Emails have a one-click unsubscribe option which allows turning off email notifications for all activity types. - -.. image:: /_images/educator_concepts/Notification_daily_email_screenshot.png - :width: 400 - :align: center - :alt: Screenshot of email having daily summary of notifications. - -.. _Managing Preferences: - -Managing Preferences -#################### - -Preferences center allows users to control which notifications they receive, how often, and through which channel. Users can get to the preferences page via: - -- “Notifications” tab on the “Account Settings” page. -- Gear icon in top right corner in the notification tray. -- “Notification Settings” link in email. - -For each preference: - -- Users can toggle tray and email preference ON or OFF. -- Users can set cadence for email notifications: Immediately, Daily and Weekly. - -.. image:: /_images/educator_concepts/Preference_center.png - :width: 700 - :align: center - :alt: Screenshot of preference center on Account Settings. - - -Default Settings -***************** - -- High-value notifications have tray and email ON by default. - - - “New posts from instructors” and “Course updates” are exceptions where email is OFF by default to prevent high volume/cost of email due to courses with large enrollments. - -- High-volume notifications (e.g., new discussion posts) are OFF by default to prevent clutter. -- Email cadence default is set to “Daily” for all preferences where email default ON. - -The table below shows defaults for each notification type. - -.. list-table:: - :widths: 25 25 25 25 - :align: center - :header-rows: 1 - - * - Preference - - Default Tray Preference - - Default Email Preference - - Visibility - * - Activity notifications - - ON - - ON / Daily - - All - * - New discussion posts - - OFF - - OFF - - All - * - New question qosts - - OFF - - OFF - - All - * - New posts from instructors - - ON - - ON - - All - * - Reported content - - ON - - ON / Daily - - Forum moderators - * - Course updates - - ON - - OFF - - All - * - Essay assignment grade received - - ON - - ON / Daily - - All - * - New ORA submission for staff grading - - ON - - OFF - - Course staff, Course admin - -.. _Notifications Grouping: - -Notifications Grouping -###################### - -High-volume notifications, such as new discussion posts or new ORA submissions, can clutter the notification tray. This clutter reduces the visibility of other important notifications, making it challenging for users to stay informed effectively. As a result, crucial but potentially high-volume notifications need to be turned off by default to avoid overwhelming users. The notification grouping feature mitigates this issue by combining similar notifications into a single, unified notification, based on their context. Currently, grouping is supported for two notification types: - -- New discussion posts: Notifications are grouped by the specific course. -- New ORA submissions: Notifications are grouped by the ORA assignment ID. - -.. image:: /_images/educator_concepts/Notificaitons_grouping_ORA_screenshot.png - :width: 400 - :align: center - :alt: Screenshot of grouped and ungrouped ORA submission received notification. - -.. _Notifications Expiry: - -Notifications Expiry -###################### - -Everyday, notifications older than 60 days are deleted from the database to keep the storage in control. Developers can change this duration from the django settings page. ++--------------+-------------------------------+----------------+--------------------------------+ +| Review Date | Working Group Reviewer | Release | Test situation | ++--------------+-------------------------------+----------------+--------------------------------+ +| Dec 15, 2025 | Aamir Ayub | Ulmo | | ++--------------+-------------------------------+----------------+--------------------------------+ \ No newline at end of file diff --git a/source/learners/sfd_discussions/discussions_notifications.rst b/source/learners/sfd_discussions/discussions_notifications.rst index 73f0050f5..5956c1b12 100644 --- a/source/learners/sfd_discussions/discussions_notifications.rst +++ b/source/learners/sfd_discussions/discussions_notifications.rst @@ -14,19 +14,65 @@ Discussion notifications keep you informed when others interact with your posts There are four notification preferences for Discussions: 1. **Activity notifications**: Notifies you of all activity related to posts or responses you've authored or are following. -2. **New question posts**: Notifies you when someone creates a new question type post in your course. +2. **New posts from instructors**: Notifies you when an instructor creates a post. 3. **New discussion posts**: Notifies you when someone creates a new discussion type post. -4. **New posts from instructors**: Notifies you when an instructor or staff member creates a post. - -The table in the image below shows which activity types trigger notifications. Several activity types are grouped -into a single preference to avoid clutter in preferences. - -.. figure:: /_images/learners/Discussions_notification_activity.png - :alt: Table listing discussion activity types, their preference names, recipients and defaults - :width: 800 - :align: center - - Table listing discussion activity types, their preference names, recipients and defaults. +4. **New question posts**: Notifies you when someone creates a new question type post. + +Table below shows which activity types trigger notifications. Several activity types are +grouped into a single preference to avoid clutter in preferences. + + +.. flat-table:: Table listing discussion notification types, including activity and preference name, audience and defaults. + :header-rows: 1 + + * - # + - Activity + - Recipients + - Preference Name + - Tray Default + - Email Default + * - 1 + - New response on your post + - Post author + - :rspan:`6` Activity Notifications + - :rspan:`6` ON + - :rspan:`6` Daily + * - 2 + - New comment on your post + - Post author + * - 3 + - New comment on your response + - Response author + * - 4 + - New response on a post you follow + - Post follower + * - 5 + - New comment on a post you follow + - Post follower + * - 6 + - Response on your post is endorsed + - Post author + * - 7 + - Your response is endorsed + - Response author + * - 8 + - A new discussion-type post + - Anyone + - New discussion posts + - OFF + - OFF + * - 9 + - A new question-type post + - Anyone + - New question posts + - OFF + - OFF + * - 10 + - A new post from the course instructor + - Anyone + - New posts from instructors + - ON + - Daily .. note:: Learn more about notifications in :ref:`Notifications & Preferences`. @@ -34,7 +80,6 @@ into a single preference to avoid clutter in preferences. .. seealso:: - :ref:`Getting started with Discussions` :ref:`Finding and Following the Right Conversations` @@ -47,5 +92,5 @@ into a single preference to avoid clutter in preferences. +--------------+-------------------------------+----------------+--------------------------------+ | Review Date | Working Group Reviewer | Release | Test situation | +--------------+-------------------------------+----------------+--------------------------------+ -| 3rd Dec, 2025| Aamir Ayub | Ulmo | Pass | +| Dec 11, 2025 | Aamir Ayub | Ulmo | | +--------------+-------------------------------+----------------+--------------------------------+ diff --git a/source/learners/sfd_notifications/index.rst b/source/learners/sfd_notifications/index.rst index 794dd927e..568aeeb66 100644 --- a/source/learners/sfd_notifications/index.rst +++ b/source/learners/sfd_notifications/index.rst @@ -4,152 +4,182 @@ Notifications & Preferences ########################### -Notifications keep you informed about activity in your courses. +Notifications help you stay informed about activity in your courses. You can view notifications while +on the platform or receive them by email, depending on your preferences. -.. _notification-types: +.. contents:: + :local: + :depth: 1 -Notification Types -================== +.. _Where Notifications Appear: -Discussion Notifications ------------------------- +Where Notifications Appear +=========================== -#. Activity notifications: New responses or comments on your posts and on posts you follow, and endorsements **of** your responses and of responses on your posts. -#. New discussion posts: When a new discussion post is created. -#. New question posts: When a new question post is created. -#. New posts from instructors: When the instructor creates a post and chooses to notify learners. +Notification Tray +------------------ -.. image:: /_images/learners/Notification_tray_forum_notifications_learner.png - :width: 400 - :align: center - :alt: Clicking the bell on the top right opens the notifications tray. +.. figure:: /_images/learners/Notifications_tray_screenshot.png + :alt: Notifications tray is shown which can be opened by clicking on the bell icon on right side of page header. + :width: 600 + :align: center -Updates -------- + Clicking the bell icon on top right opens the notifications tray. Next to bell icon is the count of + unseen notifications. -#. Course updates: When the instructor creates a new course update. +The notification tray keeps you updated while you’re browsing the site. -.. image:: /_images/learners/Notifications_tray_updates_screenshot.png - :width: 400 - :align: center - :alt: Screenshot of a course update notification in the tray. +- Clicking the bell icon on top right opens the notifications tray with tabs such as Discussions, + Updates and Grading. +- Each notification shows the course it belongs to, time elapsed since it was created + and a red dot that indicates that it has not been clicked. +- A gear icon in the tray takes you directly to your notification preferences on Account Settings page. -Grading -------- - -#. ORA grade received: When your submission for an open response assessment (ORA) receives a grade. - -.. image:: /_images/learners/Notifications_tray_grading_screenshot_learner.png - :width: 400 - :align: center - :alt: Screenshot of grading notifications in the tray. - -.. _delivery-channels: - -Delivery Channels -================= - -Tray ----- - -- The notification tray is intended to keep users informed while they are on the web platform. -- A bell icon in the top-right corner displays the count of unread notifications. -- When clicked, it opens a tray that organizes notifications into tabs based on platform area (Discussions, Grading, Updates). -- Each notification includes the relevant course name, an indicator showing it is unread, and a timestamp of when it was generated. -- A gear icon in the tray’s top-right corner links to the preferences center, where users can adjust notification settings. - -.. image:: /_images/learners/Notifications_tray_screenshot.png - :width: 700 - :align: center - :alt: Clicking the bell on the top right opens the notifications tray. +If you have more notifications than can fit in the tray, a “Load more” button appears at the bottom. +Clicking it loads mores notifications at the bottom. Email Notifications ------------------- -- Notification emails keep users informed even when they are away from the platform. -- Users can choose to get notified immediately or receive a daily or weekly summary of notifications. - - - **Immediately:** Receive the email notification as soon as the activity happens. - - **Daily:** Receive a summary of notifications from the past 24 hours, every day at 22:00 UTC. - - **Weekly:** Receive a summary of notifications from the past 7 days, every Saturday at 22:00 UTC. - -- Emails include a one-click unsubscribe option to turn off email notifications for all activity types. - -.. image:: /_images/learners/Notification_daily_email_screenshot_learner.png - :width: 400 - :align: center - :alt: Screenshot of an email with the daily summary of notifications. - -.. _managing-preferences: +.. figure:: /_images/learners/Notification_daily_email_screenshot.png + :alt: Screenshot of a daily email digest showing list of notifications from the past 24 hours + :width: 400 + :align: center -Managing Preferences -==================== - -The preferences center allows users to control which notifications they receive, how often, and through which channel. Users can get to the preferences page via: + Screenshot of email containing daily summary of notifications from the past 24hrs. -- The **Notifications** tab on the **Account Settings** page. -- The gear icon in the top-right corner of the notification tray. -- The **Notification Settings** link in email. - -For each preference: +Notification emails keep you informed when you are away from the platform. You can choose to get notified immediately +or receive a daily or weekly summary of notifications. -- Users can toggle tray and email preferences ON or OFF. -- Users can set the cadence for email notifications: Immediately, Daily, or Weekly. +- **Immediately:** Receive the email notification as soon as the activity happens. +- **Daily:** Receive a summary of notifications from the past 24 hours. +- **Weekly:** Receive a summary of notifications from the past 7 days. -.. image:: /_images/learners/Preference_center_learner.png - :width: 700 - :align: center - :alt: Screenshot of the preferences center on Account Settings. +Email summary contains up to 5 notifications for each platform area (Discussions, Updates, Grading). +Click the "View more" button to the see rest in the notifications tray on the website. -Default Settings ----------------- +Emails include a one-click unsubscribe option to turn off email notifications for all activity types. -- High-value notifications have tray and email ON by default. +.. _Activity Types: - - “New posts from instructors” and “Course updates” are exceptions where email is OFF by default to prevent high email volume/cost for courses with large enrollments. +Activity Types +================ -- High-volume notifications (e.g., new discussion posts) are OFF by default to prevent clutter. -- The default email cadence is set to **Daily** for all preferences where email is ON by default. +Activities for which you may be notified for, depending on your preferences, are listed in the table below. -The table below shows defaults for each notification type. .. list-table:: - :widths: 25 25 25 25 - :align: center :header-rows: 1 + :widths: 5 15 45 20 10 10 + + * - # + - Area + - Activity + - Preference name + - Tray default + - Email default + + * - 1 + - Discussions + - All activity on posts and responses that you've authored or you are following + - Activity notifications + - ON + - Daily - * - Preference - - Default Tray Preference - - Default Email Preference - - Visibility - * - Activity notifications + * - 2 + - Discussions + - Someone reported a post, response or comment + - Reported content - ON - - ON / Daily - - All - * - New discussion posts + - Daily + + * - 3 + - Discussions + - Any new discussion post + - New discussion posts - OFF - OFF - - All - * - New question qosts + + * - 4 + - Discussions + - Any new question post + - New question posts - OFF - OFF - - All - * - New posts from instructors + + * - 5 + - Discussions + - Your instructor created a post and chose to notify everyone + - New posts from instructors - ON + - Daily + + * - 6 + - Updates + - Instructor created a course update + - Course updates - ON - - All - * - Course updates + - Daily + + * - 7 + - Grading + - You received a grade on your essay (ORA) submission + - ORA grade received - ON - - OFF - - All - * - Essay assignment grade received + - Daily + + * - 8 + - Grading + - A submission made for an essay (ORA) that requires staff grading + - New ORA submission for staff grading - ON - - ON / Daily - - All + - Daily + -.. _notifications-expiry: +.. _Managing Preferences: + +Managing Preferences +==================== + +.. figure:: /_images/learners/Notifications_preferences.png + :alt: Preferences center on Account Settings page showing activity types and preference toggles and dropdowns. + :width: 700 + :align: center + + You can manage notification preference on *Account Settings* page. + +Notification preferences allow you to control which notifications you receive, how often, and through +which channel. You can get to the preferences page via: + +- The Notifications section on the *Account Settings* page. +- The gear icon in the top-right corner of the notification tray. +- The *Notification Settings* link at the bottom of notifications in email. + +For each preference, you can: + +- Turn tray notifications on or off. +- Turn email notifications on or off. +- Choose an email cadence: Immediate, Daily, or Weekly + + +.. _Notifications Expiry: Notifications Expiry ==================== -Every day, notifications older than 60 days are deleted from the database. \ No newline at end of file +Your site administrator may set a time limit for how long notifications remain available. +Once they reach that age, they are automatically removed from your notification tray. + + +.. seealso:: + + :ref:`Discussions Notifications ` + + +**Maintenance chart** + ++--------------+-------------------------------+----------------+--------------------------------+ +| Review Date | Working Group Reviewer | Release | Test situation | ++--------------+-------------------------------+----------------+--------------------------------+ +| Dec 15, 2025 | Aamir Ayub | Ulmo | | ++--------------+-------------------------------+----------------+--------------------------------+ \ No newline at end of file