Page MenuHomePhabricator

Deprecate PersonalUrls hook
Closed, ResolvedPublic3 Estimated Story Points

Description

We are targeting having a single hook for modifying menus: SkinTemplateNavigation::Universal

Since 1.36 we've been encouraging use of SkinTemplateNavigation::Universal instead of PersonalUrls hook.

It's a good time now to move over all remaining usages and deprecate this method.

TODO

  • Update remaining usages in Wikimedia deployed extensions
  • Using the PersonalUrls hook should send deprecation warnings.

sign off steps

Details

SubjectRepoBranchLines +/-
mediawiki/extensions/ConfirmAccountREL1_39+5 -6
mediawiki/extensions/LiquidThreadsREL1_39+9 -6
mediawiki/extensions/LiquidThreadswmf/1.39.0-wmf.28+9 -6
mediawiki/skins/CologneBlueREL1_39+6 -16
mediawiki/extensions/GrowthExperimentsREL1_39+25 -21
mediawiki/coreREL1_39+5 -1
mediawiki/skins/MirageREL1_39+19 -20
mediawiki/skins/Miragemaster+19 -20
mediawiki/extensions/DarkModeREL1_39+13 -12
mediawiki/extensions/AdminLinksREL1_39+13 -17
mediawiki/extensions/AdminLinksmaster+13 -17
mediawiki/extensions/DarkModemaster+13 -12
mediawiki/extensions/ConfirmAccountmaster+5 -6
mediawiki/extensions/SandboxLinkREL1_39+12 -9
mediawiki/extensions/BetaFeaturesREL1_39+14 -11
mediawiki/coremaster+5 -1
mediawiki/skins/VectorREL1_39+3 -7
mediawiki/extensions/GrowthExperimentsmaster+25 -21
mediawiki/extensions/UploadsLinkREL1_39+6 -6
mediawiki/skins/CologneBluemaster+6 -16
mediawiki/skins/Vectormaster+3 -7
mediawiki/extensions/UploadsLinkmaster+6 -6
mediawiki/skins/CologneBluemaster+6 -16
mediawiki/extensions/GrowthExperimentsmaster+18 -21
mediawiki/extensions/UploadsLinkmaster+6 -6
mediawiki/extensions/LiquidThreadsmaster+9 -6
mediawiki/extensions/BetaFeaturesmaster+14 -11
mediawiki/extensions/SandboxLinkmaster+12 -9
mediawiki/extensions/Wikibasemaster+17 -16
mediawiki/extensions/Wikibasemaster+17 -16
mediawiki/extensions/BetaFeaturesmaster+12 -11
mediawiki/extensions/GrowthExperimentsmaster+23 -34
mediawiki/skins/CologneBluemaster+6 -5
mediawiki/coremaster+22 -15
Show related patches Customize query in gerrit

Event Timeline

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

Change 830215 had a related patch set uploaded (by Jdlrobson; author: Mabualruz):

[mediawiki/extensions/SandboxLink@REL1_39] Deprecate PersonalUrls hook

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

Change 830216 had a related patch set uploaded (by Jdlrobson; author: Mabualruz):

[mediawiki/extensions/BetaFeatures@REL1_39] Deprecate PersonalUrls hook

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

Change 829157 merged by jenkins-bot:

[mediawiki/extensions/SandboxLink@master] Deprecate PersonalUrls hook

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

Change 829225 merged by jenkins-bot:

[mediawiki/extensions/BetaFeatures@master] Deprecate PersonalUrls hook

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

Change 830274 had a related patch set uploaded (by Mabualruz; author: Mabualruz):

[mediawiki/skins/Vector@master] Deprecate PersonalUrls hook

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

Change 829156 merged by Jdlrobson:

[mediawiki/extensions/LiquidThreads@master] Deprecate PersonalUrls hook

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

Change 829158 abandoned by Mabualruz:

[mediawiki/extensions/UploadsLink@master] Deprecate PersonalUrls hook

Reason:

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

Change 830652 had a related patch set uploaded (by Mabualruz; author: Mabualruz):

[mediawiki/extensions/UploadsLink@master] Deprecate PersonalUrls hook

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

Change 830655 had a related patch set uploaded (by Mabualruz; author: Mabualruz):

[mediawiki/extensions/GrowthExperiments@master] Deprecate PersonalUrls hook

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

