Page MenuHomePhabricator
Create Task
Maniphest T410267

Build a language selector component into MediaWiki core
Closed, ResolvedPublic8 Estimated Story Points
Actions

Description

We're planning to create a headless UI component to have the logic and functionality for the actual language selector element. The UI component will then be built on top of this headless component. This approach allow us to build different interfaces easily.

Here’s some exploration by @santhosh:
Demo: https://csb-2hd7s.netlify.app/
Code: https://codesandbox.io/s/renderless-language-selector-2hd7s

While we are still validating this approach, we will build a component into MediaWiki core and start using it in a couple of places where a language selector is needed inside MediaWiki.

We will review the possibility of moving the library out to a separate independent component.

Solution

Documentation for added components: https://www.mediawiki.org/wiki/Manual:LanguageSelector

Details

Related Changes in Gerrit:
SubjectRepoBranchLines +/-
Add placeholder property to language selector componentsmediawiki/coremaster+20 -2
Use LookupLanguageSelector component in SpecialPageLanguagemediawiki/coremaster+63 -5
LanguageSelector: Change the way menu items are computedmediawiki/coremaster+51 -55
Replace headless LanguageSelector component with composablemediawiki/coremaster+453 -403
PageTranslationSpecialPage: Use MultiselectLookupLanguageSelectormediawiki/extensions/Translatemaster+25 -137
Add MultiselectLookupLanguageSelector componentmediawiki/coremaster+368 -34
Add LookupLanguageSelector componentmediawiki/coremaster+804 -3
AggregateGroupsSpecialPage: Use LookupLanguageSelectormediawiki/extensions/Translatemaster+13 -21
Customize query in gerrit

Related Objects
Search...

Event Timeline

abi_ created this task.Nov 17 2025, 10:58 AM
abi_ triaged this task as High priority.
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptNov 17 2025, 10:58 AM
abi_ moved this task from Backlog to Ready for dev on the LPL Essential (FY2025-26 Q2) board.Nov 17 2025, 10:58 AM
A_smart_kitten added a project: MediaWiki-General.Nov 17 2025, 11:55 AM
Bugreporter subscribed.EditedNov 17 2025, 11:59 AM

Should we build it inside Codex?

Note the ULS language selector is also used in WDQS, which calls Wikidata's language search API.

abi_ updated the task description. (Show Details)Nov 17 2025, 1:05 PM
abi_ added a comment.Nov 17 2025, 1:17 PM
In T410267#11378566, @Bugreporter wrote:

Should we build it inside Codex?

Note the ULS language selector is also used in WDQS, which calls Wikidata's language search API.

This was something we had long discussions over and are still contemplating. In general our view was that a design system like Codex should only contain generic components like buttons, dropdown, dialogs etc that we then used to build the language selector. A language selector will be much more specific in nature with business logic built in.

Nikerabbit subscribed.Nov 18 2025, 8:39 AM
In T410267#11378566, @Bugreporter wrote:

Note the ULS language selector is also used in WDQS, which calls Wikidata's language search API.

It is using jquery.uls which is different from the ULS extension. Language search API will continue to work, we are just moving it from ULS extension to MediaWiki Core.

abi_ changed the task status from Open to In Progress.Nov 20 2025, 7:52 AM
abi_ moved this task from Ready for dev to In Progress on the LPL Essential (FY2025-26 Q2) board.
gerritbot added a comment.Nov 20 2025, 6:09 PM

Change #1207929 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[mediawiki/core@master] Build and use LanguageSelector component in SpecialPageLanguage

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

gerritbot added a project: Patch-For-Review.Nov 20 2025, 6:09 PM
gerritbot added a comment.Nov 24 2025, 5:38 PM

Change #1210647 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[mediawiki/extensions/Translate@master] AggregateGroupsSpecialPage: Use LookupLanguageSelector

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

gerritbot added a comment.Nov 26 2025, 10:34 AM

Change #1211624 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[mediawiki/core@master] Add a MultiselectLookupLanguageSelector component

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

gerritbot added a comment.Nov 26 2025, 12:29 PM

Change #1211663 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[mediawiki/extensions/Translate@master] WIP: Use MultiselectLookupLanguageSelector

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

gerritbot added a comment.Nov 26 2025, 3:40 PM

Change #1211707 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[mediawiki/core@master] Use LookupLanguageSelector component in SpecialPageLanguage

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

gerritbot added a comment.Dec 11 2025, 1:04 PM

Change #1207929 merged by jenkins-bot:

[mediawiki/core@master] Add LookupLanguageSelector component

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

ReleaseTaggerBot added a project: MW-1.46-notes (1.46.0-wmf.7; 2025-12-16).Dec 11 2025, 2:00 PM
Jdlrobson-WMF added a project: MobileFrontend (Language overlay).Dec 11 2025, 5:58 PM
gerritbot added a comment.Dec 12 2025, 7:33 AM

