View source for MediaWiki 1.31

<languages/>
{{MWReleases}}
<translate><!--T:1--> <tvar name=1>'''MediaWiki 1.31'''</tvar> is an obsolete long-term support release of MediaWiki.</translate>
<translate><!--T:2--> Consult the <tvar name=1>{{RELEASE-NOTES|MediaWiki 1.31}}</tvar> file for the full list of changes.</translate>
<translate><!--T:3--> It was deployed on Wikimedia Foundation wikis through incremental "<tvar name=1>{{ll|WMF product development process|wmf}}</tvar>"-branches starting 26 September 2017.</translate>
<translate><!--T:4--> The 1.31.0 stable release was released on 13 June 2018.</translate>
<translate><!--T:5--> Download the [<tvar name=1>https://releases.wikimedia.org/mediawiki/1.31/</tvar> latest releases] or checkout the <tvar name=master><code>{{git file|project=mediawiki/core|branch=REL1_31|text=REL1_31}}</code></tvar> branch [[<tvar name=download>Special:MyLanguage/Download from Git</tvar>|in Git]] to follow this release.</translate>

<translate><!--T:258--> It was originally due to go end-of-life in June 2021.</translate>
<translate><!--T:260--> Due to MediaWiki 1.35 being delayed to September 2020, 1.31 went end of life on 30 September 2021.</translate>

{{clear}}
{{MediaWiki Release navigation|1.31}}

__TOC__
<translate>
== What's new == <!--T:14-->

=== More bundled extensions === <!--T:21-->
</translate>
[[File:I-40W-Sunflowers.jpg|thumb|<translate><!--T:20--> Clicking on this image should trigger the MultimediaViewer extension (unless you disable it in your [[<tvar name=1>Special:Preferences#mw-prefsection-rendering</tvar>|preferences]])</translate>]]
<translate>
<!--T:22-->
The set of extensions that are bundled with the MediaWiki tarball has increased. The new additions are:</translate>

* {{ll|Extension:CategoryTree|CategoryTree}}
* <translate><!--T:89--> {{ll|Extension:CodeEditor|CodeEditor}} provides a more friendly editor when editing CSS and JavaScript on-wiki.</translate>
* <translate><!--T:90--> {{ll|Extension:MultimediaViewer|MultimediaViewer}} provides a lightbox viewer for images and galleries.</translate>
* <translate><!--T:91--> {{ll|Extension:OATHAuth|OATHAuth}} provides two-factor authentication for wiki accounts.</translate>
* <translate><!--T:92--> {{ll|Extension:Replace Text|Replace Text}} provides a form to let administrators do string replacements on the entire wiki, for both page contents and page titles.</translate>

<translate>
<!--T:23-->
The <tvar name=1>{{ll|Extension:Nuke|nsp=0}}</tvar> extension was not included in the tarball for MediaWiki 1.31.0 by mistake. If you want to use this extension, please download the extension separately. This is fixed in 1.31.1 and up.

=== Skins === <!--T:26-->

==== Timeless skin ==== <!--T:24-->

<!--T:25-->
[[Skin:Timeless|Timeless]] is a new, responsive skin for MediaWiki, and is now bundled.</translate>
<gallery>
File:Timeless screenshot - Mobile 01.png|<translate><!--T:27--> Mobile layout</translate>
File:Timeless screenshot - 1024x768.png|<translate><!--T:28--> Tablet layout</translate>
File:Timeless screenshot - 1280x800.png|<translate><!--T:29--> Desktop layout</translate>
File:Timeless screenshot - 1440x900.png|<translate><!--T:30--> Wide desktop layout</translate>
</gallery>

<translate>
==== CologneBlue and Modern ==== <!--T:31-->

<!--T:32-->
The [[Skin:CologneBlue|CologneBlue]] and [[Skin:Modern|Modern]] skins are no longer bundled, although are still compatible with MediaWiki. If you are upgrading and had that skin installed, be sure to [[Special:SkinDistributor|download it separately]].

=== Tidy replaced with HTML 5 parsing algorithm === <!--T:15-->

<!--T:33-->
:''See the [[Parsing/Replacing Tidy/FAQ|frequently asked questions]] for more details''

<!--T:34-->
The HTML 4 based Tidy library has been replaced by a pure-PHP HTML 5 parser named RemexHtml to clean up improper wikitext in a modern and standards compliant way. If your content relied on some of the tidy fix-ups that are not being continued, they will need to be fixed.
</translate>

<translate><!--T:35--> You can use the <tvar name=1>{{ll|Extension:Linter|nsp=0}}</tvar> extension in conjunction with [[Parsoid]] to identify pages with problems that cause differences in rendering with the RemexHtml parser.</translate>
<translate><!--T:259--> The <tvar name=1>{{ll|Extension:ParserMigration|nsp=0}}</tvar> extension shows editors a side-by-side comparison of rendering with tidy and RemexHtml.</translate>

<translate>
=== Interwiki usernames === <!--T:36-->

<!--T:37-->
MediaWiki now supports "interwiki" usernames in a format like "<code>iw>Example</code>" in revisions, log entries, and so on. This allows for properly recording imports and events from foreign wikis (as generated by Wikibase, for example) without confusion with a local account that exists now or may be created in the future.</translate>

* ({{phabT|9240}}) <translate><!--T:93--> Imports will now record unknown (and, optionally, known) usernames in a format like "<code>iw>Example</code>".</translate>
* ({{phabT|20209}}) <translate><!--T:94--> <code>Linker</code> (used on history pages, log pages, and so on) will display usernames formed like "<code>iw></code>Example" as interwiki links, as if by wikitext like <code><nowiki>[[iw:User:Example|iw>Example]]</nowiki></code>.</translate>

<translate>
=== Further UI standardization === <!--T:39-->
</translate>
{{Todo|Expand this}}
<translate>
<!--T:40-->
*As a first pass in standardizing dialog boxes across the MediaWiki product, [https://doc.wikimedia.org/mediawiki-core/master/php/classHtml.html Html class] now provides helper methods for messageBox, successBox, errorBox and warningBox generation.

=== Other feature changes === <!--T:41-->
</translate>
* <translate><!--T:95--> Add default edit rate limit of 90 edits/minute for all users. This can be changed by setting <tvar name=1>{{wg|RateLimits}}</tvar>.</translate>
* ({{phabT|143790}}) <translate><!--T:96--> {{wg|EmailConfirmToEdit}} only affects <code>edit</code> actions.</translate>
* ({{phabT|76554}}) <translate><!--T:97--> User sub-pages named <code>….json</code> are now protected in the same way that <code>….js</code> and <code>….css</code> pages are, so that configuration options can safely be placed there.</translate>
* ({{phabT|181651}}) <translate><!--T:98--> The info page for File pages now displays the file's base-16 SHA1 hash value in the table of basic information.</translate>
* ({{phabT|189785}}) <translate><!--T:99--> The [[pingback]] feature will now send a monthly heartbeat ping to identify active wikis.</translate>
* ({{phabT|19099}}) <translate><!--T:100--> Tabs which link to pages that don't exist (like those to uncreated discussion pages) now have a tooltip to indicate state, not just colour.</translate>

<translate>
=== Languages updated in 1.31 === <!--T:43-->

<!--T:44-->
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.
</translate>

* ({{phabT|180052}}) <translate><!--T:101--> Mirandese (mwl) now supports gendered <code>NS_USER</code>/<code>NS_USER_TALK</code>.</translate>
* ({{phabT|182305}}) <translate><!--T:102--> New language support: Nyungar (nys).</translate>
* ({{phabT|186359}}) <translate><!--T:103--> New language support: Siberian Tatar [cебертатар] (sty).</translate>
* ({{phabT|186635}}) <translate><!--T:104--> New language support: Guianan Creole (gcr).</translate>
* ({{phabT|186647}}) <translate><!--T:105--> New language support: Kumyk [къумукъ] (kum).</translate>
* ({{phabT|187750}}) <translate><!--T:106--> New language support: Spanish formal address (es-formal).</translate>
* ({{phabT|187824}}) <translate><!--T:107--> New language support: Hungarian formal address (hu-formal).</translate>
* ({{phabT|189127}}) <translate><!--T:108--> New language support: Gorontalo (gor).</translate>

<translate>
== Upgrade notices for MediaWiki administrators == <!--T:46-->

=== PHP 7 or HHVM is now required === <!--T:47-->

<!--T:48-->
MediaWiki 1.31 requires PHP 7.0.0 or later. Although HHVM 3.18.5 or later is supported, it is generally advised to use PHP 7.0.0 or later for long term support.

=== Database changes === <!--T:49-->

<!--T:50-->
1.31 has several database changes since 1.30, and will not work without schema updates. PostgreSQL users now need version 9.2 or later.

==== Revision table ==== <!--T:51-->

<!--T:52-->
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!

==== Archive table ==== <!--T:53-->
</translate>
<translate><!--T:54--> If you're using MySQL, SQLite, or MSSQL, are not using <tvar name=1><code>update.php</code></tvar> to apply schema changes, and cannot have downtime to run <tvar name=2><code>migrateArchiveText.php</code></tvar> and apply <tvar name=3><code>patch-drop-ar_text.sql</code></tvar> manually, you'll have to apply a default value to the <tvar name=4><code>ar_text</code></tvar> and <tvar name=5><code>ar_flags</code></tvar> columns of the <tvar name=6><code>archive</code></tvar> table or make those columns nullable before upgrading to MediaWiki 1.31.</translate>
<translate><!--T:261--> <tvar name=1><code>maintenance/archives/patch-nullable-ar_text.sql</code></tvar> shows how to do this for MySQL.</translate>

<translate>
==== Actor table ==== <!--T:55-->

<!--T:56-->
The identity of the logged-in or IP "actor" for logged actions is being moved into a new <code>actor</code> table, with the rows in tables such as revision and logging referring to the actor ID instead of storing the user ID and name/IP in every row.</translate>

* <translate><!--T:109--> This is currently gated by <tvar name=1>{{wg|ActorTableSchemaMigrationStage}}</tvar>. Most wikis can set this to <tvar name=2><code>MIGRATION_NEW</code></tvar> and run <tvar name=3><code>maintenance/migrateActors.php</code></tvar> as soon as any necessary extensions are updated.</translate>
* <translate><!--T:110--> Most code accessing rows for logged actions from the database should use the relevant <code>getQueryInfo()</code> methods to get the information needed to build the SQL query. The <code>ActorMigration</code> class may also be used to get feature-flagged information needed to access actor-related fields during the migration period.</translate>

<translate>
<!--T:257-->
See the <tvar name=1>{{ll|Actor migration}}</tvar> page for details.

=== Configuration changes === <!--T:58-->
</translate>
* <translate><!--T:111--> <tvar name=1>{{wg|EnableAPI}}</tvar> and <tvar name=2>{{wg|EnableWriteAPI}}</tvar> are now deprecated and will be removed in a future version. The API is now considered to be stable, secure and essential.</translate>
* <translate><!--T:112--> <tvar name=1>{{wg|UsejQueryThree}}</tvar> was removed, as it is now the default. This was documented as a temporary variable during the migration period, deprecated since 1.29.</translate>
* <translate><!--T:113--> <tvar name=1>{{wg|LogoHD}}</tvar> has been updated to support SVG images and uses <tvar name=2>{{wg|Logo}}</tvar> where possible for fallback images such as PNG.</translate>
* ({{PhabT|44246}}) <translate><!--T:114--> <tvar name=1>{{wg|FilterLogTypes}}</tvar> will no longer ignore '<tvar name=2><code>patrol</code></tvar>' when user does not have the right to mark things patrolled.</translate>
* <translate><!--T:115--> Wikis that contain imported revisions or <tvar name=1>{{ll|Extension:CentralAuth|nsp=0}}</tvar> global blocks should run <tvar name=2><code>{{ll|Manual:CleanupUsersWithNoId.php|maintenance/cleanupUsersWithNoId.php}}</code></tvar>.</translate>
* <translate><!--T:116--> The configuration settings <tvar name=1>{{wg|ResourceLoaderMinifierStatementsOnOwnLine}}</tvar> and <tvar name=2>{{wg|ResourceLoaderMinifierMaxLineLength}}</tvar>, deprecated since 1.27, were removed.</translate>
* ({{phabT|180921}}) <translate><!--T:117--> <tvar name=1>{{wg|ReferrerPolicy}}</tvar> now supports having fallbacks for browsers that are not using the latest version of the Referrer Policy specification.</translate>
* <translate><!--T:118--> {{wg|FragmentMode}} is now set to <code>[ 'legacy', 'html5' ]</code> by default. This is a first step of migration to human-readable section IDs that will later result in '<code>html5</code>' being the default mode.</translate>
* <translate><!--T:119--> <code>CACHE_ACCEL</code> now only supports APC(u) or WinCache. XCache support was removed as upstream is inactive and has no plans to move to PHP 7.</translate>
* <translate><!--T:120--> The old <code>CategorizedRecentChanges</code> feature, including its related configuration option {{wg|AllowCategorizedRecentChanges}}, has been removed.</translate>
* ({{phabT|188472}}) <translate><!--T:121--> The '<code>comma</code>' value for {{wg|ArticleCountMethod}} is no longer supported for performance reasons, and installations with this setting will now work as if it was configured with '<code>any</code>'.</translate>
* ({{phabT|185753}}) <translate><!--T:122--> MediaWiki now defaults to using <tvar name=1><code>RemexHtml</code></tvar> to tidy up user input, rather than being off by default. If you wish to disable HTML tidying entirely, set <tvar name=2>{{wg|TidyConfig}}</tvar> to <tvar name=3>{{phpi|null}}</tvar>; if you wish to use the old, deprecated Tidy external binary, both set <tvar name=2>{{wg|TidyConfig}}</tvar> to <tvar name=3>{{phpi|null}}</tvar> and <tvar name=4>{{wg|UseTidy}}</tvar> to <tvar name=5>{{phpi|true}}</tvar>.</translate>
* <translate><!--T:123--> <tvar name=1>{{wg|LogAutopatrol}}</tvar> now defaults to <tvar name=2>{{phpi|false}}</tvar> instead of <tvar name=3>{{phpi|true}}</tvar>.</translate>
* <translate><!--T:124--> <tvar name=1>{{wg|ValidateAllHtml}}</tvar> was removed and will be ignored.</translate>
* <translate><!--T:125--> <tvar name=1>{{wg|ScriptExtension}}</tvar>, deprecated and ignored since 1.25, was removed. See the 1.25 release notes for more information.</translate>
* <translate><!--T:126--> {<tvar name=1>{wg|UseAjax}}</tvar> is now marked as deprecated, just like the deprecated AJAX framework that it enables. Some extensions mistakenly used this to check whether any AJAX functionality at all should be enabled, further making this problematic to retain.</translate>
* <translate><!--T:127--> <tvar name=1>{{wg|DBmysql5}}</tvar> is now deprecated, and will be removed in a future version. It has been marked as experimental ever since it was introduced.</translate>
* <translate><!--T:256--> <tvar name=1>{{wg|DBmwschema}}</tvar> now affects all database types. Old MediaWiki versions were setting this to 'mediawiki' during the installer, which may cause errors during the upgrade when your database is not PostgreSQL or MSSQL. In that case, remove this setting from LocalSettings.php.</translate>

<translate>
== Action API changes in 1.31 == <!--T:78-->
</translate>
* ({{phabT|185058}}) <translate><!--T:179--> The '<code>name</code>' value to <code>tgprop</code> for <code>action=query&list=tags</code> has been removed. It has never made a difference in the output, the name was always returned regardless.</translate>
* <translate><!--T:180--> The '<code>watch</code>' and '<code>unwatch</code>' parameters for <code>action=move</code> have been removed. They were deprecated and also accidentally nonfunctional since 1.17 in 2010. Use '<code>watchlist</code>' instead.</translate>

<translate>
== Other changes in 1.31 == <!--T:86-->
</translate>
* <translate><!--T:251--> Browser support for Internet Explorer 10 was lowered from Grade A to Grade C.</translate>
* <translate><!--T:252--> Browser support for Opera 12 and older was dropped entirely. Opera 15+ continues at Grade A.</translate>
* <translate><!--T:253--> Multi-content-revision capability was introduced into the storage layer. See <https://mediawiki.org/wiki/Requests_for_comment/Multi-Content_Revisions>.</translate>
* <translate><!--T:254--> The "<code>free</code>" CSS class is now only applied to unbracketed URLs in wikitext. Links written using square brackets will get the class "<code>text</code>", not "<code>free</code>".</translate>
* <translate><!--T:255--> {{phabricator|T157418}}: Whitespace is trimmed from wikitext headings, wikitext list items, wikitext table captions, wikitext table headings, wikitext table cells. HTML headings, HTML list items, HTML table captions, HTML table headings, HTML table cells will not have this trimming behavior.</translate>
* Add support for [http://www.php-fig.org/psr/psr-4/ PSR-4] namespace autoloading for PHP classes in core and extensions ({{phabricator|T173799}}, {{phabricator|T99865}}).

<translate>
== Subpages == <!--T:12-->
</translate>
{{engine|MediaWiki 1.31|work=MediaWiki 1.31}}
{{subpages}}
[[Category:MediaWiki Releases{{#translation:}}]]