wiki.techinc.nl/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 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).

=== 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
  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::getFirstRevision()
  - WikiPage::getOldestRevision()
  - WikiPage::getRevision()
* 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.
* 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.

=== 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
* 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.
* …

=== 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.