Change 828572 abandoned by Mabualruz:

[mediawiki/extensions/GrowthExperiments@master] Deprecate PersonalUrls hook

Reason:

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

Change 830274 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Deprecate PersonalUrls hook

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

Change 830652 merged by jenkins-bot:

[mediawiki/extensions/UploadsLink@master] Deprecate PersonalUrls hook

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

Change 830660 had a related patch set uploaded (by Mabualruz; author: Mabualruz):

[mediawiki/skins/CologneBlue@master] Deprecate PersonalUrls hook

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

Change 829166 abandoned by Mabualruz:

[mediawiki/skins/CologneBlue@master] Deprecate PersonalUrls hook

Reason:

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

Change 830660 merged by jenkins-bot:

[mediawiki/skins/CologneBlue@master] Deprecate PersonalUrls hook

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

LGoto set the point value for this task to 3.Sep 8 2022, 5:19 PM

Change 830823 had a related patch set uploaded (by Jdlrobson; author: Mabualruz):

[mediawiki/extensions/UploadsLink@REL1_39] Deprecate PersonalUrls hook

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

Change 830823 merged by jenkins-bot:

[mediawiki/extensions/UploadsLink@REL1_39] Deprecate PersonalUrls hook

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

Change 830824 had a related patch set uploaded (by Jdlrobson; author: Mabualruz):

[mediawiki/core@REL1_39] Deprecate PersonalUrls hook

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

Change 830655 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] Deprecate PersonalUrls hook

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

Change 828573 merged by jenkins-bot:

[mediawiki/core@master] Deprecate PersonalUrls hook

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

Change 830825 had a related patch set uploaded (by Jdlrobson; author: Mabualruz):

[mediawiki/skins/Vector@REL1_39] Deprecate PersonalUrls hook

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

Change 830825 merged by jenkins-bot:

[mediawiki/skins/Vector@REL1_39] Deprecate PersonalUrls hook

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

Change 830216 merged by jenkins-bot:

[mediawiki/extensions/BetaFeatures@REL1_39] Deprecate PersonalUrls hook

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

Change 830215 merged by jenkins-bot:

[mediawiki/extensions/SandboxLink@REL1_39] Deprecate PersonalUrls hook

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

Change 831157 had a related patch set uploaded (by Seb35; author: Seb35):

[mediawiki/extensions/ConfirmAccount@master] Replace deprecated hook PersonalUrls

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

Change 831157 merged by jenkins-bot:

[mediawiki/extensions/ConfirmAccount@master] Replace deprecated hook PersonalUrls

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

Change 831234 had a related patch set uploaded (by Fomafix; author: Fomafix):

[mediawiki/extensions/DarkMode@master] Replace PersonalUrlsHook by SkinTemplateNavigation__UniversalHook

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

Change 831612 had a related patch set uploaded (by Fomafix; author: Fomafix):

[mediawiki/extensions/AdminLinks@master] Replace deprecated PersonalUrlsHook

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

Change 831234 merged by jenkins-bot:

[mediawiki/extensions/DarkMode@master] Replace PersonalUrlsHook by SkinTemplateNavigation__UniversalHook

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

Change 831612 merged by jenkins-bot:

[mediawiki/extensions/AdminLinks@master] Replace deprecated PersonalUrlsHook

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

Change 831559 had a related patch set uploaded (by Universal Omega; author: Fomafix):

[mediawiki/extensions/DarkMode@REL1_39] Replace PersonalUrlsHook by SkinTemplateNavigation__UniversalHook

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

Change 831560 had a related patch set uploaded (by Universal Omega; author: Fomafix):

[mediawiki/extensions/AdminLinks@REL1_39] Replace deprecated PersonalUrlsHook

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

Change 831560 merged by jenkins-bot:

[mediawiki/extensions/AdminLinks@REL1_39] Replace deprecated PersonalUrlsHook

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

Change 831559 merged by jenkins-bot:

[mediawiki/extensions/DarkMode@REL1_39] Replace PersonalUrlsHook by SkinTemplateNavigation__UniversalHook

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

Jdlrobson lowered the priority of this task from High to Low.Sep 13 2022, 5:13 PM
Nikerabbit subscribed.

We got a flood of deprecation warnings during translatewiki.net deployment.

I'd like to draw the attention to the stable interface policy which says:

