This task should list all breaking changes that were introduced in MediaUploader that may present themselves when upgrading from UploadWizard. Each item should have a link to the relevant task/patch and a suggested solution. This will be later used in documentation.

Note: the breaks should not be too serious. They should be mostly rare/edge cases or stuff that probably only Wikimedia uses. In short: you shouldn't have to worry about it.

• Scripts for upgrading from older versions of UploadWizard are not shipped with MediaUploader.
  • Task/patch: T274913: Remove old update scripts and SQL patches
  • Suggested solution: First upgrade UploadWizard to the latest (or a reasonably recent) version, then upgrade to MediaUploader.
• There is no Wikibase support. statements and wikibase config settings were removed.
  • Task/patch: T274910 – patch
  • Suggested solution: There are no plans for Wikibase support, as this was specific to Commons. Any problematic elements in campaign configs should be removed.
• There is no special patent and weapon handling for STL files.
  • Task/patch: T274910 – patch
  • Suggested solution: This should not be a problem for non-Commons users, but if it is, please mention it in T275248. A hook interface for that could be created.
• Object references are not supported. labelPickImage, noticeExistingImage and noticeUpdateDelay config settings were removed.
  • Task/patch: T274910 – patch
  • Suggested solution: This was a Commons-specific feature, but if you did use it, check if your use case is covered by improved field configurability (T275264). If it's not, file a task explaining your use case, a more general solution may be added.
• mwe-upwiz-license-custom-url message was removed
  • Task/patch: T275989 – patch
  • Suggested solution: Instead use the url field in license configuration array.
• Campaign:- is now a page reserved for MediaUploader's internal use as the global config anchor.
  • Task/patch: T276242 – patch
  • Suggested solution: In the very unlikely case you have a campaign named - you should move it to a different name before upgrading.
• Support for logging events using the EventLogging extension was removed.
  • Task/patch: T274910 – patch
  • Suggested solution: EventLogging infrastructure is very WMF-specific and it's hard to justify maintaining this without a real use case. If you would like to add and maintain event logging features in MediaUploader, file an appropriate task.
• The tutorial is a piece of wikitext now, instead of an image. The relevant config settings were removed.
  • Task/patch: T228701 – patch
  • Suggested solution: The tutorial as an image was a Commons-specific feature, the new wikitext-based tutorial is much more flexible and should be used instead.
• Extension:Campaigns support was removed.
  • Task/patch: T274910 – patch
  • Suggested solution: This was Wikimedia-specific code. The same can probably be easier achieved using a tool such as Google Analytics or Matomo.
• The campaign definition schema is now enforced. Campaign schema fields for the removed features are no longer present. Some campaigns may fail to validate.
  • Task/patch: T277535: Rewrite campaign JSON Schema validation
  • Suggested solution: A new maintenance script (FixCampaigns.php) was added to resolve most of the issues automatically. It is ran when upgrading using the update.php script. Some issues in the campaigns may still remain, they have to be resolved manually.
• The functionality for uploading images directly from Flickr was removed.
  • Task/patch: patch
  • Suggested solution: The feature was a WMF-specific hack. If you are interested in adding it back in a more general way, see: T277292: Investigate more general upload from a URL functionality
• All messages were renamed from mwe-upwiz-* to mediauploader-*. This means that if you had any message overrides on your wiki, they will stop working.
  • Task/patch: T291640
  • Suggested solution: MediaUploader removed some messages, but many are analogous to those from UW. You can use the special page Special:PrefixIndex to find any relevant message overrides on your wiki so that you can rename them.
• All CSS classes were renamed from mwe-upwiz-* to mediauploader-*. If you had any custom CSS styles, they will stop working.
  • Task/patch: T291640
  • Suggested solution: The first release of MediaUploader has an almost identical interface to UW, so you can just substitute the prefix. Note that a future release will include a complete overhaul of the UI.
• The warning about uploading a supposedly public domain image that is too recent to meet the criteria was removed.
  • Task/patch: T275264 – patch
  • Suggested solution: This was a feature specific to Commons, relying on specific naming of templates. There is no substitute, but a more general, hook-based system could be provided if you have a use case for that.
• The configuration for setting up details fields and licenses was reworked significantly to allow for more elasticity.
  • Task/patch: T278872, T275027, T275264
  • Suggested solution: Refer to the configuration manual on how configure MediaUploader for your wiki.
• Links for giving feedback on title denylist and the uploader in general were removed.
  • Task/patch: patch
  • Suggested solution: These were rather wiki-specific. If you do need to gather feedback from your users, either use a dedicated tool for that or modify some message to include a proper link.
• The autoAdd.wikitext config setting was removed.
  • Task/patch: patch
  • Suggested solution: Use the new formatting config settings instead (content section).
• The autoAdd.categories, trackingCategory.all, and missingCategoriesWikiText config settings were removed.
  • Task/patch: T317000 – patch
  • Suggested solution: Use the new configuration settings for the categories field (fields section) instead.
• Renamed the campaignSquidMaxAge config setting to campaignCdnMaxAge
  • Task/patch: T292920 – patch
  • Suggested solution: Use the campaignCdnMaxAge setting instead.
• The enableLicensePreference config setting was removed.
  • Task/patch: patch
  • Suggested solution: Use the $wgHiddenPrefs setting instead.

Template

• (the issue)
  • Task/patch:
  • Suggested solution: