path: root/RELEASE-NOTES-1.37

= MediaWiki 1.37 =

== MediaWiki 1.37.0-PRERELEASE ==

THIS IS NOT A RELEASE YET

MediaWiki 1.37 is an alpha-quality development branch, and is not recommended
for use in production.

== Upgrading notes for 1.37 ==
Don't forget to always back up your database before upgrading!

See the file UPGRADE for more detailed per-version upgrade instructions from the
oldest supported upgrading version, MediaWiki 1.27.

Some specific notes for MediaWiki 1.37 upgrades are below:
* …

For notes on 1.36.x and older releases, see HISTORY.

=== Configuration changes for system administrators in 1.37 ===
* …

==== New configuration ====
* …

==== Changed configuration ====
* …

==== Removed configuration ====
* $wgLegacyJavaScriptGlobals was deprecated in 1.36.

=== New user-facing features in 1.37 ===
* Media files uploaded server side using the importImages.php maintenance
  script now have the "mw-server-side-upload" change tag.
* …

=== New developer features in 1.37 ===
* …

=== External library changes in 1.37 ===
* …

==== New external libraries ====
* …

===== New development-only external libraries =====
* …

==== Changed external libraries ====
* Updated OOjs from v5.0.0 to v6.0.0
* Updated WVUI from v0.1.0 to v0.1.1
* Updated psr/container from v1.0.0 to v1.1.1.
* Updated wikimedia/object-factory from v3.0.0 to v3.0.2.
* Updated wikimedia/parsoid from v0.13.0-a20 to v0.14.0-a1.
* …

===== Changed development-only external libraries =====
* …

==== Removed external libraries ====
* …

=== Bug fixes in 1.37 ===
* …

=== Action API changes in 1.37 ===
* …

=== Action API internal changes in 1.37 ===
* …

=== Languages updated in 1.37 ===
MediaWiki supports over 350 languages. Many localisations are updated regularly.
Below only new and removed languages are listed, as well as changes to languages
because of Phabricator reports.

* (T280435) LRM and RLM characters were removed from names of languages with
  parentheses in Names.php
* (T279619) Added language support for Dagbani (dag).
* (T282085) Added language support for Malay in Arabic (Jawi) script (ms-arab).

=== Breaking changes in 1.37 ===
* The Revision class, hard deprecated in 1.35, is being removed. As
  part of this, the following hooks that included a Revision object
  were removed:
  - ArticleRevisionUndeleted - use RevisionUndeleted
  - ArticleRollbackComplete - use RollbackComplete
  - DiffRevisionTools - use DiffTools
  - DiffViewHeader - use DifferenceEngineViewHeader
  - HistoryRevisionTools - use HistoryTools
  - NewRevisionFromEditComplete - use RevisionFromEditComplete
  - PageContentInsertComplete - use PageSaveComplete
  - PageContentSaveComplete - use PageSaveComplete
  - ParserFetchTemplate - use BeforeParserFetchTemplateRevisionRecord
  - RevisionInsertComplete - use RevisionRecordInserted
  - TitleMoveComplete - use PageMoveComplete
  - TitleMoveCompleting - use PageMoveCompleting
  - UndeleteShowRevision - no replacement
  - UserRetrieveNewTalks - no replacement
  and the following methods and variables have been removed
  - Article::$mRevision
  - Article::getRevisionFetched()
  - ContribsPager::tryToCreateValidRevision()
  - EditPage::$mBaseRevision
  - EditPage::getBaseRevision()
  - LinksUpdate::getRevision()
  - LinksUpdate::setRevision()
  - PageArchive::getArchivedRevision()
  - PageArchive::getPreviousRevision
  - PageArchive::getRevision()
  - Title::countAuthorsBetween()
  - Title::getFirstRevision()
  - User::getNewMessageLinks()
  - User::getNewMessageRevisionId()
  - User::setNewtalk()
  - WikiPage::getOldestRevision()
  - WikiPage::getRevision()
  - WikiPage::getUndoContent()
  - WikiPage::updateIfNewerOn()
  and the following methods no longer accept Revision objects as parameters:
  - CategoryMembershipChange::__construct
  - ContentHandler::getUndoContent
  - DerivedPageDataUpdater::prepareUpdate
  - DifferenceEngine::getRevisionHeader
  - Linker::buildRollbackLink
  - Linker::generateRollback
  - Linker::getRevDeleteLink
  - Linker::getRollbackEditCount
  - Linker::revComment
  - Linker::revUserLink
  - Linker::revUserTools
  - WikiPage::doDeleteUpdates
  - WikiPage::doEditUpdates
  - WikiPage::hasDifferencesOutsideMainSlot
  - WikiPage::onArticleEdit
  - WikiPage::prepareContentForEdit
  - WikiPage::updateRevisionOn
  The following methods return arrays that formerly included a 'revision'
  key that would emit deprecation warnings when accessed and return a
  Revision object. The Revision object has been removed from the arrays,
  and the 'revision-record' key should be used to get the relevant
  RevisionRecord instead:
  - PageUpdater::doCreate
  - PageUpdater::doModify
  - Parser::statelessFetchTemplate
  The ParserOptions `templateCallback` option is a callback that is called
  in Parser::fetchTemplateAndTitle() and should return an array - the
  'revision' key to that array used to be a Revision object and was used if
  no 'revision-record' was returned - it is now ignored.
