wiki.techinc.nl/RELEASE-NOTES-1.38

171 lines
5.5 KiB
Text

= MediaWiki 1.38 =
== MediaWiki 1.38.0-PRERELEASE ==
THIS IS NOT A RELEASE YET
MediaWiki 1.38 is an alpha-quality development branch, and is not recommended
for use in production.
== Upgrading notes for 1.38 ==
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.38 upgrades are below:
* …
For notes on 1.36.x and older releases, see HISTORY.
=== Configuration changes for system administrators in 1.38 ===
* …
==== New configuration ====
* $wgBrowserFormatDetection - This setting allows the enabling or disabling
of automatic detection of possible phone numbers in a webpage in Safari on iOS.
* …
==== Changed configuration ====
* $wgMaxImageArea - This setting may now be set to false to disable size
checking before scaling. Extensions can still override its value by
using the BitmapHandlerCheckImageArea hook.
* …
==== Removed configuration ====
* …
=== New user-facing features in 1.38 ===
* …
=== New developer features in 1.38 ===
* …
=== External library changes in 1.38 ===
* …
==== New external libraries ====
* …
===== New development-only external libraries =====
* …
==== Changed external libraries ====
* Updated wikimedia/purtle from 1.0.7 to 1.0.8
* …
===== Changed development-only external libraries =====
* Updated doctrine/dbal for PHP < 7.3 from 2.10.4 to 2.13.3.
* Updated doctrine/dbal for PHP >= 7.3 from 3.0.0 to 3.1.2.
* Updated composer/spdx-licenses from 1.5.4 to 1.5.5.
* Updated composer/semver from 3.5.4 to 3.5.5.
* …
==== Removed external libraries ====
* …
=== Bug fixes in 1.38 ===
* …
=== Action API changes in 1.38 ===
* …
=== Action API internal changes in 1.38 ===
* …
=== Languages updated in 1.38 ===
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.
* …
=== Breaking changes in 1.38 ===
* LinkCache::singleton(), deprecated since 1.28, has been removed.
* RepoGroup::singleton(), ::destroySingletons() and setSingleton(), all
deprecated since 1.34, have been removed.
* MessageCache::singleton(), deprecated since 1.34, has been removed.
* LockManagerGroup::singleton() and ::destroySingletons(), both deprecated since
1.34, have been removed.
* FileBackendGroup::singleton() and ::destroySingletons(), both deprecated since
1.35, have been removed.
* TemplateParser used to support disabling the cache with a boolean parameter
in its constructor. This was deprecated in 1.35 and has now been removed.
* The ArticleUndeleteLogEntry hook, deprecated in 1.37, was removed.
* The BeforeResetNotificationTimestamp hook, deprecated in 1.37, was removed.
* The global function mimeTypeMatch() has been removed without a deprecation
process.
* The signature of PageUpdater::markAsRevert method was changed. It has never
been used outside of MediaWiki core.
* If you want to use interwiki titles with HTMLTitleTextField, you now need
to pass 'interwiki' => true. In 1.37, the default behavior was to let
interwiki title through by default, logging a deprecation warning.
* Several Skin methods, hard deprecated in 1.36, have been removed. These
include Skin::privacyLink(), aboutLink(), disclaimerLink(), makeUrl()
getIndicatorsHTML(), getLogo(), subPageSubtitle(), getSearchLink(),
makeVariablesScript(), getAllowedSkins(), getSkinNames() and
mainPageLink(). Use Skin::footerLink for footer links instead of
privacyLink, aboutLink and disclaimerLink. For others use
Skin::getIndicatorsData, ResourceLoaderSkinModule::getAvailableLogos,
Skin::prepareSubtitle, Skin::getSearchPageTitle,
ResourceLoader::makeInlineScript(), SkinFactory::getAllowedSkins
or SkinFactory::getInstalledSkins().
* …
=== Deprecations in 1.38 ===
* The MWGrants class is deprecated in favor of the new GrantsInfo and
GrantsLocalization services.
* The global functions wfReadOnly() and wfReadOnlyReason() have been
deprecated in favor of the ReadOnlyMode service.
* Skin::getSkinStylePath has been hard deprecated. Direct string path
should be used instead.
* SkinTemplate::getPersonalToolsList(), deprecated since 1.35, now emits
deprecation warnings.
* …
=== Other changes in 1.38 ===
* …
== Compatibility ==
MediaWiki 1.38 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.libera.chat.