RELEASE-NOTES-1.38

   1 = MediaWiki 1.38 =
   2
   3 == MediaWiki 1.38.0-PRERELEASE ==
   4
   5 THIS IS NOT A RELEASE YET
   6
   7 MediaWiki 1.38 is an alpha-quality development branch, and is not recommended
   8 for use in production.
   9
  10 == Upgrading notes for 1.38 ==
  11 Don't forget to always back up your database before upgrading!
  12
  13 See the file UPGRADE for more detailed per-version upgrade instructions from the
  14 oldest supported upgrading version, MediaWiki 1.29.
  15
  16 Some specific notes for MediaWiki 1.38 upgrades are below:
  17 * …
  18
  19 For notes on 1.36.x and older releases, see HISTORY.
  20
  21 === Configuration changes for system administrators in 1.38 ===
  22 * …
  23
  24 ==== New configuration ====
  25 * $wgBrowserFormatDetection – This setting allows overriding browsers' automatic
  26   detection and handling of formats. It's initially used to prevent auto-linking
  27   of possible telephone numbers in wiki pages' output in Safari on iOS; this can
  28   be re-enabled if you wish, or locally extended for other browsers' quirks.
  29 * …
  30
  31 ==== Changed configuration ====
  32 * $wgMaxImageArea - This setting may now be set to false to disable size
  33   checking before scaling. Extensions can still override its value by
  34   using the BitmapHandlerCheckImageArea hook.
  35 * …
  36
  37 ==== Removed configuration ====
  38 * $wgShellLocale - This setting has been removed as it was a flawed solution
  39   to the problem of locale dependence, MediaWiki will now always set a locale
  40   of C.UTF-8 or C and works around the remaining problems of the C locale by
  41   not using escapeshellarg. This follows the direction of PHP 8.0, which sets
  42   a locale of C by default instead of respecting LC_CTYPE.
  43 * $wgIncludejQueryMigrate - Deprecated in 1.36. We only support jQuery v3.
  44 * …
  45
  46 === New user-facing features in 1.38 ===
  47 * …
  48
  49 === New developer features in 1.38 ===
  50 * Added a deleteUserEmail maintenance script - This file enables the deletion
  51   of a given user's associated email address. It can be helpful for
  52   privacy-preserving operations.
  53 * …
  54
  55 === External library changes in 1.38 ===
  56 * …
  57
  58 ==== New external libraries ====
  59 * …
  60
  61 ===== New development-only external libraries =====
  62 * …
  63
  64 ==== Changed external libraries ====
  65 * Updated wikimedia/parsoid from v0.14.0-a14 to v0.15.0-a1.
  66 * Updated wikimedia/purtle from 1.0.7 to 1.0.8
  67 * Updated wikimedia/shellbox from 2.0.0 to 2.1.0
  68 * …
  69
  70 ===== Changed development-only external libraries =====
  71 * Updated doctrine/dbal for PHP < 7.3 from 2.10.4 to 2.13.3.
  72 * Updated doctrine/dbal for PHP >= 7.3 from 3.0.0 to 3.1.2.
  73 * Updated composer/spdx-licenses from 1.5.4 to 1.5.5.
  74 * Updated composer/semver from 3.5.4 to 3.5.5.
  75 * …
  76
  77 ==== Removed external libraries ====
  78 * …
  79
  80 === Bug fixes in 1.38 ===
  81 * …
  82
  83 === Action API changes in 1.38 ===
  84 * …
  85
  86 === Action API internal changes in 1.38 ===
  87 * …
  88
  89 === Languages updated in 1.38 ===
  90 MediaWiki supports over 400 languages. Many localisations are updated regularly.
  91 Below only new and removed languages are listed, as well as changes to languages
  92 because of Phabricator reports.
  93
  94 * (T292166) Updated namespace names for the Lombard language.
  95 * (T291899) Added language support for Xiang Chinese (hsn).
  96
  97 === Breaking changes in 1.38 ===
  98 * (T291008) The IP class, deprecated since 1.35 in favor of the IPUtils library,
  99   has been removed. The IP related regexes which were also deprecated in favor
 100   of the IPUtils library were also removed, IPUtils::RE_* should be used
 101   instead.
 102 * LinkCache::singleton(), deprecated since 1.28, has been removed.
 103 * RepoGroup::singleton(), ::destroySingletons() and setSingleton(), all
 104   deprecated since 1.34, have been removed.
 105 * The following methods from FileDeleteForm were removed:
 106   - ::__construct (the class is no longer newable)
 107   - ::execute()
 108   Use FileDeleteAction instead.
 109 * MessageCache::singleton(), deprecated since 1.34, has been removed.
 110 * LockManagerGroup::singleton() and ::destroySingletons(), both deprecated since
 111   1.34, have been removed.
 112 * FileBackendGroup::singleton() and ::destroySingletons(), both deprecated since
 113   1.35, have been removed.
 114 * TemplateParser used to support disabling the cache with a boolean parameter
 115   in its constructor. This was deprecated in 1.35 and has now been removed.
 116 * The ArticleUndeleteLogEntry hook, deprecated in 1.37, was removed.
 117 * The BeforeResetNotificationTimestamp hook, deprecated in 1.37, was removed.
 118 * The global function mimeTypeMatch() has been removed without a deprecation
 119   process.
 120 * The signature of PageUpdater::markAsRevert method was changed. It has never
 121   been used outside of MediaWiki core.
 122 * If you want to use interwiki titles with HTMLTitleTextField, you now need
 123   to pass 'interwiki' => true. In 1.37, the default behavior was to let
 124   interwiki title through by default, logging a deprecation warning.
 125 * The `UndeleteForm::undelete` hook, deprecated in 1.37, was removed.
 126 * The `jquery.mw-jump` ResourceLoader module was removed.
 127 * Several Skin methods, hard deprecated in 1.36, have been removed. These
 128   include Skin::privacyLink(), aboutLink(), disclaimerLink(), makeUrl()
 129   getIndicatorsHTML(), getLogo(), subPageSubtitle(), getSearchLink(),
 130   makeVariablesScript(), getAllowedSkins(), getSkinNames() and
 131   mainPageLink(). Use Skin::footerLink for footer links instead of
 132   privacyLink, aboutLink and disclaimerLink. For others use
 133   Skin::getIndicatorsData, ResourceLoaderSkinModule::getAvailableLogos,
 134   Skin::prepareSubtitle,  Skin::getSearchPageTitle,
 135   ResourceLoader::makeInlineScript(), SkinFactory::getAllowedSkins
 136   or SkinFactory::getInstalledSkins().
 137 * Parser::getUser and ::mUser, as well as ParserOptions::getUser, deprecated
 138   since 1.37, has been removed.
 139 * DatabaseBlock::setBlocker() no longer accepts a username as blocker, it
 140   must always be a UserIdentity. This was deprecated since 1.36.
 141 * The following deprecated constructor options of DatabaseBlock class
 142   have been removed:
 143   - 'byText' property with blocker's name,
 144     use 'by' property with UserIdentity value instead.
 145   - 'by' property with blocker's ID,
 146     use 'by' property with UserIdentity value instead.
 147 * The following functions, hard deprecated since 1.37, have been removed:
 148   - Title::isWatchable()
 149   - WatchAction::doWatchOrUnwatch(), WatchAction::doWatch(),
 150     WatchAction::doUnwatch(), WatchAction::getWatchToken()
 151   - User::isWatched(), User::isTempWatched(), User::addWatch(),
 152     User::removeWatch()
 153 * ParserOptions::setTidy() that had no effect and was deprecated since 1.35
 154   has been removed.
 155 * …
 156
 157 === Deprecations in 1.38 ===
 158 * The MWGrants class is deprecated in favor of the new GrantsInfo and
 159   GrantsLocalization services.
 160 * PageArchive::undeleteAsUser(), ::getFileStatus() and ::getRevisionStatus()
 161   were deprecated. Use UndeletePage instead.
 162 * The global functions wfReadOnly() and wfReadOnlyReason() have been
 163   deprecated in favor of the ReadOnlyMode service.
 164 * PageProps::getInstance() has been deprecated. Use
 165   MediaWikiServices::getPageProps() instead.
 166 * User::setOption(), deprecated since 1.35, now emits deprecation warnings.
 167 * Linker::formatComment(), ::formatLinksInComment(), ::commentBlock() and
 168   revComment() were soft-deprecated. Use the new CommentFormatter service.
 169 * Skin::getSkinStylePath has been hard deprecated. Direct string path
 170   should be used instead.
 171 * DatabaseBlock::purgeExpired(), deprecated since 1.36, now emit
 172   deprecation warnings.
 173 * SkinTemplate::getPersonalToolsList(), deprecated since 1.35, now emits
 174   deprecation warnings.
 175 * The following methods from the User class were hard deprecated:
 176    - ::blockedBy
 177    - ::getBlockId
 178 * Content::getParserOutput() was deprecated.
 179   Use ContentRenderer::getParserOutput and override
 180   ContentHandler::fillParserOutput instead.
 181 * MessageContent class was hard-deprecated.
 182 * Message::content() was hard-deprecated.
 183 * The following methods from the ParserOutput class were hard deprecated:
 184    - ::hideNewSection() - use ::setHideNewSection()
 185    - ::preventClickjacking() - use ::{get,set}PreventClickjacking()
 186 * The following methods were soft-deprecated; use ::setPreventClickjacking(..)
 187   instead:
 188    - OutputPage::preventClickjacking()
 189    - OutputPage::allowClickjacking()
 190    - ImageHistoryList::preventClickjacking()
 191    - ImageHistoryPseudoPager::preventClickjacking()
 192    - ContribsPager::preventClickjacking()
 193 * Collation::singleton() and ::factory() were hard-deprecated.
 194 * Return values in the parameter $pageLang of the hook PageContentLanguage
 195   with other types than a Language object, deprecated since 1.33, now emmits
 196   deprecation warnings.
 197 * …
 198
 199 === Other changes in 1.38 ===
 200 * …
 201
 202 == Compatibility ==
 203
 204 MediaWiki 1.38 requires PHP 7.3.19 or later and the following PHP extensions:
 205
 206 * ctype
 207 * dom
 208 * fileinfo
 209 * iconv
 210 * intl
 211 * json
 212 * mbstring
 213 * xml
 214
 215 MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
 216 but support for them is somewhat less mature.
 217
 218 The supported versions are:
 219
 220 * MySQL 5.5.8 or later
 221 * PostgreSQL 9.4 or later
 222 * SQLite 3.8.0 or later
 223
 224 == Online documentation ==
 225 Documentation for both end-users and site administrators is available on
 226 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 227 for pages that explicitly state that their contents are in the public domain):
 228
 229        https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
 230
 231 == Mailing list ==
 232 A mailing list is available for MediaWiki user support and discussion:
 233
 234        https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 235
 236 A low-traffic announcements-only list is also available:
 237
 238        https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 239
 240 It's highly recommended that you sign up for one of these lists if you're
 241 going to run a public MediaWiki, so you can be notified of security fixes.
 242
 243 == IRC help ==
 244 There's usually someone online in #mediawiki on irc.libera.chat.