173 lines
7.3 KiB
Text
173 lines
7.3 KiB
Text
== MediaWiki 1.32 ==
|
|
|
|
THIS IS NOT A RELEASE YET
|
|
|
|
MediaWiki 1.32 is an alpha-quality branch and is not recommended for use in
|
|
production.
|
|
|
|
=== Configuration changes in 1.32 ===
|
|
* (T115414) The $wgEnableAPI and $wgEnableWriteAPI settings, deprecated in 1.31,
|
|
have been removed.
|
|
* The $wgUseAjax setting, deprecated in 1.31, is now ignored.
|
|
* The $wgSiteSupportPage setting, unused since 1.5, was removed.
|
|
* The default quality of JPEG thumbnails generated by GD was reduced from 95 to
|
|
80. The quality of JPEG thumbnails is now configurable through the new setting
|
|
$wgJpegQuality (default 80). This aligns the quality to what ImageMagick uses.
|
|
* $wgExperimentalHtmlIds, deprecated since 1.30, has been removed. The
|
|
'html5-legacy' value for $wgFragmentMode is no longer accepted.
|
|
* The experimental Html5Internal and Html5Depurate tidy drivers were removed.
|
|
RemexHtml, which is the default, should be used instead.
|
|
* (T135963) You can now define a Content Security Policy for your wiki. This
|
|
adds a defense-in-depth feature to stop an attacker who has found a bug in
|
|
the parser allowing them to insert malicious attributes. Disabled by default,
|
|
you can configure this via $wgCSPHeader and $wgCSPReportOnlyHeader.
|
|
|
|
=== New features in 1.32 ===
|
|
* (T112474) Generalized the ResourceLoader mechanism for overriding modules
|
|
using a particular page during edit previews.
|
|
* Added 'ApiParseMakeOutputPage' hook.
|
|
* (T174313) Added checkbox on Special:ListUsers to display only users in temporary
|
|
user groups.
|
|
|
|
=== External library changes in 1.32 ===
|
|
* …
|
|
|
|
==== Upgraded external libraries ====
|
|
* Updated QUnit from 2.4.0 to 2.6.0.
|
|
|
|
==== New external libraries ====
|
|
* …
|
|
|
|
==== Removed and replaced external libraries ====
|
|
* …
|
|
|
|
=== Bug fixes in 1.32 ===
|
|
* …
|
|
|
|
=== Action API changes in 1.32 ===
|
|
* Added templated parameters.
|
|
* A module can define a templated parameter like "{fruit}-quantity", where
|
|
the actual parameters recognized correspond to the values of a multi-valued
|
|
parameter. Then clients can make requests like
|
|
"fruits=apples|bananas&apples-quantity=1&bananas-quantity=5".
|
|
* action=paraminfo will return templated parameter definitions separately
|
|
from normal parameters. All parameter definitions now include an "index"
|
|
key to allow clients to maintain parameter ordering when merging normal and
|
|
templated parameters.
|
|
|
|
=== Action API internal changes in 1.32 ===
|
|
* Added 'ApiParseMakeOutputPage' hook.
|
|
* Parameter names may no longer contain '{' or '}', as these are now used for
|
|
templated parameters.
|
|
|
|
=== Languages updated in 1.32 ===
|
|
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.
|
|
|
|
* (T193566) Added language support for Ambonese Malay (abs).
|
|
|
|
=== Breaking changes in 1.32 ===
|
|
* $wgRequestTime, deprecated in 1.25, was removed. Use
|
|
$_SERVER['REQUEST_TIME_FLOAT'] or WebRequest::getElapsedTime() instead.
|
|
* The MediaWikiI18N class, deprecated in 1.31, was removed.
|
|
* QuickTemplate::setTranslator(), deprecated in 1.31, was removed. Use
|
|
Skin::msg() instead.
|
|
* wfInitShellLocale(), deprecated in 1.30, was removed.
|
|
* wfShellExecDisabled(), deprecated in 1.30, was removed.
|
|
* The type string for the parameter $lang of DateFormatter::getInstance,
|
|
deprecated in 1.31, was removed.
|
|
* The EDIT_TOKEN_SUFFIX constant deprecated in 1.27, was removed. Use
|
|
MediaWiki\Session\Token::SUFFIX instead.
|
|
* EditPage::isOouiEnabled() deprecated in 1.30, was removed.
|
|
* mw.util.wikiGetlink(), deprecated in 1.23, was removed. Use mw.util.getUrl()
|
|
instead.
|
|
* (T61113) The following methods and constants from the Revision class, which
|
|
were deprecated in 1.25, have now been removed:
|
|
* Revision::getRawUser()
|
|
* Revision::getRawUserText()
|
|
* Revision::getRawComment()
|
|
* window.gM() from mediawiki.jqueryMsg, deprecated in 1.23, was removed. Use
|
|
mw.msg() or mw.message() instead.
|
|
* mw.util.escapeId(), deprecated in 1.30, was removed. Use
|
|
mw.util.escapeIdForAttribute or mw.util.escapeIdForLink instead.
|
|
* mw.util.updateTooltipAccessKeys(), deprecated in 1.24, was removed. Use
|
|
jquery.accessKeyLabel instead.
|
|
* The SqlDataUpdate class, deprecated in 1.28, has been removed.
|
|
* The Html5Internal and Html5Depurate tidy driver classes were removed, along with the
|
|
Balancer tidy implementation. Both implementations were experimental, and were replaced
|
|
by RemexHtml.
|
|
|
|
=== Deprecations in 1.32 ===
|
|
* Use of a StartProfiler.php file is deprecated in favour of placing
|
|
configuration in LocalSettings.php.
|
|
* HTMLForm::setSubmitProgressive() is deprecated. No need to call it. Submit
|
|
button is already marked as progressive.
|
|
* Skin::setupSkinUserCss() is deprecated. Adding of modules to load
|
|
has been centralised to Skin::getDefaultModules(), which is now capable
|
|
of queueing style modules as well.
|
|
* OutputPage::addModuleScripts() and ParserOutput::addModuleScripts are
|
|
deprecated. Use addModules() instead.
|
|
* Overriding SearchEngine::{searchText,searchTitle,searchArchiveTitle}
|
|
in extending classes is deprecated. Extend related doSearch* methods
|
|
instead.
|
|
* CollationFa has been removed completely as it's not needed anymore
|
|
|
|
=== Other changes in 1.32 ===
|
|
* Soft hyphens (U+00AD) are now automatically removed from titles; these
|
|
characters can accidentally end up in copy-and-pasted titles.
|
|
* Strip Unicode 6.3.0 directional formatting characters (U+061C, U+2066,
|
|
U+2067, U+2068, U+2069) from the title.
|
|
* …
|
|
|
|
== Compatibility ==
|
|
MediaWiki 1.32 requires PHP 5.5.9 or later. Although HHVM 3.18.5 or later is
|
|
supported, it is generally advised to use PHP 5.5.9 or later for long term
|
|
support.
|
|
|
|
MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
|
|
but support for them is somewhat less mature. There is experimental support for
|
|
Oracle and Microsoft SQL Server.
|
|
|
|
The supported versions are:
|
|
|
|
* MySQL 5.5.8 or later
|
|
* PostgreSQL 9.2 or later
|
|
* SQLite 3.3.7 or later
|
|
* Oracle 9.0.1 or later
|
|
* Microsoft SQL Server 2005 (9.00.1399)
|
|
|
|
== Upgrading ==
|
|
1.32 has several database changes since 1.31, and will not work without schema
|
|
updates. Note that due to changes to some very large tables like the revision
|
|
table, the schema update may take quite long (minutes on a medium sized site,
|
|
many hours on a large site).
|
|
|
|
Don't forget to always back up your database before upgrading!
|
|
|
|
See the file UPGRADE for more detailed upgrade instructions, including
|
|
important information when upgrading from versions prior to 1.11.
|
|
|
|
For notes on 1.31.x and older releases, see HISTORY.
|
|
|
|
== 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.
|