Page MenuHomePhabricator

Roll out new donate button design to all wikis
Closed, ResolvedPublic3 Estimated Story Points

Description

Background

In Q1 FY25-26, we conducted an experiment with a new donate button design (with a heart icon) that demonstrated promising results with higher clickthrough rates. We want to roll this design out to all the wiki projects with a donate button in the top toolbar on desktop (projects using Vector22 by default).

Fundraising will be in charge of monitoring the donation metrics via their existing tracking.

User story

As a user on any of the wiki projects that has a donate button in the header, I will see the new donate button with a heart design.

Design requirements

See https://phabricator.wikimedia.org/T388149#10685291


Requirements

Acceptance criteria

  • On desktop, navigate to a wiki that uses vector 2022 as a logged out user. At the top of the main page, the "Donate" button in the top navigation should be slightly bolded compared to the font of the other links, and there's a blue heart icon next to the Donate text.
  • Navigate to any article page within that wiki and see the same updated donate button design
  • Clicking on the donate link and be navigated to donate.wikimedia.org (the URL parameter should correctly indicate the source wiki that you came from.

BDD

  • Given a non-logged user on desktop visiting any of wikiprojects
  • When a user is on any page of a wiki
  • Then a blue heart with bolded Donate link will be displayed in the top navigation menu leading, upon clicking, to donate.wikimedia.org

Test Steps

  • Check different wikiprojects - on beta checked: commons, enwiktionary
  • On a wiki check different namespaces/editing mode - Special pages and Talk pages checked; editor workflow is not interrupted
  • Run accessibility check - Done - no issues

Communication criteria

Add if this needs an announcement or discussion.

Rollback plan

Describe the rollback plan in production for this task if something goes wrong.

This task was created by Version 1.0.0 of the Reader Experience team task template using phabulous.

Event Timeline

HFan-WMF moved this task from Incoming to Needs refinement on the Reader Experience Team board.
bwang set the point value for this task to 3.Mar 18 2026, 5:25 PM
bwang moved this task from Needs refinement to Ready for sprint on the Reader Experience Team board.

Change #1261478 had a related patch set uploaded (by Stoyofuku-wmf; author: Stoyofuku-wmf):

[mediawiki/extensions/WikimediaMessages@master] Add a heart to the donate link, style as button

https://gerrit.wikimedia.org/r/1261478

Change #1261479 had a related patch set uploaded (by Stoyofuku-wmf; author: Stoyofuku-wmf):

[mediawiki/skins/Vector@master] Color donate button blue (progressive)

https://gerrit.wikimedia.org/r/1261479

Change #1262192 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/skins/Vector@master] Allow overflow menu to display icon buttons for logged out users

https://gerrit.wikimedia.org/r/1262192

Change #1261479 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Color donate button blue (progressive)

https://gerrit.wikimedia.org/r/1261479

Change #1261478 merged by jenkins-bot:

[mediawiki/extensions/WikimediaMessages@master] Add a heart to the donate link, style as button

https://gerrit.wikimedia.org/r/1261478

Change #1264736 had a related patch set uploaded (by VolkerE; author: VolkerE):

[mediawiki/extensions/WikimediaMessages@master] Remove 'donate-button-heart' class from donate link in user menu

https://gerrit.wikimedia.org/r/1264736

Change #1264736 merged by jenkins-bot:

[mediawiki/extensions/WikimediaMessages@master] Remove 'donate-button-heart' class from donate link in user menu

https://gerrit.wikimedia.org/r/1264736

Change #1265497 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/skins/Vector@master] Add test coverage for VectorComponentUserLinks

https://gerrit.wikimedia.org/r/1265497

Change #1264721 had a related patch set uploaded (by Jdlrobson; author: Bernard Wang):

[mediawiki/skins/Vector@master] Consolidate how how menu items are styles in VectorComponentUserLinks

https://gerrit.wikimedia.org/r/1264721

Change #1264721 abandoned by Jdlrobson:

[mediawiki/skins/Vector@master] Consolidate how how menu items are styles in VectorComponentUserLinks

Reason:

Now folded into https://gerrit.wikimedia.org/r/c/mediawiki/skins/Vector/+/1262192/9?usp=related-change

https://gerrit.wikimedia.org/r/1264721

Change #1265497 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Add test coverage for VectorComponentUserLinks

https://gerrit.wikimedia.org/r/1265497

Change #1262192 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Allow overflow menu to display icon buttons for logged out users

https://gerrit.wikimedia.org/r/1262192

Jdlrobson-WMF subscribed.

This needs more work as we need to make the link and icon progressive

We previously did this with https://gerrit.wikimedia.org/r/c/mediawiki/skins/Vector/+/1261479/3/resources/skins.vector.styles/components/UserLinks.less which has already proved brittle.

Adding cdx-button--action-progressive class to the donate link will give the blue link (but we'll need some custom code for making the icon also blue.. not sure if that's a bug in Codex?)

Change #1265504 had a related patch set uploaded (by Jdlrobson; author: Bernard Wang):

[mediawiki/skins/Vector@master] Remove UserLinks menu code in Hooks.php

https://gerrit.wikimedia.org/r/1265504

Change #1265504 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Remove UserLinks menu code in Hooks.php

https://gerrit.wikimedia.org/r/1265504

Change #1266344 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/skins/Vector@master] Support progressive button class and progressive icons in user links

https://gerrit.wikimedia.org/r/1266344

Change #1266394 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/skins/Vector@master] Revert^2 "Color donate button blue (progressive)

https://gerrit.wikimedia.org/r/1266394

Change #1266394 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Revert^2 "Color donate button blue (progressive)

https://gerrit.wikimedia.org/r/1266394

Etonkovidova subscribed.

Checked on beta - enwiki, commons, and enwiktionary - all AC specs are in place.

The url parameter includes the source wiki, e.g. https://donate.wikimedia.org/w/index.php?title=Special:LandingPage&country=US&uselang=en&wmf_medium=sidebar&wmf_source=donate&wmf_campaign=en.wikipedia.beta.wmcloud.org

Notes:

  • The design places the donate button as the first in the nav menu, but on enwiki beta the dropdow-appearnace menu link displayed first.
  • after deployment, a quick check should be run in production

Change #1268282 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/skins/Vector@master] Do not style talk alert as button

https://gerrit.wikimedia.org/r/1268282

This causes a bug in the orange new messages bar:

image.png (374×1 px, 110 KB)

Posted a patch above.

Change #1268282 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Do not style talk alert as button

https://gerrit.wikimedia.org/r/1268282

Checked the donation button on wmf.23 - all look as expected.

HFan-WMF claimed this task.