* WANObjectCache::HOLDOFF_NONE, deprecated since 1.35, was removed.
  Use HOLDOFF_TTL_NONE instead.
* The following methods and fields in the Language class, deprecated since
  1.35, have been removed:
   - classFromCode()
   - clearCaches()
   - convertTitle()
   - findVariantLink()
   - mConverter
   - updateConversionTable()
* The following methods in the Parser class have been removed after having
  been deprecated in 1.35:
   - fetchCurrentRevisionOfTitle()
   - statelessFetchRevision()
   - fetchTemplate()
   - Title()
* (T273354) When an edit is prevented by an 'EditFilterMergedContent' hook
  handler without changing the status, the edit form will now be displayed.
* User::clearNotification() which had been deprecated in 1.35 has been removed.
  Use WatchlistManager::clearTitleUserNotification() instead.
* User::getNewtalk() which had been deprecated in 1.35 has been removed. Use
  TalkPageNotificationManager::userHasNewMessages() instead.
* Autopromote class, deprecated since 1.35, was removed. Use
  UserGroupManager instead.
* The following classes, hard-deprecated since 1.36, have been removed:
  CachedAction, SpecialCachedPage, CacheHelper, ICacheHelper.
* The hooks BeforeHttpsRedirect, CanIPUseHTTPS and UserRequiresHTTPS, deprecated
  in 1.35, were removed.
* The deprecated "es6-promise" alias ResourceLoader module has been removed. Use
  "es6-polyfills" directly intead.
* AuthenticationProvider interface doesn't extend LoggerAwareInterface.
  So AuthenticationProvider can't be typehinted as LoggerAwareInterface.
* The following methods, deprecated in 1.35, were removed:
  - Parser::fetchCurrentRevisionOfTitle
  - Parser::statelessFetchRevision
  - Parser::getRevisionObject
  - ParserOptions::getCurrentRevisionCallback
  - ParserOptions::setCurrentRevisionCallback
* User::getGrantName(), hard deprecated since 1.36, has been removed.
  Use MWGrants::grantName instead.
* SessionProvider class doesn't extend LoggerAwareInterface.
  So SessionProvider can't be typehinted as LoggerAwareInterface.
* IDatabase::upsert() and IDatabase::replace() only accept a single unique key.
  Previously, a warning was issued if there were multiple unique keys provided.
* The MediaWiki:Autoblock_whitelist block exemption control was moved in 1.36 to
  MediaWiki:Block-autoblock-exemptionlist. The backward-compatibility of reading
  the old MediaWiki:Autoblock_whitelist page has now been dropped.
* –

=== Deprecations in 1.37 ===
* JobQueue::getWiki, deprecated in 1.33, now emits deprecation warnings.
* Deprecated passing UserIdentity to
  WatchlistManager::clearAllUserNotifications() and
  WatchlistManager::clearTitleUserNotifications(). Pass Authority instead.
* Deprecated passing LinkTarget to
  WatchlistManager::clearTitleUserNotifications() and
  WatchlistManager::getTitleNotificationTimestamp(). Pass PageIdentity instead.
