Page MenuHomePhabricator

Update donor slides for Year in Review
Closed, ResolvedPublic3 Estimated Story Points

Description

Background

This year we plan to offer contributors (editing and donations) a custom icon for their contributions. Likewise we will let app users know that they can unlock a custom icon by contributing to wikis.

Task

  • For the sake of V3 do not show the "your generosity helped keep Wikipedia thriving" or "0 ads served on Wikipedia" slides
  • If a user does not have donor or editing history for 2025 show them an image of the custom icon but continue to use the same components for the slides. The copy for the slide can be found in Figma . Instead of the donate button being in the top left corner of the slide, in this case position as a main CTA on the slide.
  • If user does have donor or editing history for 2025 (January 1 - November 30, 2025(, show them the same image as a non donor however, the text and CTA should be different. The copy can be found on Figma. If user has editing history for 2025 replace the X in 'Your contributions as a X in 2025' with the word editor. If they have donor history, likewise replace the X with donor. If they have both replace X with donor and editor. This screen should include a toggle default on for the user to activate their new icon.
  • For this list of countries, hide this slide completely. If they are an editor, they should still see the donor/editor version
    • AE, AF, AX, BY, CD, CI, CU, FI, ID, IQ, IR, KP, KR, LB, LY, MM, PY, RU, SA, SD, SO, SS, SY, TM, TR, UA, UZ, XK, YE, ZW
  • [Added Oct 9] Update copy with learnings from user testing
  • [Added Oct 9] Update the donate button on the non-contributor slide to be primary (matching "share highlights" styling.
Open Question
  • Does user have to relaunch app for icon to update?
Engineering Notes
  • Update YearInReviewDonateCountSlideDataController, populateSlideData. We should also fetch the user's edit count here and persist it with the slide data.
  • Create two new view model + slide view pairs. One pair for the V3 non-contributor (no donate or edits) slide, and one pair for the contributor slide. Insert the correct pair in the slides array (within WMFYearInReviewViewModel) based on if their personalized slide data indicates they are a contributor (donated or edited). Leave the V2 donate slide untouched.
  • Ensure on the new view, when tapping the "activate new icon" toggle, it switches the app icon. We should also persist a flag in user defaults so that we know that they need the new app icon, and ensure when they revisit this slide after activating their new icon, that this toggle automatically shows in an ON state. See T401842 for details on how to change the app icon.
  • Ensure top-left donate button is hidden where appropriate.
  • Create new sharing views for exporting as images to share.

Test notes

  1. Fresh install Wikipedia 7.8.5 (latest build)
  2. In an account with no contributions (donations or edits):
  3. Go to Profile -> Settings -> About -> Tap about 7 times to enter Developer Settings
  4. Toggle ON YIR V3
  5. Go back to home screen
  6. Open profile, open year in review
  7. Navigate to the last slide
  8. Ensure that you see the noncontributor slide, you are able to tab donate button, and that you can share the image
  9. Repeat steps 1-8, log into an account that has donations or edits. Note: to fake a local donation count, you can toggle on "bypass donation" in developer settings, then go through the native apple pay donation flow. It should not charge your card, but will appear to succeed.
  10. Toggle ON YIR V3 in developer settings
  11. Go back to home screen
  12. Open profile, open year in review
  13. Ensure you see the contributor slide and are able to toggle icon on and off
  14. Ensure that app icon remains even when app is backgrounded or closed
  15. Ensure that donation slide remembers status of app icon

Test notes pt 2

  1. With a fresh install + country set to Indonesia in your schema
  2. Go to developer settings, toggle on YIR V3
  3. Go back to home page
  4. Go to YIR in profile
  5. Go through YIR
  6. Ensure last slide (donation slide) does NOT show

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes

@GOlson-WMF - Could the copy for this slide be updated

Unlock your custom contributor icon

We’re glad Wikipedia was part of your 2025! Learn more about the ways to unlock your icon by becoming a contributor—whether by editing Wikipedia or by donating to the Wikimedia Foundation, the non-profit behind it. If Wikipedia has been useful to you this year, please consider donating to help sustain its future and keep it free, ad-free, trustworthy, and accessible to all.

@SChekfa-WMF

New design review build - Staging 7.8.2 (105):

Note: You will need an account that has 0 edits in 2025 on English Wikipedia, and 1+ edits in 2025 on Test Wikipedia. If you don't have this let me know, and I can adjust the config to allow for alternative Wiki languages.

  1. Delete all Wikipedia apps. Fresh install this Staging build. Log into account that has edits in 2025 on Test Wiki. Set Test as primary app language, US device region.
  2. Go to developer settings, turn on YiR V3.
  3. In Settings, go to Year in Review, toggle off and back on (don't do this too fast).
  4. Year in Review should show in Profile. Go to last contributor slide, ensure text looks correct and app icon switcher is an option. Ensure switching app icon works as expected.
  5. Deselect custom app icon on contributor slide. Go to app languages, switch to EN Wiki primary language.
  6. Go to app settings > Year in review, toggle off and back on (don't do this too fast).
  7. Go back to feature from Profile, ensure non-contributor slide shows as expected.

@Tsevener thank you!

some notes:

  1. for the non-contributor: can we make sure the Donate button is fixed to 16px above the footer?

IMG_7519.PNG (2×1 px, 431 KB)

  1. for the contributor: can we omit this message when they toggle the app icon on?

IMG_7521.PNG (2×1 px, 617 KB)

  1. also for the contributor: can we make sure there is 24px above the divider, 16px below it? and can we make sure there is 4x between "activate new app icon" and "if you don't turn it on now...?"

also @Tsevener did you look into the dark/tinted elements for the app icon? the system doesn't seem to be automatically updating the icon in those themes, does something else need to be configured to ensure that's working properly?

Notes:

Unable to do dark icon
Alert is automatic from Apple

Approval from Sarah mentioned on PR, moving on to QA.

Blocked due to tweaks needed post user-testing/dynamic tabs.

We will need to tweak the logic so that the donation badge can still be earned after the YiR report is generated but not after December 31st in the users timezone.

We will need to tweak the copy and will need two variants, pre-December 31st and post December 31st.

We need to then ensure we can use donations generated post December 31st for next years badge.

Seddon renamed this task from Update donor slides for Year in Review to Update donor slides for Year in Review.Sep 26 2025, 3:22 AM
Seddon updated the task description. (Show Details)

Updated copy for the third slide state is being finalised

@Tsevener are we already hiding the large "Donate" button on the non-donor version of this slide for countries listed in the config hideDonateCountryCodes ?

If not, the ideal behavior is for the non-donor/editor version to hide the SLIDE completely for non-donor/non-editors in the hideDonateCountryCodes countries. We do want to show them the custom icon slide if they are an editor still.

Hi @HNordeenWMF

We are already hiding the donate button:

US:

Screenshot 2025-09-29 at 2.52.06 PM.png (1×564 px, 335 KB)

ID:

Screenshot 2025-09-29 at 2.50.36 PM.png (1×564 px, 330 KB)

But we can look into hiding the slide completely while we're in here tweaking copy.

New requirements, so moving back into Current Sprint Work.

  • Show alternate text for non-contributor slide state if user is reading on or after Jan 1st, 2026:

Alternate copy:
Unlock your custom contributor icon for next year!
We’re glad Wikipedia was part of your 2025! Learn how you can unlock a special icon in your 2026 Year in Review by becoming a contributor—whether by editing Wikipedia or by donating to the Wikimedia Foundation, the nonprofit behind it. If Wikipedia will be useful to you this year, please consider donating to help sustain its future and keep it free, ad-free, trustworthy, and accessible to all.

@GOlson-WMF I have added 2 new requirements here in response to what we learned in usability testing. Figma is updated with those changes, so this can move forward after those have been incorporated!

Moving back into Current Sprint work so we don't code review an outdated PR.

For whoever picks this up, let's add these fixes to https://github.com/wikimedia/wikipedia-ios/pull/5459.

Tsevener added a subscriber: GOlson-WMF.

Moving to Design Review

@SChekfa-WMF See new requirements [Added Oct 9] in task description, I don't think those were design-reviewed yet.

You can test on latest Wikipedia TestFlight build (white icon). See task description for specific test steps.

Moving back to Design Review :)

@SChekfa-WMF See new requirements [Added Oct 9] in task description, I don't think those were design-reviewed yet.

You can test on latest Wikipedia TestFlight build (white icon). See task description for specific test steps.

ABorbaWMF subscribed.

Appears to be fixed on 7.8.5 (5867)

Tested on iPhone 16 on iOS 26, iPad 12.9 on iPadOS 26, and iPhone 11 on iOS 18. Tested account with and without donations and edits.

Must-fix: Please remove the "donate" button from the top left for the non-contributor version, so that we do not have 2 donate buttons on one slide

Settings 8.jpeg (2×1 px, 942 KB)

  • If a user does not have donor or editing history for 2025 show them an image of the custom icon but continue to use the same components for the slides. The copy for the slide can be found in Figma . Instead of the donate button being in the top left corner of the slide, in this case position as a main CTA on the slide.
HNordeenWMF claimed this task.