Developers or teams deprecating code SHOULD actively support removal of usages in code in the MediaWiki ecosystem, especially in popular extensions. This includes making maintainers aware of the deprecation as well as creating or reviewing patches removing usages.

I don't see any report for SMW about this in https://github.com/SemanticMediaWiki/SemanticMediaWiki/issues?q=PersonalUrls even though the use of this hook is easy to see using the CodeSearch tool.

The translatewiki.net deployers will appreciate if this can be avoided in the future for smoother deployments.

@Nikerabbit the stable policy says:

Usage of deprecated code is considered more or less problematic depending on where it occurs: the most critical usages are within the same repository, followed by Wikimedia maintained code, further followed by code in the MediaWiki ecosystem. Usages outside the ecosystem are considered the least relevant.

Our priorities thus are:

Work here is still ongoing.
The problem with 2, is many of the repos in codesearch are not maintained (I've been raising tickets about those). That adds unnecessary noise so it makes it harder to know what to prioritize. Also some extension/skins are optimized for older releases, so often when issues/patches are raised they are stalled for some time (Scratchwiki, Chameleon and Bluespice being certain examples). I've captured this in https://www.mediawiki.org/w/index.php?title=Topic:X34wraaili56q6xy&action=history so we don't go offtopic here.

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

[mediawiki/skins/Mirage@master] PersonalUrls hook is deprecated

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

Thanks! To clarify, I am not expecting you to fix every possible extension and skin yourself. I'd be content just to have issues filed against SMW (which is a recurring pain point for us during deployments) in their issue tracker so that the Language team can help the SMW maintainers to get these resolved before hard deprecation warnings are enabled and before we update translatewiki.net code (we have a weekly deployment schedule currently).

Change 832310 had a related patch set uploaded (by Mainframe98; author: Jdlrobson):

[mediawiki/skins/Mirage@REL1_39] PersonalUrls hook is deprecated

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

Change 832284 merged by jenkins-bot:

[mediawiki/skins/Mirage@master] PersonalUrls hook is deprecated

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

Change 832310 merged by jenkins-bot:

[mediawiki/skins/Mirage@REL1_39] PersonalUrls hook is deprecated

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

Change 830824 merged by Jforrester:

[mediawiki/core@REL1_39] Deprecate PersonalUrls hook

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

Jdlrobson updated the task description. (Show Details)
Jdlrobson updated the task description. (Show Details)

Change 850571 had a related patch set uploaded (by Paladox; author: Mabualruz):

[mediawiki/extensions/GrowthExperiments@REL1_39] Deprecate PersonalUrls hook

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

Change 850571 merged by Gergő Tisza:

[mediawiki/extensions/GrowthExperiments@REL1_39] Deprecate PersonalUrls hook

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

Change 863365 had a related patch set uploaded (by Umherirrender; author: Mabualruz):

[mediawiki/skins/CologneBlue@REL1_39] Deprecate PersonalUrls hook

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

Change 863365 merged by jenkins-bot:

[mediawiki/skins/CologneBlue@REL1_39] Deprecate PersonalUrls hook

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

Change 864671 had a related patch set uploaded (by Abijeet Patro; author: Mabualruz):

[mediawiki/extensions/LiquidThreads@wmf/1.39.0-wmf.28] Deprecate PersonalUrls hook

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

Change 864674 had a related patch set uploaded (by Abijeet Patro; author: Mabualruz):

[mediawiki/extensions/LiquidThreads@REL1_39] Deprecate PersonalUrls hook

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

Change 864671 abandoned by Abijeet Patro:

[mediawiki/extensions/LiquidThreads@wmf/1.39.0-wmf.28] Deprecate PersonalUrls hook

Reason:

In favor of Ia04efa0b5bc6fbfdeef360d421e4a4342503be4f

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

Change 864674 merged by jenkins-bot:

[mediawiki/extensions/LiquidThreads@REL1_39] Deprecate PersonalUrls hook

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

Change 864924 had a related patch set uploaded (by Umherirrender; author: Seb35):

[mediawiki/extensions/ConfirmAccount@REL1_39] Replace deprecated hook PersonalUrls

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

Change 864924 merged by jenkins-bot:

[mediawiki/extensions/ConfirmAccount@REL1_39] Replace deprecated hook PersonalUrls

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