Page MenuHomePhabricator

Introduce additional tools within the mobile visual editor's "+" menu
Open, Stalled, Needs TriagePublic

Assigned To
Authored By
ppelberg
Feb 7 2025, 12:56 AM
Referenced Files
F71670954: image.png
Feb 4 2026, 12:41 PM
F71670855: image.png
Feb 4 2026, 12:41 PM
F58982673: IMG_4456 2.jpg
Apr 4 2025, 9:06 PM
F58982614: Screenshot 2025-04-04 at 21.56.39.png
Apr 4 2025, 8:57 PM
F58982395: image.png
Apr 4 2025, 8:30 PM
F58973678: image.png
Apr 3 2025, 5:48 PM
F58973592: image.png
Apr 3 2025, 5:29 PM
F58973589: image.png
Apr 3 2025, 5:29 PM

Description

This task involves the work of introducing additional tools for volunteers editing using the mobile visual editor.

Requirements

The tools we end up introducing within the new + menu T382454 implements will need to meet the following requirements:

  1. Already available within the desktop visual editor
  2. Function reasonably well on mobile devices (smaller screen, gestural navigation, lower compute power, and potential for network interruption/latency) with minimal additional effort/work
  3. Avoid increasing the burden on moderators
    • E.g. while adding the ability to upload images would meet requirements "1." and "2.", it's likely to risk increasing the burden on moderators absent additional work
NOTE: the Editing Team will revisit the tools marked "❗️Exclude for now" (below) after the initial deployment of the + menu. The tools we've prioritized introducing to start are those which meet the three requirements listed above.

Tech/News

"Last week, on all wikis except the largest 20, people using the mobile visual editor will have additional tools in the menu bar, accessed using the new + button. To start, the new menu will include options to add: citations, hieroglyphs, and code blocks. Deployment to remaining wikis is scheduled to happen in June via T388605."

Tools

ToolMenu LocationPositionNotes
Add reference+ menu1stThis is being implemented in T382454
image.png (48×249 px, 2 KB)
❗️Exclude for nowN/ARevisit in TICKET
image.png (44×244 px, 1 KB)
❗️Exclude for nowN/ARevisit in TICKET
image.png (48×249 px, 3 KB)
❗️Exclude for nowN/ARevisit in TICKET
image.png (44×244 px, 2 KB)
+ menu2ndRevisit in TICKET
image.png (87×244 px, 5 KB)
❗️Exclude for nowN/ARevisit in TICKET
image.png (44×244 px, 2 KB)
❗️Exclude for nowRevisit in TICKET
image.png (44×244 px, 2 KB)
+ menu3rd
image.png (48×249 px, 1 KB)
❗️Exclude for nowN/ARevisit in TICKET
image.png (48×249 px, 1 KB)
❗️Exclude for nowN/AGraphs extension is currently disabled
image.png (401×247 px, 20 KB)
❗️Exclude for nowN/ARevisit in TICKET; need to figure out menu placement
image.png (47×247 px, 1 KB)
❗️Exclude for nowN/ARevisit in TICKET; need to figure out menu placement
image.png (90×244 px, 4 KB)
❗️Exclude for nowN/ARevisit in TICKET
image.png (92×249 px, 7 KB)
❗️Exclude for nowN/ARevisit in TICKET; need to figure out menu placement

References

https://wikimedia.slack.com/archives/C8W3HEHLG/p1739488733968979

Related Objects

Event Timeline

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

Change #1119699 abandoned by Esanders:

[mediawiki/extensions/VisualEditor@master] Include more tools in '+' menu

Reason:

squashed into I2422c127ec1f52295614e6cdf198eaf9b9064c52

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

Change #1114761 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] Add insert menu to MobileArticleTarget

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

ppelberg added a project: Editing QA.
ppelberg moved this task from Inbox to High Priority on the Editing QA board.

Collapsed:

Screenshot 2025-04-04 at 21.56.39.png (486×552 px, 24 KB)

