Page MenuHomePhabricator
Create Task
Maniphest T274404

Support notifications on the iOS app
Closed, ResolvedPublic
Actions

Description

Design document

Notifications on the iOS app

Background

We will now be able to support all Echo notifications and alerts in the iOS app. This update will make it easier for editors who use iOS devices to be notified about new messages and alerts that they have, without having to voluntarily open the app or website to check. As we prepare to support these notifications we want to ensure that the usability of notifications is clear and doesn’t disrupt editors existing flows. Simultaneously, we will design and build with consistency with iOS system elements in mind to ensure that the feature feels at home on its platform.

Feature job story

As a Wikipedia editor with an iOS device, I want to be able to know when I have a new Echo notification without having to check Wikipedia myself, so that I can take timely action on my notifications.

Anatomy of a notification

System level

  • Lock screen: Appears on the lock screen of the device. Supports tap through and detail view.
  • Banner: Appears at the top of the screen for a few seconds while the device is in use, then disappears. Supports tap through and detail view.
  • System notification center: Notifications that are not acted on (dismissed or tap through) are
  • Badging: Appears on app icon.

In-app level

  • Notification center: A space within the app where unread and archived notifications and alerts are available to logged-in users.
  • Notification message: String and links sent from the server to the app, which is shown in system level notifications and in the app-level notification center.
  • Notification message primary link: Primary action associated with the notification, tapping on a notification in the in-app notification center will push to this page.
  • Notification message secondary links: 2-3 secondary links, accessible through the in-app notification center or through the system notification detail view.
Proposed general notification flow

View flow on Miro

iOS Notifications Flows - General notifications flow.jpg (1×3 px, 191 KB)

Types of Echo notifications and alerts

Over 20 different notification and alert types are seen on Wikipedia. An overview of each type can be found on MediaWiki: Help:Notifications/Types - MediaWiki.

A proposed mapping of each notification is in progress here: Echo Notification Mapping on iOS.

Related Objects
Search...

StatusSubtypeAssignedTask
 OpenNoneT278838 Mobile user communication issues ([[Wikipedia:Mobile communication bugs]])
 ResolvedJMinorT274404 Support notifications on the iOS app
 DuplicateNoneT271856 As a new editor, I need a way to set my notification preferences
 ResolvedJMinorT272499 As someone with notifications turned on, I want notifications to lead me to somewhere that is actionable / appropriate
 ResolvedJMinorT274305 Experimental mocks of notification center messages
 ResolvedSpikeTsevenerT284237 [Spike]: Notification content
 ResolvedSpikeTsevenerT284238 [Spike]: Notification Receipt Questions
 ResolvedSpikeDmantenaT285348 [Spike]: Explore breaking Push Notifications into Local Notifications
 ResolvedSpikeTsevenerT284239 [Spike]: App Notification Center Read/Write Questions
ResolvedSpikeDmantenaT284255 [Spike]: Notification Navigation Design Questions
 ResolvedNoneT285417 Connect testing flows for push notification development
 ResolvedLGotoT285440 Provide a way to trigger all Echo notification types during development and testing
 ResolvedJMinorT286607 As someone who uses an iPad, I want to be able to access my in-app notification center on my iPad
 ResolvedJMinorT287298 Build data controller for importing and refreshing notification center content
 ResolvedJMinorT297639 Create icons for projects that are not currently represented in the OOUI icon set
 ResolvedJMinorT287302 Build mark as read/unread functionality into data controller
 ResolvedTsevenerT287305 Build out push subscription and registration flow
 DuplicateNoneT271855 As an existing editor I need a way to opt into notifications
DuplicateNoneT287307 Re-enable in the news notification
 ResolvedJMinorT287308 Notification Center UI
 ResolvedJMinorT288652 [Notifications] Add "Bell" button to navigation bar
 ResolvedJMinorT288654 [Notifications] Add empty Notifications Center
 ResolvedJMinorT288658 [Notifications] Implement all notification cell types
 ResolvedJMinorT288662 [Notifications] Display notifications in Notifications Center
 ResolvedJMinorT288665 [Notifications] Add Mark as Read functionality
 DeclinedNoneT288835 Loading state for notifications center table
 ResolvedJMinorT288668 [Notifications] Add empty state view to Notifications Center
 ResolvedJMinorT288669 [Notifications] Update display logic for notifications bell state
 ResolvedJMinorT288670 [Notifications] Add primary actions for cells
 ResolvedDmantenaT288687 [Notifications] Add secondary actions for cells (swipe + swipe menu)