Change #1217624 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[mediawiki/core@master] Replace headless LangaugeSelector component with composable

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

gerritbot added a comment.Dec 12 2025, 8:04 AM

Change #1211707 merged by jenkins-bot:

[mediawiki/core@master] Use LookupLanguageSelector component in SpecialPageLanguage

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

gerritbot added a comment.Dec 12 2025, 9:39 AM

Change #1210647 merged by jenkins-bot:

[mediawiki/extensions/Translate@master] AggregateGroupsSpecialPage: Use LookupLanguageSelector

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

abi_ added a comment.Dec 12 2025, 1:09 PM

We now have the LookupLanguageSelector on translatewiki.net enabled on Special:PageLanguage (needs permissions) and on Special:AggregateGroups.

abi_ added a comment.Dec 15 2025, 8:19 AM
In T410267#11454514, @abi_ wrote:

We now have the LookupLanguageSelector on translatewiki.net enabled on Special:PageLanguage (needs permissions) and on Special:AggregateGroups.

When searching for a language, we temporarily see "No results" before the actual language list is shown.

gerritbot added a comment.Dec 15 2025, 8:58 PM

Change #1211624 merged by jenkins-bot:

[mediawiki/core@master] Add MultiselectLookupLanguageSelector component

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

gerritbot added a comment.Dec 17 2025, 6:55 AM

Change #1211663 merged by jenkins-bot:

[mediawiki/extensions/Translate@master] PageTranslationSpecialPage: Use MultiselectLookupLanguageSelector

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

gerritbot added a comment.Dec 17 2025, 7:03 AM

Change #1219058 had a related patch set uploaded (by Abijeet Patro; author: Abijeet Patro):

[mediawiki/core@master] LanguageSelector: Change the way menu items are computed

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

gerritbot added a comment.Dec 18 2025, 10:41 PM

Change #1217624 merged by jenkins-bot:

[mediawiki/core@master] Replace headless LanguageSelector component with composable

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

gerritbot added a comment.Dec 19 2025, 2:57 AM

Change #1219058 merged by jenkins-bot:

[mediawiki/core@master] LanguageSelector: Change the way menu items are computed

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

Maintenance_bot removed a project: Patch-For-Review.Dec 19 2025, 3:30 AM
abi_ mentioned this in T413313: On Wikimedia Commons: Uncaught Error: Widget not found.Jan 5 2026, 10:26 AM
gerritbot added a comment.Jan 8 2026, 7:04 AM

Change #1224532 had a related patch set uploaded (by Huei Tan; author: Huei Tan):

[mediawiki/core@master] Add placeholder property to language selector components

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

gerritbot added a project: Patch-For-Review.Jan 8 2026, 7:04 AM
gerritbot added a comment.Jan 8 2026, 1:04 PM

Change #1224532 merged by jenkins-bot:

[mediawiki/core@master] Add placeholder property to language selector components

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

Maintenance_bot removed a project: Patch-For-Review.Jan 8 2026, 1:31 PM
abi_ moved this task from In Progress to Need QA on the LPL Essential (FY2025-26 Q2) board.Jan 9 2026, 1:27 PM

I've documented the MultiselectLookupLanguageSelector and LookupLanguageSelector components we built on this MediaWiki page: https://www.mediawiki.org/wiki/Manual:LanguageSelector

Tacsipacsi mentioned this in T414254: Translate: Marking a page for translation removes priority languages.Sun, Jan 11, 5:57 PM
Nikerabbit added a subtask: T414254: Translate: Marking a page for translation removes priority languages.Tue, Jan 13, 8:46 AM
abi_ closed this task as Resolved.Tue, Jan 13, 10:14 AM
abi_ moved this task from Need QA to Done on the LPL Essential (FY2025-26 Q2) board.
abi_ added a subscriber: hueitan.
In T410267#11507438, @abi_ wrote:

I've documented the MultiselectLookupLanguageSelector and LookupLanguageSelector components we built on this MediaWiki page: https://www.mediawiki.org/wiki/Manual:LanguageSelector

Updated the documentation after discussion with @hueitan.

This task can be considered as done for now as the new selectors are operational in MediaWiki core: Special:PageLanguage and the Translate extension.

abi_ reopened this task as In Progress.Tue, Jan 13, 10:15 AM
abi_ closed this task as Resolved.
abi_ updated the task description. (Show Details)
abi_ closed subtask T414254: Translate: Marking a page for translation removes priority languages as Resolved.Fri, Jan 16, 4:27 AM
Tacsipacsi reopened subtask T414254: Translate: Marking a page for translation removes priority languages as Open.Fri, Jan 16, 9:20 AM
Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and 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 · Credits