Expanded:
image.png (1×510 px, 98 KB)

ToolMenu LocationPositionExpected Position
image.png (106×514 px, 5 KB)
+ menu1st1st
image.png (48×249 px, 2 KB)
+ menu2nd2nd
image.png (44×244 px, 1 KB)
+ menu3rd3rd
image.png (44×244 px, 2 KB)
+ menuWithin More sub-dropdownWithin More sub-dropdown
image.png (44×244 px, 2 KB)
+ menuWithin More sub-dropdownWithin More sub-dropdown
image.png (48×249 px, 1 KB)
+ menuWithin More sub-dropdownWithin More sub-dropdown
image.png (87×244 px, 5 KB)
+ menuWithin More sub-dropdownWithin More sub-dropdown
image.png (44×244 px, 2 KB)
+ menuWithin More sub-dropdownWithin More sub-dropdown
image.png (48×249 px, 3 KB)
+ menuWithin More sub-dropdownWithin More sub-dropdown
image.png (94×252 px, 4 KB)
+ menuWithin More sub-dropdownnot on the list
image.png (78×318 px, 5 KB)
+ menuWithin More sub-dropdownnot on the list
image.png (76×344 px, 6 KB)
+ menuWithin More sub-dropdownnot on the list
image.png (90×244 px, 4 KB)
❗️Exclude for nowN/AN/A
image.png (178×406 px, 13 KB)
❗️Exclude for nowN/AN/A

Change #1133990 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@master] Mobile insert menu: Exclude media and signature tools

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

Change #1134053 had a related patch set uploaded (by Esanders; author: Esanders):

[mediawiki/extensions/VisualEditor@wmf/1.44.0-wmf.23] Mobile insert menu: Exclude media and signature tools

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

Change #1134053 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@wmf/1.44.0-wmf.23] Mobile insert menu: Exclude media and signature tools

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