* Deprecated User::isWatched(), User::isTempWatched(), User::addWatch(), and
  User::removeWatch(). Use corresponding methods in WatchlistManager instead.
* Deprecated WatchAction::doWatchOrUnwatch(). Use WatchlistManager::setWatch()
  instead.
* Deprecated WatchAction::doWatch() and WatchAction::doUnwatch(). Use
  WatchlistManager::addWatch() or WatchlistManager::removeWatch(), instead.
* The getTitle() and setTitle() methods in Parser have been deprecated.
  Use getPage() and setPage() instead.
* Title::isWatchable() has been deprecated. Use WatchlistManager::isWatchable()
  instead.
* wfIncrStats(), deprecated in 1.36, now emits deprecation warnings.
* wfCanIPUseHTTPS() is now deprecated, and always returns true.
* The UserLoadFromDatabase hook has been deprecated. It had no known uses.
* AbstractAuthenticationProvider ::setLogger(), ::setManager(), ::setConfig(),
  ::setHookContainer() were soft deprecated. Use ::init() to inject
  dependencies or override ::postInitSetup() to do any custom
  post-initialization configuration.
* The following functions from the User class, deprecated in 1.35, now emit
  deprecation warnings:
   - getOptions
   - isIP
* Use of ActorMigration for any table except revision, deprecated in 1.34, now
  emits deprecation warnings. Instead of getInsertValues(), use
  ActorNormalization::acquireActorId(). Instead of getWhere() and getJoin(),
  do your own join on the actor table.
* DatabasePostgres::remappedTableName() and its dependent constructor parameter
  'keywordTableMap' are deprecated. Reserved identifiers that are used as table
  names should be quoted where necessary.
* LinkCache::singleton(), deprecated since 1.28, now emits deprecation warnings.
* MessageCache::singleton(), deprecated since 1.34, now emits deprecation
  warnings.
* LockManagerGroup::singleton() and ::destroySingletons(), deprecated since
  1.34, now emit deprecation warnings.
* SessionProvider ::setLogger(), ::setManager(), ::setConfig(),
  ::setHookContainer() were soft deprecated. Use ::init() to inject
  dependencies or override ::postInitSetup() to do any custom
  post-initialization configuration.
* FileBackendGroup::singleton() and ::destroySingletons(), deprecated since
  1.35, now emit deprecation warnings.
* …

=== Other changes in 1.37 ===
* WatchlistManager::addWatch and WatchlistManager::addWatchIgnoringRights(),
  which replace User::addWatch(), now call the WatchArticle and
  WatchArticleComplete hooks.
* WatchlistManager::removeWatch and
  WatchlistManager::removeWatchIgnoringRights(), which replace
  User::removeWatch(), now call the UnwatchArticle and UnwatchArticleComplete
  hooks.
* The overridable postInitSetup() method was added to the
  AbstractAuthenticationProvider class. A provider can override postInitSetup()
  to do any custom post-initialization configuration.
* The overridable postInitSetup() method was added to the SessionProvider
  class. A provider can override postInitSetup() to do any custom
  post-initialization configuration.
* The protected getConfig() method was added to the SessionProvider class.
  Use SessionProvider::getConfig to get a config.
* …

== Compatibility ==

MediaWiki 1.37 requires PHP 7.3.19 or later and the following PHP extensions:

* ctype
* dom
* fileinfo
* iconv
* intl
* json
* mbstring
* xml

MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
but support for them is somewhat less mature.

The supported versions are:

* MySQL 5.5.8 or later
* PostgreSQL 9.4 or later
* SQLite 3.8.0 or later

== Online documentation ==
Documentation for both end-users and site administrators is available on
MediaWiki.org, and is covered under the GNU Free Documentation License (except
for pages that explicitly state that their contents are in the public domain):

       https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation

== Mailing list ==
A mailing list is available for MediaWiki user support and discussion:

       https://lists.wikimedia.org/mailman/listinfo/mediawiki-l

A low-traffic announcements-only list is also available:

       https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce

It's highly recommended that you sign up for one of these lists if you're
going to run a public MediaWiki, so you can be notified of security fixes.

== IRC help ==
There's usually someone online in #mediawiki on irc.freenode.net.