Page MenuHomePhabricator

Make Skin::getFooterIcons and Skin::makeFooterIcon final methods and deprecate
Closed, ResolvedPublic1 Estimated Story Points

Description

In 1.40 as part of T302116 we made these methods final by deprecating overrides. Nobody seems to override these methods so in 1.41 we should make these final methods

TODO

IMPORTANT: Do not touch SkinComponentFooter. This is specifically about the functions in Skin. SkinComponentRegistryContext methods should be revised per unstable notes.
  • Make methods final so they cannot be overriden e.g. final public function getFooterIcons
  • Remove the call to MWDebug::detectDeprecatedOverride in Skin::getFooterIcons
  • Remove the call to MWDebug::detectDeprecatedOverride in Skin::makeFooterIcon
  • Note in the RELEASE-NOTES-1.44 that overriding is no longer supported.
  • Make sure commit message is prefixed with "Skin [Breaking change]: Remove ability of skins to override makeFooterIcon and getFooterIcons"

Event Timeline

Jdlrobson renamed this task from [1.41] Make Skin::getFooterIcons and Skin::makeFooterIcon final methods to [1.41] Make Skin::getFooterIcons and Skin::makeFooterIcon final methods and deprecate.Sep 30 2022, 12:29 AM
Jdlrobson updated the task description. (Show Details)
Jdlrobson triaged this task as Medium priority.Jun 14 2023, 9:23 PM
Jdlrobson added a project: MW-1.41-release.
Jdlrobson added a project: patch-welcome.

Note that these have missed the boat for 1.41, so should be moved/re-evaluated for 1.42.

Reedy renamed this task from [1.41] Make Skin::getFooterIcons and Skin::makeFooterIcon final methods and deprecate to Make Skin::getFooterIcons and Skin::makeFooterIcon final methods and deprecate.Mar 11 2024, 2:58 PM
Reedy updated the task description. (Show Details)
SToyofuku-WMF changed the task status from Open to In Progress.Dec 11 2024, 7:05 PM
SToyofuku-WMF subscribed.

pending estimate

LMora-WMF set the point value for this task to 1.Dec 16 2024, 5:51 PM

Change #1108105 had a related patch set uploaded (by LorenMora; author: LorenMora):

[mediawiki/core@master] Skin [Breaking change]: Remove ability of skins to override makeFooterIcon and getFooterIcons

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

This comment was removed by Jdlrobson.

@LMora-WMF looks like Vector is using that unstable method in the tests so we will have to update Vector to skip that test or fix the usage to make it possible to merge the core change (which looks good!)

Thanks, @Jdlrobson! I was wondering what other step I needed to do and was about to ask you. I appreciate it!

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

[mediawiki/core@master] Follow up: Remove unnecessary SkinComponentRegistryContext methods

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

Change #1108466 abandoned by Jdlrobson:

[mediawiki/core@master] Follow up: Remove unnecessary SkinComponentRegistryContext methods

Reason:

Sqaushed into parent commit

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

Change #1108105 merged by jenkins-bot:

[mediawiki/core@master] Skin [Breaking change]: Remove ability of skins to override makeFooterIcon and getFooterIcons

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