Mentioned in SAL (#wikimedia-operations) [2025-04-03T21:00:34Z] <jforrester@deploy1003> Started scap sync-world: Backport for [[gerrit:1134053|Mobile insert menu: Exclude media and signature tools (T385851)]], [[gerrit:1128374|VE: Enable mobile insert menu everywhere except top 20 mobile VE wikipedias (T388604)]]

Mentioned in SAL (#wikimedia-operations) [2025-04-03T21:06:20Z] <jforrester@deploy1003> esanders, jforrester: Backport for [[gerrit:1134053|Mobile insert menu: Exclude media and signature tools (T385851)]], [[gerrit:1128374|VE: Enable mobile insert menu everywhere except top 20 mobile VE wikipedias (T388604)]] synced to the testservers (https://wikitech.wikimedia.org/wiki/Mwdebug)

Change #1133990 merged by jenkins-bot:

[mediawiki/extensions/VisualEditor@master] Mobile insert menu: Exclude media and signature tools

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

Re: User-notice please could someone provide a draft entry, and comment about the desired-timing, for Tech News? From a skim...

Timing-wise: it looks like this might deserve announcing on this coming Monday, with a "coming later this week" framing. -- Alternatively, it could be included on the Monday after (14 April) so that editors can immediately see and try out the new tools. -- Please confirm which you prefer.

Content-wise: I'd guess at something like this.
Please approve, or overhaul/replace/edit as needed.
Please add any appropriate documentation links.

  • Starting later this week, editors using the mobile visual editor will have additional tools in the menu bar, accessed using the + button's drop-down menu. The new tools include buttons to add: references, templates, tables, reference lists, formulae, comments, hieroglyphs, and maps.

@Quiddity The above deployment was actually held up, so it won't be going out next week. Deployment date is still TBD. The announcement looks fine although I would change "The new tools include buttons to add" to "The new menu will include buttons to add" as strictly not all the tools are new (i.e. references).

@Quiddity Deployment is also unfortunately going out in phases, so you might need a "on some wikis" disclaimer. First phase is going to be "everything but the top 20 wikis".

These look good. However, the "insert" menu in the Gallery options tab has hidden text displayed:

IMG_4456 2.jpg (2×1 px, 235 KB)

I could be wrong but oo-ui-labelElement-invisible is missing. Did we mean for this to be an oo-ui-tool-title(like with link), not a oo-ui-labelElement-label

Will it be possible for volunteer developers to add custom tools/gadgets to this menu?

@Nemoralis Sure, in the same way as adding a tool anywhere else in the toolbars in VisualEditor. Basically: if you create a tool and set autoAddToCatchall on it, it'll wind up in that menu without you needing to do anything else. If you want more fiddly control over exactly where in the menu it appears you'd need to do something slightly more complicated.

@Nemoralis See: https://www.mediawiki.org/wiki/VisualEditor/Gadgets/Add_a_tool -- which I might want to find time to update for the new hook structure from T355555, but looks like it'll work as-is.

Tech News - Just noting that I will wait for your confirmation about which week to include this. You can either ping me here/elsewhere, or move the task in the User-notice workboard, or edit the relevant week's Tech News directly.
And here's an updated final-draft (and question):

  • Starting later this week, on all wikis except the largest 20, editors using the mobile visual editor will have additional tools in the menu bar, accessed using the + button's drop-down menu. The new menu will include buttons to add: references, templates, tables, reference lists, formulae, comments, hieroglyphs, and maps.

If we have any expected details about when it will be deployed at the remaining 20 wikis, that might be good to add. Thanks.

Tech News - Hello @Esanders, I am following up to know if this is ready for announcement in this week's tech news.

Test wiki on Patch demo by ESanders (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmcloud.org/wikis/6282b36ef4/w/

Test wiki on Patch demo by ESanders (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmcloud.org/wikis/62b116ed69/w/

Test wiki on Patch demo by ESanders (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmcloud.org/wikis/657a7089ca/w/

Tech News - Just noting that I will wait for your confirmation about which week to include this.

@Quiddity: could you please include a mention of the + menu deployment that will go out this week?

Proposed language here:
"Last week, on all wikis except the largest 20, people using the mobile visual editor will have additional tools in the menu bar, accessed using the new + button. To start, the new menu will include options to add: hieroglyphs and code blocks. Deployment to remaining wikis is scheduled to happen in June via T388605."

To start, the new menu will include options to add: hieroglyphs and code blocks.

@ppelberg and citations?

To start, the new menu will include options to add: hieroglyphs and code blocks.

@ppelberg and citations?

Oh, yes. Good spot. I'm going to move the Tech/News language to the task description so we can iterate upon it (as needed).

Initial deployment per T388604 has happened.

Following alignment in team meeting. Releasing this from QA.

This needs to be revisited to actually schedule releasing the rest of the tools.

The Editing Team is scheduled to revisit the decision to deploy this feature as part of the deployment planning meeting scheduled for 28 Jan 2026.

In case we include a "+" (add) menu, I recommend including both Cite and Link within the "+" menu since both them are related to "add", leaving space to include the suggestions button there as proposed in T415589: [EPIC] Suggestion Mode: Introduce way to toggle Suggestion Mode ON/OFF.

image.png (496×736 px, 58 KB)

Regarding the expanded menu, we could group the actions by using dividers to make it easier to find related options.

image.png (1×736 px, 132 KB)

Another option we could include in this add menu is the Special characters currently used in desktop.

Another option we could include in this add menu is the Special characters currently used in desktop.

This tool doesn't currently work very well on mobile.

crossposting from from T400903#11763119 following a prompt from @bmartinezcalvo

i wanted to share some early learnings from the article guidance research project T414812! we knew that inserting headings (h2, h3, etc.) isn't currently possible in the mobile VE (without using wikitext syntax, eg. === for h3), and we assumed the article guidance features would be enough.

Screenshot_1774860845.png (2×1 px, 259 KB)

but it's looking like surfacing that kind of text formatting could actually be helpful too. sharing since you're exploring improvements to the mobile VE toolbar too!