ResolvedJMinorT288688 [Notifications] Update Settings > Notifications view
 ResolvedJMinorT288692 [Notifications] Present alert to user when they log out in Settings > Account
 ResolvedJMinorT288694 [Notifications] Add app icon badging
 DeclinedNoneT288868 [Notifications] Separate notifications by type in tabs
 OpenNoneT288869 [Notifications] Add Search Bar
 ResolvedJMinorT288870 [Notifications] Add read status filtering
 ResolvedJMinorT288873 [Notifications] Add inbox filtering
 ResolvedJMinorT288874 [Notifications] Update toolbar status text depending on state and configuration
 InvalidNoneT288877 [Notifications] Add Trending current events push notification
 OpenNoneT291019 [notifications] Remove read notifications from iOS Notification Center?
 ResolvedJMinorT287310 Add Notification Service Extension to populate push notification content
 ResolvedJMinorT287033 "Default" notification handling on iOS
ResolvedJMinorT285353 Experimental mock for a "no new data" notification
 OpenNoneT287311 Add Notification Content Extension for rich notification content and quick actions
 ResolvedJMinorT287766 Offline support and copy for notifications
 ResolvedJMinorT287768 Log in, log out and 'Explore feed turned off' experiences for Notifications on iOS
 ResolvedJMinorT287970 Mark Echo notifications and alerts as seen when opening app notification center
 ResolvedJMinorT288776 Accessibility audit for iOS Notifications
 ResolvedJMinorT296779 [Notifications]: Make notifications cell swipe actions accessible via VoiceOver
 ResolvedJMinorT288777 Audit color usage for iOS reading themes in the Notifications center
 DuplicateNoneT288779 Notifications copy doc
 ResolvedJMinorT288781 Usability testing of the Notifications feature of the iOS app
 ResolvedcmadeoT290682 Diary study for notifications feature on the iOS app
 OpenNoneT302452 As a contributor to sister projects, I want to be able to see my frequently edited projects included in my Notifications Inbox, even if I have no un-read messages
 ResolvedJMinorT302453 Consistent tap throughs: As an editor, it's confusing to not know where a notification tap through is going to lead to
 OpenNoneT303476 Allow for paging up and down in the detail view of Notifications
 ResolvedJMinorT302454 Update notification badge color: It's hard for me to tell when I have a new notification due to the color of the badge in the app
 ResolvedJMinorT302455 Updates to read/unread states for notifications: As a contributor, I would like it to be easier for me to tell my read and unread messages apart, especially in dark mode.
StalledNoneT302026 As a contributor I want granular control over my push notifications
OpenNoneT291003 Inform users that Web subscriptions override app inbox settings
 ResolvedMazevedoT288693 [Notifications] Add first time user Explore feed information card
 OpenBUG REPORTNoneT302456 [Bug] Notification count can differ across web and iOS
 ResolvedJTannerWMFT302522 [Bug] Tap throughs from notification center on talk pages do not lead to expected section
 ResolvedJMinorT302609 [Bug] Ensure that push notifications are being sent in a timely manner and are receivable on device
 OpenNoneT302613 Support native access to key project pages (Meta, Village pump, personal pages)
 OpenFeatureNoneT302615 VisualEditor for Wikipedia iOS app
 OpenNoneT165382 Update the app icon to be i18n-friendly
 OpenNoneT220541 As an editor of Wikipedia on iOS I would like to be able to easily upload media into an article
 OpenJMinorT302632 Improve coverage for Places on non-EN wikis by using Wikidata coordinates
 ResolvedJMinorT290683 Usability testing of Notifications feature on iOS app with new contributors (via UserTesting.com)
 DuplicatecmadeoT296787 Updates to Notifications cell design
