= 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. * … ===== 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 === * 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() * (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 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 === 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. * Title::isWatchable() has been deprecated. Use WatchlistManager::isWatchable() instead. * wfIncrStats(), deprecated in 1.36, now emits deprecation warnings. * 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 * … === 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. * … == 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.