= MediaWiki 1.36 = == MediaWiki 1.36.0-PRERELEASE == THIS IS NOT A RELEASE YET MediaWiki 1.36 is an alpha-quality development branch, and is not recommended for use in production. == Upgrading notes for 1.36 == 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. Some specific notes for MediaWiki 1.36 upgrades are below: * … For notes on 1.35.x and older releases, see HISTORY. === Configuration changes for system administrators in 1.36 === … ==== New configuration ==== * $wgManualRevertSearchRadius – this introduces a new feature that marks edits as reverts if they restore the page to an exact previous state. This configuration variable sets the maximum number of revisions of a page that will be checked against every new edit. Set this to 0 to disable the feature entirely. * … ==== Changed configuration ==== * … ==== Removed configuration ==== * $wgUseTwoButtonsSearchForm - This setting, deprecated in 1.35, has been removed. * … === New user-facing features in 1.36 === * All HTML5 named entities are now accepted in wikitext. * … === New developer features in 1.36 === * A new UnblockUser service was introduced that can be used for unblocking users. This was done to expose code previously present in SpecialUnblock to other parts of the code, or to extensions. * … === External library changes in 1.36 === * … ==== New external libraries ==== * … ===== New development-only external libraries ===== * … ==== Changed external libraries ==== * pear/mail_mime was upgraded from 1.10.8 to 1.10.9. * wikimedia/html-formatter was upgraded from 1.0.2 to 2.0.0. * Updated OOUI from 0.39.3 to 0.40.3. * … ===== Changed development-only external libraries ===== * … ==== Removed external libraries ==== * The html5shiv library has been removed, as support for Internet Explorer 8 has been dropped. * … === Bug fixes in 1.36 === * … === Action API changes in 1.36 === * … === Action API internal changes in 1.36 === * … === Languages updated in 1.36 === 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.36 === * Multiple methods that fell back to the $wgUser global variable were individually hard deprecated previously. The following have now been removed: - ApiTestCase::doLogin - File::delete - ForeignDBFile::delete - LocalFile::delete - LocalFile::deleteOld - PageArchive::undelete - RecentChange::markPatrolled - Title::getUserPermissionsErrors - Title::quickUserCan - Title::userCan - WebRequest::getLimitOffset - All methods of the old SpecialPageFactory; the entire class was removed * Multiple methods previously had optional User parameters, with fallbacks to the $wgUser global variable. Not passing a User to those methods was previously hard deprecated, and support for now passing a User has now been removed: - FileDeleteForm::__construct - LocalFileDeleteBatch::__construct - LogPage::addEntry (also accepts user id instead) - PatrolLog::record - Title::getNotificationTimestamp (though the entire method is deprecated) * The global function `wfWaitForSlaves`, deprecated in 1.27 and hard-deprecated in 1.35, has been removed. Use LBFactory::waitForReplication() instead. * The global variable $wgMemc, deprecated since 1.35, has been removed. Usage should generally be migrated to WANObjectCache, or if you really need the internal object, use ObjectCache::getLocalClusterInstance instead. * CategoryFinder, which was deprecated in 1.31 and hard-deprecated in 1.35, has been removed. * Sanitizer::escapeId(), deprecated in 1.30, has been removed. * Parser::setFunctionTagHook(), deprecated in 1.35, has been removed. * The ParserBeforeTidy hook, deprecated in 1.35, has been removed. * All methods of MWTidy except for MW::tidy() have been removed. These were either @internal or deprecated in 1.35. * The support for IE8 has been dropped. * Less mixin `.background-image-svg-quick()` from mediawiki.mixins.less, deprecated since 1.35, has been removed. * The ResourceLoader module `mediawiki.legacy.oldshared` and its file 'oldshared.css', deprecated since 1.35 has been removed (T248357). * The LinkBegin and LinkEnd hooks, deprecated in 1.28, have been removed. You can instead use the HtmlPageLinkRendererBegin and HtmlPageLinkRendererEnd hooks, respectively. * Skin::getDynamicStylesheetQuery(), deprecated in 1.32, has been removed. You should use action=raw&ctype=text/css directly. * Skin::makeI18nUrl(), deprecated in 1.35, has been removed. * The following User methods, deprecated and moved to BlockManager in 1.34, were removed: isDnsBlacklisted, inDnsBlacklist, isLocallyBlockedProxy, trackBlockWithCookie. * Support for v1 of the parser tests file format has been removed; it was deprecated in 1.35. (T174199) * SpecialUnblockUser::processUIUnblock() has a different return value (previously, array of messages or a boolean value, now, a Status object). This function was also marked as @internal and is no longer safe to call it publicly. * mw.Title.getDotExtension() from the 'mediawiki.Title' module was removed without deprecation. You should use mw.Title.getExtension() and prepend the dot if need be. * … === Deprecations in 1.36 === * The User class, which was marked as @newable in 1.35, is no longer newable, meaning that it is no longer safe to manually call the constructor via `new User`. Instead, use the UserFactory service. * Use of the `preprocessor=Preprocessor_DOM` option in parser test files has been deprecated. Preprocessor_DOM was removed in 1.35. * ParserOptions::setTidy() has been deprecated. It has had no effect since 1.35. * Sanitizer::escapeIdReferenceList() has been deprecated; it will eventually be made private to the class, as it appears to have no uses outside the Sanitizer class. * Sanitizer::hackDocType() is deprecated; it will eventually be made private. * Skin::getIndicatorsHTML() is deprecated. The functionality can be retained by reimplementing the method using the raw indicators data from OutputPage::getIndicators. * The PageProps class was converted to a service. PageProps::overrideInstance was deprecated, and MediaWikiServices::redefineService should be used instead. * Title::nameOf() is deprecated; use Title::newFromID()->getPrefixedDBkey() instead. * SpecialUnblock::processUnblock was deprecated - use UnblockUserFactory service instead. * Skin::getSearchLink(), also exposed as 'searchaction' option in SkinTemplate, has been deprecated. Use Title or SpecialPage methods directly. * Skin::getAllowedSkins and ::getSkinNames have been deprecated. Use their respective equivalents in SkinFactory instead. * The RollbackComplete hook has been deprecated, use the PageSaveComplete hook instead. * Skin::makeUrl() has been deprecated. Title methods should be used instead. * Skin::privacyLink(), Skin::disclaimerLink() and Skin::aboutLink() have been deprecated. Please use Skin::footerLink() instead. * Skin::getLogo() has been deprecated. Use ResourceLoaderSkinModule instead. * … === Other changes in 1.36 === * The 'tidy' key in ParserOptions (used in the parser cache) has been removed. It has had no effect since 1.35. * The implementation of TestFileReader::read has been changed to use Parsoid's parser test file parser. This should be compatible with existing code, but it only supports version 2 of the test file specification and may be more strict when parsing invalid input, including duplicate tests. * … == Compatibility == MediaWiki 1.36 requires PHP 7.2.22 or later, and the following PHP extensions: * ctype * dom * fileinfo * iconv * 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.2 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.