ResolvedOTichonovaT296788 Updates to Notifications filters
 ResolvedJMinorT297331 Usability testing of Notification Center findings
 ResolvedJMinorT297746 Updates to Notification Cells based on usability testing findings
 InvalidNoneT297747 Updates to filters and empty states from usability testing findings
ResolvedJMinorT288773 [notifications] edge and error cases, user education
 ResolvedJMinorT287628 Handle tap through of native notifications shown while app is open
 ResolvedJTannerWMFT303218 As an editor I want to be warned before I close the editing mode if I have made modifications to the Wikitext
 ResolvedTsevenerT291383 [Notifications]: Tackle any straggling TODO comments

Event Timeline

cmadeo created this task.Feb 10 2021, 7:14 PM
Restricted Application added a project: Wikipedia-iOS-App-Backlog. · View Herald TranscriptFeb 10 2021, 7:14 PM
Restricted Application added a subscriber: Aklapper. · View Herald Transcript
cmadeo added a subtask: T271856: As a new editor, I need a way to set my notification preferences.Feb 10 2021, 7:14 PM
cmadeo added a subtask: T272499: As someone with notifications turned on, I want notifications to lead me to somewhere that is actionable / appropriate.
cmadeo added a subtask: T274305: Experimental mocks of notification center messages.
cmadeo updated the task description. (Show Details)
cmadeo updated the task description. (Show Details)Feb 10 2021, 7:59 PM
cmadeo updated the task description. (Show Details)Feb 10 2021, 9:16 PM
cmadeo updated the task description. (Show Details)
• MattCleinman merged a task: T275117: iOS app users do not receive notifications (both talk and Echo).Feb 22 2021, 7:49 PM
• MattCleinman added subscribers: Proc, Diannaa, Firefly and 2 others.
JMinor triaged this task as High priority.Feb 22 2021, 7:50 PM
JMinor moved this task from Needs Triage to Product Backlog on the Wikipedia-iOS-App-Backlog board.
Novem_Linguae added a subscriber: Novem_Linguae.Mar 1 2021, 4:56 PM
ToBeFree awarded a token.Mar 2 2021, 8:40 PM
ToBeFree added a subscriber: ToBeFree.
ppelberg added a subscriber: ppelberg.Mar 4 2021, 12:11 AM
Jack_Frost added a subscriber: Jack_Frost.Mar 12 2021, 10:07 AM
TheSandDoctor added a subscriber: TheSandDoctor.Mar 26 2021, 4:47 PM
SD0001 added a parent task: T278838: Mobile user communication issues ([[Wikipedia:Mobile communication bugs]]).Mar 30 2021, 8:05 PM
SD0001 mentioned this in T278838: Mobile user communication issues ([[Wikipedia:Mobile communication bugs]]).Mar 31 2021, 4:05 PM
cmadeo edited projects, added iOS-app-v6.9-Carp-On-A-Zamboni; removed iOS-app-v6.8-Manta-Ray-On-A-Riding-Mower.Apr 5 2021, 6:52 PM
JTannerWMF added subscribers: scblr, JTannerWMF.Apr 6 2021, 11:10 PM
JMinor moved this task from Tasks from Product Backlog to Design Doing on the iOS-app-v6.9-Carp-On-A-Zamboni board.May 24 2021, 9:53 PM
Dmantena added a subtask: T285348: [Spike]: Explore breaking Push Notifications into Local Notifications.Jun 22 2021, 7:54 PM
Dmantena removed a subtask: T285348: [Spike]: Explore breaking Push Notifications into Local Notifications.Jun 22 2021, 7:56 PM
cmadeo removed cmadeo as the assignee of this task.Jul 21 2021, 8:23 PM
cmadeo moved this task from Design Doing to Epics In Progress on the iOS-app-v6.9-Carp-On-A-Zamboni board.
Diannaa removed a subscriber: Diannaa.Jul 21 2021, 10:09 PM
Tsevener added a subtask: T271855: As an existing editor I need a way to opt into notifications .Jul 23 2021, 9:47 PM
Tsevener removed a subtask: T287033: "Default" notification handling on iOS .Jul 23 2021, 10:23 PM
Tsevener removed a subtask: T285353: Experimental mock for a "no new data" notification.
LGoto closed subtask T285440: Provide a way to trigger all Echo notification types during development and testing as Resolved.Aug 19 2021, 7:32 PM
JTannerWMF closed subtask T284239: [Spike]: App Notification Center Read/Write Questions as Resolved.Sep 2 2021, 4:18 PM
Tsevener added a subtask: T288773: [notifications] edge and error cases, user education.Sep 10 2021, 2:39 AM
Tsevener added a subtask: T287628: Handle tap through of native notifications shown while app is open.Sep 10 2021, 3:05 AM
ppelberg removed a subscriber: ppelberg.Sep 10 2021, 4:47 PM
Jgiannelos closed subtask T285417: Connect testing flows for push notification development as Resolved.Sep 13 2021, 3:18 PM
L235 added a subscriber: L235.Sep 13 2021, 11:39 PM
scblr removed a subscriber: scblr.Sep 15 2021, 9:43 AM
Tsevener reopened subtask T285417: Connect testing flows for push notification development as Open.Sep 24 2021, 6:50 PM
Tsevener closed subtask T285417: Connect testing flows for push notification development as Resolved.Oct 1 2021, 1:14 AM
Novem_Linguae removed a subscriber: Novem_Linguae.Nov 23 2021, 1:08 PM
JMinor closed subtask T284238: [Spike]: Notification Receipt Questions as Resolved.Feb 7 2022, 10:57 PM
JMinor closed subtask T284255: [Spike]: Notification Navigation Design Questions as Resolved.
JMinor closed subtask T284237: [Spike]: Notification content as Resolved.
JMinor closed subtask T287302: Build mark as read/unread functionality into data controller as Resolved.
ppelberg added a subscriber: ppelberg.Mar 16 2022, 3:41 PM
JMinor closed subtask T287628: Handle tap through of native notifications shown while app is open as Resolved.Apr 4 2022, 7:40 PM
JMinor closed subtask T287970: Mark Echo notifications and alerts as seen when opening app notification center as Resolved.Apr 4 2022, 7:43 PM
JMinor closed subtask T287298: Build data controller for importing and refreshing notification center content as Resolved.Apr 4 2022, 7:46 PM
JMinor closed subtask T287305: Build out push subscription and registration flow as Resolved.
JMinor closed subtask T274305: Experimental mocks of notification center messages as Resolved.
cmadeo moved this task from Epics In Progress to Ready for PM Signoff on the iOS-app-v6.9-Carp-On-A-Zamboni board.May 2 2022, 6:38 PM
JMinor closed subtask T287308: Notification Center UI as Resolved.May 6 2022, 7:57 PM
JMinor closed subtask T288781: Usability testing of the Notifications feature of the iOS app as Resolved.
JMinor awarded a token.
JMinor closed subtask T286607: As someone who uses an iPad, I want to be able to access my in-app notification center on my iPad as Resolved.
JMinor closed subtask T287766: Offline support and copy for notifications as Resolved.
JMinor closed subtask T288773: [notifications] edge and error cases, user education as Resolved.May 6 2022, 8:00 PM
JMinor closed subtask T287310: Add Notification Service Extension to populate push notification content as Resolved.
JMinor closed subtask T288776: Accessibility audit for iOS Notifications as Resolved.May 6 2022, 8:03 PM
JMinor closed subtask T287768: Log in, log out and 'Explore feed turned off' experiences for Notifications on iOS as Resolved.
JMinor closed subtask T272499: As someone with notifications turned on, I want notifications to lead me to somewhere that is actionable / appropriate as Resolved.May 6 2022, 8:07 PM
JMinor closed subtask T291383: [Notifications]: Tackle any straggling TODO comments as Resolved.
JMinor closed this task as Resolved.May 6 2022, 8:11 PM
JMinor claimed this task.
JMinor closed subtask T288777: Audit color usage for iOS reading themes in the Notifications center as Resolved.
TheDJ added a subscriber: TheDJ.May 6 2022, 10:44 PM

Such a great milestone ! Thx everyone who worked on this.

Content licensed under Creative Commons Attribution-ShareAlike 3.0 (CC-BY-SA) unless otherwise noted; code licensed under GNU General Public License (GPL) or other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL