0a2869d0d10791585ea5e28a10f9677abc450c57
[lhc/web/wiklou.git] / HISTORY
1 Change notes from older releases. For current info see RELEASE-NOTES-1.30.
2
3 = MediaWiki 1.29 =
4
5 == MediaWiki 1.29.0 ==
6
7 === Configuration changes in 1.29 ===
8 * Default cookie expiration time has been reduced to 30 days. Login cookie
9 expiration time is kept at 180 days.
10 * A new configuration variable has been added: $wgCookieSetOnAutoblock. This
11 determines whether to set a cookie when a user is autoblocked. Doing so means
12 that a blocked user, even after logging out and moving to a new IP address,
13 will still be blocked.
14 * The resetpassword right and associated password reset capture feature has
15 been removed.
16 * The $error parameter to the EmailUser hook should be set to a Status object
17 or boolean false. This should be compatible with at least MediaWiki 1.23 if
18 not earlier. Returning a raw HTML string is now deprecated.
19 * The $message parameter to the ApiCheckCanExecute hook should be set to an
20 ApiMessage. This is compatible with MediaWiki 1.27 and later. Returning a
21 code for ApiBase::parseMsg() will no longer work.
22 * ApiBase::$messageMap is no longer public. Code attempting to access it will
23 result in a PHP fatal error.
24 * $wgUserEmailUseReplyTo is now true by default to work around restrictive DMARC
25 policies.
26 * Subpages are now enabled by default in the Template namespace. Set
27 $wgNamespacesWithSubpages[NS_TEMPLATE] to false to keep the old behavior.
28 * $wgRunJobsAsync is now false by default (T142751). This change only affects
29 wikis with $wgJobRunRate > 0.
30 * (T158474) "Unknown user" has been added to $wgReservedUsernames.
31 * (T156983) $wgRateLimitsExcludedIPs now accepts CIDR ranges as well as single IPs.
32 * $wgDummyLanguageCodes is deprecated. Additional language code mappings may be
33 added to $wgExtraLanguageCodes instead.
34 * (T161453) LocalisationCache will no longer use the temporary directory in it's
35 fallback chain when trying to work out where to write the cache.
36 * The user right 'editusercssjs' (deprecated in 1.16) was removed. Use
37 'editusercss' and 'edituserjs' in $wgGroupPermissions and elsewhere instead.
38
39 === New features in 1.29 ===
40 * (T5233) A cookie can now be set when a user is autoblocked, to track that user
41 if they move to a new IP address. This is disabled by default.
42 * Added ILocalizedException interface to standardize the use of localized
43 exceptions, largely so the API can handle them more sensibly.
44 * Blocks created automatically by MediaWiki, such as for configured proxies or
45 dnsbls, are now indicated as such and use a new i18n message when displayed.
46 * Added new $wgHTTPImportTimeout setting. Sets timeout for
47 downloading the XML dump during a transwiki import in seconds.
48 * Parser limit report is now available in machine-readable format to JavaScript
49 via mw.config.get('wgPageParseReport').
50 * Added $wgSoftBlockRanges, to allow for automatically blocking anonymous edits
51 from certain IP ranges (e.g. private IPs).
52 * (T59603) Added new magic word {{PAGELANGUAGE}} which returns the language code
53 of the page being parsed.
54 * HTML5 form validation attributes will no longer be suppressed. Originally
55 browsers had poor support for them, but modern browsers handle them fine.
56 This might affect some forms that used them and only worked because the
57 attributes were not actually being set.
58 * Expiry times can now be specified when users are added to user groups.
59 * Completely new user interface for the RecentChanges page, which
60 structures filters into user-friendly groups. This has corresponding
61 changes to how filters are registered by core and extensions.
62 * The edit form now uses pretty OOjs UI buttons, checkboxes and summary input.
63 Because this change can cause problems for extensions and on-wiki
64 scripts depending on the exact HTML, the old version is still available
65 and can be used by setting $wgOOUIEditPage = false; in LocalSettings.php.
66 This will be removed later and OOjs UI will become the only option.
67 To make testing easier, users can also force either mode by adding
68 &ooui=true or &ooui=false to the action=edit URL.
69
70 === External library changes in 1.29 ===
71
72 ==== Upgraded external libraries ====
73 * Updated QUnit from v1.22.0 to v1.23.1.
74 * Updated cssjanus from v1.1.2 to v1.2.0.
75 * Updated psr/log from v1.0.0 to v1.0.2.
76 * Update Moment.js from v2.8.4 to v2.15.0.
77 * Updated oyejorge/less.php from v1.7.0.10 to v1.7.0.14.
78 * Updated monolog from v1.18.2 to 1.22.1.
79 * Updated wikimedia/composer-merge-plugin from v1.3.1 to v1.4.0.
80 * Updated OOjs from v1.1.10 to v2.0.0.
81 * Updated jQuery from v1.11.3 to v3.2.1 (including jQuery Migrate v3.0.0).
82
83 ==== New external libraries ====
84 * Added wikimedia/timestamp v1.0.0.
85 * Added wikimedia/remex-html v1.0.1.
86
87 ==== Removed and replaced external libraries ====
88
89 === Bug fixes in 1.29 ===
90 * (T62604) Core parser functions returning a number now format the number according
91 to the page content language, not wiki content language.
92 * (T27187) Search suggestions based on jquery.suggestions will now correctly only
93 highlight prefix matches in the results.
94 * (T157035) "new mw.Uri()" was ignoring options when using default URI.
95 * Special:Allpages can no longer be filtered by redirect in miser mode.
96 * (T160519) CACHE_ANYTHING will not be CACHE_ACCEL if no accelerator is installed.
97 * (T109140) (T122209) SECURITY: Special:UserLogin and Special:Search allow redirect
98 to interwiki links.
99 * (T144845) SECURITY: XSS in SearchHighlighter::highlightText() when
100 $wgAdvancedSearchHighlighting is true.
101 * (T125177) SECURITY: API parameters may now be marked as "sensitive" to keep
102 their values out of the logs.
103 * (T150044) SECURITY: "Mark all pages visited" on the watchlist now requires a CSRF
104 token.
105 * (T156184) SECURITY: Escape content model/format url parameter in message.
106 * (T151735) SECURITY: SVG filter evasion using default attribute values in DTD
107 declaration.
108 * (T161453) SECURITY: LocalisationCache will no longer use the temporary directory
109 in it's fallback chain when trying to work out where to write the cache.
110 * (T48143) SECURITY: Spam blacklist ineffective on encoded URLs inside file inclusion
111 syntax's link parameter.
112 * (T108138) SECURITY: Sysops can undelete pages, although the page is protected against
113 it.
114
115 === Action API changes in 1.29 ===
116 * Submitting sensitive authentication request parameters to action=login,
117 action=clientlogin, action=createaccount, action=linkaccount, and
118 action=changeauthenticationdata in the query string is now an error. They
119 should be submitted in the POST body instead.
120 * The capture option for action=resetpassword has been removed
121 * action=clearhasmsg now requires a POST.
122 * (T47843) API errors and warnings may be requested in non-English languages
123 using the new 'errorformat', 'errorlang', and 'errorsuselocal' parameters.
124 * API error codes may have changed. Most notably, errors from modules using
125 parameter prefixes (e.g. all query submodules) will no longer be prefixed.
126 * ApiPageSet-using modules will report the 'invalidreason' using the specified
127 'errorformat'.
128 * action=emailuser may return a "Warnings" status, and now returns 'warnings' and
129 'errors' subelements (as applicable) instead of 'message'.
130 * action=imagerotate returns an 'errors' subelement rather than 'errormessage'.
131 * action=move now reports errors when moving the talk page as an array under
132 key 'talkmove-errors', rather than using 'talkmove-error-code' and
133 'talkmove-error-info'. The format for subpage move errors has also changed.
134 * action=revisiondelete no longer includes a "rendered" property on warnings
135 and errors for each item. Use errorformat=wikitext if you're wanting parsed
136 output.
137 * action=rollback no longer returns a "messageHtml" property. Use
138 errorformat=html if you're wanting HTML formatting of error messages.
139 * action=upload now reports optional stash failures as an array under key
140 'stasherrors' rather than a 'stashfailed' text string.
141 * action=watch reports 'errors' and 'warnings' instead of a single 'error', and
142 no longer returns a 'message' on success.
143 * Added action=validatepassword to validate passwords for the account creation
144 and password change forms.
145 * action=purge now requires a POST.
146 * There is a new `languagevariants` siprop for action=query&meta=siteinfo,
147 which returns a list of languages with active LanguageConverter instances.
148 * action=query&query=allpages will no longer filter redirects using a database
149 query in miser mode. This may result in less results being returned than were
150 requested.
151
152 === Action API internal changes in 1.29 ===
153 * New methods were added to ApiBase to handle errors and warnings using i18n
154 keys. Methods for using hard-coded English messages were deprecated:
155 * ApiBase::dieUsage() was deprecated
156 * ApiBase::dieUsageMsg() was deprecated
157 * ApiBase::dieUsageMsgOrDebug() was deprecated
158 * ApiBase::getErrorFromStatus() was deprecated
159 * ApiBase::parseMsg() was deprecated
160 * ApiBase::setWarning() was deprecated
161 * ApiBase::$messageMap is no longer public. Code attempting to access it will
162 result in a PHP fatal error.
163 * The $message parameter to the ApiCheckCanExecute hook should be set to an
164 ApiMessage. This is compatible with MediaWiki 1.27 and later. Returning a
165 code for ApiBase::parseMsg() will no longer work.
166 * UsageException is deprecated in favor of ApiUsageException. For the time
167 being ApiUsageException is a subclass of UsageException to allow things that
168 catch only UsageException to still function properly.
169 * If, for some strange reason, code was using an ApiErrorFormatter instead of
170 ApiErrorFormatter_BackCompat, note that the result format has changed and
171 various methods now take a module path rather than a module name.
172 * ApiMessageTrait::getApiCode() now strips 'apierror-' and 'apiwarn-' prefixes
173 from the message key, and maps some message keys for backwards compatibility.
174 * API parameters may now be marked as "sensitive" to keep their values out of
175 the logs.
176
177 === Languages updated in 1.29 ===
178
179 MediaWiki supports over 350 languages. Many localisations are updated
180 regularly. Below only new and removed languages are listed, as well as
181 changes to languages because of Phabricator reports.
182
183 * Based as always on linguistic studies on intelligibility and language
184 knowledge by geography, language fallbacks have been expanded. When a
185 translation is missing in the user's preferred interface language, the
186 corresponding translation for the fallback language will be used instead.
187 English will only be used as last resort when there are no translations.
188 Some configurations (such as date formats and gender namespaces) have also
189 been updated when using the fallback language's configuration was inadequate.
190 The new or reinstated language fallbacks are (after cs ↔ sk in 1.28):
191 ca ↔ oc; hsb ↔ dsb; io → eo; mdf → ru; pnt → el; roa-tara → it; rup → ro;
192 sh → bs, sr-el, hr.
193 * (T137376) New language support: Atikamekw (atj).
194 * (T163600) New language support: Dinka (din).
195 * (T155957) Talk Namespaces for Javanese language (jv) have been updated.
196
197 ==== No fallback for Ukrainian ====
198 * (T39314) The fallback from Ukrainian to Russian was removed. The Ukrainian
199 language will now use the default fallback language: English. When a translation
200 to Ukrainian is not available, an English string will be shown.
201
202 === Other changes in 1.29 ===
203 * Database::getSearchEngine() (deprecated in 1.28) was removed. Use
204 SearchEngineFactory::getSearchEngineClass() instead.
205 * $wgSessionsInMemcached (deprecated in 1.20) was removed. No replacement is
206 required as all sessions are stored in Object Cache now.
207 * MWHttpRequest::execute() should be considered to return a StatusValue; the
208 Status return type is deprecated.
209 * User::edits() (deprecated in 1.21) was removed.
210 * Xml::escapeJsString() (deprecated in 1.21) was removed.
211 * Article::getText() and Article::prepareTextForEdit() (deprecated in 1.21)
212 were removed.
213 * Article::getAutosummary() and WikiPage::getAutosummary() (deprecated in 1.21)
214 were removed.
215 * Hook ArticleViewCustom (deprecated in 1.21) was removed. Use ArticleContentViewCustom
216 instead.
217 * Hooks EditPageGetDiffText and ShowRawCssJs (deprecated in 1.21) were removed.
218 * Class RevisiondeleteAction (deprecated in 1.25) was removed.
219 * WikiPage::prepareTextForEdit() (deprecated in 1.21) was removed.
220 * WikiPage::getText() (deprecated in 1.21) was removed.
221 * Article::fetchContent() (deprecated in 1.21) was removed.
222 * User::getPassword() (deprecated in 1.27) was removed.
223 * User::getTemporaryPassword() (deprecated in 1.27) was removed.
224 * User::isPasswordReminderThrottled() (deprecated in 1.27) was removed.
225 * Class FSRepo (deprecated in 1.19) was removed.
226 * WebRequest::checkSessionCookie() (deprecated in 1.27) was removed. Use
227 \MediaWiki\Session\SessionManager::singleton()->getPersistedSessionId() instead.
228 * Class ImageGallery (deprecated in 1.22) was removed.
229 Use ImageGalleryBase::factory instead.
230 * Title::moveNoAuth() (deprecated in 1.25) was removed. Use MovePage class instead.
231 * Hook UnknownAction (deprecated in 1.19) was actually deprecated (it will now
232 emit warnings). Create a subclass of Action and add it to $wgActions instead.
233 * WikiRevision::getText() (deprecated since 1.21) is no longer marked deprecated.
234 * Linker::getInterwikiLinkAttributes() (deprecated since 1.25) was removed.
235 * Linker::getInternalLinkAttributes() (deprecated since 1.25) was removed.
236 * Linker::getInternalLinkAttributesObj() (deprecated since 1.25) was removed.
237 * Linker::getLinkAttributesInternal() (deprecated since 1.25) was removed.
238 * RedisConnectionPool::handleException (deprecated since 1.23) was removed.
239 * The static properties mw.Api.errors and mw.Api.warnings, containing incomplete
240 and outdated lists of errors/warnings returned by the API, are now deprecated.
241 * wiki.phtml entry point was removed. Refer to index.php instead. If you want "wiki.phtml"
242 URLs to continue to work, set up redirects. In Apache, this can be done by enabling
243 mod_rewrite and adding the following rules to your configuration:
244
245 RewriteEngine On
246 RewriteBase /
247 RewriteRule ^/w/wiki\.phtml$ /w/index.php [R=301,L]
248 * Hook ArticleAfterFetchContent (deprecated in 1.21) was removed.
249 Use ArticleAfterFetchContentObject instead.
250 * Hook ArticleInsertComplete (deprecated in 1.21) was removed.
251 Use PageContentInsertComplete instead.
252 * Hook ArticleSave (deprecated in 1.21) was removed.
253 Use PageContentSave instead.
254 * Hook ArticleSaveComplete (deprecated in 1.21) was removed.
255 Use PageContentSaveComplete instead.
256 * Hook EditFilterMerged (deprecated in 1.21) was removed.
257 Use EditFilterMergedContent instead.
258 * Hook EditPageGetPreviewText (deprecated in 1.21) was removed.
259 Use EditPageGetPreviewContent instead.
260 * Hook TitleIsCssOrJsPage (deprecated in 1.21) was removed.
261 Use ContentHandlerDefaultModelFor instead.
262 * Hook TitleIsWikitextPage (deprecated in 1.21) was removed.
263 Use ContentHandlerDefaultModelFor instead.
264 * Article::getContent() (deprecated in 1.21) was removed.
265 * Revision::getText() (deprecated in 1.21) was removed.
266 * Article::doEdit() and WikiPage::doEdit() (deprecated in 1.21) were removed.
267 * Parser::replaceUnusualEscapes() (deprecated in 1.24) was removed.
268 * Article::doEditContent() was marked as deprecated, to be removed in 1.30
269 or later.
270 * ContentHandler::runLegacyHooks() was removed.
271 * refreshLinks.php now can be limited to a particular category with --category=...
272 or a tracking category with --tracking-category=...
273 * User-like objects that are passed to SpecialUserRights and its subclasses are
274 now required to have a getGroupMemberships() method. See UserRightsProxy for
275 an example.
276 * User::$mGroups (instance variable) was marked private. Use User::getGroups()
277 instead.
278 * User::getGroupName(), User::getGroupMember(), User:getGroupPage(),
279 User::makeGroupLinkHTML(), and User::makeGroupLinkWiki() were deprecated.
280 Use equivalent methods on the UserGroupMembership class.
281 * Maintenance scripts and tests that call User::addGroup() must now ensure that
282 User objects have been added to the database prior to calling addGroup().
283 * Protected function UsersPager::getGroups() was removed, and protected function
284 UsersPager::buildGroupLink() was changed from a static to an instance method.
285 * The third parameter ($cache) to the UsersPagerDoBatchLookups hook was changed;
286 see docs/hooks.txt.
287 * User::crypt() (deprecated in 1.24) was removed.
288 * User::comparePasswords() (deprecated in 1.24) was removed.
289 * ArchivedFile::getUserText() (deprecated in 1.23) was removed.
290 * HTMLFileCache::newFromTitle() (deprecated in 1.24) was removed.
291 * BREAKING CHANGE: Internal signature changes to ChangesListSpecialPage
292 and subclasses. It should only break if you call buildMainQueryConds
293 (changed to buildQuery with new signature) or doMainQuery (new
294 signature). Subclasses are likely to call at least doMainQuery
295 (possibly both), but other classes might too, because they were
296 public.
297 Also, some related hooks were deprecated, but this is not yet a
298 breaking change.
299 * Removed 'jquery.arrowSteps' module. (deprecated since 1.28)
300 * The 'jquery.autoEllipsis' ResourceLoader module is now deprecated.
301 * WikiRevision::$fileIsTemp was deprecated.
302 * WikiRevision::$importer was deprecated.
303 * WikiRevision::$user was deprecated.
304 * Article::getLastPurgeTimestamp(), WikiPage::getLastPurgeTimestamp(), and the
305 WikiPage::PURGE_* constants are deprecated, and the functions will always
306 return false. They were a hack for an issue that has since been fixed.
307 * Hook 'EditPageBeforeEditChecks' is now deprecated. Instead use the new hook
308 'EditPageGetCheckboxesDefinition', or 'EditPage::showStandardInputs:options'
309 if you don't actually care about checkboxes and just want to add some HTML
310 to the page.
311 * Selflinks are now rendered as href-less <a> tags with the class mw-selflink
312 rather than <strong> tags. The old class name, "selflink", was deprecated
313 and will be removed in a future release. (T160480)
314 * (T156184) $wgRawHtml will no longer apply to internationalization messages.
315 * Browser support for non-ES5 JavaScript browsers, including Android 2,
316 Opera <12.10, and Internet Explorer 9, was lowered from Grade A to Grade C.
317 * Removed wikibits global methods deprecated since MediaWiki 1.17 (T122755):
318 is_gecko, is_chrome_mac, is_chrome, webkit_version, is_safari_win, is_safari,
319 webkit_match, is_ff2, ff2_bugs, is_ff2_win, is_ff2_x11, opera95_bugs,
320 opera7_bugs, opera6_bugs, is_opera_95, is_opera_preseven, is_opera,
321 ie6_bugs, clientPC, changeText, killEvt, addHandler, hookEvent,
322 addClickHandler, removeHandler, getElementsByClassName, getInnerText,
323 setupCheckboxShiftClick, addCheckboxClickHandlers, mwEditButtons,
324 mwCustomEditButtons, injectSpinner, removeSpinner, escapeQuotes,
325 escapeQuotesHTML, jsMsg, addPortletLink, appendCSS, tooltipAccessKeyPrefix,
326 tooltipAccessKeyRegexp, updateTooltipAccessKeys.
327 * The ID of the <li> element containing the login link has changed from
328 'pt-login' to 'pt-login-private' in private wikis.
329 * The old, neglected "bulletin board style toolbar" in the edit form is now
330 deprecated (T30856). This old code dates from 2006, and was replaced in the
331 MediaWiki release tarball and in Wikimedia production by the WikiEditor
332 extension in 2010. It is only shown to users if no other editor was
333 installed, and leads to confusion.
334 * (T92459) Loading ResourceLoader modules containing JavaScript through
335 addModuleStyles() is deprecated and will log a warning server-side.
336
337 = MediaWiki 1.28 =
338
339 == MediaWiki 1.28.1 ==
340
341 This is a security and maintenance release of the MediaWiki 1.28 branch.
342
343 === Changes since 1.28.0 ===
344
345 * $wgRunJobsAsync is now false by default (T142751). This change only affects
346 wikis with $wgJobRunRate > 0.
347 * Fix fatal from "WaitConditionLoop" not being found, experienced when a wiki has
348 more than one database server setup.
349 * (T152717) Better escaping for PHP mail() command,
350 * (T154670) A missing method causing the MySQL installer to fatal in rare
351 circumstances was restored.
352 * (T154672) Un-deprecate ArticleAfterFetchContentObject hook.
353 * (T158766) Avoid SQL error on MSSQL when using selectRowCount().
354 * (T145635) Fix too long index error when installing with MSSQL.
355 * (T156184) $wgRawHtml will no longer apply to internationalization messages.
356 * (T160519) CACHE_ANYTHING will not be CACHE_ACCEL if no accelerator is installed.
357 * (T154872) Fix incorrect ar_usertext_timestamp index names in new 1.28 installs.
358 * (T109140) (T122209) SECURITY: Special:UserLogin and Special:Search allow redirect
359 to interwiki links.
360 * (T144845) SECURITY: XSS in SearchHighlighter::highlightText() when
361 $wgAdvancedSearchHighlighting is true.
362 * (T125177) SECURITY: API parameters may now be marked as "sensitive" to keep
363 their values out of the logs.
364 * (T150044) SECURITY: "Mark all pages visited" on the watchlist now requires a CSRF
365 token.
366 * (T156184) SECURITY: Escape content model/format url parameter in message.
367 * (T151735) SECURITY: SVG filter evasion using default attribute values in DTD
368 declaration.
369 * (T161453) SECURITY: LocalisationCache will no longer use the temporary directory
370 in it's fallback chain when trying to work out where to write the cache.
371 * (T48143) SECURITY: Spam blacklist ineffective on encoded URLs inside file inclusion
372 syntax's link parameter.
373 * (T108138) SECURITY: Sysops can undelete pages, although the page is protected against
374 it.
375
376 == MediaWiki 1.28 ==
377
378 === Changes since 1.28.0-rc1 ===
379 * (T148957) Replace wgShowExceptionDetails with wgShowDBErrorBacktrace on db
380 errors.
381 * (T148956) Only apply wgDBschema to postgres/mssql.
382 * (T145991) Introduce separate log action for deleting pages on move.
383 * (T141474) (T110464) Bypass login page if no user input is required.
384
385 === Changes since 1.28.0-rc0 ===
386 * (T142210) The changes to move the parser "NewPP limit report" from a HTML
387 comment to a machine-readable JavaScript config option 'wgPageParseReport'
388 have been undone. They caused the human-readable limit report to be shown
389 incompletely or not at all. ParserOutput::setLimitReportData() and
390 getLimitReportData() behave as they did in MediaWiki 1.27 again.
391 * (T149510) Value of {{DISPLAYTITLE:}} parser function will not be used for
392 the text of subheadings on a category page when creating it. This wasn't
393 working correctly.
394 * (T106793) MediaWiki will no longer try to perform a HTTP redirect to the
395 canonical pretty URL when a non-pretty URL is used. It resulted in redirect
396 loops in some clients and in some server configurations. This undoes a change
397 made in MediaWiki 1.26.
398 * (T149759) manifest_version: 2 was removed.
399
400 === Configuration changes in 1.28 ===
401 * $wgSend404Code now affects status code of action=history if the page is not there.
402 * BREAKING CHANGE: $wgHTTPProxy is now *required* for all external requests
403 made by MediaWiki via a proxy. Relying on the http_proxy environment
404 variable is no longer supported.
405 * The load.php entry point now enforces the existing policy of not allowing
406 access to session data, which includes the session user and the session
407 user's language. If such access is attempted, an exception will be thrown.
408 * The number of internal PBKDF2 iterations used to derive the session secret
409 is configurable via $wgSessionPbkdf2Iterations.
410 * Upload dialog's file upload log comment can now be configured separately for
411 local and foreign uploads.
412 * $wgForeignUploadTargets now defaults to `[ 'local' ]`, where `'local'`
413 signifies local uploads. A value of `[]` (empty array) now means that
414 no upload targets are allowed, effectively disabling the upload dialog.
415 * The deprecated $wgEditEncoding variable has been removed; it was only used
416 for Esperanto language character conversion. You are now recommended to use
417 input methods provided by the UniversalLanguageSelector extension.
418 * When $wgPingback is true, MediaWiki will periodically ping
419 https://www.mediawiki.org/beacon with basic information about the local
420 MediaWiki installation. This data includes, for example, the type of system,
421 PHP version, and chosen database backend. This behavior is off by default.
422 * When $wgEditSubmitButtonLabelPublish is true, MediaWiki will label the button
423 to store-to-database-and-show-to-others as "Publish page"/"Publish changes";
424 if false, the default, they will be "Save page"/"Save changes".
425 * The 'editcontentmodel' permission is now granted to all logged-in users ('user').
426 instead of just administrators ('sysop'). Documentation for this feature is
427 available at <https://www.mediawiki.org/wiki/Help:ChangeContentModel>.
428 * $wgRevisionCacheExpiry is now set to one week by default instead of being disabled.
429 * Magic links are now disabled by default, and can be re-enabled by modifying the value
430 of $wgEnableMagicLinks. Their usage is discouraged, but if they are manually enabled,
431 a tracking category will be added to help identify usage and make it easier to migrate
432 away from. If you depend upon magic link functionality, it is requested that you comment
433 on <https://www.mediawiki.org/wiki/Requests_for_comment/Future_of_magic_links> and
434 explain your use case(s).
435 * New config variable $wgCSPFalsePositiveUrls to control what URLs to ignore
436 in upcoming Content-Security-Policy feature's reporting.
437
438 === New features in 1.28 ===
439 * User::isBot() method for checking if an account is a bot role account.
440 * Added a new 'slideshow' mode for galleries.
441 * Added a new hook, 'UserIsBot', to aid in determining if a user is a bot.
442 * Added a new hook, 'ApiMakeParserOptions', to allow extensions to better
443 interact with API parsing.
444 * Added a new hook, 'UploadVerifyUpload', which can be used to reject a file
445 upload. Unlike 'UploadVerifyFile' it provides information about upload comment
446 and the file description page, but does not run for uploads to stash.
447 * (T141604) Extensions can now provide a better error message when their
448 maintenance scripts are run without the extension being installed.
449 * (T8948) Numeric sorting in categories is now supported by setting $wgCategoryCollation
450 to 'uca-default-u-kn' or 'uca-<langcode>-u-kn'. If you can't use UCA collations,
451 a 'numeric' collation is also available. If migrating from another
452 collation, you will need to run the updateCollation.php maintenance script.
453 * Two new codes have been added to #time parser function: "xit" for days in current
454 month, and "xiz" for days passed in the year, both in Iranian calendar.
455 * mw.Api has a new option, useUS, to use U+001F (Unit Separator) when
456 appropriate for sending multi-valued parameters. This defaults to true when
457 the mw.Api instance seems to be for the local wiki.
458 * After a client performs an action which alters a database that has replica databases,
459 MediaWiki will wait for the replica databases to synchronize with the master database
460 while it renders the HTML output. However, if the output is a redirect to another wiki
461 on the wiki farm with a different domain, MediaWiki will instead alter the redirect
462 URL to include a ?cpPosTime parameter that triggers the database synchronization when
463 the URL is followed by the client. The same-domain case uses a new cpPosTime cookie.
464 * Added new hooks, 'ApiQueryBaseBeforeQuery', 'ApiQueryBaseAfterQuery', and
465 'ApiQueryBaseProcessRow', to make it easier for extensions to add 'prop' and
466 'show' parameters to existing API query modules.
467
468 === External library changes in 1.28 ===
469
470 ==== Upgraded external libraries ====
471 * Updated es5-shim from v4.1.5 to v4.5.8
472 * Updated composer/semver from v1.4.1 to v1.4.2
473 * Updated wikimedia/php-session-serializer from v1.0.3 to v1.0.4
474
475 ==== New external libraries ====
476 * Added wikimedia/scoped-callback v1.0.0
477 * Added wikimedia/wait-condition-loop v1.0.1
478
479 === Bug fixes in 1.28 ===
480 * (T146496) action=history pages should return 404 HTTP error code if the page does not exist
481 * (T137264) SECURITY: XSS in unclosed internal links
482 * (T133147) SECURITY: Escape '<' and ']]>' in inline <style> blocks
483 * (T133147) SECURITY: Require login to preview user CSS pages
484 * (T132926) SECURITY: Do not allow undeleting a revision deleted file if it is
485 the top file
486 * (T129738) SECURITY: Make $wgBlockDisablesLogin also restrict logged in
487 permissions
488 * (T129738) SECURITY: Make blocks log users out if $wgBlockDisablesLogin is true
489 * (T139670) Move 'UserGetRights' call before application of
490 Session::getAllowedUserRights()
491
492 === Action API changes in 1.28 ===
493 * Added 'maxarticlesize' property to action=query&meta=siteinfo which contains
494 the value of $wgMaxArticleSize.
495 * Property 'modulemessages' from action=parse&prop=modules was removed
496 (deprecated since 1.26).
497 * The following response properties from action=login, deprecated in 1.27, are
498 now removed: lgtoken, cookieprefix, sessionid. Clients should handle cookies
499 to properly manage session state.
500 * Submitting the lgtoken and lgpassword parameters in the query string to
501 action=login is now deprecated and outputs a warning. They should be submitted
502 in the POST body instead.
503 * Submitting sensitive authentication request parameters to action=clientlogin,
504 action=createaccount, action=linkaccount, and action=changeauthenticationdata
505 in the query string is now deprecated and outputs a warning. They should be
506 submitted in the POST body instead.
507 * (T141960) Multi-valued parameters may now be separated using U+001F (Unit Separator)
508 instead of the pipe character. This will be useful if some of the multiple
509 values need to contain pipes, e.g. for action=options.
510 * The API will now warn if input is not NFC-normalized Unicode or if it
511 contains invalid characters.
512 * The 'normalized' list output by action=query and other modules that use
513 ApiPageSet may contain entries where the 'from' value is percent-encoded as
514 the raw value cannot be represented in a valid API response. These are
515 indicated by a 'fromencoded' boolean alongside the existing 'from' parameter.
516 * (T28680) action=paraminfo can now return info about all submodules of a
517 module without listing them all explicitly.
518 * (T146770) It is now possible to assert that the current user is a specific
519 named user, using the 'assertuser' parameter.
520 * (T141963) Added a 'known' property when missing-but-known titles (e.g. from
521 the 'TitleIsAlwaysKnown' hook) are output in various modules.
522
523 === Action API internal changes in 1.28 ===
524 * Added a new hook, 'ApiMakeParserOptions', to allow extensions to better
525 interact with ApiParse and ApiExpandTemplates.
526 * (T139565) SECURITY: API: Generate head items in the context of the given title
527 * (T115333) SECURITY: Check read permission when loading page content in ApiParse
528 * ApiBase::getResultData() was removed (deprecated since 1.25)
529 * ApiBase::makeHelpArrayToString() was removed (deprecated since 1.25)
530 * ApiBase::makeHelpMsgParameters() was removed (deprecated since 1.25)
531 * ApiBase::makeHelpMsg() was removed (deprecated since 1.25)
532 * ApiFormatBase::formatHTML() was removed (deprecated since 1.25)
533 * ApiFormatBase::getNeedsRawData() was removed (deprecated since 1.25)
534 * ApiFormatBase::getWantsHelp() was removed (deprecated since 1.25)
535 * ApiFormatBase::setBufferResult() was removed (deprecated since 1.25)
536 * ApiFormatBase::setHelp() was removed (deprecated since 1.25)
537 * ApiFormatBase::setUnescapeAmps() was removed (deprecated since 1.25)
538 * ApiMain::makeHelpMsgHeader() was removed (deprecated since 1.25)
539 * ApiMain::reallyMakeHelpMsg() was removed (deprecated since 1.25)
540 * ApiMain::setHelp() was removed (deprecated since 1.25)
541 * ApiResult::beginContinuation() was removed (deprecated since 1.25)
542 * ApiResult::cleanUpUTF8() was removed (deprecated since 1.25)
543 * ApiResult::convertStatusToArray() was removed (deprecated since 1.25)
544 * ApiResult::disableSizeCheck() was removed (deprecated since 1.24)
545 * ApiResult::enableSizeCheck() was removed (deprecated since 1.24)
546 * ApiResult::endContinuation() was removed (deprecated since 1.25)
547 * ApiResult::getData() was removed (deprecated since 1.25)
548 * ApiResult::getIsRawMode() was removed (deprecated since 1.25)
549 * ApiResult::setContent() was removed (deprecated since 1.25)
550 * ApiResult::setContinueParam() was removed (deprecated since 1.25)
551 * ApiResult::setElement() was removed (deprecated since 1.25)
552 * ApiResult::setGeneratorContinueParam() was removed (deprecated since 1.25)
553 * ApiResult::setIndexedTagName_internal() was removed (deprecated since 1.25)
554 * ApiResult::setIndexedTagName_recursive() was removed (deprecated since 1.25)
555 * ApiResult::setMainForContinuation() was removed (deprecated since 1.25)
556 * ApiResult::setParsedLimit() was removed (deprecated since 1.25)
557 * ApiResult::setRawMode() was removed (deprecated since 1.25)
558 * ApiResult::size() was removed (deprecated since 1.25)
559 * Added new hooks, 'ApiQueryBaseBeforeQuery', 'ApiQueryBaseAfterQuery', and
560 'ApiQueryBaseProcessRow', to make it easier for extensions to add 'prop' and
561 'show' parameters to existing API query modules. A query module can enable
562 these hooks by passing an array for $hookData to ApiQueryBase::select() and
563 by calling ApiQueryBase->processRow() before adding a row's data to the
564 result.
565
566 === Languages updated in 1.28 ===
567
568 MediaWiki supports over 375 languages. Many localisations are updated
569 regularly. Below only new and removed languages are listed, as well as
570 changes to languages because of Phabricator reports.
571
572 * (T137411) ban (Balinese), thanks to translators Adi Mayndra, Andru,
573 BASAbali, M. Adiputra, Naval Scene, Nemo bis, NoiX180, and 아라.
574 * (T135867) shn (Shan), thanks to translators Khun Sar, Piangpha,
575 Saiddzone Saimawnkham, Saosukham, and Sengwan.
576 * Czech (cs) and Slovak (sk) set as reciprocal fallbacks.
577 * (T146744) Livvi-Karelian (olo) namespace messages created thanks to translator Ilja.mos.
578
579 === Other changes in 1.28 ===
580 * (T128697) Improved handling of large diffs.
581 * [BREAKING CHANGE] $wgExtendedLoginCookies has been removed. You can
582 use or update a custom session provider if needed.
583 * Deprecated APIEditBeforeSave hook in favor of EditFilterMergedContent.
584 * The 'UploadVerification' hook is deprecated. Use 'UploadVerifyFile' instead.
585 * SiteConfiguration::isLocalVHost() was removed (deprecated since 1.25).
586 * The 'UserLoginComplete' hook has a new parameter to differentiate between actual
587 login and visiting the login page while already logged in.
588 * ResourceLoader::makeLoaderURL() was removed (deprecated since 1.24).
589 * $.fn.liveAndTestAtStart was removed (deprecated since 1.24).
590 * mw.util.tooltipAccessKeyPrefix was removed (deprecated since 1.24).
591 * mw.util.tooltipAccessKeyRegexp was removed (deprecated since 1.24).
592 * Linker::link() and Linker::linkKnown() were deprecated; please instead use
593 MediaWiki\Linker\LinkRenderer. In addition, the LinkBegin and LinkEnd hooks
594 were replaced by HtmlPageLinkRendererBegin and HtmlPageLinkRendererEnd
595 respectively. See docs/hooks.txt for the specific changes needed for those hooks.
596 * Linker::formatSize() was deprecated. Use Language::formatSize() directly.
597 * Aliases for Linker methods, deprecated since 1.21, were removed from Skin:
598 * Skin::commentBlock() (use Linker::commentBlock() instead)
599 * Skin::generateRollback() (use Linker::generateRollback() instead)
600 * Skin::link() (use MediaWiki\Linker\LinkRenderer instead)
601 * Skin::linkKnown() (use MediaWiki\Linker\LinkRenderer instead)
602 * Skin::userLink() (use Linker::userLink() instead)
603 * Skin::userToolLinks() (use Linker::userToolLinks() instead)
604 * Disabled "bug 2702" HTML tidying of parsed UI messages on wikis where Tidy is
605 disabled.
606 * DifferenceEngine::generateDiffBody() was removed (deprecated since 1.21).
607 * UploadBase::stashFileGetKey() and UploadBase::stashSession() were deprecated.
608 Use ...->stashFile()->getFileKey() instead.
609 * "Public domain" was removed as a wiki license option from the installer, in
610 favour of CC-0.
611 * AuthenticationRequest::$required is now changed from REQUIRED to PRIMARY_REQUIRED
612 on requests needed by primary providers even if all primaries need them.
613 Primary providers are discouraged from returning multiple REQUIRED requests.
614 * OOjs UI PHP widgets constructed with the `'infusable' => true` config option
615 will no longer be automatically infused. You should call `OO.ui.infuse()`
616 on them yourself from your JavaScript code.
617 * parserTests.php has moved to tests/parser/parserTests.php
618 * The command line options specific to parser tests have been removed from
619 phpunit.php: --regex and --keep-uploads. Instead of --regex, use --filter.
620 Instead of --keep-uploads, use the same option to parserTests.php, but you
621 must specify a directory with --upload-dir.
622 * The 'jquery.arrowSteps' ResourceLoader module is now deprecated.
623 * IP::isConfiguredProxy() and IP::isTrustedProxy() were removed. Callers should
624 migrate to using the same functions on a ProxyLookup instance, obtainable from
625 MediaWikiServices.
626 * The ArticleAfterFetchContent, ArticleInsertComplete, ArticleSave, ArticleSaveComplete,
627 ArticleViewCustom, EditFilterMerged, EditPageGetDiffText, EditPageGetPreviewText and
628 ShowRawCssJs hooks will now emit deprecation warnings if used.
629 * (T68404) CSS3 attr() function with url type is no longer allowed
630 in inline styles.
631 * Database::getSearchEngine() is deprecated, use SearchEngineFactory::getSearchEngineClass
632 instead.
633
634 == Compatibility ==
635
636 MediaWiki 1.28 requires PHP 5.5.9 or later. There is experimental support for
637 HHVM 3.6.5 or later.
638
639 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
640 support for them is somewhat less mature. There is experimental support for
641 Oracle and Microsoft SQL Server.
642
643 The supported versions are:
644
645 * MySQL 5.0.3 or later
646 * PostgreSQL 8.3 or later
647 * SQLite 3.3.7 or later
648 * Oracle 9.0.1 or later
649 * Microsoft SQL Server 2005 (9.00.1399)
650
651 == Upgrading ==
652
653 1.28 has several database changes since 1.27, and will not work without schema
654 updates. Note that due to changes to some very large tables like the revision
655 table, the schema update may take quite long (minutes on a medium sized site,
656 many hours on a large site).
657
658 If upgrading from before 1.11, and you are using a wiki as a commons
659 repository, make sure that it is updated as well. Otherwise, errors may arise
660 due to database schema changes.
661
662 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
663 new database fields are filled with data.
664
665 If you are upgrading from MediaWiki 1.4.x or earlier, you should upgrade to
666 1.5 first. The upgrade script maintenance/upgrade1_5.php has been removed
667 with MediaWiki 1.21.
668
669 Don't forget to always back up your database before upgrading!
670
671 See the file UPGRADE for more detailed upgrade instructions.
672
673 For notes on 1.27.x and older releases, see HISTORY.
674
675 == Online documentation ==
676
677 Documentation for both end-users and site administrators is available on
678 MediaWiki.org, and is covered under the GNU Free Documentation License (except
679 for pages that explicitly state that their contents are in the public domain):
680
681 https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
682
683 == Mailing list ==
684
685 A mailing list is available for MediaWiki user support and discussion:
686
687 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
688
689 A low-traffic announcements-only list is also available:
690
691 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
692
693 It's highly recommended that you sign up for one of these lists if you're
694 going to run a public MediaWiki, so you can be notified of security fixes.
695
696 == IRC help ==
697
698 There's usually someone online in #mediawiki on irc.freenode.net.
699
700 = MediaWiki 1.27 =
701
702 == MediaWiki 1.27.3 ==
703 Due to a packaging error, the wrong version of the SyntaxHighlight extension was
704 included in the tarball version of MediaWiki 1.27.2. The version included had a
705 serious security issue in it (T158689). There was also some minor code fixes in
706 MediaWiki itself since 1.27.2, but none of them were security relevant.
707
708 === Changes since 1.27.2 ===
709 * (T145664) Fix broken wincache merge() implementation
710 * (T163434) Add wikimedia/testing-access-wrapper for forwards compatibility
711 * (T153505) Fix php warnings on php 7.1 due to use of &$this
712
713 == MediaWiki 1.27.2 ==
714 This is a security and maintenance release of the MediaWiki 1.27 branch.
715
716 ApiCreateAccount was removed in 1.27.0. It was incorrectly still marked as
717 deprecated (rather than already removed) in the RELEASE-NOTES at the point 1.27.0
718 was released.
719
720 === Changes since 1.27.1 ===
721
722 * (T68404) CSS3 attr() function with url type argument is no longer allowed
723 in inline styles.
724 * $wgRunJobsAsync is now false by default (T142751). This change only affects
725 wikis with $wgJobRunRate > 0.
726 * (T152717) Better escaping for PHP mail() command
727 * Submitting the lgtoken and lgpassword parameters in the query string to
728 action=login is now deprecated and outputs a warning. They should be submitted
729 in the POST body instead.
730 * Submitting sensitive authentication request parameters to action=clientlogin,
731 action=createaccount, action=linkaccount, and action=changeauthenticationdata
732 in the query string is now deprecated and outputs a warning. They should be
733 submitted in the POST body instead.
734 * (T158766) Avoid SQL error on MSSQL when using selectRowCount()
735 * (T145635) Fix too long index error when installing with MSSQL.
736 * (T156184) $wgRawHtml will no longer apply to internationalization messages.
737 * (T160519) CACHE_ANYTHING will not be CACHE_ACCEL if no accelerator is installed.
738 * (T109140) (T122209) SECURITY: Special:UserLogin and Special:Search allow redirect
739 to interwiki links.
740 * (T144845) SECURITY: XSS in SearchHighlighter::highlightText() when
741 $wgAdvancedSearchHighlighting is true.
742 * (T125177) SECURITY: API parameters may now be marked as "sensitive" to keep
743 their values out of the logs.
744 * (T150044) SECURITY: "Mark all pages visited" on the watchlist now requires a CSRF
745 token.
746 * (T156184) SECURITY: Escape content model/format url parameter in message.
747 * (T151735) SECURITY: SVG filter evasion using default attribute values in DTD
748 declaration.
749 * (T161453) SECURITY: LocalisationCache will no longer use the temporary directory
750 in it's fallback chain when trying to work out where to write the cache.
751 * (T48143) SECURITY: Spam blacklist ineffective on encoded URLs inside file inclusion
752 syntax's link parameter.
753 * (T108138) SECURITY: Sysops can undelete pages, although the page is protected against
754 it.
755
756 == MediaWiki 1.27.1 ==
757
758 This is a maintenance release of the MediaWiki 1.27 branch.
759
760 === Changes since 1.27.0 ===
761 * BREAKING CHANGE: $wgHTTPProxy is now *required* for all external requests
762 made by MediaWiki via a proxy. Relying on the http_proxy environment
763 variable is no longer supported.
764 * (T139565) SECURITY: API: Generate head items in the context of the given title
765 * (T137264) SECURITY: XSS in unclosed internal links
766 * (T133147) SECURITY: Escape '<' and ']]>' in inline <style> blocks
767 * (T133147) SECURITY: Require login to preview user CSS pages
768 * (T132926) SECURITY: Do not allow undeleting a revision deleted file if it is
769 the top file
770 * (T129738) SECURITY: Make $wgBlockDisablesLogin also restrict logged in
771 permissions
772 * (T129738) SECURITY: Make blocks log users out if $wgBlockDisablesLogin is true
773 * (T115333) SECURITY: Check read permission when loading page content in ApiParse
774 * (T57548) Remove support for $wgWellFormedXml = false, all output is now well formed
775 * (T139670) Move 'UserGetRights' call before application of Session::getAllowedUserRights()
776
777 == MediaWiki 1.27.0 ==
778
779 === PHP version requirement in 1.27 ===
780 As of 1.27, MediaWiki now requires PHP 5.5.9 or higher (see Compatibility
781 section). Additionally, the following PHP extensions are required:
782 * ctype
783 * iconv
784 * json
785 * mbstring (new requirement in 1.27)
786 * xml
787 The following PHP extensions are strongly recommended:
788 * openssl
789
790 === Configuration changes in 1.27 ===
791 * $wgAllowMicrodataAttributes and $wgAllowRdfaAttributes were removed,
792 now always enabled. If you use RDFa on your wiki, you now have to explicitly
793 set $wgHtml5Version to 'HTML+RDFa 1.0' or 'XHTML+RDFa 1.0'.
794 * $wgUseLinkNamespaceDBFields was removed.
795 * Deprecated $wgResourceLoaderMinifierStatementsOnOwnLine and
796 $wgResourceLoaderMinifierMaxLineLength, because there was little value in
797 making the behavior configurable. The default values (`false` for the former,
798 1000 for the latter) are now hard-coded.
799 * $wgDebugDumpSqlLength was removed (deprecated in 1.24).
800 * $wgDebugDBTransactions was removed (deprecated in 1.20).
801 * $wgUseXVO has been removed, as it provides functionality only used by
802 custom Wikimedia patches against Squid 2.x that probably noone uses in
803 production anymore. There is now $wgUseKeyHeader that provides similar
804 functionality but instead of the MediaWiki-specific X-Vary-Options header,
805 uses the draft Key header standard.
806 * $wgScriptExtension (and support for '.php5' entry points) was removed. See the
807 deprecation notice in the release notes for version 1.25 for advice on how to
808 preserve support for '.php5' entry points via URL rewriting.
809 * Password handling via the User object has been deprecated and partially
810 removed, pending the future introduction of AuthManager. In particular:
811 ** expirePassword(), getPasswordExpireDate(), resetPasswordExpiration(), and
812 getPasswordExpired() have been removed. They were unused outside of core.
813 ** The mPassword, mNewpassword, mNewpassTime, and mPasswordExpires fields are
814 now private and will be removed in the future.
815 ** The getPassword() and getTemporaryPassword() methods now throw
816 BadMethodCallException and will be removed in the future.
817 ** The ability to pass 'password' and 'newpassword' to createNew() has been
818 removed. The only users of it seem to have been using it to set invalid
819 passwords, and so shouldn't be greatly affected.
820 ** setPassword(), setInternalPassword(), and setNewpassword() have been
821 deprecated, pending the introduction of AuthManager.
822 ** User::randomPassword() is deprecated in favor of a new method
823 PasswordFactory::generateRandomPasswordString()
824 ** User::getPasswordFactory() is deprecated, callers should just create a
825 PasswordFactory themselves.
826 ** A new constructor, User::newSystemUser(), has been added to simplify the
827 creation of passwordless "system" users for logged actions.
828 * $wgMaxSquidPurgeTitles was removed.
829 * $wgAjaxWatch was removed. This is now enabled by default.
830 * $wgUseInstantCommons now hotlinks Commons images by default instead of
831 downloading originals and thumbnailing them locally. This allows wikis to save
832 on CPU and bandwidth while reducing time to first byte for pages, even without
833 a thumbnail handler. See $wgForeignFileRepos documentation for tweaks.
834 * (T27397) WebP is enabled by default as an uploadable filetype.
835 * (T48998) $wgArticlePath must now be either a full url, or start with a "/".
836 * $wgRateLimitLog was removed; use $wgDebugLogGroups['ratelimit'] instead.
837 * Deprecated API formats dbg, txt, and yaml have been removed.
838 * CLDRPluralRule* classes have been replaced with
839 wikimedia/cldr-plural-rule-parser.
840 * Removed $wgProfilePerHost, $wgUDPProfilerHost, $wgUDPProfilerPort,
841 $wgUDPProfilerFormatString, $wgStatsMethod, $wgAggregateStatsID,
842 $wgStatsFormatString, and $wgProfileCallTree (deprecated since 1.20).
843 * For proper operation of LocalIdLookup with shared user tables, ensure that
844 $wgSharedDB and $wgSharedTables are properly set even on the "central" wiki
845 that all others are sharing from and that $wgLocalDatabases is set to the
846 full list of sharing wikis on all those wikis.
847 * Massive overhaul to session handling:
848 ** $wgSessionsInObjectCache is no longer supported and must be true, due to
849 MediaWiki\Session\SessionManager. $wgSessionHandler is similarly no longer
850 used.
851 ** ObjectCacheSessionHandler is removed, replaced with
852 MediaWiki\Session\PhpSessionHandler.
853 ** PHP session handling in general ($_SESSION, session_id(), and so on) is
854 deprecated. Use MediaWiki\Session\SessionManager instead. A new config
855 variable, $wgPHPSessionHandling, is available to cause use of $_SESSION to
856 issue a deprecation warning or to cause most PHP session handling to throw
857 exceptions.
858 ** Deprecated UserSetCookies hook. Session-handling extensions should generally
859 be creating a custom subclass of CookieSessionProvider. Other extensions
860 messing with cookies can no longer count on user data being saved in cookies
861 versus other methods.
862 ** Deprecated UserLoadFromSession hook, extensions should create a
863 MediaWiki\Session\SessionProvider.
864 ** The User cannot be loaded from session until after Setup.php completes.
865 Attempts to do so will be ignored and the User will remain unloaded.
866 ** CSRF tokens may be fetched from the MediaWiki\Session\Session, which uses
867 the MediaWiki\Session\Token class.
868 * MediaWiki will now auto-create users as necessary, removing the need for
869 extensions to do so. An 'autocreateaccount' right is added to allow
870 auto-creation when 'createaccount' is not granted to all users.
871 * Deprecated AuthPluginAutoCreate hook in favor of LocalUserCreated.
872 * Most cookie-handling methods in User are deprecated.
873 * $wgAllowAsyncCopyUploads and $CopyUploadAsyncTimeout were removed. This was an
874 experimental feature that has never worked.
875 * Login and createaccount tokens now vary by timestamp.
876 * LoginForm::getLoginToken() and LoginForm::getCreateaccountToken()
877 return a MediaWiki\Session\Token, and tokens must be checked using that
878 class's methods.
879 * $wgEnotifUseJobQ was removed and the job queue is always used.
880 * The functionality of the ApiSandbox extension has been merged into core. The
881 extension should no longer be used.
882 * $wgPreloadJavaScriptMwUtil was removed (deprecated in 1.26).
883 Extensions, skins, gadgets and scripts that use the mediawiki.util module must
884 express a dependency on it.
885 * $wgIncludeLegacyJavaScript, deprecated in MediaWiki 1.26, now defaults false.
886 Extensions, skins, gadgets and scripts that need the mediawiki.legacy.wikibits
887 module should express a dependency on it.
888 * Removed configuration option $wgCopyrightIcon (deprecated since 1.18). Use
889 $wgFooterIcons['copyright']['copyright'] instead.
890 * If the openssl and mcrypt PHP extensions are both unavailable, secure
891 session storage (used for login) will raise an exception. This exception may
892 be bypassed by setting $wgSessionInsecureSecrets = true.
893 * Massive overhaul to authentication:
894 ** AuthPlugin and AuthPluginUser are deprecated.
895 ** LoginForm and associated templates are deprecated. Extensions which called
896 static LoginForm methods should be converted into authentication providers.
897 ** The following hooks are deprecated:
898 *** AbortAutoAccount (create a MediaWiki\Auth\PreAuthenticationProvider instead)
899 *** AbortLogin (create a MediaWiki\Auth\PreAuthenticationProvider instead)
900 *** AbortNewAccount (create a MediaWiki\Auth\PreAuthenticationProvider instead)
901 *** AddNewAccount (use LocalUserCreated instead)
902 *** AuthPluginSetup (create a MediaWiki\Auth\PrimaryAuthenticationProvider instead)
903 *** ChangePasswordForm (use AuthChangeFormFields instead, or security levels)
904 *** LoginUserMigrated (create a MediaWiki\Auth\PreAuthenticationProvider instead)
905 *** UserCreateForm (create a MediaWiki\Auth\AuthenticationProvider of some type instead)
906 *** UserLoginForm (create a MediaWiki\Auth\AuthenticationProvider of some type instead)
907 ** The following hooks are removed:
908 *** AbortChangePassword
909 *** LoginPasswordResetMessage
910 *** PrefsPasswordAudit
911 ** The UserLoginComplete hook will no longer be called for all logins, only for
912 those via the web UI. Use UserLoggedIn if you need to do something on all
913 logins.
914 ** $wgRequirePasswordforEmailChange is removed.
915
916 === New features in 1.27 ===
917 * $wgDataCenterUpdateStickTTL was also added. This decides how long a user
918 sticks to the primary DC (via cookies) after they make changes to the site.
919 * Added a new hook, 'UserMailerTransformContent', to transform the contents
920 of an email. This is similar to the EmailUser hook but applies to all mail
921 sent via UserMailer.
922 * Added a new hook, 'UserMailerTransformMessage', to transform the contents
923 of an emai after MIME encoding.
924 * Added a new hook, 'UserMailerSplitTo', to control which users have to be
925 emailed separately (ie. there is a single address in the To: field) so
926 user-specific changes to the email can be applied safely.
927 * $wgCdnMaxageLagged was added, which limits the CDN cache TTL
928 when any load balancer uses a DB that is lagged beyond the 'max lag'
929 setting in the relevant section of $wgLBFactoryConf.
930 * User::newSystemUser() may be used to simplify the creation of passwordless
931 "system" users for logged actions from scripts and extensions.
932 * Extensions can now return detailed error information via the API when
933 preventing user actions using 'getUserPermissionsErrors' and similar hooks
934 by using ApiMessage instances instead of strings for the $result value.
935 * $wgAPIMaxLagThreshold was added to limit bot changes when databases lag
936 becomes too high.
937 * Skins and extensions can now use FlexBox mixins (.flex-display(@display: flex)
938 and .flex(@grow: 1, @shrink: 1, @width: auto, @order: 1)) in Less to create
939 cross-browser-compatible FlexBox rules. Users will still need to add fallback
940 float rules or the like for compatibility with IE9- separately.
941 * Added MWTimestamp::getTimezoneString() which returns the localized timezone
942 string, if available. To localize this string, see the comments of
943 $wgLocaltimezone in includes/DefaultSettings.php.
944 * Added CentralIdLookup, a service that allows extensions needing a concept of
945 "central" users to get that without having to know about specific central
946 authentication extensions.
947 * $wgMaxUserDBWriteDuration added to limit huge user-generated transactions.
948 Regular web request transactions that takes longer than this are aborted.
949 * Added a new hook, 'TitleMoveCompleting', which runs before a page move is
950 committed.
951 * $wgCdnReboundPurgeDelay was added to provide secondary delayed purges of URLs
952 from CDN to mitigate DB replication lag and WAN cache purge lag.
953 * (T49162) Installer will default to setting CACHE_ACCEL as the main cache type
954 if it is available.
955 * It is now possible to patrol file uploads (both for new files and new versions
956 of existing files). Special:NewFiles has gained an option to filter by patrol
957 status. This functionality can be disabled using $wgUseFilePatrol.
958 * MediaWiki\Session infrastructure allows for easier use of session mechanisms
959 other than the usual cookies.
960 ** SessionMetadata and SessionCheckInfo hooks allow for setting and checking
961 custom session metadata.
962 * Added MWGrants and associated configuration settings $wgGrantPermissions and
963 $wgGrantPermissionGroups to hold configuration for authentication features
964 such as OAuth that want to allow restricting the user rights a user may make
965 use of.
966 ** If you're already using the OAuth extension, these new variables are
967 identical to (and will replace) $wgMWOAuthGrantPermissions and
968 $wgMWOAuthGrantPermissionGroups.
969 * Added MWRestrictions as a class to check restrictions on a WebRequest, e.g.
970 to assert that the request comes from a particular IP range.
971 * Added bot passwords, a rights-restricted login mechanism for API-using bots.
972 * Whitelisted the following HTML attributes for all elements in wikitext:
973 aria-describedby, aria-flowto, aria-label, aria-labelledby, aria-owns.
974 * Removed "presentation" restriction on the HTML role attribute in wikitext.
975 All values are now allowed for the role attribute.
976 * $wgContentHandlers now also supports callbacks to create an instance of the
977 appropriate ContentHandler subclass.
978 * Added $wgAuthenticationTokenVersion, which if non-null prevents the
979 user_token database field from being exposed in cookies. Setting this would
980 be a good idea, but will log out all current sessions.
981 * $wgEventRelayerConfig was added, for managing PubSub event relay configuration,
982 specifically for reliable CDN url purges.
983 * Requests have unique IDs, equal to the UNIQUE_ID environment variable (when
984 MediaWiki is behind Apache+mod_unique_id or something similar) or a randomly-
985 generated 24-character string. This request ID is used to annotate log records
986 and error messages. It is available client-side via mw.config.get( 'wgRequestId' ).
987 The request ID supplants exception IDs. Accordingly, MWExceptionHandler::getLogId()
988 is deprecated.
989 * (T33313) Add a preference for watching uploads by default, also applies
990 to API-based upload tools.
991 * $wgJpegPixelFormat was added to override chroma subsampling for JPEG image
992 thumbnails created via ImageMagick. Defaults to 'yuv420', providing bandwidth
993 savings versus the previous behavior on many files.
994 * MediaWiki\Auth infrastructure (called "AuthManager") allows for more flexible
995 configuration of multiple authentication pieces that was possible with
996 AuthPlugin. For example, it's now easy to plug in second-factor
997 authentication, or add additional checks to the login process, or to support
998 multiple login methods at once, or to support non-password-based login methods.
999 ** Providers are configured via the global setting $wgAuthManagerConfig.
1000 ** A global, $wgDisableAuthManager, is temporarily available to disable
1001 AuthManager until extensions are ready to support it.
1002 ** New hook, AuthChangeFormFields, to adjust the form fields on
1003 AuthManager-related special pages.
1004 ** New hook, AuthManagerLoginAuthenticateAudit, for additional logging of
1005 AuthManager-related authentication requests.
1006 ** New hook, ChangeAuthenticationDataAudit, for additional logging of
1007 AuthManager-related authentication data changes.
1008 ** New hook, SecuritySensitiveOperationStatus, to work with the new mechanism
1009 for requiring a recent login before taking security-sensitive operations
1010 like changing a password.
1011 ** Two new globals, $wgChangeCredentialsBlacklist and $wgRemoveCredentialsBlacklist
1012 can be used to prevent the web UI and the API changing certain authentication data.
1013 * The file upload dialog (available if you install WikiEditor or VisualEditor)
1014 can now be configured using $wgUploadDialog.
1015
1016 === External library changes in 1.27 ===
1017
1018 ==== Upgraded external libraries ====
1019 * Updated oojs/oojs-ui from v0.12.12 to v0.13.3.
1020 * Updated composer/semver from v1.0.0 to v1.2.0.
1021 * Updated liuggio/statsd-php-client to 1.0.18.
1022 * Updated QUnit from v1.18.0 to v1.22.0.
1023
1024 ==== New external libraries ====
1025 * Added wikimedia/base-convert v1.0.1.
1026 * Added wikimedia/cldr-plural-rule-parser v1.0.0.
1027 * Added wikimedia/relpath v1.0.3.
1028 * Added wikimedia/running-stat v1.1.0.
1029 * Added wikimedia/php-session-serializer v1.0.3.
1030
1031 ==== Removed and replaced external libraries ====
1032
1033 === Bug fixes in 1.27 ===
1034 * Special:Upload will now display correct maximum allowed file size when running
1035 under HHVM (T116347).
1036 * (T54077) The APIEditBeforeSave hook will once again give only the content of
1037 the section being edited, rather than the whole revision. This reverts the
1038 change made in MediaWiki 1.22.
1039
1040 === Action API changes in 1.27 ===
1041 * Added list=allrevisions.
1042 * generator=recentchanges now has the option to generate revids.
1043 * ApiPageSet::setRedirectMergePolicy() was added. This allows generator
1044 modules to define how generator data for a redirect source gets merged
1045 into the redirect destination.
1046 * prop=imageinfo&iiprop=uploadwarning will no longer include the possibility of
1047 "was-deleted" warning.
1048 * Added difftotextpst to query=revisions which preforms a pre-save transform on
1049 the text before diffing it.
1050 * Deprecated formats dbg, txt, and yaml have been removed.
1051 * (T47988) The protect log event details now use new-style formatting.
1052 * The following response properties from action=login are deprecated, and may
1053 be removed in the future: lgtoken, cookieprefix, sessionid. Clients should
1054 handle cookies to properly manage session state.
1055 * action=login transparently allows login using bot passwords. Clients should
1056 merely need to change the username and password used after setting up a bot
1057 password.
1058 * action=upload no longer understands statuskey, asyncdownload or leavemessage.
1059 * Several changes when $wgDisableAuthManager is false:
1060 ** action=login is deprecated for uses other than bot passwords.
1061 ** list=users can now indicate if a missing username is creatable.
1062 ** action=createaccount is changed in a non-backwards-compatible manner.
1063 ** Added action=query&meta=authmanagerinfo.
1064 ** Added action=clientlogin to be used to log into the main account instead of
1065 action=login.
1066 ** Added action=linkaccount.
1067 ** Added action=unlinkaccount.
1068 ** Added action=changeauthenticationdata.
1069 ** Added action=removeauthenticationdata.
1070 ** Added action=resetpassword.
1071
1072 === Action API internal changes in 1.27 ===
1073 * ApiQueryORM removed.
1074 * The following classes have been removed:
1075 ** ApiFormatDbg
1076 ** ApiFormatTxt
1077 ** ApiFormatYaml
1078 * ApiBase::addTokenProperties() was removed (deprecated since 1.24).
1079 * ApiBase::getFinalPossibleErrors() was removed (deprecated since 1.24).
1080 * ApiBase::getFinalResultProperties() was removed (deprecated since 1.24).
1081 * ApiBase::getRequireAtLeastOneParameterErrorMessages() was removed (deprecated since 1.24).
1082 * ApiBase::getPossibleErrors() was removed (deprecated since 1.24).
1083 * ApiBase::getRequireMaxOneParameterErrorMessages() was removed (deprecated since 1.24).
1084 * ApiBase::getRequireOnlyOneParameterErrorMessages() was removed (deprecated since 1.24).
1085 * ApiBase::getResultProperties() was removed (deprecated since 1.24).
1086 * ApiBase::getTitleOrPageIdErrorMessage() was removed (deprecated since 1.24).
1087 * ApiBase::parseErrors() was removed (deprecated since 1.24).
1088 * ApiQueryBase::titleToKey(), ApiQueryBase::keyToTitle() and
1089 ApiQueryBase::keyPartToTitle() all removed (deprecated since 1.24).
1090 * ApiQueryBase::checkRowCount() was removed (deprecated since 1.24).
1091 * ApiQueryBase::getDirectionDescription() was removed (deprecated since 1.25).
1092 * ApiQuery::getGenerators() was removed (deprecated since 1.21).
1093 * ApiQuery::getModules() was removed (deprecated since 1.21).
1094 * ApiQuery::getModuleType() was removed (deprecated since 1.21).
1095 * ApiQuery::setGeneratorContinue() was removed (deprecated since 1.24).
1096 * ApiMain::getModules() was removed (deprecated since 1.21).
1097 * ApiBase::getVersion() was removed (deprecated since 1.21).
1098 * ApiMain::getShowVersions() was removed (deprecated in 1.21).
1099 * ApiMain::addModule() was removed (deprecated in 1.21).
1100 * ApiMain::addFormat() was removed (deprecated in 1.21).
1101 * ApiMain::getFormats() was removed (deprecated in 1.21).
1102 * ApiPageSet::finishPageSetGeneration() was removed (deprecated in 1.21).
1103 * ApiCreateAccount was removed.
1104
1105 === Languages updated in 1.27 ===
1106
1107 MediaWiki supports over 350 languages. Many localisations are updated
1108 regularly. Below only new and removed languages are listed, as well as
1109 changes to languages because of Phabricator reports.
1110
1111 * (T113688) Change default numerals from Gurmukhi to Arabic for Punjabi locale.
1112 * (T116020) Aliases of magic words in MessagesXx.php are sorted by usage.
1113
1114 === Other changes in 1.27 ===
1115 * Added dependency injection (DI) infrastructure, see docs/injection.txt for details.
1116 It is planned to incrementally move MediaWiki code towards using DI, using the
1117 service locator (SL) pattern as a stepping stone.
1118 * ProfilerOutputUdp was removed. Note that there is a ProfilerOutputStats class.
1119 * WikiPage::doDeleteArticleReal() and WikiPage::doDeleteArticle() now
1120 ignore the 2nd and 3rd arguments (formerly $id and $commit).
1121 * Removed "loaderScripts" option from ResourceLoaderFileModule class.
1122 * Removed ORM-like wrapper added in 1.20.
1123 * LinkCache::getGoodLinks and LinkCache::getBadLinks were removed
1124 (deprecated in 1.26).
1125 * WikiPage::doQuickEdit() was removed (deprecated since 1.21).
1126 * Removed SiteObject and SiteArray classes (deprecated in 1.21).
1127 * MessageBlobStore::getInstance() was removed (deprecated since 1.25).
1128 * (T84937) Free external links ("autolinked" urls) will now be terminated
1129 by &nbsp; and HTML entity encodings of &nbsp, <, and >.
1130 * (T36948) The default file revert message's timestamp is now in
1131 $wgLocaltimezone, instead of UTC.
1132 * The default name of the 'suppress' group page has been changed from
1133 'Project:Oversight' to 'Project:Suppress'.
1134 * DatabaseBase::resultObject() is now protected (use outside Database classes
1135 not necessary since 1.11).
1136 * Calling ResourceLoaderFileModule::readStyleFiles() without a
1137 ResourceLoaderContext instance is deprecated.
1138 * ResourceLoader::getLessCompiler() now takes an optional parameter of
1139 additional LESS variables to set for the compiler.
1140 * wfBaseConvert() marked as deprecated, use Wikimedia\base_convert() directly
1141 instead.
1142 * Obsolete maintenance scripts clearCacheStats.php and showCacheStats.php
1143 were removed. The underlying data is sent to StatsD (see $wgStatsdServer).
1144 * Removed msg_resource_links database table and associated code.
1145 * Removed msg_resource database table and associated code.
1146 * Skin::getNamespaceNotice() was removed.
1147 * wfIsConfiguredProxy() was removed (deprecated since 1.24).
1148 * wfDebugTimer() was removed (deprecated since 1.25).
1149 * wfIsTrustedProxy() was removed (deprecated since 1.24).
1150 * wfGetIP() was removed (deprecated since 1.19).
1151 * MWHookException was removed.
1152 * OutputPage::appendSubtitle() was removed (deprecated since 1.19).
1153 * OutputPage::loginToUse() was removed (deprecated since 1.19).
1154 * Article::loadContent() was removed (deprecated since 1.19).
1155 * User::editToken() was removed (deprecated since 1.19).
1156 * Removed --force-normal option of dumpBackup.php, as it no longer served
1157 any useful purpose since 1.22.
1158 * The functions processOption() and processArgs() on the BackupDumper and
1159 TextPassDumper classes have been removed.
1160 * The maintenance/backupTextPass.inc file was deleted. You should include
1161 maintenance/dumpTextPass.php instead.
1162 * WikiPage::getUsedTemplates() was removed (deprecated since 1.19).
1163 * wfEmptyMsg() was removed (deprecated since 1.18).
1164 * OutputPage::permissionRequired() was removed (deprecated since 1.18).
1165 * OutputPage::blockedPage() was removed (deprecated since 1.18).
1166 * User::getSkin() was removed (deprecated since 1.18).
1167 * OutputPage::includeJQuery() was removed (deprecated since 1.17).
1168 * WikiPage::updateRestrictions() was removed (deprecated since 1.19).
1169 * WikiPage::testPreSaveTransform() was removed (deprecated since 1.19).
1170 * LogPage::logName() was removed (deprecated since 1.19).
1171 * LogPage::logHeader() was removed (deprecated since 1.19).
1172 * wfCheckLimits() was removed (deprecated since 1.24).
1173 * Linker::makeKnownLinkObj() was removed (deprecated since 1.16).
1174 * Linker::makeLinkObj() was removed (deprecated since 1.16).
1175 * wfMsgForContentNoTrans() was removed (deprecated since 1.18).
1176 * ChangesList::usePatrol was removed (deprecated since 1.22).
1177 * wfMsgNoTrans() was removed (deprecated since 1.18).
1178 * Linker::makeImageLink2 was removed (deprecated since 1.20).
1179 * Title::userIsWatching() was removed (deprecated since 1.20).
1180 * Removed WaitForSlave maintenance script; use SELECT MASTER_POS_WAIT()
1181 database function directly instead.
1182 * wfMsg() was removed (deprecated since 1.18).
1183 * wfMsgForContent() was removed (deprecated since 1.18).
1184 * wfMsgReal() was removed (deprecated since 1.18).
1185 * wfMsgGetKey() was removed (deprecated since 1.18).
1186 * wfMsgHtml() was removed (deprecated since 1.18).
1187 * wfMsgWikiHtml() was removed (deprecated since 1.18).
1188 * wfMsgExt() was removed (deprecated since 1.18).
1189 * Language::armourMath() was removed (deprecated since 1.22).
1190 * LanguageConverter::armourMath() was removed (deprecated since 1.22).
1191 * FakeConverter::armourMath() was removed (deprecated since 1.22).
1192 * The unused jquery.validate ResourceLoader module was removed.
1193 * FileRepo::getRootUrl() was removed (deprecated since 1.20).
1194 * User::generateToken() was removed (deprecated since 1.20).
1195 * WikiPage::getRawText() was removed (deprecated since 1.21).
1196 * ParserOutput::hasCustomDataUpdates() was removed (deprecated since 1.25).
1197 * ParserOutput::addSecondaryDataUpdate() was removed (deprecated since 1.25).
1198 * ParserOutput::getSecondaryDataUpdates() was removed (deprecated since 1.25).
1199 * Gallery images with multiple caption pipes no longer concatenate them all
1200 together but instead pick the final one, similar to image syntax.
1201 * XML-like parser tags (such as <gallery>), when unclosed, will be left unparsed
1202 rather than consume everything until the end of the page.
1203 * New maintenance script resetUserEmail.php allows sysadmins to reset user emails in case
1204 a user forgot password/account was stolen.
1205 * wfCheckEntropy() was removed (deprecated in 1.27).
1206 * Browser support for Internet Explorer 8 lowered from Grade A to Grade C.
1207 * ContentHandler::supportsCategories method added. Default is true.
1208 CategoryMembershipChangeJob updates are skipped for content that
1209 does not support categories.
1210 * wikidiff difference engine is no longer supported, anyone still using it are encouraged
1211 to upgrade to wikidiff2 which is actively maintained and has better package availability.
1212 * Database logic was removed from WatchedItem and a WatchedItemStore was created:
1213 ** WatchedItem::IGNORE_USER_RIGHTS and WatchedItem::CHECK_USER_RIGHTS were deprecated.
1214 User::IGNORE_USER_RIGHTS and User::CHECK_USER_RIGHTS were introduced.
1215 ** WatchedItem::fromUserTitle was deprecated in favour of the constructor.
1216 ** WatchedItem::resetNotificationTimestamp was deprecated.
1217 ** WatchedItem::batchAddWatch was deprecated.
1218 ** WatchedItem::addWatch was deprecated.
1219 ** WatchedItem::removeWatch was deprecated.
1220 ** WatchedItem::isWatched was deprecated.
1221 ** WatchedItem::duplicateEntries was deprecated.
1222 ** EmailNotification::updateWatchlistTimestamp was deprecated.
1223 ** User::getWatchedItem was removed.
1224 * Unit tests don't work with external PHPUnit anymore, Composer is now the only supported
1225 way. Run `composer install` to install it and other dev dependencies to run unit tests.
1226 * wl_id field added to the watchlist table.
1227 * Revision::getRawText() was removed (deprecated since 1.21).
1228 * WikiPage::replaceSection() was removed (deprecated since 1.21).
1229 * Article::replaceSection() was removed (deprecated since 1.21).
1230 * Language::getLangObj() was removed (deprecated since 1.24).
1231 * Language::getLanguageName() was removed (deprecated since 1.20).
1232 * Language::getLanguageNames() was removed (deprecated since 1.20).
1233 * Language::getTranslatedLanguageNames() was removed (deprecated since 1.20).
1234 * Language::specialPage() was removed (deprecated since 1.24).
1235 * MediaWikiTestCase::assertException() was removed (deprecated since 1.22).
1236 * OutputPage::getHeadItems() was removed (deprecated since 1.24).
1237 * OutputPage::getScript() was removed (deprecated since 1.24).
1238 * OutputPage::out() was removed (deprecated since 1.22).
1239 * OutputPage::setAllowedModules() was removed (deprecated since 1.24).
1240 * UserrightsPage::makeGroupNameListForLog() was removed (deprecated since 1.21).
1241 * MediaWikiSite::newFromGlobalId() was removed (deprecated since 1.21).
1242 * Title::newFromRedirect() was removed (deprecated since 1.21).
1243 * Skin::commonPrintStylesheet() was removed (deprecated since 1.22).
1244 * Skin::getCommonStylePath() was removed (deprecated since 1.24).
1245 * Skin::newFromKey() was removed (deprecated since 1.24).
1246 * Skin::getUsableSkins() was removed (deprecated since 1.23).
1247 * LoadBalancer::pickRandom() was removed (deprecated in 1.21).
1248 * Article::getUndoText() and WikiPage::getUndoText were removed (deprecated since
1249 1.21).
1250 * DifferenceEngine::setText() was removed (deprecated in 1.21).
1251 * Title::newFromRedirectArray() was removed (deprecated in 1.21).
1252 * UserMailer::send() no longer accepts $replyto as the 5th argument and $contentType
1253 as the 6th. These must be passed in the options array now.
1254 * Title::newFromRedirectRecurse() was removed (deprecated in 1.21).
1255 * Skin::accesskey was removed (deprecated since 1.21).
1256 * Skin::blockLink was removed (deprecated since 1.21).
1257 * Skin::buildRollbackLink was removed (deprecated since 1.21).
1258 * Skin::emailLink was removed (deprecated since 1.21).
1259 * Skin::formatComment was removed (deprecated since 1.21).
1260 * Skin::formatHiddenCategories was removed (deprecated since 1.21).
1261 * Skin::formatLinksInComment was removed (deprecated since 1.21).
1262 * Skin::formatRevisionSize was removed (deprecated since 1.21).
1263 * Skin::formatSize was removed (deprecated since 1.21).
1264 * Skin::formatTemplates was removed (deprecated since 1.21).
1265 * Skin::generateTOC was removed (deprecated since 1.21).
1266 * Skin::getInternalLinkAttributes was removed (deprecated since 1.21).
1267 * Skin::getInternalLinkAttributesObj was removed (deprecated since 1.21).
1268 * Skin::getInterwikiLinkAttributes was removed (deprecated since 1.21).
1269 * Skin::getInvalidTitleDescription was removed (deprecated since 1.21).
1270 * Skin::getLinkColour was removed (deprecated since 1.21).
1271 * Skin::getRevDeleteLink was removed (deprecated since 1.21).
1272 * Skin::getRollbackEditCount was removed (deprecated since 1.21).
1273 * Skin::makeBrokenImageLinkObj was removed (deprecated since 1.21).
1274 * Skin::makeCommentLink was removed (deprecated since 1.21).
1275 * Skin::makeExternalImage was removed (deprecated since 1.21).
1276 * Skin::makeExternalLink was removed (deprecated since 1.21).
1277 * Skin::makeHeadline was removed (deprecated since 1.21).
1278 * Skin::makeImageLink was removed (deprecated since 1.21).
1279 * Skin::makeMediaLinkFile was removed (deprecated since 1.21).
1280 * Skin::makeMediaLinkObj was removed (deprecated since 1.21).
1281 * Skin::makeSelfLinkObj was removed (deprecated since 1.21).
1282 * Skin::makeThumbLink2 was removed (deprecated since 1.21).
1283 * Skin::makeThumbLinkObj was removed (deprecated since 1.21).
1284 * Skin::normaliseSpecialPage was removed (deprecated since 1.21).
1285 * Skin::normalizeSubpageLink was removed (deprecated since 1.21).
1286 * Skin::processResponsiveImages was removed (deprecated since 1.21).
1287 * Skin::revComment was removed (deprecated since 1.21).
1288 * Skin::revDeleteLink was removed (deprecated since 1.21).
1289 * Skin::revDeleteLinkDisabled was removed (deprecated since 1.21).
1290 * Skin::revUserLink was removed (deprecated since 1.21).
1291 * Skin::revUserTools was removed (deprecated since 1.21).
1292 * Skin::specialLink was removed (deprecated since 1.21).
1293 * Skin::splitTrail was removed (deprecated since 1.21).
1294 * Skin::titleAttrib was removed (deprecated since 1.21).
1295 * Skin::tocIndent was removed (deprecated since 1.21).
1296 * Skin::tocLine was removed (deprecated since 1.21).
1297 * Skin::tocLineEnd was removed (deprecated since 1.21).
1298 * Skin::tocList was removed (deprecated since 1.21).
1299 * Skin::tocUnindent was removed (deprecated since 1.21).
1300 * Skin::tooltip was removed (deprecated since 1.21).
1301 * Skin::tooltipAndAccesskeyAttribs was removed (deprecated since 1.21).
1302 * Skin::userTalkLink was removed (deprecated since 1.21).
1303 * Skin::userToolLinksRedContribs was removed (deprecated since 1.21).
1304 * wikidiff3 is now the default and only PHP diff engine. It provides improved diff
1305 performance on complex changes. $wgExternalDiffEngine = 'wikidiff3' therefore
1306 makes no difference now. Users are still recommended to use wikidiff2 if possible,
1307 though.
1308 * User::addNewUserLogEntry() was deprecated.
1309 * User::addNewUserLogEntryAutoCreate() was deprecated.
1310 * User::isPasswordReminderThrottled() was deprecated.
1311 * Bot-oriented parameters to Special:UserLogin (wpCookieCheck, wpSkipCookieCheck)
1312 were removed.
1313 * Installer can now be customized without patching MediaWiki code, see
1314 mw-config/overrides/README for details.
1315
1316 === Compatibility ===
1317
1318 MediaWiki 1.27 requires PHP 5.5.9 or later. There is experimental support for
1319 HHVM 3.6.5 or later.
1320
1321 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
1322 support for them is somewhat less mature. There is experimental support for
1323 Oracle and Microsoft SQL Server.
1324
1325 The supported versions are:
1326
1327 * MySQL 5.0.3 or later
1328 * PostgreSQL 8.3 or later
1329 * SQLite 3.3.7 or later
1330 * Oracle 9.0.1 or later
1331 * Microsoft SQL Server 2005 (9.00.1399)
1332
1333 === Upgrading ===
1334
1335 1.27 has several database changes since 1.26, and will not work without schema
1336 updates. Note that due to changes to some very large tables like the revision
1337 table, the schema update may take quite long (minutes on a medium sized site,
1338 many hours on a large site).
1339
1340 If upgrading from before 1.11, and you are using a wiki as a commons
1341 repository, make sure that it is updated as well. Otherwise, errors may arise
1342 due to database schema changes.
1343
1344 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
1345 new database fields are filled with data.
1346
1347 If you are upgrading from MediaWiki 1.4.x or earlier, you should upgrade to
1348 1.5 first. The upgrade script maintenance/upgrade1_5.php has been removed
1349 with MediaWiki 1.21.
1350
1351 Don't forget to always back up your database before upgrading!
1352
1353 See the file UPGRADE for more detailed upgrade instructions.
1354
1355 For notes on 1.26.x and older releases, see HISTORY.
1356
1357
1358 = MediaWiki 1.26 =
1359
1360 == MediaWiki 1.26.4 ==
1361
1362 This is a maintenance release of the MediaWiki 1.26 branch.
1363
1364 === Changes since 1.26.3 ===
1365 * BREAKING CHANGE: $wgHTTPProxy is now *required* for all external requests
1366 made by MediaWiki via a proxy. Relying on the http_proxy environment
1367 variable is no longer supported.
1368 * (T124163) Fixed fatal error in DifferenceEngine under HHVM.
1369 * (T139565) SECURITY: API: Generate head items in the context of the given title
1370 * (T137264) SECURITY: XSS in unclosed internal links
1371 * (T133147) SECURITY: Escape '<' and ']]>' in inline <style> blocks
1372 * (T133147) SECURITY: Require login to preview user CSS pages
1373 * (T132926) SECURITY: Do not allow undeleting a revision deleted file if it is
1374 the top file
1375 * (T129738) SECURITY: Make $wgBlockDisablesLogin also restrict logged in
1376 permissions
1377 * (T129738) SECURITY: Make blocks log users out if $wgBlockDisablesLogin is true
1378 * (T115333) SECURITY: Check read permission when loading page content in ApiParse
1379 * Remove support for $wgWellFormedXml = false, all output is now well formed
1380
1381 == MediaWiki 1.26.3 ==
1382
1383 This is a maintenance release of the MediaWiki 1.26 branch.
1384
1385 === Changes since 1.26.2 ===
1386 * (T116266) Fixed undefined property notices in DairikiDiff under HHVM.
1387 * (T123166) Fix fatal error when importing pages to titles which cannot be
1388 created, such as invalid titles or titles the user is not allowed to edit.
1389 * (T122056) Old tokens are remaining valid within a new session
1390 * (T127114) Login throttle can be tricked using non-canonicalized usernames
1391 * (T123653) Cross-domain policy regexp is too narrow
1392 * (T123071) Incorrectly identifying http link in a's href attributes, due to
1393 m modifier in regex
1394 * (T129506) MediaWiki:Gadget-popups.js isn't renderable
1395 * (T125283) Users occasionally logged in as different users after
1396 SessionManager deployment
1397 * (T103239) Patrol allows click catching and patrolling of any page
1398 * (T122807) [tracking] Check php crypto primatives
1399 * (T98313) Graphs can leak tokens, leading to CSRF
1400 * (T130947) Diff generation should use PoolCounter
1401 * (T133507) Careless use of $wgExternalLinkTarget is insecure
1402 * (T132874) API action=move is not rate limited
1403 * (T110143) strip markers can be used to get around html attribute escaping in
1404 (many?) parser tags
1405 * (T116030) Increase pbkdf2 parameter strengths
1406 * (T127420) Pbkdf2Password does not check if hash_pbkdf2() succeeded
1407 * (T126685) Globally throttle password attempts
1408
1409 == MediaWiki 1.26.2 ==
1410
1411 This is a maintenance release of the MediaWiki 1.26 branch.
1412
1413 === Changes since 1.26.1 ===
1414 * (T121892) Fix fatal error on some Special pages, introduced in 1.26.1.
1415
1416 == MediaWiki 1.26.1 ==
1417
1418 This is a maintenance release of the MediaWiki 1.26 branch.
1419
1420 === Changes since 1.26.0 ===
1421 * (T117899) SECURITY: $wgArticlePath can no longer be set to relative paths
1422 that do not begin with a slash. This enabled trivial XSS attacks.
1423 Configuration values such as "http://my.wiki.com/wiki/$1" are fine, as are
1424 "/wiki/$1". A value such as "$1" or "wiki/$1" is not and will now throw an
1425 error.
1426 * (T119309) SECURITY: Use hash_compare() for edit token comparison
1427 * (T118032) SECURITY: Don't allow cURL to interpret POST parameters starting
1428 with '@' as file uploads
1429 * (T115522) SECURITY: Passwords generated by User::randomPassword() can no
1430 longer be shorter than $wgMinimalPasswordLength
1431 * (T97897) SECURITY: Improve IP parsing and trimming. Previous behavior could
1432 result in improper blocks being issued
1433 * (T109724) SECURITY: Special:MyPage, Special:MyTalk, Special:MyContributions
1434 and related pages no longer use HTTP redirects and are now redirected by
1435 MediaWiki
1436 * Fixed ConfigException in ExpandTemplates due to AlwaysUseTidy.
1437 * Fixed stray literal \n in Special:Search.
1438 * Fix issue that breaks HHVM Repo Authorative mode.
1439 * (T120267) Work around APCu memory corruption bug
1440
1441 == MediaWiki 1.26.0 ==
1442
1443 === Configuration changes in 1.26 ===
1444 * $wgPasswordResetRoutes['email'] = true by default.
1445 * $wgEnableParserCache was deprecated, set $wgParserCacheType to CACHE_NONE
1446 instead if you want to disable the parser cache.
1447 * New-style continuation is now the default for API action=continue. Clients may
1448 use the 'rawcontinue' parameter to receive raw query-continue data, but the
1449 new style is encouraged as it's harder to implement incorrectly.
1450 * Deprecated API formats dump and wddx have been completely removed.
1451 * (T7645) The "Signature" button on the edit toolbar is now hidden by default
1452 in non-talk namespaces. A new configuration variable,
1453 $wgExtraSignatureNamespaces, controls in which subject (non-talk) namespaces
1454 the "Signature" button on the edit toolbar will be displayed.
1455 * $wgResourceLoaderUseESI was deprecated and removed. This was an experimental
1456 feature that was never enabled by default.
1457 * $wgResourceLoaderExperimentalAsyncLoading was deprecated and removed.
1458 This experimental feature was never enabled by default and is obsolete as of
1459 MediaWiki 1.26, in where ResourceLoader became fully asynchronous.
1460 * $wgMasterWaitTimeout was removed (deprecated in 1.24).
1461 * Fields in ParserOptions are now private. Use the accessors instead.
1462 * Custom LESS functions (defined via $wgResourceLoaderLESSFunctions or
1463 in extension.json) have been removed, after being deprecated in 1.24.
1464 * $wgAlwaysUseTidy has been removed.
1465 * ResetSessionID hook has been removed. Nothing seems to use it.
1466 * Certain AuthPlugin methods are deprecated in favor of new hooks:
1467 ** AuthPlugin::initUser() is replaced by LocalUserCreated.
1468 ** AuthPlugin::updateUser() is replaced by UserLoggedIn.
1469 ** AuthPlugin::updateExternalDB() is replaced by the existing UserSaveSettings.
1470 ** AuthPlugin::updateExternalDBGroups() is replaced by UserGroupsChanged.
1471 ** AuthPluginUser::isHidden() is replaced by UserIsHidden.
1472 ** AuthPluginUser::isLocked() is replaced by UserIsLocked.
1473 * The UserRights hook is deprecated in favor of the new UserGroupsChanged hook.
1474 * AuthPlugin::initUser() and AuthPlugin::updateUser() should no longer replace
1475 the passed User object.
1476 * $wgBlockAllowsUTEdit is now set to true by default. This allows
1477 blocked users to edit their talk pages unless explicitly disabled
1478 when they are being blocked.
1479
1480 === New features in 1.26 ===
1481 * (T51506) Now action=info gives estimates of actual watchers for a page.
1482 See $wgRCMaxAge, $wgWatchersMaxAge and $wgUnwatchedPageSecret
1483 to learn how to configure if needed.
1484 * Change tags can now be hidden in the interface by disabling the associated
1485 "tag-<id>" interface message.
1486 * ':' (colon) is now invalid in usernames for new accounts. Existing accounts
1487 are not affected.
1488 * Added a new hook, 'LogException', to log exceptions in nonstandard ways.
1489 * Revive the 'SpecialSearchResultsAppend' hook which occurs after the list of
1490 search results are rendered. The initial use case is to append a "give us
1491 feedback" link beneath the search results.
1492 * Added a new hook, 'RejectParserCacheValue', which allows extensions to
1493 reject an otherwise-successful parser cache lookup. The intent is to allow
1494 extensions to manage the eviction of archaic HTML output from the cache.
1495 * (T68699) The expiration of the UserID and Token login cookies
1496 ($wgExtendedLoginCookieExpiration) can be configured independently of the
1497 expiration of all other cookies ($wgCookieExpiration).
1498 * (T50519) Support for generating JPEG/PNG thumbnails from WebP images added
1499 if ImageMagick is used as image scaler ($wgUseImageMagick = true). Uploading
1500 of WebP images still disabled by default. Add $wgFileExtensions[] =
1501 'webp'; to LocalSettings.php to enable uploading of WebP images.
1502 * Added new hooks 'EnhancedChangesListModifyLineData' &
1503 'EnhancedChangesListModifyBlockLineData', to modify the data used to build
1504 lines in enhanced recentchanges and watchlist.
1505 * Caches that need purging ability now use the WANObjectCache interface.
1506 This corresponds to a new $wgMainWANCache setting, which defaults to using
1507 the $wgMainCacheType settings.
1508 * Callers needing fast light-weight data stores use $wgMainStash to select
1509 the store type from $wgObjectCaches. The default is the local database.
1510 * Interface message overrides in the MediaWiki namespace will now be cached in
1511 memcached and APC (if available), rather than memcached and local files.
1512 * Added a new hook, 'RandomPageQuery', to allow modification of the query used
1513 by Special:Random to select random pages.
1514 * $wgTransactionalTimeLimit was added, which controls the request time limit
1515 for potentially slow POST requests that need to be as atomic as possible.
1516 * ResourceLoader now loads all scripts asynchronously. The top-queue and
1517 startup modules are no longer synchronously loaded.
1518 * 'mediawiki.ui.button' styles are no longer unconditionally loaded on every
1519 page. During the deprecation period, the styles will only be loaded on pages
1520 which contain 'mw-ui-button' in their HTML. Starting in 1.28, the styles will
1521 only be loaded if explicitly required.
1522 * If search returns zero results and current search engine has a "did you mean"
1523 suggestion, results for suggestion will be shown. Can be disabled by setting
1524 $wgSearchRunSuggestedQuery to false.
1525 * Added several JavaScript libraries for uploading files to MediaWiki
1526 from the client-side. See documentation for mw.Upload and its
1527 subclasses for more information.
1528 * Added OOUI dialogs and layout for file upload interfaces. See
1529 documentation for mw.Upload.Dialog, mw.Upload.BookletLayout and its
1530 subclasses for more information.
1531
1532 === extension.json changes in 1.26 ===
1533 * (T99344) The extension.json schema is now versioned. All extensions
1534 and skins should set a "manifest_version" property corresponding to
1535 the schema version they were written for. The only supported version
1536 currently is "1".
1537 * (T102523) The error message if a non-array attribute is set was improved.
1538 * (T107646) Configuration settings can now specify how they should be merged,
1539 which is necessary for arrays using integer keys.
1540 * (T110389) Adding namespaces through extension.json now actually works
1541 * $wgNamespaceProtection can now be set in extension.json.
1542 * $wgCapitalLinkOverrides can now be set in extension.json.
1543 * (T97186) Extensions using a custom prefix for their configuration settings
1544 can now set a "_prefix" key to override the default of "wg".
1545 * (T99084) Extensions can now specify what MediaWiki core versions they
1546 depend upon.
1547 * (T105236) The extension.json schema now validates custom classes in
1548 the "ResourceModules" property properly.
1549
1550 === External library changes in 1.26 ===
1551 ==== Upgraded external libraries ====
1552 * Updated es5-shim from v4.0.0 to v4.1.5.
1553 * Updated json2 from revision 2014-02-04 to 2015-05-03.
1554 * Updated Sinon.JS from 1.10.3 to 1.15.4.
1555 * Updated jQuery Client from v1.0.0 to v2.0.0.
1556 * Updated QUnit from v1.17.1 to v1.18.0.
1557 * Updated liuggio/statsd-php-client from v1.0.12 to v1.0.16.
1558 * Updated oojs/oojs-ui from v0.11.3 to v0.12.12.
1559 * Updated wikimedia/cdb from v1.0.1 to v1.3.0.
1560 * Updated wikimedia/utfnormal from v1.0.2 to v1.0.3.
1561 * Updated wikimedia/composer-merge-plugin from v1.0.0 to v1.3.0.
1562 * Updated zordius/lightncandy from v0.18 to v0.21.
1563
1564 ==== New external libraries ====
1565 * Added composer/semver v1.0.0.
1566 * Added mediawiki/at-ease v1.1.0.
1567 * Added wikimedia/assert v0.2.2.
1568 * Added wikimedia/ip-set v1.0.1.
1569 * Added wikimedia/wrappedstring v2.0.0.
1570
1571 ==== Removed and replaced external libraries ====
1572 * Replaced leafo/lessphp v0.5.0 with oyejorge/less.php v1.7.0.9.
1573
1574 === Bug fixes in 1.26 ===
1575 * (T53283) load.php sometimes sends 304 response without full headers
1576 * (T65198) Talk page tabs now have a "rel=discussion" attribute
1577 * (T98841) {{msgnw:}} now preserves comments even when subst: is not used.
1578 * (T104142) $wgEmergencyContact and $wgPasswordSender now use their default
1579 value if set to an empty string.
1580
1581 === Action API changes in 1.26 ===
1582 * New-style continuation is now the default for action=continue. Clients may
1583 use the 'rawcontinue' parameter to receive raw query-continue data, but the
1584 new style is encouraged as it's harder to implement incorrectly.
1585 * Deprecated API formats dump and wddx have been completely removed.
1586 * API action=query&list=tags: The displayname can now be boolean false if the
1587 tag is meant to be hidden from user interfaces.
1588 * action=import no longer allows both the namespace= and rootpage= parameters
1589 to be set. If they are both set, the value of rootpage= will be ignored.
1590 * prop=revision output in enum mode is now sorted by timestamp rather than
1591 revision ID. This usually won't make any difference.
1592 * (T102645) Namespace list from meta=siteinfo&siprop=namespaces is now an array
1593 with formatversion=2.
1594 * Various other output from meta=siteinfo will now always be arrays instead of
1595 sometimes being numerically-indexed objects with formatversion=2.
1596 * When errors about users being blocked are returned, they now include
1597 information about the relevant block.
1598 * (T99926) list=random has higher limits, in line with other API modules.
1599 * list=random's rnredirect parameter is deprecated in favor of a new
1600 rnfilterredir parameter that also allows for listing both redirects and
1601 non-redirects.
1602 * list=random now supports continuation.
1603 * API responses to GET requests may now include ETag and Last-Modified headers,
1604 and will honor corresponding If-None-Match and If-Modified-Since on such
1605 requests.
1606
1607 === Action API internal changes in 1.26 ===
1608 * New metadata item ApiResult::META_KVP_MERGE to allow for merging the KVP key
1609 into the value when the value is an assoc.
1610 * API action modules may now provide values for the RFC 7232 ETag and
1611 Last-Modified headers. The API will check these against If-None-Match and
1612 If-Modified-Since request headers on GET requests and avoid executing the
1613 module when appropriate.
1614
1615 === Languages updated in 1.26 ===
1616
1617 MediaWiki supports over 350 languages. Many localisations are updated
1618 regularly. Below only new and removed languages are listed, as well as
1619 changes to languages because of Phabricator reports.
1620
1621 * Languages added:
1622 ** ase (American sign language), thanks to translator Icemandeaf
1623 ** dty (डोटेली/Doteli), thanks to translators जनक राज भट्ट, बिप्लब आनन्द,
1624 मेश सिंह बोहरा, and राम प्रसाद जोशी
1625 ** luz (لئری دوٙمینی / Southern Luri)
1626 ** olo (Livvinкarjala / Livvi-Karelian), thanks to translators Denö, Hiloin Natoi,
1627 Ilja.mos, and Mashoi7
1628
1629 === Other changes in 1.26 ===
1630 * ChangeTags::tagDescription() will return false if the interface message
1631 for the tag is disabled.
1632 * Added PageHistoryPager::doBatchLookups hook.
1633 * Added $wikiId parameter to FormatAutocomments hook.
1634 * Added ParserCacheSaveComplete to ParserCache
1635 * supportsDirectEditing and supportsDirectApiEditing methods added to
1636 ContentHandler, to provide a way for ApiEditPage and EditPage to check
1637 if direct editing of content is allowed. These methods return false,
1638 by default for the ContentHandler base class and true for TextContentHandler
1639 and it's derivative classes (everything in core). For Content types that
1640 do not support direct editing, an alternative mechanism should be provided
1641 for editing, such as action overrides or specific api modules.
1642 * mediaWiki.confirmCloseWindow now returns an object of functions, instead of
1643 one function. The callback can't be called directly any more. The callback
1644 function is replaced with confirmCloseWindow.release().
1645 * BREAKING CHANGE: Added an optional ResouceLoaderContext parameter to
1646 ResourceLoaderModule::getDependencies(). Extension classes that override that
1647 method should be updated. If they aren't updated, PHP Strict standards
1648 warnings will appear when E_STRICT error reporting is enabled. Note: in the
1649 near future, this parameter will probably become non-optional.
1650 * Removed maintenance script deleteImageMemcached.php.
1651 * MWFunction::newObj() was removed (deprecated in 1.25).
1652 ObjectFactory::getObjectFromSpec() should be used instead.
1653 * The parser will no longer randomize the string it uses to mark the place of
1654 items that were stripped during parsing. It will use a fixed string instead.
1655 This causes the parser to re-use the regular expressions it uses to search
1656 and replace markers rather than generate novel expressions on each parse.
1657 Re-using regular expressions will improve performance on HHVM and the
1658 forthcoming PHP 7. The interfaces changes accompanying this change are:
1659 - Parser::getRandomString() and Parser::uniqPrefix() have been deprecated.
1660 - The $uniq_prefix argument for Parser::extractTagsAndParams() and the
1661 $prefix argument for StripState::_construct() are deprecated and their
1662 value is ignored.
1663 * wfSuppressWarnings() and wfRestoreWarnings() were split into a separate library,
1664 mediawiki/at-ease, and are now deprecated. Callers should use
1665 MediaWiki\suppressWarnings() and MediaWiki\restoreWarnings() directly.
1666 * The Block class constructor now takes an associative array of parameters
1667 instead of many optional positional arguments. Calling the constructor the old
1668 way will issue a deprecation warning.
1669 * The jquery.mwExtension module was deprecated.
1670 * $wgSpecialPageGroups was removed (deprecated in 1.21).
1671 * SpecialPageFactory::setGroup was removed (deprecated in 1.21).
1672 * SpecialPageFactory::getGroup was removed (deprecated in 1.21).
1673 * DatabaseBase::ignoreErrors() is now protected.
1674 * BREAKING CHANGE: mediawiki.legacy.ajax has been removed, following
1675 a lengthy deprecation period.
1676 * The ScopedPHPTimeout class was removed.
1677 * Removed maintenance script fixSlaveDesync.php.
1678 * Watchlist tokens, SpecialResetTokens, and User::getTokenFromOption()
1679 are deprecated. Applications using those can work via the OAuth
1680 extension instead. New tokens types should not be added.
1681 * DatabaseBase::errorCount() was removed (unused).
1682 * $wgDeferredUpdateList was removed.
1683 * DeferredUpdates::addHTMLCacheUpdate() was removed.
1684
1685 = MediaWiki 1.25 =
1686
1687 == MediaWiki 1.25.6 ==
1688
1689 This is a maintenance release of the MediaWiki 1.25 branch.
1690
1691 === Changes since 1.25.5 ===
1692 * (T123166) Fix fatal error when importing pages to titles which cannot be
1693 created, such as invalid titles or titles the user is not allowed to edit.
1694 * (T122056) Old tokens are remaining valid within a new session
1695 * (T127114) Login throttle can be tricked using non-canonicalized usernames
1696 * (T123653) Cross-domain policy regexp is too narrow
1697 * (T123071) Incorrectly identifying http link in a's href attributes, due to
1698 m modifier in regex
1699 * (T129506) MediaWiki:Gadget-popups.js isn't renderable
1700 * (T125283) Users occasionally logged in as different users after
1701 SessionManager deployment
1702 * (T103239) Patrol allows click catching and patrolling of any page
1703 * (T122807) [tracking] Check php crypto primatives
1704 * (T98313) Graphs can leak tokens, leading to CSRF
1705 * (T130947) Diff generation should use PoolCounter
1706 * (T133507) Careless use of $wgExternalLinkTarget is insecure
1707 * (T132874) API action=move is not rate limited
1708 * (T110143) strip markers can be used to get around html attribute escaping in
1709 (many?) parser tags
1710 * (T116030) Increase pbkdf2 parameter strengths
1711 * (T127420) Pbkdf2Password does not check if hash_pbkdf2() succeeded
1712 * (T126685) Globally throttle password attempts
1713
1714 == MediaWiki 1.25.5 ==
1715
1716 This is a maintenance release of the MediaWiki 1.25 branch.
1717
1718 === Changes since 1.25.4 ===
1719 * (T121892) Fix fatal error on some Special pages, introduced in 1.25.4.
1720
1721 == MediaWiki 1.25.4 ==
1722
1723 This is a security and maintenance release of the MediaWiki 1.25 branch.
1724
1725 === Changes since 1.25.3 ===
1726 * (T117899) SECURITY: $wgArticlePath can no longer be set to relative paths
1727 that do not begin with a slash. This enabled trivial XSS attacks.
1728 Configuration values such as "http://my.wiki.com/wiki/$1" are fine, as are
1729 "/wiki/$1". A value such as "$1" or "wiki/$1" is not and will now throw an
1730 error.
1731 * (T119309) SECURITY: Use hash_compare() for edit token comparison
1732 * (T118032) SECURITY: Don't allow cURL to interpret POST parameters starting
1733 with '@' as file uploads
1734 * (T115522) SECURITY: Passwords generated by User::randomPassword() can no
1735 longer be shorter than $wgMinimalPasswordLength
1736 * (T97897) SECURITY: Improve IP parsing and trimming. Previous behavior could
1737 result in improper blocks being issued
1738 * (T109724) SECURITY: Special:MyPage, Special:MyTalk, Special:MyContributions
1739 and related pages no longer use HTTP redirects and are now redirected by
1740 MediaWiki
1741 * (T103237) $wgUseGzip had no effect when using file cache.
1742 * (T114606) mw.notify was not correctly fixed to the page if
1743 initialized while not at the top of the page.
1744 * Fix issue that breaks HHVM Repo Authorative mode.
1745
1746 == MediaWiki 1.25.3 ==
1747
1748 This is a security and maintenance release of the MediaWiki 1.25 branch.
1749
1750 === Changes since 1.25.2 ===
1751
1752 * (T98975) Fix having multiple callbacks for a single hook.
1753 * (T107632) maintenance/refreshLinks.php did not always remove all links
1754 pointing to nonexistent pages.
1755 * (T104142) $wgEmergencyContact and $wgPasswordSender now use their default
1756 value if set to an empty string.
1757 * (T62174) Provide fallbacks for use of mb_convert_encoding() in
1758 HtmlFormatter. It was causing an error when accessing the api help page
1759 if the mbstring PHP extension was not installed.
1760 * (T105896) Confirmation emails would sometimes contain invalid codes.
1761 * (T105597) Fixed edit stash inclusion queries.
1762 * (T91850) SECURITY: Add throttle check in ApiUpload and SpecialUpload
1763 * (T91203, T91205) SECURITY: API: Improve validation in chunked uploading
1764 * (T95589) SECURITY: RevDel: Check all revisions for suppression, not just the
1765 first
1766 * (T108616) SECURITY: Avoid exposure of local path in PNG thumbnails
1767
1768 == MediaWiki 1.25.2 ==
1769
1770 This is a security and maintenance release of the MediaWiki 1.25 branch.
1771
1772 === Changes since 1.25.1 ===
1773
1774 * (T94116) SECURITY: Compare API watchlist token in constant time
1775 * (T97391) SECURITY: Escape error message strings in thumb.php
1776 * (T106893) SECURITY: Don't leak autoblocked IP addresses on
1777 Special:DeletedContributions
1778 * (T102562) Fix InstantCommons parameters to handle the new HTTPS-only
1779 policy of Wikimedia Commons.
1780 * (T100767) Setting a configuration setting for skin or extension to
1781 false in LocalSettings.php was not working.
1782 * (T100635) API action=opensearch json output no longer breaks when
1783 $wgDebugToolbar is enabled.
1784 * (T102522) Using an extension.json or skin.json file which has
1785 a "manifest_version" property for 1.26 compatability will no longer
1786 trigger warnings.
1787 * (T86156) Running updateSearchIndex.php will not throw an error as
1788 page_restrictions has been added to the locked table list.
1789 * Special:Version would throw notices if using SVN due to an incorrectly
1790 named variable. Add an additional check that an index is defined.
1791
1792 == MediaWiki 1.25.1 ==
1793
1794 This is a bug fix release of the MediaWiki 1.25 branch.
1795
1796 === Changes since 1.25 ===
1797 * (T100351) Fix syntax errors in extension.json of ConfirmEdit extension
1798
1799 == MediaWiki 1.25.0 ==
1800
1801 === Configuration changes in 1.25 ===
1802 * $wgPageShowWatchingUsers was removed.
1803 * $wgLocalVirtualHosts has been added to replace $wgConf->localVHosts.
1804 * $wgAntiLockFlags was removed.
1805 * $wgJavaScriptTestConfig was removed.
1806 * Edit tokens returned from User::getEditToken may change on every call. Token
1807 validity must be checked by passing the user-supplied token to
1808 User::matchEditToken rather than by testing for equality with a
1809 newly-generated token.
1810 * (T74951) The UserGetLanguageObject hook may be passed any IContextSource
1811 for its $context parameter. Formerly it was documented as receiving a
1812 RequestContext specifically.
1813 * Profiling was restructured and $wgProfiler now requires an 'output' parameter.
1814 See StartProfiler.sample for details.
1815 * $wgMangleFlashPolicy was added to make MediaWiki's mangling of anything that
1816 might be a flash policy directive configurable.
1817 * ApiOpenSearch now supports XML output. The OpenSearchXml extension should no
1818 longer be used. If extracts and page images are desired, the TextExtracts and
1819 PageImages extensions are required.
1820 * $wgOpenSearchTemplate is deprecated in favor of $wgOpenSearchTemplates.
1821 * Edits are now prepared via AJAX as users type edit summaries. This behavior
1822 can be disabled via $wgAjaxEditStash.
1823 * (T46740) The temporary option $wgIncludejQueryMigrate was removed, along
1824 with the jQuery Migrate library, as indicated when this option was provided in
1825 MediaWiki 1.24.
1826 * ProfilerStandard and ProfilerSimpleTrace were removed. Make sure that any
1827 StartProfiler.php config is updated to reflect this. Xhprof is available
1828 for zend/hhvm. Also, for hhvm, one can consider using its xenon profiler.
1829 * Default value of $wgSVGConverters['rsvg'] now uses the 'rsvg-convert' binary
1830 rather than 'rsvg'.
1831 * Default value of $wgSVGConverters['ImageMagick'] now uses transparent
1832 background with white fallback color, rather than just white background.
1833 * MediaWikiBagOStuff class removed, make sure any object cache config
1834 uses SqlBagOStuff instead.
1835 * The 'daemonized' flag must be set to true in $wgJobTypeConf for any redis
1836 job queues. This means that mediawiki/services/jobrunner service has to
1837 be installed and running for any such queues to work.
1838 * $wgAutopromoteOnce no longer supports the 'view' event. For keeping some
1839 compatibility, any 'view' event triggers will still trigger on 'edit'.
1840 * $wgExtensionDirectory was added for when your extensions directory is somewhere
1841 other than $IP/extensions (as $wgStyleDirectory does with the skins directory).
1842
1843 === New features in 1.25 ===
1844 * (T64861) Updated plural rules to CLDR 26. Includes incompatible changes
1845 for plural forms in Russian, Prussian, Tagalog, Manx and several languages
1846 that fall back to Russian.
1847 * (T60139) ResourceLoaderFileModule now supports language fallback
1848 for 'languageScripts'.
1849 * Added a new hook, "ContentAlterParserOutput", to allow extensions to modify the
1850 parser output for a content object before links update.
1851 * (T37785) Enhanced recent changes and extended watchlist are now default.
1852 Documentation: https://meta.wikimedia.org/wiki/Special:MyLanguage/Help:Enhanced_recent_changes
1853 and https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgDefaultUserOptions.
1854 * (T69341) SVG images will no longer be base64-encoded when being embedded
1855 in CSS. This results in slight size increase before gzip compression (due to
1856 percent-encoding), but up to 20% decrease after it.
1857 * Update jStorage to v0.4.12.
1858 * MediaWiki now natively supports page status indicators: icons (or short text
1859 snippets) usually displayed in the top-right corner of the page. They have
1860 been in use on Wikipedia for a long time, implemented using templates and CSS
1861 absolute positioning.
1862 - Basic wikitext syntax: <indicator name="foo">[[File:Foo.svg|20px]]</indicator>
1863 - Usage instructions: https://www.mediawiki.org/wiki/Help:Page_status_indicators
1864 - Adjusting custom skins to support indicators:
1865 https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Skinning#Page_status_indicators
1866 * Edit tokens may now be time-limited: passing a maximum age to
1867 User::matchEditToken will reject any older tokens.
1868 * The debug logging internals have been overhauled, and are now using the
1869 PSR-3 interfaces.
1870 * Update CSSJanus to v1.1.1.
1871 * Update lessphp to v0.5.0.
1872 * Added a hook, "ApiOpenSearchSuggest", to allow extensions to provide extracts
1873 and images for ApiOpenSearch output. The semantics are identical to the
1874 "OpenSearchXml" hook provided by the OpenSearchXml extension.
1875 * PrefixSearchBackend hook now has an $offset parameter. Combined with $limit,
1876 this allows for pagination of prefix results. Extensions using this hook
1877 should implement supporting behavior. Not doing so can result in undefined
1878 behavior from API clients trying to continue through prefix results.
1879 * Update jQuery from v1.11.1 to v1.11.3.
1880 * External libraries installed via composer will now be displayed
1881 on Special:Version in their own section. Extensions or skins that are
1882 installed via composer will not be shown in this section as it is assumed
1883 they will add the proper credits to the skins or extensions section. They
1884 can also be accessed through the API via the new siprop=libraries to
1885 ApiQuerySiteInfo.
1886 * Update QUnit from v1.14.0 to v1.16.0.
1887 * Update Moment.js from v2.8.3 to v2.8.4.
1888 * Special:Tags now allows for manipulating the list of user-modifiable change
1889 tags.
1890 * Added 'managetags' user right and 'ChangeTagCanCreate', 'ChangeTagCanDelete',
1891 and 'ChangeTagCanCreate' hooks to allow for managing user-modifiable change
1892 tags.
1893 * Added 'ChangeTagsListActive' hook, to separate the concepts of "defined" and
1894 "active" formerly conflated by the 'ListDefinedTags' hook.
1895 * Added TemplateParser class that provides a server-side interface to cachable
1896 dynamically-compiled Mustache templates (currently uses lightncandy library).
1897 * Clickable anchors for each section heading in the content are now generated
1898 and appear in the gutter on hovering over the heading.
1899 * Added 'CategoryViewer::doCategoryQuery' and 'CategoryViewer::generateLink' hooks
1900 to allow extensions to override how links to pages are rendered within NS_CATEGORY
1901 * (T19665) Special:WantedPages only lists page which having at least one red link
1902 pointing to it.
1903 * New hooks 'ApiMain::moduleManager' and 'ApiQuery::moduleManager', can be
1904 used for conditional registration of API modules.
1905 * New hook 'EnhancedChangesList::getLogText' to alter, remove or add to the
1906 links of a group of changes in EnhancedChangesList.
1907 * A full interface for StatsD metric reporting has been added to the context
1908 interface, reachable via IContextSource::getStats().
1909 * Move the jQuery Client library from being mastered in MediaWiki as v0.1.0 to a
1910 proper, published library, which is now tagged as v1.0.0.
1911 * A new message (defaulting to blank), 'editnotice-notext', can be shown to users
1912 when they are editing if no edit notices apply to the page being edited.
1913 * (T94536) You can now make the sitenotice appear to logged-in users only by
1914 editing MediaWiki:Anonnotice and replacing its content with "". Setting it to
1915 "-" (default) will continue disable it and fallback to MediaWiki:Sitenotice.
1916 * Modifying the tagging of a revision or log entry is now available via
1917 Special:EditTags, generally accessed via the revision-deletion-like interface
1918 on history pages and Special:Log is likely to be more useful.
1919 * Added 'applychangetags' and 'changetags' user rights.
1920 * (T35235) LogFormatter subclasses are now responsible for formatting the
1921 parameters for API log event output. Extensions should implement the new
1922 getParametersForApi() method in their log formatters.
1923
1924 ==== External libraries ====
1925 * MediaWiki now requires certain external libraries to be installed. In the past
1926 these were bundled inside the Git repository of MediaWiki core, but now they
1927 need to be installed separately. For users using the tarball, this will be taken
1928 care of and no action will be required. Users using Git will either need to use
1929 composer to fetch dependencies or use the mediawiki/vendor repository which includes
1930 all dependencies for MediaWiki core and ones used in Wikimedia deployment. Detailed
1931 instructions can be found at:
1932 https://www.mediawiki.org/wiki/Download_from_Git#Fetch_external_libraries
1933 * The following libraries are now required:
1934 ** psr/log
1935 This library provides the interfaces set by the PSR-3 standard (http://www.php-fig.org/psr/psr-3/)
1936 which are used by MediaWiki internally via the
1937 MediaWiki\Logger\LoggerFactory class.
1938 See the structured logging RfC (https://www.mediawiki.org/wiki/Special:MyLanguage/Requests_for_comment/Structured_logging)
1939 for more background information.
1940 ** cssjanus/cssjanus
1941 This library was formerly bundled with MediaWiki core and has been removed.
1942 It automatically flips CSS for RTL support.
1943 ** leafo/lessphp
1944 This library was formerly bundled with MediaWiki core and has been removed.
1945 It compiles LESS files into CSS.
1946 ** wikimedia/cdb
1947 This library was formerly a part of MediaWiki core, and has been moved into a separate library.
1948 It provides CDB functions which are used in the Interwiki and Localization caches.
1949 More information about the library can be found at https://www.mediawiki.org/wiki/Special:MyLanguage/CDB.
1950 ** liuggio/statsd-php-client
1951 This library provides a StatsD client API for logging application metrics to a remote server.
1952
1953 === Bug fixes in 1.25 ===
1954 * (T73003) No additional code will be generated to try to load CSS-embedded
1955 SVG images in Internet Explorer 6 and 7, as they don't support them anyway.
1956 * (T69021) On Special:BookSources, corrected validation of ISBNs (both
1957 10- and 13-digit forms) containing "X".
1958 * Page moving was refactored into a MovePage class. As part of that:
1959 ** The AbortMove hook was removed.
1960 ** MovePageIsValidMove is for extensions to specify whether a page
1961 cannot be moved for technical reasons, and should not be overridden.
1962 ** MovePageCheckPermissions is for checking whether the given user is
1963 allowed to make the move.
1964 ** Title::moveNoAuth() was deprecated. Use the MovePage class instead.
1965 ** Title::moveTo() was deprecated. Use the MovePage class instead.
1966 ** Title::isValidMoveOperation() broken down into MovePage::isValidMove()
1967 and MovePage::checkPermissions().
1968 * (T18530) Multiple autocomments are now formatted in an edit summary.
1969 * (T70361) Autocomments containing "/*" are parsed correctly.
1970 * The Special:WhatLinksHere page linked from 'Number of redirects to this page'
1971 on action=info about a file page does not list file links anymore.
1972 * (T78637) Search bar is not autofocused unless it is empty so that proper scrolling using arrow keys is possible.
1973 * (T50853) Database::makeList() modified to handle 'NULL' separately when building IN clause
1974 * (T85192) Captcha position modified in Usercreate template. As a result:
1975 ** extrafields parameter added to Usercreate.php to insert additional data
1976 ** 'extend' method added to QuickTemplate to append additional values to any field of data array
1977 * (T86974) Several Title methods now load from the database when necessary
1978 (instead of returning incorrect results) even when the page ID is known.
1979 * (T74070) Duplicate search for archived files on file upload now omits the extension.
1980 This requires the fa_sha1 field being populated.
1981 * Removed rel="archives" from the "View history" link, as it did not pass
1982 HTML validation.
1983 * $wgUseTidy is now set when parserTests are run with the tidy option to match
1984 output on wiki.
1985 * (T37472) update.php will purge ResourceLoader cache unless --nopurge is passed to it.
1986 * (T72109) mediawiki.language should respect $wgTranslateNumerals in convertNumber().
1987
1988 === Action API changes in 1.25 ===
1989 * (T67403) XML tag highlighting is now only performed for formats
1990 "xmlfm" and "wddxfm".
1991 * action=paraminfo supports generalized submodules (modules=query+value),
1992 querymodules and formatmodules are deprecated
1993 * action=paraminfo no longer outputs descriptions and other help text by
1994 default. If needed, it may be requested using the new 'helpformat' parameter.
1995 * action=help has been completely rewritten, and outputs help in HTML
1996 rather than plain text.
1997 * Hitting api.php without specifying an action now displays only the help for
1998 the main module, with links to submodule help.
1999 * API help is no longer displayed on errors.
2000 * 'uselang' is now a recognized API parameter; "uselang=user" may be used to
2001 explicitly select the language from the current user's preferences, and
2002 "uselang=content" may be used to select the wiki's content language.
2003 * Default output format for the API is now jsonfm.
2004 * Simplified continuation will return a "batchcomplete" property in the result
2005 when a batch of pages is complete.
2006 * Pretty-printed HTML output now has nicer formatting and (if available)
2007 better syntax highlighting.
2008 * Deprecated list=deletedrevs in favor of newly-added prop=deletedrevisions and
2009 list=alldeletedrevisions.
2010 * prop=revisions will gracefully continue when given too many revids or titles,
2011 rather than just ignoring the extras.
2012 * prop=revisions will no longer die if rvcontentformat doesn't match a
2013 revision's content model; it will instead warn and omit the content.
2014 * If the user has the 'deletedhistory' right, action=query's revids parameter
2015 will now recognize deleted revids.
2016 * prop=revisions may be used as a generator, generating revids.
2017 * (T68776) format=json results will no longer be corrupted when
2018 $wgMangleFlashPolicy is in effect. format=php results will cleanly return an
2019 error instead of returning invalid serialized data.
2020 * Generators may now return data for the generated pages when used with
2021 action=query.
2022 * Query page data for generator=search and generator=prefixsearch will now
2023 include an "index" field, which may be used by the client for sorting the
2024 search results.
2025 * ApiOpenSearch now supports XML output.
2026 * ApiOpenSearch will now output descriptions and URLs as array indexes 2 and 3
2027 in JSON format.
2028 * (T76051) list=tags will now continue correctly.
2029 * (T76052) list=tags can now indicate whether a tag is defined.
2030 * (T75522) list=prefixsearch now supports continuation
2031 * (T78737) action=expandtemplates can now return page properties.
2032 * (T78690) list=allimages now accepts multiple pipe-separated values
2033 for the 'aimime' parameter.
2034 * prop=info with inprop=protections will now return applicable protection types
2035 with the 'restrictiontypes' key.
2036 * (T85417) When resolving redirects, ApiPageSet will now add the targets of
2037 interwiki redirects to the list of interwiki titles.
2038 * (T85417) When outputting the list of redirect titles, a 'tointerwiki'
2039 property (like the existing 'tofragment' property) will be set.
2040 * Added action=managetags to allow for managing the list of
2041 user-modifiable change tags. Actually modifying the tagging of a revision or
2042 log entry is not implemented yet.
2043 * list=tags has additional properties to indicate 'active' status and tag
2044 sources.
2045 * siprop=libraries was added to ApiQuerySiteInfo to list installed external libraries.
2046 * (T88010) Added action=checktoken, to test a CSRF token's validity.
2047 * (T88010) Added intestactions to prop=info, to allow querying of
2048 Title::userCan() via the API.
2049 * Default type param for query list=watchlist and list=recentchanges has
2050 been changed from all types (e.g. including 'external') to 'edit|new|log'.
2051 * Added formatversion to format=json. Still "experimental" as further changes
2052 to the output formatting might still be made.
2053 * (T73020) Log event details are now always under a 'params' subkey for
2054 list=logevents, and a 'logparams' subkey for list=watchlist and
2055 list=recentchanges.
2056 * Log event details are changing formatting:
2057 * block events now report flags as an array rather than as a comma-separated
2058 list.
2059 * patrol events now report the 'auto' flag as a boolean (absent/empty string
2060 for BC formats) rather than as an integer.
2061 * rights events now report the old and new group lists as arrays rather than
2062 as comma-separated lists.
2063 * merge events use new-style formatting.
2064 * delete/event and delete/revision events use new-style formatting.
2065 * The root node and various other nodes will now always be an object in formats
2066 such as json that distinguish between arrays and objects.
2067 * Except for action=opensearch where the spec requires an array.
2068
2069 === Action API internal changes in 1.25 ===
2070 * ApiHelp has been rewritten to support i18n and paginated HTML output.
2071 Most existing modules should continue working without changes, but should do
2072 the following:
2073 * Add an i18n message "apihelp-{$moduleName}-description" to replace getDescription().
2074 * Add i18n messages "apihelp-{$moduleName}-param-{$param}" for each parameter
2075 to replace getParamDescription(). If necessary, the settings array returned
2076 by getParams() can use the new ApiBase::PARAM_HELP_MSG key to override the
2077 message.
2078 * Implement getExamplesMessages() to replace getExamples().
2079 * Modules with submodules (like action=query) must have their submodules
2080 override ApiBase::getParent() to return the correct parent object.
2081 * The 'APIGetDescription' and 'APIGetParamDescription' hooks are deprecated,
2082 and will have no effect for modules using i18n messages. Use
2083 'APIGetDescriptionMessages' and 'APIGetParamDescriptionMessages' instead.
2084 * Api formatters will no longer be asked to display the help screen on errors.
2085 * ApiMain::getCredits() was removed. The credits are available in the
2086 'api-credits' i18n message.
2087 * ApiFormatBase has been changed to support i18n and syntax highlighting via
2088 extensions with the new 'ApiFormatHighlight' hook. Core syntax highlighting
2089 has been removed.
2090 * ApiFormatBase now always buffers. Output is done when
2091 ApiFormatBase::closePrinter is called.
2092 * Much of the logic in ApiQueryRevisions has been split into ApiQueryRevisionsBase.
2093 * The 'revids' parameter supplied by ApiPageSet will now count deleted
2094 revisions as "good" if the user has the 'deletedhistory' right. New methods
2095 ApiPageSet::getLiveRevisionIDs() and ApiPageSet::getDeletedRevisionIDs() are
2096 provided to access just the live or just the deleted revids.
2097 * Added ApiPageSet::setGeneratorData() and ApiPageSet::populateGeneratorData()
2098 to allow generators to include data in the action=query result.
2099 * New hooks 'ApiMain::moduleManager' and 'ApiQuery::moduleManager', can be
2100 used for conditional registration of API modules.
2101 * Added ApiBase::lacksSameOriginSecurity() to allow modules to easily check if
2102 the current request was sent with the 'callback' parameter (or any future
2103 method that breaks the same-origin policy).
2104 * Profiling methods in ApiBase are deprecated and no longer need to be called.
2105 * ApiResult was greatly overhauled. See inline documentation for details.
2106 * ApiResult will automatically convert objects to strings or arrays (depending
2107 on whether a __toString() method exists on the object), and will refuse to
2108 add unsupported value types.
2109 * An informal interface, ApiSerializable, exists to override the default
2110 object conversion.
2111 * ApiResult/ApiFormatBase "raw mode" is deprecated.
2112 * ApiFormatXml now assumes defaults and so on instead of throwing errors when
2113 metadata isn't set.
2114 * (T35235) LogFormatter subclasses are now responsible for formatting log event
2115 parameters for the API.
2116 * Many modules have changed result data formats. While this shouldn't affect
2117 clients not using the experimental formatversion=2, code using
2118 ApiResult::getResultData() without the transformations for backwards
2119 compatibility may need updating, as will code that wasn't following the old
2120 conventions for API boolean output.
2121 * The following methods have been deprecated and may be removed in a future
2122 release:
2123 * ApiBase::getDescription
2124 * ApiBase::getParamDescription
2125 * ApiBase::getExamples
2126 * ApiBase::makeHelpMsg
2127 * ApiBase::makeHelpArrayToString
2128 * ApiBase::makeHelpMsgParameters
2129 * ApiBase::getModuleProfileName
2130 * ApiBase::profileIn
2131 * ApiBase::profileOut
2132 * ApiBase::safeProfileOut
2133 * ApiBase::getProfileTime
2134 * ApiBase::profileDBIn
2135 * ApiBase::profileDBOut
2136 * ApiBase::getProfileDBTime
2137 * ApiBase::getResultData
2138 * ApiFormatBase::setUnescapeAmps
2139 * ApiFormatBase::getWantsHelp
2140 * ApiFormatBase::setHelp
2141 * ApiFormatBase::formatHTML
2142 * ApiFormatBase::setBufferResult
2143 * ApiFormatBase::getDescription
2144 * ApiFormatBase::getNeedsRawData
2145 * ApiMain::setHelp
2146 * ApiMain::reallyMakeHelpMsg
2147 * ApiMain::makeHelpMsgHeader
2148 * ApiResult::setRawMode
2149 * ApiResult::getIsRawMode
2150 * ApiResult::getData
2151 * ApiResult::setElement
2152 * ApiResult::setContent
2153 * ApiResult::setIndexedTagName_recursive
2154 * ApiResult::setIndexedTagName_internal
2155 * ApiResult::setParsedLimit
2156 * ApiResult::beginContinuation
2157 * ApiResult::setContinueParam
2158 * ApiResult::setGeneratorContinueParam
2159 * ApiResult::endContinuation
2160 * ApiResult::size
2161 * ApiResult::convertStatusToArray
2162 * ApiQueryImageInfo::getPropertyDescriptions
2163 * ApiQueryLogEvents::addLogParams
2164 * The following classes have been deprecated and may be removed in a future
2165 release:
2166 * ApiQueryDeletedrevs
2167
2168 === Languages updated in 1.25 ===
2169
2170 MediaWiki supports over 350 languages. Many localisations are updated
2171 regularly. Below only new and removed languages are listed, as well as
2172 changes to languages because of Bugzilla reports.
2173
2174 * Languages added:
2175 ** awa (अवधी / Awadhi), thanks to translator 1AnuraagPandey;
2176 ** bgn (بلوچی رخشانی / Western Balochi), thanks to translators
2177 Baloch Afghanistan, Ibrahim khashrowdi and Rachitrali;
2178 ** ses (Koyraboro Senni), thanks to translator Songhay.
2179 * (T66440) Kazakh (kk) wikis should no longer forcefully reset the user's
2180 interface language to kk where unexpected.
2181 * The Chinese conversion table was substantially updated to fix a lot of
2182 bugs and ensure better reading experience for different variants.
2183
2184 === Other changes in 1.25 ===
2185 * (T45591) Links to MediaWiki.org translatable help were added to indicators,
2186 mostly in special pages. Local custom target titles can be placed in the
2187 relevant '(namespace-X|action name|special page name)-helppage' system
2188 message. Extensions can use the addHelpLink() function to do the same.
2189 * The skin autodiscovery mechanism, deprecated in MediaWiki 1.23, has been
2190 removed. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for
2191 migration guide for creators and users of custom skins that relied on it.
2192 * Javascript variables 'wgFileCanRotate' and 'wgFileExtensions' now only
2193 available on Special:Upload.
2194 * (T58257) Set site logo from mediawiki.skinning.interface module instead of
2195 inline styles in the HTML.
2196 * Removed ApiQueryUsers::getAutoGroups(). (deprecated since 1.20)
2197 * Removed XmlDumpWriter::schemaVersion(). (deprecated since 1.20)
2198 * Removed LogEventsList::getDisplayTitle(). (deprecated since 1.20)
2199 * Removed Preferences::trySetUserEmail(). (deprecated since 1.20)
2200 * Removed mw.user.name() and mw.user.anonymous() methods. (deprecated since 1.20)
2201 * Removed 'ok' and 'err' parameters in the mediawiki.api modules. (deprecated
2202 since 1.20)
2203 * Removed 'async' parameter from the mw.Api#getCategories() method. (deprecated
2204 since 1.20)
2205 * Removed 'jquery.json' module. (deprecated since 1.24)
2206 Use the 'json' module and global JSON object instead.
2207 * Deprecated OutputPage::readOnlyPage() and OutputPage::rateLimited().
2208 Also, the former will now throw an MWException if called with one or more
2209 arguments.
2210 * Removed hitcounters and associated code.
2211 * The "temp" zone of the upload respository is now considered private. If it
2212 already exists (such as under the images/ directory), please make sure that
2213 the directory is not web readable (e.g. via a .htaccess file).
2214 * BREAKING CHANGE: In the XML dump format used by Special:Export and
2215 dumpBackup.php, the <model> and <format> tags now apprear before the <text>
2216 tag, instead of after the <text> and <sha1> tags.
2217 The new schema version is 0.10, the new schema URI is:
2218 https://www.mediawiki.org/xml/export-0.10.xsd
2219 * MWFunction::call() and MWFunction::callArray() were removed, having being
2220 deprecated in 1.22.
2221 * Deprecated the getInternalLinkAttributes, getInternalLinkAttributesObj,
2222 and getInternalLinkAttributes methods in Linker, and removed
2223 getExternalLinkAttributes method, which was deprecated in MediaWiki 1.18.
2224 * Removed Sites class, which was deprecated in 1.21 and replaced by SiteSQLStore.
2225 * Added wgRelevantArticleId to the client-side config, for use on special pages.
2226 * Deprecated the TitleIsCssOrJsPage hook. Superseded by the
2227 ContentHandlerDefaultModelFor hook since MediaWiki 1.21.
2228 * Deprecated the TitleIsWikitextPage hook. Superseded by the
2229 ContentHandlerDefaultModelFor hook since MediaWiki 1.21.
2230 * Changed parsing of variables in schema (.sql) files:
2231 ** The substituted values are no longer parsed. (Formerly, several passes
2232 were made for each variable, so depending on the order in which variables
2233 were defined, variables might have been found inside encoded values. This
2234 is no longer the case.)
2235 ** Variables are no longer string encoded when the /*$var*/ syntax is used.
2236 If string encoding is necessary, use the '{$var}' syntax instead.
2237 ** Variable names must only consist of one or more of the characters
2238 "A-Za-z0-9_".
2239 ** In source text of the form '{$A}'{$B}' or `{$A}`{$B}`, where variable A
2240 does not exist yet variable B does, the latter may not be replaced.
2241 However, this difference is unlikely to arise in practice.
2242 * (T67278) RFC, PMID, and ISBN "magic links" must be surrounded by non-word
2243 characters on both sides.
2244 * The FormatAutocomments hook will now receive $pre and $post as booleans,
2245 rather than as strings that must be prepended or appended to $comment.
2246 * (T30950, T31025) RFC, PMID, and ISBN "magic links" can no longer contain
2247 newlines; but they can contain &nbsp; and other non-newline whitespace.
2248 * The 'mediawiki.action.edit' ResourceLoader module no longer generates the edit
2249 toolbar, which has been moved to a separate 'mediawiki.toolbar' module. If you
2250 relied on this behavior, update your scripts' dependencies.
2251 * HTMLForm's 'vform' display style has been separated to a subclass. Therefore:
2252 * HTMLForm::isVForm() is now deprecated.
2253 * You can no longer do this:
2254 $form = new HTMLForm( … );
2255 $form->setDisplayFormat( 'vform' ); // throws exception
2256 Instead, do this:
2257 $form = HTMLForm::factory( 'vform', … );
2258 * Deprecated Revision methods getRawUser(), getRawUserText() and getRawComment().
2259 * BREAKING CHANGE: mediawiki.user.generateRandomSessionId:
2260 The alphabet of the prior string returned was A-Za-z0-9 and now it is 0-9A-F
2261 * (T87504) Avoid serving SVG background-images in CSS for Opera 12, which
2262 renders them incorrectly when combined with border-radius or background-size.
2263 * Removed maintenance script dumpSisterSites.php.
2264 * DatabaseBase class constructors must be called using the array argument style.
2265 Ideally, DatabaseBase:factory() should be used instead in most cases.
2266 * Deprecated ParserOutput::addSecondaryDataUpdate and ParserOutput::getSecondaryDataUpdates.
2267 This is a hard deprecation, with getSecondaryDataUpdates returning an empty array and
2268 addSecondaryDataUpdate throwing an exception. These functions will be removed in 1.26,
2269 since they interfere with caching of ParserOutput objects.
2270 * Introduced new hook 'SecondaryDataUpdates' that allows extensions to inject custom updates.
2271 * Introduced new hook 'OpportunisticLinksUpdate' that allows extensions to perform
2272 updates when a page is re-rendered.
2273 * EditPage::attemptSave has been modified not to call handleStatus itself and
2274 instead just returns the Status object. Extension calling it should be aware of
2275 this.
2276 * Removed class DBObject. (unused since 1.10)
2277 * wfDiff() is deprecated.
2278 * The -m (maximum replication lag) option of refreshLinks.php was removed.
2279 It had no effect since MediaWiki 1.18 and should be removed from any cron
2280 jobs or similar scripts you may have set up.
2281 * (T85864) The following messages no longer support raw html: redirectto,
2282 thisisdeleted, viewdeleted, editlink, retrievedfrom, version-poweredby-others,
2283 retrievedfrom, thisisdeleted, viewsourcelink, lastmodifiedat, laggedslavemode,
2284 protect-summary-cascade
2285 * All BloomCache related code has been removed. This was largely experimental.
2286 * $wgResourceModuleSkinStyles no longer supports per-module local or remote paths. They
2287 can only be set for the entire skin.
2288 * Removed global function swap(). (deprecated since 1.24)
2289 * Deprecated the ".php5" file extension entry points and the $wgScriptExtension
2290 configuration variable. Refer to the ".php" files instead. If you want
2291 ".php5" URLs to continue to work, set up redirects. In Apache, this can be
2292 done by enabling mod_rewrite and adding the following rules to your
2293 configuration:
2294
2295 RewriteEngine On
2296 RewriteBase /
2297 RewriteRule ^(.*)\.php5 $1.php [R=301,L]
2298
2299 * The global importScriptURI and importStylesheetURI functions, as well as the
2300 loadedScripts object, from wikibits.js (deprecated since 1.17) now emit
2301 warnings through mw.log.warn when accessed.
2302
2303 = MediaWiki 1.24 =
2304
2305 == MediaWiki 1.24.6 ==
2306
2307 This is a maintenance release of the MediaWiki 1.24 branch.
2308
2309 === Changes since 1.24.5 ===
2310 * (T121892) Fix fatal error on some Special pages, introduced in 1.24.5.
2311
2312 == MediaWiki 1.24.5 ==
2313
2314 This is a security and maintenance release of the MediaWiki 1.23 branch.
2315
2316 === Changes since 1.24.4 ===
2317 * (T117899) SECURITY: $wgArticlePath can no longer be set to relative paths
2318 that do not begin with a slash. This enabled trivial XSS attacks.
2319 Configuration values such as "http://my.wiki.com/wiki/$1" are fine, as are
2320 "/wiki/$1". A value such as "$1" or "wiki/$1" is not and will now throw an
2321 error.
2322 * (T119309) SECURITY: Use hash_compare() for edit token comparison
2323 * (T118032) SECURITY: Don't allow cURL to interpret POST parameters starting
2324 with '@' as file uploads
2325 * (T115522) SECURITY: Passwords generated by User::randomPassword() can no
2326 longer be shorter than $wgMinimalPasswordLength
2327 * (T97897) SECURITY: Improve IP parsing and trimming. Previous behavior could
2328 result in improper blocks being issued
2329 * (T109724) SECURITY: Special:MyPage, Special:MyTalk, Special:MyContributions
2330 and related pages no longer use HTTP redirects and are now redirected by
2331 MediaWiki
2332 * (T103237) $wgUseGzip had no effect when using file cache.
2333
2334 == MediaWiki 1.24.4 ==
2335
2336 This is a security and maintenance release of the MediaWiki 1.24 branch.
2337
2338 === Changes since 1.24.3 ===
2339
2340 * (T91653) Minimal PSR-3 debug logger to support backports from 1.25+.
2341 * (T68650) Fix indexing of moved pages with PostgreSQL. Requires running
2342 update.php to fix.
2343 * (T91850) SECURITY: Add throttle check in ApiUpload and SpecialUpload
2344 * (T91203, T91205) SECURITY: API: Improve validation in chunked uploading
2345 * (T95589) SECURITY: RevDel: Check all revisions for suppression, not just the
2346 first
2347 * (T108616) SECURITY: Avoid exposure of local path in PNG thumbnails
2348
2349 == MediaWiki 1.24.3 ==
2350
2351 This is a security and maintenance release of the MediaWiki 1.24 branch.
2352
2353 === Changes since 1.24.2 ===
2354
2355 * (T94116) SECURITY: Compare API watchlist token in constant time
2356 * (T97391) SECURITY: Escape error message strings in thumb.php
2357 * (T106893) SECURITY: Don't leak autoblocked IP addresses on
2358 Special:DeletedContributions
2359 * Update jQuery from v1.11.2 to v1.11.3.
2360 * (T102562) Fix InstantCommons parameters to handle the new HTTPS-only
2361 policy of Wikimedia Commons.
2362
2363 == MediaWiki 1.24.2 ==
2364
2365 This is a security and maintenance release of the MediaWiki 1.24 branch.
2366
2367 === Changes since 1.24.1 ===
2368
2369 * (T85848, T71210) SECURITY: Don't parse XMP blocks that contain XML entities,
2370 to prevent various DoS attacks.
2371 * (T85848) SECURITY: Don't allow directly calling Xml::isWellFormed, to reduce
2372 likelihood of DoS.
2373 * (T88310) SECURITY: Always expand xml entities when checking SVG's.
2374 * (T73394) SECURITY: Escape > in Html::expandAttributes to prevent XSS.
2375 * (T85855) SECURITY: Don't execute another user's CSS or JS on preview.
2376 * (T64685) SECURITY: Allow setting maximal password length to prevent DoS when
2377 using PBKDF2.
2378 * (T85349, T85850, T86711) SECURITY: Multiple issues fixed in SVG filtering to
2379 prevent XSS and protect viewer's privacy.
2380 * Fix case of SpecialAllPages/SpecialAllMessages in SpecialPageFactory to fix
2381 loading these special pages when $wgAutoloadAttemptLowercase is false.
2382 * (bug T70087) Fix Special:ActiveUsers page for installations using
2383 PostgreSQL.
2384 * (bug T76254) Fix deleting of pages with PostgreSQL. Requires a schema change
2385 and running update.php to fix.
2386
2387 == MediaWiki 1.24.1 ==
2388
2389 This is a security and maintenance release of the MediaWiki 1.24 branch.
2390
2391 === Changes since 1.24.0 ===
2392
2393 * (bug T76686) [SECURITY] thumb.php outputs wikitext message as raw HTML, which
2394 could lead to xss. Permission to edit MediaWiki namespace is required to
2395 exploit this.
2396 * (bug T77028) [SECURITY] Malicious site can bypass CORS restrictions in
2397 $wgCrossSiteAJAXdomains in API calls if it only included an allowed domain as
2398 part of its name.
2399 * (bug T74222) The original patch for T74222 was reverted as unnecessary.
2400 * Fixed a couple of entries in RELEASE-NOTES-1.24.
2401 * (bug T76168) OutputPage: Add accessors for some protected properties.
2402 * (bug T74834) Make 1.24 branch directly installable under PostgreSQL.
2403
2404 == MediaWiki 1.24.0 ==
2405
2406 === Configuration changes in 1.24 ===
2407 * MediaWiki will no longer run if register_globals is enabled. It has been
2408 deprecated for 5 years now, and was removed in PHP 5.4. For more information
2409 about why, see <https://www.mediawiki.org/wiki/register_globals>.
2410 * MediaWiki now requires PHP's iconv extension. openSUSE users may need to
2411 install the php5-iconv package. Users of other systems may need to add
2412 extension=iconv.so to php.ini or recompile PHP without --without-iconv.
2413 * MediaWiki will no longer function if magic quotes are enabled. It has
2414 been deprecated for 5 years now, and was removed in PHP 5.4.
2415 * The server's canonical hostname is available as $wgServerName, which is
2416 exposed in both mw.config and ApiQuerySiteInfo.
2417 * Introduced $wgPagePropsHaveSortkey as a backwards-compatibility switch,
2418 for using the old schema of the page_props table, in case the respective
2419 schema update was not applied.
2420 * $wgSearchEverythingOnlyLoggedIn was removed as the 'searcheverything'
2421 user option was removed. Use $wgNamespacesToBeSearchedDefault instead or
2422 if you used to have $wgDefaultUserOptions['searcheverything'] = 1.
2423 * $wgMasterWaitTimeout has been deprecated.
2424 * $wgDBClusterTimeout has been removed.
2425 * $wgProxyKey has been removed. It is no longer used by MediaWiki core.
2426 Ensure $wgSecretKey is set in LocalSettings.php.
2427 * $wgExtraInterlanguageLinkPrefixes is a new configuration variable that
2428 contains an array of interwiki prefixes that should be treated as language
2429 prefixes (i.e. turned into interlanguage links when $wgInterwikiMagic is set
2430 to true).
2431 * $wgParserTestRemote has been removed.
2432 * $wgCountTotalSearchHits has been removed. If you're concerned about efficiency
2433 of search, you should use something like CirrusSearch instead of built in
2434 search.
2435 * Users in the 'sysop' group have access to Special:MergeHistory by default.
2436 * $wgFileStore was removed after having been deprecated in 1.17. Alternative
2437 configurations are $wgDeletedDirectory and $wgHashedUploadDirectory.
2438 * The deprecated $wgUseCommaCount variable has been removed.
2439 * $wgEnableSorbs and $wgSorbsUrl have been removed.
2440 * The UserCryptPassword and UserComparePassword hooks are no longer called.
2441 Any extensions using them must be updated to use the Password Hashing API.
2442 * $wgCompiledFiles has been removed.
2443 * $wgSortSpecialPages was removed, the listing on Special:SpecialPages is
2444 now always sorted.
2445 * $wgSpecialPages may now use callback functions as an alternative to plain class names.
2446 This allows more control over constructor parameters.
2447 * $wgHTCPMulticastAddress, $wgHTCPMulticastRouting and $wgHTCPPort were removed.
2448 * $wgRC2UDPAddress, $wgRC2UDPInterwikiPrefix, $wgRC2UDPOmitBots, $wgRC2UDPPort
2449 and $wgRC2UDPPrefix have been removed.
2450 * The default password type for MediaWiki has been changed from MD5 to PBKDF2.
2451 Password hashes will automatically be updated as users log in. If necessary, the
2452 old MD5 hashing can be restored by changing $wgPasswordDefault to 'B'. In addition,
2453 there is a maintenance script wrapOldPassword.php that can wrap all passwords in
2454 PBKDF2 (or the hashing algorithm of your choice) if you don't want to wait for your
2455 users to log in.
2456 * $wgImportSources can now either be a regular array, or an associative map
2457 specifying subprojects on the interwiki map of the target wiki, or a mix of
2458 the two. Existing configurations will still work.
2459 * Users must be able to edit through a page's protection to be able to delete it.
2460 * The default thumb size ($wgDefaultUserOptions['thumbsize']) is now 300px, up from
2461 180px. If you have altered the number of entries in $wgThumbLimits for your wiki, you
2462 may need to adjust your default user settings to compensate for the index change.
2463 * $wgDeferredUpdateList is now deprecated, you should use DeferredUpdates::addUpdate()
2464 instead.
2465 * $wgCanonicalLanguageLinks has been removed. Per Google recommendations, we
2466 will not send a rel=canonical pointing to a variant-neutral page, however
2467 we will send rel=alternate.
2468 * $wgResourceLoaderLESSFunctions has been deprecated and will be removed in the future.
2469 * $wgGoToEdit has been removed. Use the SpecialSearchNogomatch hook for similar
2470 functionality.
2471
2472 === New features in 1.24 ===
2473 * Added new hook WatchlistEditorBeforeFormRender, allowing subscribers to
2474 manipulate the list of pages and/or preload lots of data at once.
2475 * Added new argument &$link in hook WatchlistEditorBuildRemoveLine, allowing the
2476 link to the title to be changed.
2477 * Added a new hook, "WhatLinksHereProps", to allow extensions to annotate
2478 WhatLinksHere entries.
2479 * Added a new hook, "ContentGetParserOutput", to customize parser output for
2480 a given content object.
2481 * Deprecated the hook "ShowRawCssJs", use "ContentGetParserOutput" instead.
2482 * HTMLForm's HTMLTextField now supports the 'url' type.
2483 * HTMLForm fields may now be dynamically hidden based on the values of other
2484 fields in the form.
2485 * HTMLForm now supports multiple copies of an input field or set of input
2486 fields, e.g. the form may request "one or more usernames" without having to
2487 have the user enter delimited list of names into a text field.
2488 * Added a new hook, "SidebarBeforeOutput", to allow to edit the structure of
2489 the sidebar just before its display.
2490 * (bug 49156) Added the mediawiki.cookie ResourceLoader module, which wraps
2491 jquery.cookie so that getting/setting a cookie is syntactically and
2492 functionally similar to using the WebRequest::getCookie() and
2493 WebResponse::setcookie() methods.
2494 * (bug 44740) jQuery upgraded from 1.8.3 to 1.11.1. A new configuration option,
2495 $wgIncludejQueryMigrate, also loads the jQuery Migrate hack to let extensions
2496 and gadgets use the long-deprecated functions that were removed in jQuery 1.9.
2497 This option is turned off by default, and will be removed in MediaWiki 1.25.
2498 * (bug 47076) jQuery UI upgraded from 1.8.24 to 1.9.2.
2499 * Changes to content typography (fonts, etc.). See
2500 https://www.mediawiki.org/wiki/Typography_refresh for further information.
2501 * WikitextContent will now render redirects with the expected "redirect"
2502 header, rather than as an ordered list. Code calling Article::viewRedirect
2503 can probably be changed to no longer special-case redirects.
2504 * Header font set to a serif font stack. See
2505 https://www.mediawiki.org/wiki/Typography_refresh for further information.
2506 * (bug 65567) Added a new hook, "BeforeHttpsRedirect", to allow cancellation of
2507 the HTTP to HTTPS redirect due to forceHTTPS cookie, userRequires, etc. This
2508 is only for page views, since this hook doesn't affect UserLogin, OAuth,
2509 CentralAuth, etc. ATTENTION: This hook is likely to be removed soon due to
2510 overall design of the system.
2511 * (bug 17367) It is now possible to add pages to your watchlist from
2512 Special:UnwatchedPages without reloading the special page.
2513 * New methods setVolatile and isVolatile are added to PPFrame, so that
2514 extensions such as Cite.php can mark that their output is volatile and
2515 shouldn't be cached.
2516 * (bug 52817) Advanced search options are now saved on the search page itself,
2517 rather than in a dedicated pane in the preferences panel.
2518 * (bug 44591) The dropdown actions menu (little triangle next to page tabs) in
2519 the Vector skin has gained a label that should make it more discoverable.
2520 * MWCryptHKDF added for fast, cryptographically secure random number generation
2521 that won't deplete openssl's entropy pool.
2522 * ResourceLoader: File modules can now provide a skip function that uses an
2523 inline feature test to bypass loading of the module.
2524 * (bug 20210) Special pages may now provide autocompletion of their subpage
2525 names in search suggestions. Right now the only useful implementation is in
2526 Special:Log, but more are to come.
2527 * Special:MostLinkedTemplates is no longer limited to transclusions from the
2528 Template namespace.
2529 * Skins can now use 'remoteSkinPath' when defining ResourceLoader modules.
2530 This works the same as 'remoteExtPath' but is relative to the skins/ folder
2531 instead of the extensions/ folder.
2532 * Added the json2.js polyfill for the ES5 JSON.stringify and JSON.parse methods.
2533 Exposed as module "json" with a skip function to optimise loading.
2534 * Extensions and skins may now use 'namemsg' in $wgExtensionCredits in addition
2535 to 'name', to allow for the name to be localizable. 'name' should still be
2536 specified for backwards-compatibility and to define the path Special:Version
2537 uses to find extension license information.
2538 * Browser tests are now included to verify basic wiki functionality in developer
2539 environments. For details on running tests, see tests/browser/README.mediawiki.
2540 * Upgrade jStorage to v0.4.10.
2541 * {{!}} is now a magic word that produces the | character. This removes the need
2542 for Template:! for purposes such as passing pipes inside of parameters.
2543 * (bug 20790) The block log snippet on Special:Contributions and while
2544 editing user and user talk pages now works for IP range blocks.
2545 * (bug 9360) Added ability to change the page language for MediaWiki pages using
2546 Special:PageLanguage. All pages are set to wiki language by default.
2547 The feature needs to be enabled with $wgPageLanguageUseDB=true and
2548 permission needs to be set for 'pagelang'.
2549 * Upgrade Moment.js to v2.8.3.
2550 * (bug 67042) Added support for the HTML5 <rtc> tag for East Asian typography.
2551 * Upgrade Sinon.JS to 1.10.3.
2552 * Added the es5-shim polyfill for older or non-compliant javascript engines.
2553 * Upgrade jQuery Cookie to v1.3.1.
2554 * (bug 20476) Add a "viewsuppressed" user right to be able to view
2555 suppressed content but not suppress it ("suppressrevision" right).
2556 * (bug 66440) The MediaWiki web installer will now allow you to choose the skins
2557 to enable (from the ones included in download tarball) and decide which one
2558 should be the default.
2559 * (bug 68085, 68802) Links like [[localInterwikiPrefix:languageCode:pageTitle]],
2560 where localInterwikiPrefix is a member of the $wgLocalInterwikis array, will
2561 no longer be displayed in the sidebar when $wgInterwikiMagic is true. In a
2562 similar way, links like [[localInterwikiPrefix:File:Image.png]] and
2563 [[localInterwikiPrefix:Category:Hello]] will now render as regular links, and
2564 will not include the file or add the page to the category.
2565 * New special page, MyLanguage, to redirect users to subpages with localised
2566 versions of a page. (Integrated from Extension:Translate)
2567 * MediaWiki now supports multiple password types, including bcrypt and PBKDF2.
2568 The default type can be changed with $wgPasswordDefault and the type
2569 configurations can be changed with $wgPasswordConfig.
2570 * Skins can now define custom styles for default ResourceLoader modules using
2571 the $wgResourceModuleSkinStyles global. See the Vector skin for examples.
2572 * (bug 4488) There is now a preference to watch pages where the user has
2573 rollbacked an edit by default.
2574 * (bug 15484) Users will now be redirected to the login page when they need to
2575 log in, rather than being shown a page asking them to log in and having to click
2576 another link to actually get to the login page.
2577 * A JsonContent and JsonContentHandler were added for extensions to extend.
2578 * (bug 35045) Redirects to sections will now update the URL in browser's address
2579 bar using the HTML5 History API. When [[Dog]] redirects to [[Animals#Dog]],
2580 the user will now see "Animals#Dog" in their browser instead of "Dog#Dog".
2581 * API token handling has been rewritten. Any API module using tokens will need
2582 to be updated. See the entry below under "Action API internal changes".
2583 * Added HTMLAutoCompleteSelectField.
2584 * Added a new hook, "SkinPreloadExistence", to allow extensions to add titles to
2585 link existence cache before the page is rendered.
2586 * Config::set() was moved to its own interface, MutableConfig. GlobalVarConfig::set()
2587 is now deprecated, does not implement MutableConfig.
2588 * A MutableConfig named HashConfig was added, that stores an array of configuration
2589 settings.
2590 * (bug 69418) A MultiConfig implementation was added that supports fallback
2591 to multiple Config instances.
2592 * Update CSSJanus to v1.1.0.
2593 * Added FormatJson::parse() returning status with result or localized error message
2594 * Added DeletedContribsPager::reallyDoQuery hook allowing extensions to data to
2595 Special:DeletedContributions
2596 * Added DeletedContributionsLineEnding hook allowing extensions to format
2597 Special:DeletedContributions lines
2598 * (T69525) You can now make MediaWiki speed up its thumbnail rendering by using
2599 intermediary thumbnails. $wgThumbnailBuckets must be set to a list of target
2600 thumbnail widths; when a new thumbnail needs to be rendered, MediaWiki will
2601 find the smallest bucket smaller than the original but larger than the target
2602 width + $wgThumbnailMinimumBucketDistance, and it will scale that thumbnail,
2603 rather than the original, down to the target size at greater speed in return
2604 for minor loss of fidelity.
2605
2606 === Bug fixes in 1.24 ===
2607 * (bug 50572) MediaWiki:Blockip should support gender
2608 * (bug 49116) Footer copyright notice is now always displayed in user language
2609 rather than content language (same as copyright notice for editing interface).
2610 * (bug 62258) A bug was fixed in File::getUnscaledThumb when a height
2611 restriction was present in the parameters. Images with both the "frame"
2612 option and a size specification set will now always ignore the provided
2613 size and display an unscaled image, as the documentation has always
2614 claimed it would.
2615 * (bug 39035) Improved Vector skin performance by removing collapsibleNav,
2616 which used to collapse some sidebar elements by default.
2617 This removes -list id suffixes like p-lang-list: instead of using things like
2618 #p-lang-list, you can do #p-lang .body ul.
2619 * (bug 890) Links in Special:RecentChanges and Special:Watchlist no longer
2620 follow redirects to their target pages.
2621 * Parser now dies early if called recursively, instead of producing subtle bugs.
2622 * (bug 14323) Redirect pages, when viewed with redirect=no, no longer hide the
2623 remaining page content.
2624 * (bug 52587) Maintenance script deleteBatch.php no longer follows redirects
2625 in the file namespace and delete the file on the target page. It will still
2626 however delete the redirect page.
2627 * (bug 22683) {{msgnw:}} and other uses of PPFrame::RECOVER_ORIG will correctly
2628 recover the original code of extension tags.
2629 * (bug 65757) MSSQL: Update script drops unnamed constraints to be prepared
2630 for future updates. Because it's doing so heuristically, it may fail or drop
2631 wrong constraints.
2632 * (bug 67870) wfShellExec() cuts off stdout at multiples of 8192 bytes.
2633 * $wgRunJobsAsync now works with private wikis (e.g. read requires login).
2634 * (bugs 57238, 65206) Blank pages can now be directly created.
2635 * (bug 69789) Title::getContentModel() now loads from the database when
2636 necessary instead of incorrectly returning the default content model.
2637 * (bug 69249) wfBaseConvert() now works around PHP Bug #50175 when using GMP.
2638 * (bug 57909) URLs in the externallinks table will no longer have certain
2639 characters decoded in the query string.
2640 * (bug 67368) LESS mixins like .background-image() correctly flip image
2641 references for RTL stylesheets now.
2642
2643 === Action API changes in 1.24 ===
2644 * action=parse API now supports prop=modules, which provides the list of
2645 ResourceLoader modules that should be used to enhance the parsed content.
2646 * action=query&meta=siteinfo&siprop=interwikimap returns a new "protorel"
2647 field which is true if protocol-relative urls can be used to access
2648 a particular interwiki map entry.
2649 * list=logevents now provides logpage, which is the page ID from the
2650 logging table, if ids are requested and the user has the permissions.
2651 * action=edit now requires that appendtext, prependtext, or section=new be used
2652 when using the 'redirect' parameter, to prevent clients accidentally
2653 overwriting the target page with the content of the redirect.
2654 * list=logevents will now return an error if both letitle and leprefix are
2655 specified.
2656 * list=logevents has a new parameter, lenamespace, to allow filtering by
2657 namespace.
2658 * action=expandtemplates has a new parameter, prop, and a new output format.
2659 The old format is still used if prop isn't provided, but this is deprecated.
2660 * meta=userinfo can now return the count of unread pages on the watchlist.
2661 * list=watchlist can now filter by unread status.
2662 * The deprecated action=parse&prop=languageshtml has been removed.
2663 * (bug 48071) action=setnotificationtimestamp no longer throws PHP or database
2664 errors when no pages are given.
2665 * (bug 60734) Actions that use ApiPageSet (e.g. purge, watch,
2666 setnotificationtimestamp) will now include continuation information when
2667 using a generator.
2668 * Removed 'props' and 'errors' from action=paraminfo, as they have extremely
2669 limited use and are generally inaccurate, unmaintained, and impossible to
2670 properly maintain.
2671 * Formats dbg, dump, txt, wddx, and yaml are now deprecated.
2672 * action=paraminfo now indicates when a parameter is specifying a submodule.
2673 * The iwurl parameter to prop=iwlinks is deprecated in favor of iwprop=url, for
2674 parallelism with prop=langlinks.
2675 * All tokens should be fetched from action=query&meta=tokens; all other methods
2676 of fetching tokens are deprecated. The value needed for meta=tokens's 'type'
2677 parameter for each module is documented in the action=help output and is
2678 returned from action=paraminfo.
2679 * New action ClearHasMsg that can be used to clear HasMsg flag.
2680 * The cmstartsortkey and cmendsortkey parameters to list=categorymembers are
2681 deprecated in favor of cmstarthexsortkey and cmendhexsortkey.
2682 * (bug 63326) Add blockedtimestamp field to output of blockinfo property for
2683 the list=allusers and list=users modules.
2684 * prop=imageinfo no longer requires iiurlwidth to be set when using iiurlparam.
2685 * Added prop=linkshere, prop=fileusage, and prop=transcludedin, which are
2686 roughly equivalent to list=backlinks, list=imageusage, and list=embeddedin
2687 but can work on a list of titles (including titles from a generator).
2688 * prop=redirects can now filter returned redirects by namespace.
2689
2690 === Action API internal changes in 1.24 ===
2691 * Methods for handling continuation are added to ApiResult, so actions other
2692 than query that use generators can easily support continuation.
2693 * $wgAPIModules (and the related $wgAPIFormatModules, $wgAPIMetaModules,
2694 $wgAPIPropModules, and $wgAPIListModules settings) now allow API modules
2695 to be specified using a "module spec" array instead of a plain class name.
2696 A "module spec" is an associative array containing at least the 'class' key
2697 for the module's class, and optionally a 'factory' key for the factory function
2698 to use for the module. This is intended for extensions that want control over
2699 the instantiation of their API modules, to allow for proper dependency
2700 injection.
2701 * A new param type 'submodule' is available. Parameters of this type will take
2702 the list of valid values from the module's ApiModuleManager for the group
2703 corresponding to the parameter name.
2704 * The 'APIGetPossibleErrors' and 'APIGetResultProperties' hooks are no longer used.
2705 * API token handling has been rewritten. Any API module using tokens will need
2706 to be updated:
2707 * ApiBase::needsToken now returns a token type instead of boolean true when a
2708 token is needed. Returning true will throw an exception. See documentation
2709 of that method for details.
2710 * Information for the 'token' parameter is automatically set by ApiBase
2711 getFinalParams and getFinalParamDescription.
2712 * ApiBase::getTokenSalt has been removed.
2713 * The hooks APIQueryInfoTokens, APIQueryRevisionsTokens,
2714 APIQueryRecentChangesTokens, APIQueryUsersTokens, and
2715 ApiTokensGetTokenTypes are deprecated, but are still called to support
2716 backwards-compatible token access.
2717 * ApiBase::validateLimit and ApiBase::validateTimestamp are now protected.
2718 * ApiQueryRedirects was removed; prop=redirects is now implemented by
2719 ApiQueryBacklinksProp along with the newly-added prop modules.
2720 * The following methods have been deprecated and may be removed in a future
2721 release:
2722 * ApiBase::getResultProperties
2723 * ApiBase::getFinalResultProperties
2724 * ApiBase::addTokenProperties
2725 * ApiBase::getRequireOnlyOneParameterErrorMessages
2726 * ApiBase::getRequireMaxOneParameterErrorMessages
2727 * ApiBase::getRequireAtLeastOneParameterErrorMessages
2728 * ApiBase::getTitleOrPageIdErrorMessage
2729 * ApiBase::getPossibleErrors
2730 * ApiBase::getFinalPossibleErrors
2731 * ApiBase::parseErrors
2732 * ApiQuery::setGeneratorContinue
2733 * ApiQueryBase::checkRowCount
2734 * ApiQueryBase::titleToKey
2735 * ApiQueryBase::keyToTitle
2736 * ApiQueryBase::keyPartToTitle
2737 * ApiQueryInfo::getTokenFunctions
2738 * ApiQueryInfo::resetTokenCache
2739 * ApiQueryInfo::getEditToken
2740 * ApiQueryInfo::getDeleteToken
2741 * ApiQueryInfo::getProtectToken
2742 * ApiQueryInfo::getMoveToken
2743 * ApiQueryInfo::getBlockToken
2744 * ApiQueryInfo::getUnblockToken
2745 * ApiQueryInfo::getEmailToken
2746 * ApiQueryInfo::getImportToken
2747 * ApiQueryInfo::getWatchToken
2748 * ApiQueryInfo::getOptionsToken
2749 * ApiQueryRecentChanges::getTokenFunctions
2750 * ApiQueryRecentChanges::getPatrolToken
2751 * ApiQueryRevisions::getTokenFunctions
2752 * ApiQueryRevisions::getRollbackToken
2753 * ApiQueryUsers::getTokenFunctions
2754 * ApiQueryUsers::getUserrightsToken
2755 * The following classes have been deprecated and may be removed in a future
2756 release:
2757 * ApiFormatDbg
2758 * ApiFormatDump
2759 * ApiFormatTxt
2760 * ApiFormatWddx
2761 * ApiFormatYaml
2762 * ApiTokens
2763 * The following class constants have been deprecated and may be removed in a
2764 future release:
2765 * ApiBase::PROP_ROOT
2766 * ApiBase::PROP_LIST
2767 * ApiBase::PROP_TYPE
2768 * ApiBase::PROP_NULLABLE
2769
2770 === Languages updated in 1.24 ===
2771
2772 MediaWiki supports over 350 languages. Many localisations are updated
2773 regularly. Below only new and removed languages are listed, as well as
2774 changes to languages because of Bugzilla reports.
2775
2776 === Other changes in 1.24 ===
2777 * The deprecated jquery.delayedBind ResourceLoader module was removed.
2778 * The deprecated function mw.util.toggleToc was removed.
2779 * The Special:Search hooks SpecialSearchGo and SpecialSearchResultsAppend
2780 were removed as they were unused.
2781 * (bug 65477) User::pingLimiter() now has an additional profile point varying
2782 by action being used.
2783 * mediawiki.util.$content no longer supports old versions of the Vector,
2784 Monobook, Modern and CologneBlue skins that don't yet implement the "mw-body"
2785 and/or "mw-body-primary" class name in their html.
2786 * Added pp_sortkey column to page_props table, so pages can be efficiently
2787 queried and sorted by property value (bug 58032).
2788 See $wgPagePropsHaveSortkey if you want to postpone the schema change.
2789 * BREAKING CHANGE: All four built-in MediaWiki skins (Vector, MonoBook, Modern
2790 and Cologne Blue) were moved out of MediaWiki core to their own respective
2791 repositories. They will be installed with the release tarball, but you must
2792 install them separately if installing MediaWiki from source code. A warning
2793 message displayed until you do it should guide you through the process. See
2794 also <https://www.mediawiki.org/wiki/Manual:Skin_configuration>.
2795 * BREAKING CHANGE: Skins built for MediaWiki 1.15 and earlier that do not use
2796 the "headelement" template key are no longer supported. Setting
2797 $useHeadElement = false; is no longer supported and will not cause old keys
2798 like "headlinks", "skinnameclass", etc. to be defined.
2799 * BREAKING CHANGE: The files commonElements.css, commonContent.css and
2800 commonInterface.css (in skins/common/) have been removed. Skins may no longer
2801 rely on their presence and include them in their style modules. ResourceLoader
2802 modules introduced in MediaWiki 1.23 should be loaded instead:
2803 - skins/common/commonElements.css → 'mediawiki.skinning.elements' module
2804 - skins/common/commonContent.css → 'mediawiki.skinning.content' module
2805 - skins/common/commonInterface.css → 'mediawiki.skinning.interface' module
2806 * The deprecated 'SpecialVersionExtensionTypes' hook was removed.
2807 * (bug 63891) Add 'X-Robots-Tag: noindex' header in action=render pages.
2808 * SpecialPage no longer supports the syntax for invoking wfSpecial*() functions.
2809 Special pages should subclass SpecialPage and implement the execute() method.
2810 * (bug 63755) The deprecated constants RC_MOVE and RC_MOVE_OVER_REDIRECT were
2811 removed.
2812 * Special:MostLinkedTemplates has been renamed to Special:MostTranscludedPages.
2813 * The skin autodiscovery mechanism has been deprecated and will be removed in
2814 MediaWiki 1.25. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery
2815 for migration guide for creators and users of custom skins that relied on it.
2816 * ResourceLoaderFileModule#getAllStyleFiles now returns all style files and all
2817 skin style files used by the module.
2818 * Removed getLang() from IContextSource and subclasses. (deprecated since 1.19)
2819 * Removed setLang() from subclasses of IContextSource. (deprecated since 1.19)
2820 * Removed WebRequest::escapeAppendQuery(). (deprecated since 1.20)
2821 * Removed info(), purge(), revert() and rollback() from the Article class; they
2822 have since become subclasses of the Action class. (deprecated since 1.19)
2823 * SearchEngineReplacePrefixesComplete hook was removed.
2824 * The "jquery.json" module has been deprecated. Use the "json" module instead.
2825 * Removed HTMLForm::addJS(). (deprecated since 1.18)
2826 * Removed LogEventsList::showHeader(). (deprecated since 1.19)
2827 * Removed ImageGalleryBase::useSkin(). (deprecated since 1.18)
2828 * Removed DatabaseMysqlBase::getLagFromProcesslist(). (deprecated since 1.19)
2829 * Removed LoadBalancer::closeConnecton(). (deprecated since 1.18)
2830 * Removed ApiBase::createContext(). (deprecated since 1.19)
2831 * BREAKING CHANGE: The undocumented Special{$this->getName()}BeforeFormDisplay
2832 set of hooks has been removed and replaced by a single new hook
2833 SpecialPageBeforeFormDisplay.
2834 * (bug 65781) Removed block warning on included {{Special:Contributions}}
2835 * Removed Skin::makeGlobalVariablesScript(). (deprecated since 1.19)
2836 * Removed MWNamespace::isMain(). (deprecated since 1.19)
2837 * Removed Preferences::loadOldSearchNs(). (deprecated since 1.19)
2838 * Removed OutputPage::getStatusMessage(). (deprecated since 1.18)
2839 * Removed OutputPage::isUserJsAllowed(). (deprecated since 1.18)
2840 * Removed Title::updateTitleProtection(). (deprecated since 1.19)
2841 * Removed ParserOptions::setSkin(). (deprecated since 1.19)
2842 * Removed Title::escapeCanonicalURL(). (deprecated since 1.19)
2843 * Removed Title::escapeLocalURL(). (deprecated since 1.19)
2844 * Removed Title::escapeFullURL(). (deprecated since 1.19)
2845 * Removed User::isValidEmailAddr(). (deprecated since 1.18)
2846 * Removed Title::getEscapedText(). (deprecated since 1.19)
2847 * Removed Language::getFallbackLanguageCode(). (deprecated since 1.19)
2848 * Removed WikiPage::isBigDeletion(). (deprecated since 1.19)
2849 * Removed MWInit class which contained functions related to a now discontinued
2850 PHP compiler called hphpc. (deprecated since 1.22)
2851 * ApiResult::enableSizeCheck() and disableSizeCheck() are now obsolete.
2852 * Removed ResourceLoaderGetStartupModules hook. (deprecated since 1.23)
2853 * Removed getFormFields(), onSubmit() and onSuccess() from FormlessAction, as
2854 these were meant specifically for FormAction instead.
2855 * Removed Action::execute().
2856 * Removed AjaxAddScript which has been obsolete since ResourceLoader and
2857 is unused by any modern extension.
2858 * Removed maintenance/nextJobDB.php; no longer in use.
2859 * Removed global function wfViewPrevNext(). (deprecated since 1.19)
2860 * Removed global function xmlsafe() from Export.php. (moved to OAIRepo extension)
2861 * Removed Title::userCanRead(). (deprecated since 1.19)
2862 * Removed maintenance script importTextFile.php. Use edit.php script instead.
2863 * A _from_namespace field has been added to the templatelinks, pagelinks,
2864 and filelinks tables. Run update.php to apply this change to the schema.
2865 * Removed File::sha1Base36(). (deprecated since 1.19)
2866 * Removed File::getPropsFromPath(). (deprecated since 1.19)
2867 * Removed functions blockedPage(), noCreatePermission(), readOnlyPage() and
2868 userNotLoggedInPage() from EditPage.php. (deprecated since 1.19)
2869 * Removed functions getContent(), getPreloadedText(), mergeChangesInto() and
2870 setPreloadedText() from EditPage.php. (deprecated since 1.21)
2871 * Removed global functions wfArrayLookup(), wfArrayMerge(), wfDebugDieBacktrace()
2872 and wfTime(). (deprecated since 1.22)
2873 * Browser support for Internet Explorer 6 and 7 lowered from Grade A to Grade C,
2874 meaning that JavaScript is no longer executed in these browser versions.
2875 * Browser support for Opera 11 lowered from Grade A to Grade C.
2876 * Removed IEFixes module which existed purely to provide support for MSIE versions
2877 below 7 (conditionally loaded only for those browsers).
2878 * Deprecated SpecialPageFactory::getList() in favor of
2879 SpecialPageFactory::getNames()
2880 * Action::checkCanExecute() no longer has a return value.
2881 * Removed cleanupForIRC(), loadFromCurRow(), newFromCurRow(), notifyRC2UDP()
2882 and sendToUDP() from RecentChange.php. (deprecated since 1.22)
2883 * Removed EnhancedChangesList::arrow(), sideArrow(), downArrow(), spacerArrow().
2884 * Removed Xml::namespaceSelector(). (deprecated since 1.19)
2885 * Removed WikiPage::estimateRevisionCount(). (deprecated since 1.19)
2886 * MYSQL: Enum item added to "major MIME type" columns.
2887 Running update.php on MySQL < v5.1 may result in heavy processing.
2888 * RSS and Atom feeds generated by MediaWiki no longer include a fallback
2889 stylesheet. It was ignored by most browsers these days anyway.
2890 * SpecialSearchNoResults hook has been removed. SpecialSearchResults is now
2891 called unconditionally.
2892 * TablePager::getBody() is now 'final' and can't be overridden in subclasses.
2893 * TablePager::getBody() is deprecated, use getBodyOutput() or getFullOutput().
2894 * Added $outputPage parameter to the SkinTemplateGetLanguageLink hook.
2895 * log_page for move log entries store the original page ID, rather than that
2896 of the new redirect page. This is not retroactive.
2897 * LCStoreAccel was removed. $wgLocalisationCacheConf can no longer be set to
2898 use this store class.
2899 * Html::infoBox() no longer accepts paths relative to skins/common/images/.
2900 * Deprecated defunct Skin::getCommonStylePath().
2901 * Some extensions had their ResourceLoader modules depend on the "mediawiki"
2902 and "jquery" modules. In the past, this behavior was undefined, now it will
2903 throw an error.
2904 * Removed BagOStuff::replace(). (deprecated since 1.23)
2905 * In Linker.php, link(), linkText() and makeBrokenImageLinkObj() now display
2906 warnings if their first parameter is not a Title object. Also makeImageLink()
2907 now requires a Parser as its first parameter.
2908 * (bug 67368) LESS functions embed() and embeddable(), added in MediaWiki 1.23
2909 and broken by design, have been removed. Use appropriate LESS mixins instead.
2910 * Removed cssjanus.py from maintenance directory as it was unused.
2911 * Removed maintenance/purgeOldText.inc and the PurgeRedundantText() function
2912 it contained (superseded by Maintenance::purgeRedundantText() in 1.16).
2913 The purgeOldText.php maintenance script has been retained.
2914 * PHPUnit tests can be found by directory discovery, by adding the directory
2915 path from your UnitTestsList callback. Older versions of MediaWiki core will
2916 barf at this usage.
2917
2918 ==== Renamed classes ====
2919 * CLDRPluralRuleConverter_Expression to CLDRPluralRuleConverterExpression
2920 * CLDRPluralRuleConverter_Fragment to CLDRPluralRuleConverterFragment
2921 * CLDRPluralRuleConverter_Operator to CLDRPluralRuleConverterOperator
2922 * CLDRPluralRuleEvaluator_Range to CLDRPluralRuleEvaluatorRange
2923 * CSSJanus_Tokenizer to CSSJanusTokenizer
2924 * MediaWiki_I18N to MediaWikiI18N
2925 * Parser_DiffTest to ParserDiffTest
2926 * RevDel_ArchiveItem to RevDelArchiveItem
2927 * RevDel_ArchiveList to RevDelArchiveList
2928 * RevDel_ArchivedFileItem to RevDelArchivedFileItem
2929 * RevDel_ArchivedFileList to RevDelArchivedFileList
2930 * RevDel_ArchivedRevisionItem to RevDelArchivedRevisionItem
2931 * RevDel_FileItem to RevDelFileItem
2932 * RevDel_FileList to RevDelFileList
2933 * RevDel_Item to RevDelItem
2934 * RevDel_List to RevDelList
2935 * RevDel_LogItem to RevDelLogItem
2936 * RevDel_LogList to RevDelLogList
2937 * RevDel_RevisionItem to RevDelRevisionItem
2938 * RevDel_RevisionList to RevDelRevisionList
2939 * WebInstaller_Complete to WebInstallerComplete
2940 * WebInstaller_Copying to WebInstallerCopying
2941 * WebInstaller_DBConnect to WebInstallerDBConnect
2942 * WebInstaller_DBSettings to WebInstallerDBSettings
2943 * WebInstaller_Document to WebInstallerDocument
2944 * WebInstaller_ExistingWiki to WebInstallerExistingWiki
2945 * WebInstaller_Install to WebInstallerInstall
2946 * WebInstaller_Language to WebInstallerLanguage
2947 * WebInstaller_Name to WebInstallerName
2948 * WebInstaller_Options to WebInstallerOptions
2949 * WebInstaller_Readme to WebInstallerReadme
2950 * WebInstaller_ReleaseNotes to WebInstallerReleaseNotes
2951 * WebInstaller_Restart to WebInstallerRestart
2952 * WebInstaller_Upgrade to WebInstallerUpgrade
2953 * WebInstaller_UpgradeDoc to WebInstallerUpgradeDoc
2954 * WebInstaller_Welcome to WebInstallerWelcome
2955
2956 ==== Removed classes ====
2957 * IPBlockForm - Use SpecialBlock directly
2958 * WatchlistEditor - Use SpecialEditWatchlist directly
2959 * FormatExif - Use FormatMetadata directly
2960 * RevertFileAction - Use RevertAction directly
2961 * HistoryPage - Use HistoryAction directly
2962 * RawPage - Use RawAction directly
2963 * StubContLang - Use Language::factory() instead
2964 * XMLReader2 - Use XMLReader directly
2965 * ResourceLoaderLESSFunctions - No longer in use, not intended for public usage
2966
2967 ==== Removed files ====
2968 The skins/common/ directory, previously containing some assets intended to be
2969 used by skins and a number of legacy styles and scripts, has been removed. Its
2970 contents have been deleted or relocated into the resources/ directory. Full list
2971 of files that are no longer available follows.
2972
2973 * skins/common/ajax.js
2974 * skins/common/commonContent.css
2975 * skins/common/commonElements.css
2976 * skins/common/commonInterface.css
2977 * skins/common/commonPrint.css
2978 * skins/common/config-cc.css
2979 * skins/common/config.css
2980 * skins/common/config.js
2981 * skins/common/feed.css
2982 * skins/common/IEFixes.js
2983 * skins/common/oldshared.css
2984 * skins/common/protect.js
2985 * skins/common/shared.css
2986 * skins/common/upload.js
2987 * skins/common/wikibits.js
2988 * skins/common/images/add.png
2989 * skins/common/images/ajax-loader.gif
2990 * skins/common/images/arrow_disabled_first_25.png
2991 * skins/common/images/arrow_disabled_last_25.png
2992 * skins/common/images/arrow_disabled_left_25.png
2993 * skins/common/images/arrow_disabled_right_25.png
2994 * skins/common/images/arrow_first_25.png
2995 * skins/common/images/arrow_last_25.png
2996 * skins/common/images/arrow_left_25.png
2997 * skins/common/images/arrow_right_25.png
2998 * skins/common/images/Arr_.png
2999 * skins/common/images/Arr_d.png
3000 * skins/common/images/Arr_l.png
3001 * skins/common/images/Arr_r.png
3002 * skins/common/images/Arr_u.png
3003 * skins/common/images/bullet.gif
3004 * skins/common/images/button_bold.png
3005 * skins/common/images/button_extlink.png
3006 * skins/common/images/button_headline.png
3007 * skins/common/images/button_hr.png
3008 * skins/common/images/button_image.png
3009 * skins/common/images/button_italic.png
3010 * skins/common/images/button_link.png
3011 * skins/common/images/button_media.png
3012 * skins/common/images/button_nowiki.png
3013 * skins/common/images/button_sig.png
3014 * skins/common/images/button_template.png
3015 * skins/common/images/cc-0.png
3016 * skins/common/images/cc-by-nc-sa.png
3017 * skins/common/images/cc-by-sa.png
3018 * skins/common/images/cc-by.png
3019 * skins/common/images/Checker-16x16.png
3020 * skins/common/images/closewindow.png
3021 * skins/common/images/closewindow19x19.png
3022 * skins/common/images/critical-32.png
3023 * skins/common/images/diffunderline.gif
3024 * skins/common/images/download-32.png
3025 * skins/common/images/feed-icon.png
3026 * skins/common/images/feed-icon.svg
3027 * skins/common/images/gnu-fdl.png
3028 * skins/common/images/help-question-hover.gif
3029 * skins/common/images/help-question.gif
3030 * skins/common/images/info-32.png
3031 * skins/common/images/link_icon.gif
3032 * skins/common/images/magnify-clip-rtl.png
3033 * skins/common/images/magnify-clip.png
3034 * skins/common/images/mediawiki.png
3035 * skins/common/images/nextredirectltr.png
3036 * skins/common/images/nextredirectrtl.png
3037 * skins/common/images/poweredby_mediawiki_88x31.png
3038 * skins/common/images/public-domain.png
3039 * skins/common/images/question-small.png
3040 * skins/common/images/question.svg
3041 * skins/common/images/redirectltr.png
3042 * skins/common/images/redirectrtl.png
3043 * skins/common/images/remove.png
3044 * skins/common/images/spinner.gif
3045 * skins/common/images/tick-32.png
3046 * skins/common/images/tipsy-arrow.gif
3047 * skins/common/images/tooltip_icon.png
3048 * skins/common/images/warning-32.png
3049 * skins/common/images/wiki.png
3050 * skins/common/images/Zoom_sans.gif
3051 * skins/common/images/ar/button_bold.png
3052 * skins/common/images/ar/button_headline.png
3053 * skins/common/images/ar/button_italic.png
3054 * skins/common/images/ar/button_link.png
3055 * skins/common/images/ar/button_nowiki.png
3056 * skins/common/images/be-tarask/button_bold.png
3057 * skins/common/images/be-tarask/button_italic.png
3058 * skins/common/images/be-tarask/button_link.png
3059 * skins/common/images/cyrl/button_bold.png
3060 * skins/common/images/cyrl/button_italic.png
3061 * skins/common/images/cyrl/button_link.png
3062 * skins/common/images/de/button_bold.png
3063 * skins/common/images/de/button_italic.png
3064 * skins/common/images/fa/button_bold.png
3065 * skins/common/images/fa/button_headline.png
3066 * skins/common/images/fa/button_italic.png
3067 * skins/common/images/fa/button_link.png
3068 * skins/common/images/fa/button_nowiki.png
3069 * skins/common/images/icons/fileicon-c.png
3070 * skins/common/images/icons/fileicon-cpp.png
3071 * skins/common/images/icons/fileicon-deb.png
3072 * skins/common/images/icons/fileicon-djvu.png
3073 * skins/common/images/icons/fileicon-djvu.xcf
3074 * skins/common/images/icons/fileicon-dvi.png
3075 * skins/common/images/icons/fileicon-exe.png
3076 * skins/common/images/icons/fileicon-h.png
3077 * skins/common/images/icons/fileicon-html.png
3078 * skins/common/images/icons/fileicon-iso.png
3079 * skins/common/images/icons/fileicon-java.png
3080 * skins/common/images/icons/fileicon-mid.png
3081 * skins/common/images/icons/fileicon-mov.png
3082 * skins/common/images/icons/fileicon-o.png
3083 * skins/common/images/icons/fileicon-ogg.png
3084 * skins/common/images/icons/fileicon-ogg.xcf
3085 * skins/common/images/icons/fileicon-pdf.png
3086 * skins/common/images/icons/fileicon-ps.png
3087 * skins/common/images/icons/fileicon-psd.png
3088 * skins/common/images/icons/fileicon-rm.png
3089 * skins/common/images/icons/fileicon-rpm.png
3090 * skins/common/images/icons/fileicon-svg.png
3091 * skins/common/images/icons/fileicon-tar.png
3092 * skins/common/images/icons/fileicon-tex.png
3093 * skins/common/images/icons/fileicon-ttf.png
3094 * skins/common/images/icons/fileicon-txt.png
3095 * skins/common/images/icons/fileicon.png
3096 * skins/common/images/ksh/button_S_italic.png
3097
3098 = MediaWiki 1.23 =
3099
3100 == MediaWiki 1.23.16 ==
3101 This is a security and maintenance release of the MediaWiki 1.23 branch.
3102
3103 === Changes since 1.23.15 ===
3104 * (T68404) CSS3 attr() function with url type is no longer allowed
3105 in inline styles.
3106 * (T156184) $wgRawHtml will no longer apply to internationalization messages.
3107 * Submitting the lgtoken and lgpassword parameters in the query string to
3108 action=login is now deprecated and outputs a warning. They should be submitted
3109 in the POST body instead.
3110 * (T109140) (T122209) SECURITY: Special:UserLogin and Special:Search allow redirect
3111 to interwiki links.
3112 * (T144845) SECURITY: XSS in SearchHighlighter::highlightText() when
3113 $wgAdvancedSearchHighlighting is true.
3114 * (T125177) SECURITY: API parameters may now be marked as "sensitive" to keep
3115 their values out of the logs.
3116 * (T150044) SECURITY: "Mark all pages visited" on the watchlist now requires a CSRF
3117 token.
3118 * (T156184) SECURITY: Escape content model/format url parameter in message.
3119 * (T151735) SECURITY: SVG filter evasion using default attribute values in DTD
3120 declaration.
3121 * (T48143) SECURITY: Spam blacklist ineffective on encoded URLs inside file inclusion
3122 syntax's link parameter.
3123 * (T108138) SECURITY: Sysops can undelete pages, although the page is protected against
3124 it.
3125
3126 == MediaWiki 1.23.15 ==
3127
3128 This is a maintenance release of the MediaWiki 1.23 branch.
3129
3130 === Changes since 1.23.14 ===
3131 * BREAKING CHANGE: $wgHTTPProxy is now *required* for all external requests
3132 made by MediaWiki via a proxy. Relying on the http_proxy environment
3133 variable is no longer supported.
3134 * (T139565) SECURITY: API: Generate head items in the context of the given title
3135 * (T137264) SECURITY: XSS in unclosed internal links
3136 * (T133147) SECURITY: Escape '<' and ']]>' in inline <style> blocks
3137 * (T133147) SECURITY: Require login to preview user CSS pages
3138 * (T132926) SECURITY: Do not allow undeleting a revision deleted file if it is
3139 the top file
3140 * (T129738) SECURITY: Make $wgBlockDisablesLogin also restrict logged in
3141 permissions
3142 * (T129738) SECURITY: Make blocks log users out if $wgBlockDisablesLogin is true
3143 * (T115333) SECURITY: Check read permission when loading page content in ApiParse
3144 * Remove support for $wgWellFormedXml = false, all output is now well formed
3145
3146 == MediaWiki 1.23.13 ==
3147
3148 This is a maintenance release of the MediaWiki 1.23 branch.
3149
3150 === Changes since 1.23.12 ===
3151 * (T121892) Fix fatal errors on some Special pages, introduced in 1.23.12.
3152
3153 == MediaWiki 1.23.12 ==
3154
3155 This is a security and maintenance release of the MediaWiki 1.23 branch.
3156
3157 === Changes since 1.23.11 ===
3158 * (T117899) SECURITY: $wgArticlePath can no longer be set to relative paths
3159 that do not begin with a slash. This enabled trivial XSS attacks.
3160 Configuration values such as "http://my.wiki.com/wiki/$1" are fine, as are
3161 "/wiki/$1". A value such as "$1" or "wiki/$1" is not and will now throw an
3162 error.
3163 * (T119309) SECURITY: Use hash_compare() for edit token comparison
3164 * (T118032) SECURITY: Don't allow cURL to interpret POST parameters starting
3165 with '@' as file uploads
3166 * (T115522) SECURITY: Passwords generated by User::randomPassword() can no
3167 longer be shorter than $wgMinimalPasswordLength
3168 * (T97897) SECURITY: Improve IP parsing and trimming. Previous behavior could
3169 result in improper blocks being issued
3170 * (T109724) SECURITY: Special:MyPage, Special:MyTalk, Special:MyContributions
3171 and related pages no longer use HTTP redirects and are now redirected by
3172 MediaWiki
3173
3174 == MediaWiki 1.23.11 ==
3175
3176 This is a security and maintenance release of the MediaWiki 1.23 branch.
3177
3178 === Changes since 1.23.10 ===
3179
3180 * (T91850) SECURITY: Add throttle check in ApiUpload and SpecialUpload
3181 * (T91203, T91205) SECURITY: API: Improve validation in chunked uploading
3182 * (T108616) SECURITY: Avoid exposure of local path in PNG thumbnails
3183
3184 == MediaWiki 1.23.10 ==
3185
3186 This is a security and maintenance release of the MediaWiki 1.23 branch.
3187
3188 === Changes since 1.23.9 ===
3189
3190 * (T94116) SECURITY: Compare API watchlist token in constant time
3191 * (T97391) SECURITY: Escape error message strings in thumb.php
3192 * (T106893) SECURITY: Don't leak autoblocked IP addresses on
3193 Special:DeletedContributions
3194 * (bug 67644) Make AutoLoaderTest handle namespaces
3195 * (T91653) Minimal PSR-3 debug logger to support backports from 1.25+.
3196 * (T102562) Fix InstantCommons parameters to handle the new HTTPS-only
3197 policy of Wikimedia Commons.
3198
3199 == MediaWiki 1.23.9 ==
3200
3201 This is a security and maintenance release of the MediaWiki 1.23 branch.
3202
3203 === Changes since 1.23.8 ===
3204
3205 * (T85848, T71210) SECURITY: Don't parse XMP blocks that contain XML entities,
3206 to prevent various DoS attacks.
3207 * (T85848) SECURITY: Don't allow directly calling Xml::isWellFormed, to reduce
3208 likelihood of DoS.
3209 * (T88310) SECURITY: Always expand xml entities when checking SVG's.
3210 * (T73394) SECURITY: Escape > in Html::expandAttributes to prevent XSS.
3211 * (T85855) SECURITY: Don't execute another user's CSS or JS on preview.
3212 * (T85349, T85850, T86711) SECURITY: Multiple issues fixed in SVG filtering to
3213 prevent XSS and protect viewer's privacy.
3214 * (bug T68650) Fix indexing of moved pages with PostgreSQL. Requires running
3215 update.php to fix.
3216 * (bug T70087) Fix Special:ActiveUsers page for installations using
3217 PostgreSQL.
3218
3219 == MediaWiki 1.23.8 ==
3220
3221 This is a security and maintenance release of the MediaWiki 1.23 branch.
3222
3223 === Changes since 1.23.7 ===
3224
3225 * (bug T76686) [SECURITY] thumb.php outputs wikitext message as raw HTML, which
3226 could lead to xss. Permission to edit MediaWiki namespace is required to
3227 exploit this.
3228 * (bug T77028) [SECURITY] Malicious site can bypass CORS restrictions in
3229 $wgCrossSiteAJAXdomains in API calls if it only included an allowed domain as
3230 part of its name.
3231 * (bug T74222) The original patch for T74222 was reverted as unnecessary.
3232
3233 == MediaWiki 1.23.7 ==
3234
3235 This is a security and maintenance release of the MediaWiki 1.23 branch.
3236
3237 === Changes since 1.23.6 ===
3238
3239 * (bugs 66776, 71478) SECURITY: User PleaseStand reported a way to inject code
3240 into API clients that used format=php to process pages that underwent flash
3241 policy mangling. This was fixed along with improving how the mangling was done
3242 for format=json, and allowing sites to disable the mangling using
3243 $wgMangleFlashPolicy.
3244 * (bug 70901) SECURITY: User Jackmcbarn reported that the ability to update
3245 the content model for a page could allow an unprivileged attacker to edit
3246 another user's common.js under certain circumstances. The user right
3247 "editcontentmodel" was added, and is needed to change a revision's content
3248 model.
3249 * (bug 71111) SECURITY: User PleaseStand reported that on wikis that allow raw
3250 HTML, it is not safe to preview wikitext coming from an untrusted source such
3251 as a cross-site request. Thus add an edit token to the form, and when raw HTML
3252 is allowed, ensure the token is provided before showing the preview. This
3253 check is not performed on wikis that both allow raw HTML and anonymous
3254 editing, since there are easier ways to exploit that scenario.
3255 * (bug 72222) SECURITY: Do not show log action when the entry is revdeleted with
3256 DELETED_ACTION. NOTICE: this may be reverted in a future release pending a
3257 public RFC about the desired functionality. This issue was reported by user
3258 Bawolff.
3259 * (bug 71621) Make allowing site-wide styles on restricted special pages a
3260 config option.
3261 * (bug 42723) Added updated version history from 1.19.2 to 1.22.13
3262 * $wgMangleFlashPolicy was added to make MediaWiki's mangling of anything that
3263 might be a flash policy directive configurable.
3264
3265 == MediaWiki 1.23.6 ==
3266
3267 This is a maintenance release of the MediaWiki 1.23 branch.
3268
3269 === Changes since 1.23.5 ===
3270 * (Bug 72274) Job queue not running (HTTP 411) due to missing
3271 Content-Length: header
3272 * (Bug 67440) Allow classes to be registered properly from installer
3273
3274 == MediaWiki 1.23.5 ==
3275
3276 This is a security release of the MediaWiki 1.23 branch.
3277
3278 === Changes since 1.23.4 ===
3279 * (bug 70672) SECURITY: OutputPage: Remove separation of css and js module
3280 allowance.
3281
3282 == MediaWiki 1.23.4 ==
3283
3284 This is a security and maintenance release of the MediaWiki 1.23 branch.
3285
3286 === Changes since 1.23.3 ===
3287
3288 * (bug 69008) SECURITY: Enhance CSS filtering in SVG files. Filter <style>
3289 elements; normalize style elements and attributes before filtering; add
3290 checks for attributes that contain css; add unit tests for html5sec and
3291 reported bugs.
3292 * (bug 65998) Make MySQLi work with non-standard socket.
3293 * (bug 66986) GlobalVarConfig shouldn't throw exceptions for null-valued config
3294 settings.
3295
3296 == MediaWiki 1.23.3 ==
3297
3298 This is a maintenance release of the MediaWiki 1.23 branch.
3299
3300 === Changes since 1.23.2 ===
3301
3302 * (bug 68501) Correctly handle incorrect namespace in cleanupTitles.php.
3303 * (bug 64970) Fix support for blobs on DatabaseOracle::update.
3304 * (bug 66574) Display MediaWiki:Loginprompt on the login page.
3305 * (bug 67870) wfShellExec() cuts off stdout at multiples of 8192 bytes.
3306 * (bug 60629) Handle invalid language code gracefully in
3307 Language::fetchLanguageNames.
3308 * (bug 62017) Restore the number of rows shown on Special:Watchlist.
3309 * Check for boolean false result from database query in SqlBagOStuff.
3310
3311 == MediaWiki 1.23.2 ==
3312
3313 This is a security and maintenance release of the MediaWiki 1.23 branch.
3314
3315 === Changes since 1.23.1 ===
3316
3317 * (bug 68187) SECURITY: Prepend jsonp callback with comment.
3318 * (bug 66608) SECURITY: Fix for XSS issue in bug 66608: Generate the URL used
3319 for loading a new page in Javascript,instead of relying on the URL in the link
3320 that has been clicked.
3321 * (bug 65778) SECURITY: Copy prevent-clickjacking between OutputPage and
3322 ParserOutput.
3323 * (bug 68313) Preferences: Turn stubthreshold back into a combo box.
3324 * (bug 65214) Fix initSiteStats.php maintenance script.
3325 * (bug 67594) Special:ActiveUsers: Fix to work with PostgreSQL.
3326
3327 == MediaWiki 1.23.1 ==
3328
3329 This is a security and maintenance release of the MediaWiki 1.23 branch.
3330
3331 === Changes since 1.23.0 ===
3332
3333 * (bug 65839) SECURITY: Prevent external resources in SVG files.
3334 * (bug 67025) Special:Watchlist: Don't try to render empty row.
3335 * (bug 66922) Don't allow some E_NOTICE messages to end up in the LocalSettings.php.
3336 * (bug 66467) FileBackend: Avoid using popen() when "parallelize" is disabled.
3337 * (bug 66428) MimeMagic: Don't seek before BOF. This has weird side effects
3338 like only extracting the tail of the file partially or not at all.
3339 * (bug 66182) Removed -x flag on some php files.
3340
3341 == MediaWiki 1.23.0 ==
3342
3343 === Configuration changes in 1.23 ===
3344 * (bug 13250) Restored method for clearing a watchlist in web UI
3345 so that users with large watchlists don't have to perform
3346 contortions to clear them.
3347 * When $wgJobRunRate is higher than zero, jobs are now executed via an
3348 asynchronous HTTP request to a MediaWiki entry point. This may require
3349 increasing the number of server worker threads. $wgRunJobsAsync has been
3350 added to disable this feature if needed, falling back to executing the job
3351 on the same process but making the execution synchronously.
3352 * $wgDebugLogGroups values may be set to an associative array with a
3353 'destination' key specifying the log destination. The array may also contain
3354 a 'sample' key with a positive integer value N indicating that the log group
3355 should be sampled by dispatching one in every N messages on average. The
3356 sampling is random.
3357 * In addition to the current exception log format, MediaWiki now serializes
3358 exception metadata to JSON and logs it to the 'exception-json' log group.
3359 This makes MediaWiki easier to integrate with log aggregation and analysis
3360 tools.
3361 * $wgSquidServersNoPurge now supports the use of Classless Inter-Domain
3362 Routing (CIDR) notation to specify contiguous blocks of IPv4 and/or IPv6
3363 addresses that should be trusted to provide X-Forwarded-For headers.
3364 * Preferences 'watchcreations', 'watchdefault', 'enotifwatchlistpages' ("Add
3365 pages I create and files I upload to my watchlist", "Add pages and files I
3366 edit to my watchlist", "Email me when a page or file on my watchlist is
3367 changed") are now enabled by default. In addition new user accounts' personal
3368 and talk pages are now watched by them by default.
3369 * $wgLBFactoryConf: Class names have had underscores removed. The configuration
3370 should be updated if LBFactory_Simple or LBFactory_Multi is configured.
3371 * $wgPasswordSenderName has been removed and is no longer functional. To set a
3372 custom mailer name, the system message 'emailsender' should be modified
3373 (default: "{{SITENAME}}").
3374 * (bug 63269) Email notifications were not correctly handling the
3375 [[MediaWiki:Helppage]] message being set to a full URL (the default).
3376 If you customized [[MediaWiki:Enotif body]] (the text of email notifications),
3377 you'll need to edit it locally to include the URL via the new variable
3378 $HELPPAGE instead of the parser functions fullurl and canonicalurl; otherwise
3379 you don't have to do anything.
3380 * $wgDBAhandler was removed as the only class using it was also removed
3381 * The 'max threads' setting was removed from $wgDBservers.
3382 * Support for AdminSettings.php has been completely removed. All configuration
3383 belongs in LocalSettings.php.
3384 * $wgSkipSkin, which has been replaceable by $wgSkipSkins since 2005 (r9249), is
3385 now formally deprecated.
3386 * Removed deprecated $wgDisabledActions as it is hardly used anywhere.
3387 * $wgRateLimitLog has been deprecated and replaced by
3388 $wgDebugLogGroup['ratelimit'].
3389 * $wgLocalInterwikis is an array containing multiple local interwiki prefixes
3390 (interwiki prefixes that point back to the current wiki). This effectively
3391 allows more than one value of $wgLocalInterwiki to be specified and
3392 understood by the parser. The value of $wgLocalInterwiki is automatically
3393 prepended to the start of this array.
3394 * $wgQueryPages has been removed. Query Pages should be added to by using the
3395 wgQueryPages hook.
3396 * $wgHttpOnlyBlacklist has been removed.
3397 * $wgLicenseTerms has been removed as it was unused.
3398 * $wgProfileOnly is now deprecated; set the log file in
3399 $wgDebugLogGroups['profileoutput'] to replace it.
3400 * $wgMaxBacklinksInvalidate was removed; use $wgJobBackoffThrottling instead
3401 * Deprecated ResourceLoaderGetStartupModules hook.
3402
3403 === New features in 1.23 ===
3404 * ResourceLoader can utilize the Web Storage API to cache modules client-side.
3405 Compared to the browser cache, caching in Web Storage allows ResourceLoader
3406 to be more granular about evicting stale modules from the cache while
3407 retaining the ability to retrieve multiple modules in a single HTTP request.
3408 This capability can be enabled by setting $wgResourceLoaderStorageEnabled to
3409 true. This feature is currently considered experimental and should only be
3410 enabled with care.
3411 * (bug 6092) Add expensive parser functions {{REVISIONID:}}, {{REVISIONUSER:}}
3412 and {{REVISIONTIMESTAMP:}} (with friends).
3413 * Add "wgRelevantUserName" to mw.config containing the current
3414 Skin::getRelevantUser value.
3415 * (bug 56033) Add content model to the page information.
3416 * Added Article::MissingArticleConditions hook to give extensions a chance to
3417 hide their (unrelated) log entries.
3418 * Added LonelyPagesQuery hook to let extensions modify the query used to
3419 generate Special:LonelyPages.
3420 * Added $wgOpenSearchDefaultLimit defining the default number of entries to show
3421 on action=opensearch API call.
3422 * For namespaces with $wgNamespaceProtection (including the MediaWiki
3423 namespace), the "protect" tab will be shown only if there are restriction
3424 levels available that would restrict editing beyond what
3425 $wgNamespaceProtection already applies. The protection form will offer only
3426 those protection levels.
3427 * Added $wgAPIFormatModules, allowing extensions to add additional output
3428 formatting modules for the API.
3429 * (bug 47812) The MediaWiki:Group-user.{css,js} pages can now be used to add
3430 custom CSS or JavaScript enabled only for registered users.
3431 * (bug 52005) Special pages RecentChanges, RecentChangesLinked and Watchlist
3432 now include a legend describing the symbols used in lists of changes.
3433 * Improved the accessibility of the tabs in Special:Preferences.
3434 * Added ApiBeforeMain hook, roughly equivalent to the BeforeInitialize hook:
3435 it's called after everything is set up but before any major processing
3436 happens.
3437 * The jquery.client module now performs a component-wise version comparison in
3438 its #test method when strings are used in the browser map: version '1.10' is
3439 now correctly considered larger than '1.2'. Using numbers in the version map
3440 is not affected.
3441 * All API modules now support an assert parameter, which can either be
3442 'user' or 'bot'. The API will throw an error if the user is not logged
3443 in (user) or does not have the 'bot' userright (bot). Based off of the
3444 AssertEdit extension by Steve Sanbeg.
3445 * [[Special:Diff]] was added, allowing users to create internal links to
3446 revision comparison pages using syntax such as [[Special:Diff/12345]],
3447 [[Special:Diff/12345/prev]] or [[Special:Diff/12345/98765]].
3448 * New user accounts' personal and talk pages are now watched by them by default.
3449 * Added SkinTemplateGetLanguageLink hook to allow changing the html of language
3450 links.
3451 * Added MessageCache::get hook as a new way to customize messages across
3452 multiple sites.
3453 * Added jquery.throttle-debounce ResourceLoader module to limit the number of
3454 callbacks for frequently occurring events.
3455 * Special:ProtectedPages shows now a table. The timestamp, the reason and
3456 the protecting user are also shown.
3457 * Added experimental support for using Microsoft SQL Server as the database
3458 backend.
3459 ** Added new Microsoft SQL Server-specific configuration variable
3460 $wgDBWindowsAuthentication, which makes the web server authenticate against
3461 the database server using Integrated Windows Authentication instead of
3462 $wgDBuser/$wgDBpassword.
3463 * HTMLForm 'select', 'selectandother', 'selectorother', 'multiselect', and
3464 'radio' fields can now use message keys as labels via the 'options-messages'
3465 parameter, which overrides the 'options' parameter.
3466 * Admins can expire users passwords manually, or on a schedule using the
3467 $wgPasswordExpirationDays configuration setting.
3468 * Add new hook SendWatchlistEmailNotification, this will be used to determine
3469 whether to send a watchlist email notification.
3470 * (bug 42026) Special:Contributions now includes an option to filter page
3471 creations, similar to the topOnly option.
3472 * Add mediawiki.ui.button styling to all pages so wiki content can use styled
3473 buttons.
3474 * Special:UserLogin/signup now does AJAX checks for invalid and taken usernames,
3475 displaying the error live.
3476 * Added BaseTemplateAfterPortlet hook to allow injecting html after portlets in skins.
3477 * Support has been added for a JSON based localisation file format. The
3478 installer has been updated to use it.
3479 * Changes to content typography (colors, line-height etc.). See
3480 https://www.mediawiki.org/wiki/Typography_refresh for further information.
3481 * The Vector skin's visual treatment of external links has been simplified to a
3482 single icon (from nine). This should not affect local rules unless they were
3483 re-using these icons, which have now been deleted.
3484 * ResourceLoader: mw.loader.using() now implements a Promise interface.
3485 * Add new hook ChangesListInitRows accessed via ChangesList::initChangesListRows.
3486 If called by the ChangesList consumer this gives extensions a chance to batch
3487 process the result set prior to rendering.
3488 * A PoolCounterRedis class was added which can be make use of in $wgPoolCounterConf.
3489 This requires at least one Redis 2.6+ server.
3490 * $wgProfileToDatabase was removed. Set $wgProfiler to ProfilerSimpleDB
3491 in StartProfiler.php instead of using this.
3492 * (bug 63444) Made it possible to change the indent string (default: 4 spaces)
3493 used by FormatJson::encode().
3494
3495 === Bug fixes in 1.23 ===
3496 * (bug 41759) The "updated since last visit" markers (on history pages, recent
3497 changes and watchlist) and the talk page message indicator are now correctly
3498 updated when the user is viewing old revisions of pages, instead of always
3499 acting as if the latest revision was being viewed.
3500 * (bug 56443) Special:ConfirmEmail no longer shows a "Mail a confirmation code"
3501 when the email address is already confirmed. Also, consistently use
3502 "confirmed", rather than "authenticated", when messaging whether or not the
3503 user has confirmed an email address.
3504 * (bug 19415) action=render no longer shows section edit links. This affects
3505 behavior of several other features where (bogus) section edit links will
3506 disappear, such as file description pages loaded via $wgUseInstantCommons or
3507 pages transcluded cross-wiki via $wgEnableScaryTranscluding.
3508 * (bug 56912) Show correct link color on cached result of Special:DeadendPages.
3509 * Classes TitleListDependency and TitleDependency have been removed, as they
3510 have been found unused in core and extensions for a long time.
3511 * (bug 57098) SpecialPasswordReset now obeys returnto parameter
3512 * (bug 37812) ResourceLoader will notice when a module's definition changes and
3513 recompile it accordingly.
3514 * (bug 57201) SpecialRecentChangesFilters hook is now executed for feeds.
3515 * (bug 58640) Fixed a compatibility issue with PCRE 8.34 that caused pages
3516 to appear blank or with missing text.
3517 * (bug 56931) Updated the plural rules to CLDR 24. They are in new format
3518 which is detailed in UTS 35 Rev 33. The PHP parser and evaluator as well as
3519 the JavaScript evaluator were updated to support the new format. Plural rules
3520 for some languages have changed, most notably Russian. Affected software
3521 messages have been updated and marked for review at translatewiki.net.
3522 * (bug 23542) imagelinks now stores both the redirect and target (as
3523 templatelinks does).
3524 * (bug 58167) The web installer no longer throws an exception when PHP is
3525 compiled without support for MySQL yet with support for another DBMS.
3526 * (bug 56199) Raw option of parser functions must now match complete word,
3527 to take effect.
3528 * (bug 60543) Special:PrefixIndex forgot stripprefix=1 for "Next page" link
3529 * (bug 29762) Undoing an already-undone edit will now display an appropriate
3530 message instead of leading the user to make a null edit.
3531 * (bug 52659) mediawiki.notification: Notification area remained visible when
3532 empty and thus was stealing pointer events from links on the page.
3533 * (bug 26811) When a DBUnexpectedError occurs, DB server hostnames are now
3534 hidden unless $wgShowExceptionDetails is true, and $wgShowDBErrorBacktrace
3535 no longer applies in such cases.
3536 * (bug 60960) Avoid doing file_exist() checks on data: URIs, as they cause
3537 warnings to be printed on Windows due to large path length.
3538 * (bug 48084) Fixed a bug in the installer that could cause $wgLogo to hold
3539 the wrong path to the placeholder logo (skins/common/images/wiki.png).
3540 * (bug 64289) jquery.textSelection: Don't throw errors on empty collections.
3541
3542 === Web API changes in 1.23 ===
3543 * (bug 54884) action=parse&prop=categories now indicates hidden and missing
3544 categories.
3545 * action=query&meta=filerepoinfo now returns additional information for each
3546 repo.
3547 * action=parse&prop=languageshtml was deprecated in 1.18 and will be removed in
3548 MediaWiki 1.24.
3549 * action=parse now has disabletoc flag to disable table of contents in output.
3550 * (bug 25702) list=allcategories, list=allimages, list=alllinks, list=allpages,
3551 list=deletedrevs and list=filearchive did not handle case-sensitivity
3552 properly for all parameters.
3553 * ApiQueryBase::titlePartToKey allows an extra parameter that indicates the
3554 namespace in order to properly capitalize the title part.
3555 * (bug 57874) action=feedcontributions no longer has one item more than limit.
3556 * All API modules now support an assert parameter. See the new features section
3557 for more details.
3558 * Added prop=contributors to fetch the list of contributors to the page.
3559 * The following API modules will now return entries where fields have been
3560 revision-deleted: list=deletedrevs, list=filearchive, list=recentchanges,
3561 list=watchlist. "hidden" indicators will be included, in the same style as is
3562 already done for prop=revisions.
3563 * The following API modules will now return the content of revision-deleted
3564 fields, in addition to the "hidden" indicators, if the querying user has the
3565 necessary rights: list=logevents, list=usercontribs, prop=imageinfo,
3566 prop=revisions.
3567 * The above modules, where applicable, will now return entries filtered by
3568 revision-deleted fields if the querying user has the necessary rights. For
3569 example, prop=revisions with rvuser or rvexcludeuser will no longer skip
3570 revisions where the user was revision-deleted if the current user has the
3571 deletedhistory right.
3572 * The 'hideuser' right, used when blocking, is no longer necessary or
3573 sufficient for seeing contributions with revision-deleted in
3574 list=usercontribs.
3575 * list=watchlist now uses the querying user's rights rather than the wlowner's
3576 rights when checking whether wlprop=patrol is allowed.
3577 * (bug 32151) ApiWatch now has pageset capabilities (titles/pageids/generators).
3578 Title parameter is now deprecated.
3579 * (bug 23005) Added action=revisiondelete.
3580 * Added siprop=restrictions to API action=query&meta=siteinfo for querying
3581 possible page restriction (protection) levels and types.
3582 * Added prop 'limitreportdata' and 'limitreporthtml' to action=parse.
3583 * (bug 58627) Provide language names on action=parse&prop=langlinks.
3584 * Deprecated llurl= in favour of llprop=url for action=query&prop=langlinks.
3585 * Added llprop=langname and llprop=autonym for action=query&prop=langlinks.
3586 * prop=redirects is added, to return redirects to the pages in the query.
3587 * list=allredirects is added, to list all redirects pointing to a namespace.
3588 * (bug 42026) Added ucshow={new,!new,top,!top} to list=usercontribs.
3589 Also added newonly to action=feedcontributions.
3590 * (bug 42026) Deprecated uctoponly in favor of ucshow=top.
3591 * list=search no longer has a "srredirects" parameter. Redirects are now
3592 included in all searches.
3593 * Added list=prefixsearch that works like action=opensearch but can be used as
3594 a generator.
3595 * (bug 24782) Various modules will now use unique continuation parameters.
3596 * (bug 63249) Cache RecentChanges Atom feed in varnish for 15 seconds.
3597
3598 === Languages updated in 1.23 ===
3599
3600 MediaWiki supports over 350 languages. Many localisations are updated
3601 regularly. Below only new and removed languages are listed, as well as
3602 changes to languages because of Bugzilla reports.
3603
3604 * Support was added for Algerian Spoken Arabic (arq).
3605 * Support was added for Riograndenser Hunsrückisch (hrx).
3606 * Support was added for Northern Luri (lrc).
3607
3608 === Other changes in 1.23 ===
3609 * The rc_type field in the recentchanges table has been superseded by a new
3610 rc_source field. The rc_source field is a string representation of the
3611 change type where rc_type was a numeric constant. This field is not yet
3612 queried but will be in a future release.
3613 ** Utilize update.php to create and populate this new field. On larger wikis
3614 which do not wish to update recentchanges table in one large update please
3615 review the SQL and comments in maintenance/archives/patch-rc_source.sql.
3616 ** The rc_type field of recentchanges will be deprecated in a future release.
3617 * The global variable $wgArticle has been removed after a lengthy deprecation.
3618 * The global functions addButton and insertTags (for mw.toolbar.addButton and
3619 mw.toolbar.insertTags) now emits mw.log.warn when accessed.
3620 * The ExpandTemplates extension has been moved into MediaWiki core.
3621 * (bug 52812) Removed "Disable search suggestions" from Preference.
3622 * (bug 52809) Removed "Disable browser page caching" from Preference.
3623 * Three new modules intended for use by custom skins were added:
3624 'mediawiki.skinning.elements', 'mediawiki.skinning.content', and
3625 'mediawiki.skinning.interface', representing three levels of standard
3626 MediaWiki styling. Previously skin creators wishing to use them had to refer
3627 to the file names of appropriate files directly, which is now discouraged.
3628 * The modules 'skins.vector' and 'skins.monobook' have been renamed to
3629 'skins.vector.styles' and 'skins.monobook.styles', respectively,
3630 and their definition was changed not to include the common*.css files;
3631 the two skins now load the 'mediawiki.skinning.interface' module instead.
3632 * A page_links_updated field has been added to the page table.
3633 * SpecialPage::getTitle has been deprecated in favor of
3634 SpecialPage::getPageTitle.
3635 * BREAKING CHANGE: Two potentially backwards-incompatible changes have been made
3636 to the 'SpecialWatchlistQuery' hook's last parameter (array $values) to make
3637 the hook more consistent with the 'SpecialRecentChangesQuery' one:
3638 ** Several array keys have been renamed: hideMinor → hideminor,
3639 hideBots → hidebots, hideAnons → hideanons, hideLiu → hideliu,
3640 hidePatrolled → hidepatrolled, hideOwn → hidemyself.
3641 ** The parameter value is now a FormOptions object, not a plain array (array
3642 access operators should continue to work, as it implements the ArrayAccess
3643 interface).
3644 * Option to mark hooks as deprecated has been added.
3645 * (bug 52811) Preference "Enable section editing via [edit] links" was removed.
3646 * (bug 52813) Preference "Show table of contents (for pages with more than
3647 3 headings)" was removed.
3648 * (bug 52810) Preference "Justify paragraphs" was removed.
3649 * OutputPage::showErrorPage raises a notice if arguments are incoherent.
3650 * Thumbnails that keep failing to render in thumb.php will be rate-limited
3651 against further render attempts for 1 hour. $wgAttemptFailureEpoch can be
3652 altered to reset all rate-limited thumbnails at once.
3653 * (bug 56572) Builds of the OOjs and OOjs UI libraries are now available.
3654 * mw.loader.go and mw.loader.version have been removed.
3655 * (bug 52815) Preference "Enable simplified search bar (Vector skin only)"
3656 was removed.
3657 * A user_password_expires column has been added to the user table. The User
3658 object expects this column to exist. Use update.php to create this new field.
3659 * The jquery.delayedBind ResourceLoader module was deprecated in favor of the
3660 jquery.throttle-debounce module. It will be removed in MediaWiki 1.24.
3661 * mw.user.bucket has been deprecated.
3662 * On Special:PrefixIndex, a table#mw-prefixindex-list-table was changed to
3663 table.mw-prefixindex-list-table to avoid duplicate ids when the special page
3664 is transcluded.
3665 * (bug 62198) window.$j has been deprecated.
3666 * Preference "Disable link title conversion" was removed.
3667 * SpecialRecentChanges no longer includes any functionality for generating feeds
3668 - it has been factored out to ApiFeedRecentChanges. Old URLs redirect to new
3669 ones.
3670 * RecentChange::mExtra['lang'] is no longer set and should no longer be used.
3671 Extensions should read from other configuration variables, including
3672 $wgLocalInterwikis, to identify the current wiki.
3673 * Sections in the parser test framework have been renamed and the old
3674 section names are deprecated. Please use "!!wikitext" and "!!html"
3675 (or "!!html/php") instead of "!!input" and "!!result". This allows
3676 us to extend parser tests to accommodate additional input/output
3677 pairs, such as "!!html/parsoid" (for the output of the Parsoid
3678 parser, where it differs from the PHP parser).
3679 * Special:Search no longer has an "include redirects" option on the advanced
3680 tab. Redirects are now included in all searches.
3681 * mediawiki.api.category's getCategories() 'async' parameter was deprecated.
3682 * The locations of resources have been split between upstream libraries, now in
3683 resources/lib/, local libaries in resources/src/, and local forks of upstream
3684 libraries, also in resources/src/.
3685 * BREAKING CHANGE: The automatically-generated function closure with which
3686 ResourceLoader wraps all modules' JavaScript code now binds the identifier
3687 names 'jQuery' and '$' to the jQuery object of the version of jQuery that is
3688 bundled with MediaWiki. If you bind these names to other objects in global
3689 scope (like Zepto.js or document.querySelectorAll, for example) you will need
3690 to use different names to or re-bind them at the top of each
3691 ResourceLoader-loaded module.
3692 * (bug 52342) Preference "Remember my login" was removed.
3693 * The skin autodiscovery mechanism has been deprecated and will be removed in
3694 MediaWiki 1.25. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery
3695 for migration guide for creators and users of custom skins that relied on it.
3696
3697 ==== Removed classes ====
3698 * FakeMemCachedClient (deprecated in 1.18)
3699 * RdfMetaData (unused)
3700 * TitleDependency (unused)
3701 * TitleListDependency (unused)
3702 * WikiError (deprecated in 1.17)
3703 * WikiXmlError (deprecated in 1.17)
3704 * WikiErrorMsg (deprecated in 1.17)
3705
3706 ==== Renamed classes ====
3707 * CdbReader_DBA to CdbReaderDBA
3708 * CdbReader_PHP to CdbReaderPHP
3709 * CdbWriter_DBA to CdbWriterDBA
3710 * CdbWriter_PHP to CdbWriterPHP
3711 * DiffOp_Add to DiffOpAdd
3712 * DiffOp_Change to DiffOpChange
3713 * DiffOp_Copy to DiffOpCopy
3714 * DiffOp_Delete to DiffOpDelete
3715 * HWLDF_WordAccumulator to HWLDFWordAccumulator
3716 * LBFactory_Fake to LBFactoryFake
3717 * LBFactory_Multi to LBFactoryMulti
3718 * LBFactory_Simple to LBFactorySimple
3719 * LBFactory_Single to LBFactorySingle
3720 * LCStore_Accel to LCStoreAccel
3721 * LCStore_CDB to LCStoreCDB
3722 * LCStore_DB to LCStoreDB
3723 * LCStore_Null to LCStoreNull
3724 * LoadBalancer_Single to LoadBalancerSingle
3725 * LoadMonitor_MySQL to LoadMonitorMySQL
3726 * LoadMonitor_Null to LoadMonitorNull
3727 * LocalisationCache_BulkLoad to LocalisationCacheBulkLoad
3728 * csvStatsOutput to CsvStatsOutput
3729 * extensionLanguages to ExtensionLanguages
3730 * languages to Languages
3731 * statsOutput to StatsOutput
3732 * textStatsOutput to TextStatsOutput
3733 * wikiStatsOutput to WikiStatsOutput
3734
3735 ==== Removed methods ====
3736 * ApiBase::getValidNamespaces() (deprecated in 1.17)
3737 * ApiMain::setCachePrivate() (deprecated in 1.17)
3738 * ApiMain::setVaryCookie (deprecated in 1.17)
3739 * Article::doRedirect() (deprecated in 1.18)
3740 * Article::doUnwatch() (deprecated in 1.18)
3741 * Article::doWatch() (deprecated in 1.18)
3742 * Article::forUpdate() (deprecated in 1.18)
3743 * Article::markpatrolled() (deprecated in 1.18)
3744 * Article::unwatch() (deprecated in 1.18)
3745 * Article::watch() (deprecated in 1.18)
3746 * Block::clear() (deprecated in 1.18)
3747 * Block::decodeExpiry() (deprecated in 1.18)
3748 * Block::encodeExpiry() (deprecated in 1.18)
3749 * Block::forUpdate() (deprecated in 1.18)
3750 * Block::infinity() (deprecated in 1.18)
3751 * Block::load() (deprecated in 1.18)
3752 * Block::newFromDB() (deprecated in 1.18)
3753 * Block::normaliseRange() (deprecated in 1.18)
3754 * Block::parseExpiryInput() (deprecated in 1.18)
3755 * CategoryViewer::addSubcategory() (deprecated in 1.17)
3756 * EditPage::spamPage() (deprecated since 1.17)
3757 * Exif::getFormattedData() (deprecated in 1.18)
3758 * Exif::makeFormattedData() (deprecated in 1.18)
3759 * in_string (deprecated in 1.21)
3760 * Language::convertLinkToAllVariants() (deprecated in 1.17)
3761 * LanguageConverter::convertLinkToAllVariants() (deprecated in 1.17)
3762 * Linker::makeBrokenLink() (deprecated in 1.16)
3763 * Linker::makeBrokenLinkObj() (deprecated in 1.16)
3764 * Linker::makeColouredLinkObj() (deprecated in 1.16)
3765 * Linker::makeSizeLinkObj() (deprecated in 1.17)
3766 * MediaWiki::articleFromTitle() (deprecated in 1.18)
3767 * ParserOptions::getkin() (deprecated 1.18)
3768 * ProfilerSimple::getCpuTime (deprecated in 1.20)
3769 * Revision::revText() (deprecated in 1.17)
3770 * SkinTemplate::jstext() (deprecated in 1.21)
3771 * SpecialPage::__call() (deprecated in 1.17)
3772 * SpecialPage::executePath() (deprecated in 1.18)
3773 * SpecialPage::exists() (deprecated in 1.18)
3774 * SpecialPage::file() (deprecated in 1.18)
3775 * SpecialPage::func() (deprecated in 1.18)
3776 * SpecialPage::getGroup() (deprecated in 1.18)
3777 * SpecialPage::getPage() (deprecated in 1.18)
3778 * SpecialPage::getPageByAlias() (deprecated in 1.18)
3779 * SpecialPage::getLocalNameFor() (deprecated in 1.18)
3780 * SpecialPage::getRegularPages() (deprecated in 1.18)
3781 * SpecialPage::getRestrictedPages() (deprecated in 1.18)
3782 * SpecialPage::getTitleForAlias() (deprecated in 1.18)
3783 * SpecialPage::getUsablePages() (deprecated in 1.18)
3784 * SpecialPage::includable() (deprecated in 1.18)
3785 * SpecialPage::init()
3786 * SpecialPage::initAliasList() (deprecated in 1.18)
3787 * SpecialPage::initList() (deprecated in 1.18)
3788 * SpecialPage::name() (deprecated in 1.18)
3789 * SpecialPage::removePage() (deprecated in 1.18)
3790 * SpecialPage::resolveAlias() (deprecated in 1.18)
3791 * SpecialPage::resolveAliasWithSubpage() (deprecated in 1.18)
3792 * SpecialPage::restriction() (deprecated in 1.18)
3793 * SpecialPage::setGroup() (deprecated in 1.18)
3794 * SpecialRecentChanges::feedSetup()
3795 * SpecialRevisionDelete::extractBitField() (deprecated in 1.22)
3796 * User::getPageRenderingHash() (deprecated in 1.17)
3797 * WebRequest::getFileSize() (deprecated in 1.17)
3798 * WebRequest::isPathInfoBad() (deprecated in 1.17)
3799 * wfGenerateToken (deprecated in 1.20)
3800 * wfStreamFile (deprecated in 1.19)
3801 * wfUILang (deprecated in 1.18)
3802 * WikiPage::createUpdates() (deprecated in 1.18)
3803 * WikiPage::quickEdit() (deprecated in 1.18)
3804 * WikiPage::useParserCache() (deprecated in 1.18)
3805 * WikiPage::viewUpdates() (deprecated in 1.18)
3806
3807 ==== Removed globals ====
3808 * $wgBetterDirectionality (deprecated in 1.18)
3809
3810 = MediaWiki 1.22 =
3811
3812 == MediaWiki 1.22.15 ==
3813
3814 This is a security and maintenance release of the MediaWiki 1.22 branch.
3815
3816 === Changes since 1.22.14 ===
3817
3818 * (bug T76686) [SECURITY] thumb.php outputs wikitext message as raw HTML, which
3819 could lead to xss. Permission to edit MediaWiki namespace is required to
3820 exploit this.
3821 * (bug T77028) [SECURITY] Malicious site can bypass CORS restrictions in
3822 $wgCrossSiteAJAXdomains in API calls if it only included an allowed domain as
3823 part of its name.
3824 * (bug T74222) The original patch for T74222 was reverted as unnecessary.
3825
3826 == MediaWiki 1.22.14 ==
3827
3828 This is a security and maintenance release of the MediaWiki 1.22 branch.
3829
3830 === Changes since 1.22.13 ===
3831
3832 * (bugs 66776, 71478) SECURITY: User PleaseStand reported a way to inject code
3833 into API clients that used format=php to process pages that underwent flash
3834 policy mangling. This was fixed along with improving how the mangling was done
3835 for format=json, and allowing sites to disable the mangling using
3836 $wgMangleFlashPolicy.
3837 * (bug 70901) SECURITY: User Jackmcbarn reported that the ability to update
3838 the content model for a page could allow an unprivileged attacker to edit
3839 another user's common.js under certain circumstances. The user right
3840 "editcontentmodel" was added, and is needed to change a revision's content
3841 model.
3842 * (bug 72222) SECURITY: Do not show log action when the entry is revdeleted with
3843 DELETED_ACTION. NOTICE: this may be reverted in a future release pending a
3844 public RFC about the desired functionality. This issue was reported by user
3845 Bawolff.
3846 * (bug 71621) Make allowing site-wide styles on restricted special pages a
3847 config option.
3848 * $wgMangleFlashPolicy was added to make MediaWiki's mangling of anything that
3849 might be a flash policy directive configurable.
3850
3851 == MediaWiki 1.22.13 ==
3852 This is a maintenance release of the MediaWiki 1.22 branch.
3853
3854 === Changes since 1.22.12 ===
3855 * (bug 67440) Allow classes to be registered properly from installer
3856
3857 == MediaWiki 1.22.12 ==
3858 This is a security release of the MediaWiki 1.22 branch.
3859
3860 === Changes since 1.22.11 ===
3861 * (bug 70672) SECURITY: OutputPage: Remove separation of css and js module allowance.
3862
3863 == MediaWiki 1.22.11 ==
3864 This is a security release of the MediaWiki 1.22 branch.
3865
3866 === Changes since 1.22.10 ===
3867 * (bug 69008) SECURITY: Enhance CSS filtering in SVG files. Filter <style> elements; normalize style elements and attributes before filtering; add checks for attributes that contain css; add unit tests for html5sec and reported bugs.
3868
3869 == MediaWiki 1.22.10 ==
3870 This is a maintenance release of the MediaWiki 1.22 branch.
3871
3872 === Changes since 1.22.9 ===
3873 * (bug 64970) Fix support for blobs on DatabaseOracle::update
3874 * (bug 60719) In MediaWiki 1.22, the job queue execution on each page request was changed (Gerrit change 59797) so, instead of executing the job inside the same PHP process that's rendering the page, a new PHP cli command is spawned to execute runJobs.php in the background. It will only work if $wgPhpCli is set to an actual path or safe mode is off, otherwise, the old method will be used. https://www.mediawiki.org/wiki/Manual:Job_queue#Changes_introduced_in_MediaWiki_1.22 for more infomation. This change was in earlier releases of 1.22 but was not noted here until now.
3875
3876 == MediaWiki 1.22.9 ==
3877 This is a security and maintenance release of the MediaWiki 1.22 branch.
3878
3879 === Changes since 1.22.8 ===
3880 * (bug 68187) SECURITY: Prepend jsonp callback with comment.
3881 * (bug 66608) SECURITY: Fix for XSS issue in bug 66608: Generate the URL used for loading a new page in Javascript,instead of relying on the URL in the link that has been clicked.
3882 * (bug 65778) SECURITY: Copy prevent-clickjacking between OutputPage and ParserOutput.
3883 * (bug 59147) The img_metadata field was not being decoded from bytea into text.
3884
3885 == MediaWiki 1.22.8 ==
3886 This is a security and maintenance release of the MediaWiki 1.22 branch.
3887
3888 === Changes since 1.22.7 ===
3889 * (bug 65839) SECURITY: Prevent external resources in SVG files.
3890 * (bug 66428) MimeMagic: Don't seek before BOF. This has weird side effects like only extracting the tail of the file partially or not at all.
3891
3892 == MediaWiki 1.22.7 ==
3893 This is a security and maintenance release of the MediaWiki 1.22 branch.
3894
3895 === Changes since 1.22.6 ===
3896 * (bug 65501) SECURITY: Don't parse usernames as wikitext on Special:PasswordReset.
3897 * (bug 36356) Add space between two feed links.
3898 * (bug 63269) Email notifications were not correctly handling the MediaWiki:Helppage message being set to a full URL. This is a regression from the 1.22.5 point release, which made the default value for it a URL. If you customized MediaWiki:Enotif body (the text of email notifications), you'll need to edit it locally to include the URL via the new variable $HELPPAGE instead of the parser functions fullurl and canonicalurl; otherwise you don't have to do anything.
3899 Add missing uploadstash.us_props for PostgreSQL.
3900 * (bug 56047) Fixed stream wrapper in PhpHttpRequest.
3901
3902 == MediaWiki 1.22.6 ==
3903 This is a security release of the MediaWiki 1.22 branch.
3904
3905 === Changes since 1.22.5 ===
3906 * (bug 63251) SECURITY: Escape sortKey in pageInfo.
3907
3908 == MediaWiki 1.22.5 ==
3909 This is a security and maintenance release of the MediaWiki 1.22 branch.
3910
3911 === Changes since 1.22.4 ===
3912 * (bug 62497) SECURITY: Add CSRF token on Special:ChangePassword.
3913 * (bug 62467) Set a title for the context during import on the cli.
3914 * Fix custom local MediaWiki:Helppage values.
3915 * mediawiki.js: Fix documentation breakage.
3916 * (bug 58153) Make MySQLi work with non standard port.
3917 * (bug 53887) Reintroduced a link to help pages in the default sidebar, that any sysop can customize by editing MediaWiki:Sidebar locally. The link now points to a mediawiki.org page which is guaranteed to exist. Nothing needs to be done on your end, but remember to adjust MediaWiki:Sidebar for the needs of your wikis. Everyone can help with the shared documentation by translating: https://www.mediawiki.org/wiki/Special:Translate/agg-Help_pages .
3918 * (bug 53888) Corrected a regression in 1.22 which introduced red links on the login page. If you previously installed 1.22.x and have created a local page to make the red link blue, write its title as in MediaWiki:helplogin-url if you didn't already. Otherwise, you don't need to do anything, but you can translate the help page at https://www.mediawiki.org/wiki/Help:Logging_in .
3919
3920 == MediaWiki 1.22.4 ==
3921 This is a maintenance release of the MediaWiki 1.22 branch.
3922
3923 === Changes since 1.22.3 ===
3924 * Use the correct branch of the extensions' git repositories.
3925
3926 == MediaWiki 1.22.3 ==
3927 This is a security and bugfix release of the MediaWiki 1.22 branch.
3928
3929 === Changes since 1.22.2 ===
3930 * (bug 60771) SECURITY: Disallow uploading SVG files using non-whitelisted namespaces. Also disallow iframe elements. * User will get an error including the namespace name if they use a non- whitelisted namespace.
3931 * (bug 61346) SECURITY: Make token comparison use constant time. It seems like our token comparison would be vulnerable to timing attacks. This will take constant time.
3932 * (bug 61362) SECURITY: API: Don't find links in the middle of api.php links.
3933 * (bug 53710) Add sequence support for upsert in DatabaseOracle in the same way as in selectInsert
3934 * (bug 60231, bug 58719) Various fixes to job running code in Wiki.php: Make it async on Windows. Fixed possible "invalid filename" errors on Windows. Redirect output to dev/null to avoid hanging PHP.
3935 * (bug 60083) Correct sequence name for fresh Postgres installation. Spotted by gebhkla
3936 * (bug 60531) Avoid variable naming conflicts in DatabasePostgres::selectSQLText. Spotted by gebhkla
3937 * (bug 60094) Fix rebuildall.php fatal error with PostgreSQL.
3938 * (bug 43817) Add error handling if descriptionmsg isn't defined for extension.
3939 * (bug 60543) Special:PrefixIndex omits stripprefix=1 for "Next page" link.
3940
3941 == MediaWiki 1.22.2 ==
3942 This is a security and bugfix release of the MediaWiki 1.22 branch.
3943
3944 === Changes since 1.22.1 ===
3945 * (bug 60339) SECURITY: Sanitize shell arguments to DjVu files, and other media formats
3946 * (bug 58253) Check for very old PCRE versions in installer and updater
3947 * (bug 60054) Make WikiPage::$mPreparedEdit public
3948
3949 == MediaWiki 1.22.1 ==
3950 This is a security and maintenance release of the MediaWiki 1.22 branch.
3951
3952 === Changes since 1.22.0 ===
3953 * (bug 57550) SECURITY: Disallow stylesheets in SVG Uploads
3954 * (bug 58088) SECURITY: Don't normalize U+FF3C to \ in CSS Checks
3955 * (bug 58472) SECURITY: Disallow -o-link in styles
3956 * (bug 58553) SECURITY: Return error on invalid XML for SVG Uploads
3957 * (bug 58699) SECURITY: Fix RevDel log entry information leaks
3958 * (bug 58178) Restore compatibility with curl < 7.16.2.
3959 * (bug 56931) Updated the plural rules to CLDR 24. They are in new format which is detailed in UTS 35 Rev 33. The PHP parser and evaluator as well as the JavaScript evaluator were updated to support the new format. Plural rules for some languages have changed, most notably Russian. Affected software messages have been updated and marked for review at translatewiki.net. This change is backported from the development branch of MediaWiki 1.23.
3960 * (bug 58434) The broken installer for database backend Oracle was fixed.
3961 * (bug 58167) The web installer no longer throws an exception when PHP is compiled without support for MySQL yet with support for another DBMS.
3962 * (bug 58640) Fixed a compatibility issue with PCRE 8.34 that caused pages to appear blank or with missing text.
3963 * (bug 47055) Changed FOR UPDATE handling in Postgresql
3964 * (bug 57026) Avoid extra parsing in prepareContentForEdit()
3965
3966 == MediaWiki 1.22.0 ==
3967
3968 === Configuration changes in 1.22 ===
3969 * $wgRedirectScript was removed. It was unused.
3970 * Removed $wgLocalMessageCacheSerialized, it is now always true.
3971 * $wgVectorUseIconWatch is now enabled by default.
3972 * $wgCascadingRestrictionLevels was added.
3973 * ftps, ssh, sftp, xmpp, sip, sips, tel, sms, bitcoin, magnet, urn, and geo
3974 have been whitelisted inside of $wgUrlProtocols.
3975 * $wgDocType and $wgDTD have been removed and are no longer used for the DOCTYPE.
3976 * $wgHtml5 is no longer used by core. Setting it to false will no longer disable HTML5.
3977 It is still set to true for extension compatibility but doing so in extensions is deprecated.
3978 * $wgXhtmlDefaultNamespace is no longer used by core. Setting it will no longer change the
3979 xmlns used by MediaWiki. Reliance on this variable by extensions is deprecated.
3980 * $wgHandheldStyle was removed.
3981 * $wgHandheldForIPhone was removed.
3982 * $wgJsMimeType is no longer used by core. Most usage has been removed since
3983 HTML output is now exclusively HTML5.
3984 * $wgDBOracleDRCP added. True enables persistent connection with DRCP on Oracle.
3985 * $wgLogAutopatrol added to allow disabling logging of autopatrol edits in the logging table.
3986 Default for $wgLogAutopatrol is true.
3987 * The 'edit' right no longer allows for editing a user's own CSS and JS.
3988 * New rights 'editmyusercss', 'editmyuserjs', 'viewmywatchlist',
3989 'editmywatchlist', 'viewmyprivateinfo', 'editmyprivateinfo', and
3990 'editmyoptions' restrict actions that were formerly allowed by default. They
3991 have been added to the default for $wgGroupPermissions['*'].
3992 * The 'editprotected' right no longer allows bypassing of all page protection
3993 restrictions. Any group using it for this purpose will now need to have all
3994 the individual rights listed in $wgRestrictionTypes for the same effect.
3995 * The 'protect' and 'autoconfirmed' rights are no longer used for the default
3996 page protection levels. The rights 'editprotected' and 'editsemiprotected'
3997 are now used for this purpose instead.
3998 * (bug 40866) wgOldChangeTagsIndex removed.
3999 * $wgNoFollowDomainExceptions now only matches entire domains. For example,
4000 an entry for 'bar.com' will still match 'foo.bar.com' but not 'foobar.com'.
4001 * $wgCopyUploadTimeout and $wgCopyUploadAsyncTimeout added to change the timeout times for
4002 fetching the file during upload by url.
4003 * New key added to $wgGalleryOptions - $wgGalleryOptions['mode'] to set
4004 default gallery mode.
4005 * New hook 'GalleryGetModes' to allow extensions to make new gallery modes.
4006 * The checkbox for staying in HTTPS displayed on the login form when $wgSecureLogin is
4007 enabled has been removed. Instead, whether the user stays in HTTPS will be determined
4008 based on the user's preferences, and whether they came from HTTPS or not.
4009 * $wgRC2UDPAddress, $wgRC2UDPInterwikiPrefix, $wgRC2UDPOmitBots, $wgRC2UDPPort,
4010 and $wgRC2UDPPrefix configuration options have been deprecated in favor of a
4011 $wgRCFeeds configuration array. $wgRCFeeds makes both the format and
4012 destination of recent change notifications customizable, and allows for
4013 multiple destinations to be specified.
4014 * (bug 53862) portal-url, currentevents-url and helppage have been removed from the
4015 default Sidebar.
4016 * The 'vector-simplesearch' preference is now enabled by default. Previously
4017 it was only enabled if the Vector extension was installed.
4018 * The precise format of metric datagrams produced by the UDP profiler and stats counter
4019 may now be specified as $wgUDPProfilerFormatString and $wgStatsFormatString,
4020 respectively.
4021 * (bug 54597) $wgBlockOpenProxies, $wgProxyPorts, $wgProxyScriptPath, and
4022 $wgProxyMemcExpiry have been removed, along with the open proxy scanner
4023 script they were added for.
4024 * Default value of $wgMaxShellMemory has been tripled (it's now 300 MB).
4025
4026 === New features in 1.22 ===
4027 * You can now install extensions using Composer.
4028 See https://www.mediawiki.org/wiki/Composer
4029 * (bug 44525) mediawiki.jqueryMsg can now parse (whitelisted) HTML elements and attributes.
4030 * (bug 33454) Language::sprintfDate now has a timezone parameter, and supports
4031 the "eIOPTZ" formatting characters.
4032 * EditWarning: A warning is shown when an editor leaves the edit form without
4033 saving (enabled by default, users can opt-out via the 'useeditwarning'
4034 preference). This feature was moved from the Vector extension, and is now part
4035 of core for all skins. Take care when upgrading that you don't use an older
4036 version of the Vector extension as this feature may conflict.
4037 * New 'mediawiki.ui' CSS module providing mw-ui-* styles for buttons and a
4038 compact vertical form layout.
4039 * HTMLForm supports a new display format 'vform' which applies this compact vertical
4040 layout and button styling. Special:PasswordReset uses this format.
4041 * New versions of login (Special:UserLogin) and create account
4042 (Special:UserLogin/signup) forms using the "vform" compact vertical form layout.
4043 These forms use new messages that assume a "Help logging in" link, see
4044 https://www.mediawiki.org/wiki/Manual:Page_customizations;
4045 https://www.mediawiki.org/wiki/Account_creation_user_experience/Strings lists the
4046 message key changes.
4047 * (bug 23343) Implemented ability to apply IP blocks to the contents of X-Forwarded-For headers
4048 by adding a new configuration variable $wgApplyIpBlocksToXff (disabled by default).
4049 * The new hook 'APIGetPossibleErrors' to modify the list of possible errors was
4050 added.
4051 * (bug 25592) LogEventsList::showLogExtract() will now ignore various
4052 Pager-related WebRequest parameters by default, as this is overwhelmingly
4053 likely to be what was intended by users of the method. If any caller wishes
4054 to use these parameters, the new param 'useRequestParams' may be set to true.
4055 * mw.util.addPortletLink: Tooltip is no longer required to be plain (without
4056 an accesskey in it already). As such it now rountrips. Creating a link with a
4057 message as tooltip, grabbing the title attribute and using it to create
4058 another portlet will work as expected.
4059 * (bug 6747) {{ROOTPAGENAME}} introduced, contains the name of the topmost
4060 page without namespace.
4061 * BREAKING CHANGE: (bug 41729) Display editsection links next to headings. Also
4062 change their class name from .editsection to .mw-editsection and place them at
4063 the end of the heading element instead of the beginning. Client-side code and
4064 screen-scrapers will have to be adjusted to handle both cases (old HTML will
4065 still be visible on cached page renders until they are purged); extensions
4066 using the DoEditSectionLink or EditSectionLink hooks might need adjustments as
4067 well.
4068 * (bug 45535) introduced the new 'LanguageLinks' hook for manipulating the
4069 language links associated with a page before display.
4070 * Chosen (http://harvesthq.github.io/chosen/) was added as module 'jquery.chosen'
4071 * HTMLForm will turn multiselect checkboxes into a Chosen interface when setting cssclass 'mw-chosen'
4072 * rebuildLocalisationCache learned --lang option. Let you rebuild l10n caches
4073 of the specified languages instead of all of them.
4074 * New GetNewMessagesAlert hook allowing extensions to disable or modify the new
4075 messages alert
4076 * New wgUserNewMsgRevisionId JS global for logged in users. This will be null
4077 if the user has no new talk page messages. Otherwise it will be set to the
4078 revision ID of the oldest new talk page message. This will allow gadgets and
4079 extensions to create their own new message alerts on the client side.
4080 * mediawiki.log: Added log.warn wrapper (uses console.warn and console.trace).
4081 * mediawiki.log: Implemented log.deprecate. This method defines a property and
4082 uses ES5 getter/setter to emit a warning when they are used.
4083 * $wgCascadingRestrictionLevels was added, allowing one to specify restriction levels
4084 which can be cascading (previously 'sysop' was hard-coded as the only one).
4085 * XHTML5 support has been improved. If you set $wgMimeType = 'application/xhtml+xml'
4086 MediaWiki will try outputting markup according to XHTML5 rules.
4087 * Altered hook 'ProtectionForm::save', adding the reason page protection is
4088 changed as third parameter.
4089 * New hook 'TitleSquidURLs' for manipulating the list of URLs to be purged from
4090 HTTP caches when a page is changed.
4091 * Changed the patrolling system to always show the link for patrolling in case the
4092 current revision is patrollable. This also removed the usage of the rcid URI parameters.
4093 * Oracle DB backend now supports Database Resident Connection Pooling (DRCP).
4094 Can be enabled by setting $wgDBOracleDRCP=true.
4095 Requires Oracle DB 11gR1 or above, enabled DRCP inside the DB itself and a
4096 propper connect string.
4097 More about DRCP can be found at:
4098 http://www.oracle-base.com/articles/11g/database-resident-connection-pool-11gr1.php
4099 * Add a new parameter $patrolFooterShown to hook ArticleViewFooter so the hook
4100 handlers can take further action based on the status of the patrol footer
4101 * A new hook TitleQuickPermissions was added to allow overriding of quick
4102 permissions in the Title class.
4103 * LinkCache singleton can now be altered or cleared, letting one to specify
4104 another instance that does not rely on a database backend.
4105 * MediaWiki's PHPUnit tests can now use PHPUnit installed using composer --dev.
4106 * (bug 43689) The lists of templates used on the page and hidden categories it
4107 is a member of, shown below the edit form, are now collapsible (and collapsed
4108 by default).
4109 * Parser profiling data, formerly only available in the "NewPP limit report"
4110 HTML comment, is now also displayed at the bottom of page previews.
4111 * Added ParserLimitReportPrepare and ParserLimitReportFormat hooks, deprecated
4112 ParserLimitReport hook.
4113 * New user rights have been added to increase granularity in rights management
4114 for extensions such as OAuth:
4115 ** editmyusercss controls whether a user may edit their own CSS subpages.
4116 ** editmyuserjs controls whether a user may edit their own JS subpages.
4117 ** viewmywatchlist controls whether a user may view their watchlist.
4118 ** editmywatchlist controls whether a user may edit their watchlist.
4119 ** viewmyprivateinfo controls whether a user may access their private
4120 information (e.g. registered email address, real name).
4121 ** editmyprivateinfo controls whether a user may change their private
4122 information.
4123 ** editmyoptions controls whether a user may change their preferences.
4124 * Add new hook AbortTalkPageEmailNotification, this will be used to determine
4125 whether to send the regular talk page email notification
4126 * Action classes registered in $wgActions are now also supported in the form of
4127 a callback (which returns an instance of Action) instead of providing the name
4128 of a subclass of Action.
4129 * (bug 46513) Vector: Add the collapsibleTabs script from the Vector extension.
4130 * Added $wgRecentChangesFlags for defining new flags for RecentChanges and
4131 watchlists.
4132 * (bug 40518) mw.toolbar: Implemented mw.toolbar.addButtons for adding multiple
4133 button objects in one call.
4134 * Rights used for the default protection levels ('sysop' and 'autoconfirmed')
4135 are now used just for that purpose, instead of overloading other rights. This
4136 allows easy granting of the ability to edit sysop-protected pages without
4137 also granting the ability to protect and unprotect.
4138 * (bug 48256) Make brackets in section edit links accessible to CSS.
4139 They are now wrapped in <span class="mw-editsection-bracket" />.
4140 * (bug 8480) Allow handler specific parameters in galleries (like page number)
4141 * jquery.client: Add detection for Opera 15 and Internet Explorer 11.
4142 * Change tags (used by the AbuseFilter extension) are now shown on diff pages.
4143 * Change tag lists (shown on recent changes, watchlist, user contributions,
4144 history pages, diff pages) now include a link to Special:Tags to distinguish
4145 them from edit summaries.
4146 * Added a new method and hook, User::isEveryoneAllowed() and
4147 UserIsEveryoneAllowed, for use in situations where a "does everyone have this
4148 right?" check is used to avoid more expensive checks.
4149 * (bug 14431) Display "(No difference)" instead of an empty diff (when comparing
4150 revisions in the history or when previewing changes while editing).
4151 * New hook 'IsUploadAllowedFromUrl' is added which can be used to intercept uploads by
4152 URL, useful for blacklisting specific URLs
4153 * (bug 21912) Watchlist token implementation has been refactored and
4154 Special:ResetTokens was added to allow users to reset their tokens
4155 instead of presenting them in Preferences.
4156 * Special:PrefixIndex now lets you strip the searched prefix from the displayed
4157 titles. Given a list of articles named Bug1, Bug2, you can now transclude the
4158 list of bug numbers using: {{Special:PrefixIndex/Bug|stripprefix=1}}.
4159 The special page form received a new checkbox matching that option.
4160 * (bug 23580) Implement javascript callback interface "mw.hook".
4161 * (bug 30713) New mw.hook "wikipage.content".
4162 * (bug 40430) jquery.placeholder gets a new parameter to set the attribute value
4163 to be used.
4164 * $wgHTCPMulticastRouting renamed $wgHTCPRouting since it accepts unicast.
4165 * $wgHTCPRouting rules can now be passed an array of hosts/ports to send purge
4166 too. Can be used whenever several multicast group could be interested by a
4167 specific purge.
4168 * (bug 25931) Add Special:RandomInCategory.
4169 * mediawiki.util: addPortletLink now supports passing a jQuery object as nextnode.
4170 * <wbr> can now be used inside WikiText.
4171 * WebResponse::setcookie is much more featureful. Callers using PHP's
4172 setcookie() or setrawcookie() should begin using this instead.
4173 * New hook WebResponseSetCookie, called from WebResponse::setcookie().
4174 * New hook ResetSessionID, called when the session id is reset.
4175 * Add a mode parameter to <gallery> tag with potential options of "traditional",
4176 "nolines", "packed", "packed-overlay", or "packed-hover".
4177 * (bug 47399) A success message is now displayed after changing the password.
4178 * Make thumb.php give HTTP redirects for file redirects
4179 * (bug 30607) Special:ListFiles can now show old versions of files. Additionally
4180 Special:AllMyUploads was introduced so the user can get a list of all things
4181 they have ever uploaded, even if it was subsequently overridden.
4182 * Introduced Special:MyFiles and Special:AllMyFiles as an alias for Special:MyUploads
4183 and Special:AllMyUploads respectively.
4184 * IPv6 addresses in X-Forwarded-For headers are now normalised before checking
4185 against allowed proxy lists.
4186 * Add deferrable update support for callback/closure.
4187 * Add TitleMove hook before page renames.
4188 * Revision deletion backend code is moved out of SpecialRevisiondelete
4189 * Added {{REVISIONSIZE}} variable to get the current size of a revision.
4190 * Add support for the LESS stylesheet language to ResourceLoader. LESS is a
4191 stylesheet language that compiles into CSS. ResourceLoader file modules may
4192 include LESS style files; ResourceLoader will compile these files into CSS
4193 before sending them to the client.
4194 ** The $wgResourceLoaderLESSVars configuration variable is an associative array
4195 mapping variable names to string CSS values. These variables are considered
4196 declared for all LESS files. Additional variables may be registered by
4197 adding keys to the array.
4198 ** $wgResourceLoaderLESSFunctions is an associative array of custom LESS
4199 function names to PHP callables. See <http://leafo.net/lessphp/docs/#custom_functions>
4200 for more details regarding custom functions.
4201 ** $wgResourceLoaderLESSImportPaths is an array of file system paths. Files
4202 referenced in LESS '@import' statements are looked up here first.
4203 * ResourceLoader supports hashes as module cache invalidation trigger (instead
4204 of or in addition to timestamps).
4205 * Added $wgExtensionEntryPointListFiles for use in mergeMessageFileList.php.
4206 * Added a hook, APIQuerySiteInfoStatisticsInfo, to allow extensions to modify
4207 the output of the API query meta=siteinfo&siprop=statistics
4208 * Primary keys have been added to both the archive table and the externallinks
4209 tables.
4210 * Added $wgEnableParserLimitReporting to control whether the NewPP limit report is
4211 output in a HTML comment.
4212 * The 'UnwatchArticle' and 'WatchArticle' hooks now support a Status object
4213 instead of just a boolean return value to abort the hook.
4214 * Added a hook, SpecialWatchlistGetNonRevisionTypes, to allow extensions
4215 with custom recentchanges entries to hook into the Watchlist without
4216 clobbering each other.
4217 * A hidden, empty input field was added to the edit form, and any edit that fills
4218 it in will be rejected. This prevents against the simplest form of spambots.
4219 Previously in the "SimpleAntiSpam" extension by Ryan Schmidt.
4220 * populateRevisionLength.php maintenance script updated to also populate
4221 archive.ar_len field.
4222 * (bug 43571) DatabaseMySQLBase learned to list views, optionally filtered by a
4223 prefix. Also fixed PHPUnit test suite when using a MySQL backend containing
4224 views.
4225
4226 === Bug fixes in 1.22 ===
4227 * (bug 47271) $wgContentHandlerUseDB should be set to false during the upgrade
4228 * Disable Special:PasswordReset when $wgEnableEmail is false. Previously one
4229 could still navigate to the page by entering the URL directly.
4230 * (bug 47138) Fixed a fatal error when a blocked user tries to automatically
4231 create an account on login due external authentication in some circumstances.
4232 * (bug 23393) HTML <hN> headings containing line breaks are now handled
4233 correctly.
4234 * (bug 45803) Whitespace within == Headline == syntax and within <hN> headings
4235 is now non-significant and not preserved in the HTML output.
4236 * (bug 47218) Special:BlockList now handles correctly user names with spaces
4237 when passed as subpage.
4238 * Pager's properly validate which fields are allowed to be sorted on.
4239 * mw.util.tooltipAccessKeyRegexp: The regex now matches "option-" as well.
4240 Support for Mac "option" was added in 1.16, but the regex was never updated.
4241 * (bug 46768) Usernames of blocking users now display correctly, even if numeric.
4242 * (bug 39590) Self-transclusions now show the most up to date result always
4243 after save instead of being a revision behind.
4244 * A bias in wfRandomString() toward digits 1-7 has been corrected. Generated
4245 strings will now start with digits 0 and 8-f as often as they should.
4246 * (bug 45371) Removed Parser_LinkHooks and CoreLinkFunctions classes.
4247 * (bug 41545) Allow <kbd>, <samp>, and <var> to be nested like allowed in html.
4248 * PLURAL magic word no longer causes a PHP notice when no matching form exists.
4249 * (bug 36641) Patrol page links no longer show on non-existent revisions.
4250 * (bug 35810) Pages not linked from Special:RecentChanges or Special:NewPages
4251 are patrollable now.
4252 * (bug 30213) JavaScript for search suggestions is now disabled when the API
4253 is disabled, and AJAX patrolling and watching are now disabled when use of
4254 the write API is not allowed.
4255 * (bug 48294) API: Fix chunk upload async mode.
4256 * (bug 46749) Broken files tracking category removed from pages if an image
4257 with that name is uploaded.
4258 * (bug 14176) System messages that are empty were previously incorrectly treated
4259 as non-existent, causing a fallback to the default. This stopped users from
4260 overriding system messages to make them blank.
4261 * (bug 48319) action=parse no longer returns an error if passed none of 'oldid',
4262 'pageid', 'page', 'title', and 'text' (e.g. if only passed 'summary'). A
4263 warning will instead be issued if 'title' is non-default, unless no props are
4264 requested.
4265 * Special:Recentchangeslinked will now include upload log entries
4266 * (bug 41281) Fixed ugly output if file size could not be extracted for multi-page media.
4267 * (bug 50315) list=logevents API module will now output log entries by anonymous users.
4268 * (bug 38911) Handle headers with rowspan in jquery.tablesorter
4269 * (bug 658) Converted the table of contents on wiki pages from <table> to <div>
4270 and adjusted skin CSS accordingly. The CSS was carefully crafted to be
4271 backwards-compatible in all reasonable cases (uses of the __TOC__ magic word,
4272 the #toc CSS id and the .toc CSS class). However, particularly bad abuse of
4273 the id or the class can possibly break.
4274 * CSSJanus now supports rgb, hsl, rgba, and hsla color syntaxes.
4275 * Special:Listfiles can no longer be sorted by image name when filtering
4276 by user in miser mode.
4277 * (bug 49074) CSSJanus: Handle values of border-radius correctly.
4278 * Handle relative inclusions ({{../name}}) in main namespace with subpages
4279 enabled correctly (previously MediaWiki tried to include Template:Parent/name
4280 instead of just Parent/name).
4281 * Added $wgAPIUselessQueryPages to allow extensions to flag their query pages
4282 for non-inclusion in ApiQueryQueryPages.
4283 * (bug 50870) mediawiki.notification: Notification area should remain visible
4284 when scrolled down.
4285 * (bug 13438) Special:MIMESearch no longer an expensive special page.
4286 * (bug 48342) Fixed a fatal error when $wgValidateAllHtml is set to true and
4287 the function apache_request_headers() function is not available.
4288 * (bug 33399) LivePreview: Re-run wikipage content handlers
4289 (jquery.makeCollapsible, jquery.tablesorter) after preview content is loaded.
4290 * (bug 51891) Fixed PHP notice on Special:PagesWithProp when no properties
4291 are defined.
4292 * (bug 52006) Corrected documentation of $wgTranscludeCacheExpiry.
4293 * (bug 52077) The APIEditBeforeSave hook is giving the content of the whole
4294 revision as second argument now, rather than just the current section.
4295 * (bug 49694) $wgSpamRegex is now also applied on the new section headline text
4296 adding a new topic on a page
4297 * (bug 41756) Improve treatment of multiple comments on a blank line.
4298 * (bug 51064) Purge upstream caches when deleting file assets.
4299 * (bug 39012) File types with a mime that we do not know the extension for
4300 can no longer be uploaded as an extension that we do know the mime type
4301 for.
4302 * (bug 51742) Add data-sort-value for better sorting of hitcounts Special:Tags
4303 * (bug 26811) On DB error pages, server hostnames are now hidden when both
4304 $wgShowHostnames and $wgShowSQLErrors are false.
4305 * (bug 6200) line breaks in <blockquote> are handled like they are in <div>
4306 * (bug 14931) Default character set now set to 'utf8' when a new MySQL
4307 database is created.
4308 * (bug 47191) Fixed "Column 'si_title' cannot be part of FULLTEXT index"
4309 MySQL error when installing using the binary character set option.
4310 * (bug 45288) Support mysqli PHP extension
4311 * (bug 55818) BREAKING CHANGE: Removed undocumented 'Debug' hook in wfDebug.
4312 This resolves an infinite loop when using $wgDebugFunctionEntry = true.
4313 * (bug 56707) Correct tooltip of "Next n results" on query special pages.
4314 * (bug 56770) mw.util.addPortletLink: Check length before access array index.
4315
4316 === API changes in 1.22 ===
4317 * (bug 25553) The JSON output formatter now leaves forward slashes unescaped
4318 to improve human readability of URLs and similar strings. Also, a "utf8"
4319 option is now provided to use UTF-8 encoding instead of hex escape codes
4320 for most non-ASCII characters.
4321 * (bug 46626) xmldoublequote parameter was removed. Because of a bug, the
4322 parameter has had no effect since MediaWiki 1.16, and so its removal is
4323 unlikely to impact existing clients.
4324 * (bug 47216) action=query&meta=siteinfo&siprop=skins will now indicate which
4325 skin is the default and which are unusable (e.g. listed in $wgSkipSkins).
4326 * (bug 25325) Added support for wlshow filtering (bots/anon/minor/patrolled)
4327 to action=feedwatchlist.
4328 * WDDX formatted output will actually be formatted (and normal output will no
4329 longer be), and will no longer choke on booleans.
4330 * action=opensearch no longer silently ignores the format parameter.
4331 * action=opensearch now supports format=jsonfm.
4332 * list=usercontribs&ucprop=ids will now include the parent revision id.
4333 * BREAKING CHANGE: action=parse no longer returns all langlinks for the page
4334 with prop=langlinks by default. The new effectivelanglinks parameter will
4335 request that the LanguageLinks hook be called to determine the effective
4336 language links.
4337 * BREAKING CHANGE: list=allpages, list=langbacklinks, and prop=langlinks do not
4338 apply the new LanguageLinks hook, and thus only consider language links
4339 stored in the database.
4340 * (bug 47219) Allow specifying change type of Wikipedia feed items
4341 * prop=imageinfo now allows setting iiurlheight without setting iiurlwidth
4342 * prop=info now adds the content model and page language of the title.
4343 * New upload log entries will now contain information on the relevant
4344 image (sha1 and timestamp).
4345 * (bug 49239) action=parse now can parse in preview and section preview modes.
4346 * (bug 49259) action=patrol now accepts revision ids.
4347 * (bug 48129) list=blocks&bkip= now correctly handles IPv6 CIDR ranges and
4348 honors $wgBlockCIDRLimit. Note any clients passing invalid values to bkip
4349 will now receive an error, rather than the previous behavior listing all
4350 user blocks.
4351 * (bug 48201) action=parse&text=foo now assumes wikitext if no title is given,
4352 rather than using the content model of the page "API".
4353 * action=watch no longer silently ignores hook abort.
4354 * (bug 50785) action=purge with forcelinkupdate=1 no longer queues refreshLinks
4355 jobs in the job queue for link table updates of pages that use the given page
4356 as a template. Instead, forcerecursivelinkupdate=1 is introduced and should
4357 be used if that behaviour is desirable.
4358 * The 'debugLog' property (enabled by $wgDebugToolbar) no longer sets the log
4359 entry values through ApiResult::content but directly. This changes the JSON
4360 output from an array of objects with content in '*' to an array of strings
4361 with the content.
4362 * (bug 51342) prop=imageinfo iicontinue now contains the dbkey, not the text
4363 version of the title.
4364 * (bug 52538) action=edit will now use empty text instead of the contents
4365 of section 0 when passed prependtext or appendtext with section=new.
4366 * Support for the 'gettoken' parameter to action=block and action=unblock,
4367 deprecated since 1.20, has been removed.
4368 * (bug 49090) Token-getting functions will fail when using jsonp callbacks.
4369 * (bug 52699) action=upload returns normalized file name on warning
4370 "exists-normalized" instead of filename to be uploaded to.
4371 * (bug 53884) action=edit will now return an error when the specified section
4372 does not exist in the page.
4373 * Added meta=filerepoinfo API module for getting information about foreign
4374 file repositories, and related ForeignAPIRepo methods getInfo and getApiUrl.
4375 * The new query module list=allfileusages to enumerate file usages was added.
4376
4377 === Languages updated in 1.22 ===
4378
4379 MediaWiki supports over 350 languages. Many localisations are updated
4380 regularly. Below only new and removed languages are listed, as well as
4381 changes to languages because of Bugzilla reports.
4382
4383 * Batak Toba (bbc-latn) added.
4384 * (bug 46751) Made Buryat (Russia) (буряад) (bxr) fallback to Russian.
4385
4386 === Other changes in 1.22 ===
4387 * BREAKING CHANGE: Implementation of MediaWiki's JS and JSON value encoding
4388 has changed:
4389 ** MediaWiki no longer supports PHP installations in which the native JSON
4390 extension is missing or disabled.
4391 ** XmlJsCode objects can no longer be nested inside objects or arrays.
4392 (For Xml::encodeJsCall(), this individually applies to each argument.)
4393 ** The sets of characters escaped by default, along with the precise escape
4394 sequences used, have changed (except for the Xml::escapeJsString()
4395 function, which is now deprecated).
4396 * BREAKING CHANGE: The Services_JSON class has been removed. If necessary,
4397 be sure to upgrade affected extensions at the same time (e.g. Collection).
4398 * redirect.php was removed. It was unused.
4399 * ClickTracking integration was dropped from the mediaWiki.user.bucket
4400 JavaScript function. The 'tracked' option is now ignored.
4401 * BREAKING CHANGE: Legacy skins Simple, MySkin, Chick, Standard and Nostalgia
4402 were all removed. (Nostalgia was moved to an extension.) The SkinLegacy and
4403 LegacyTemplate classes that supported them were removed as well and are now a
4404 part of the Nostalgia extension.
4405 * Event namespace used by jquery.makeCollapsible has been changed from
4406 'mw-collapse' to 'mw-collapsible' for consistency with the module name.
4407 * BREAKING CHANGE: The "ExternalAuth" authentication subsystem was removed, along
4408 with its associated globals of $wgExternalAuthType, $wgExternalAuthConf,
4409 $wgAutocreatePolicy and $wgAllowPrefChange. Affected users are encouraged to
4410 use AuthPlugin for external authentication/authorization needs.
4411 * The Quickbar feature of the legacy skin model and the last remnants of it
4412 throughout the code base have been removed.
4413 * Externaledit/externaldiff preference was removed. Very few users used this
4414 feature, and improper configuration can actually prevent a user from editing
4415 * Calling Linker methods using a skin will now output deprecation warnings.
4416 * (bug 46680) "Return to" links are no longer tagged with rel="next".
4417 * BREAKING CHANGE: mw.util.tooltipAccessKeyRegexp: The match group for the
4418 accesskey character is now $6 instead of $5.
4419 * HipHop compiler (hphpc) support was removed. HipHop VM support (hhvm) was
4420 added.
4421 * A new Special:Redirect page was added, providing lookup by revision ID,
4422 user ID, or file name. The old Special:Filepath page was reimplemented
4423 to redirect through Special:Redirect.
4424 * Monobook: Removed the old conditional stylesheets for Opera 6, 7 and 9.
4425 * Support for XHTML 1.0 has been removed. MediaWiki now only outputs (X)HTML5.
4426 * wikibits: User-agent related globals have been deprecated. The following
4427 properties now default to false and emit mw.log.warn: is_gecko, is_chrome_mac,
4428 is_chrome, webkit_version, is_safari_win, is_safari, webkit_match, is_ff2,
4429 ff2_bugs, is_ff2_win, is_ff2_x11, opera95_bugs, opera7_bugs, opera6_bugs,
4430 is_opera_95, is_opera_preseven, is_opera, and ie6_bugs.
4431 * (bug 48276) MediaWiki will now flash a confirmation message upon successfully
4432 editing a page.
4433 * (bug 40785) mediawiki.legacy.ajax has been marked as deprecated. The following
4434 properties now emit mw.log.warn when accessed: sajax_debug, sajax_init_object,
4435 sajax_do_call and wfSupportsAjax.
4436 * BREAKING CHANGE: meta keywords are no longer supported. A <meta name="keywords"
4437 will no longer be output and OutputPage::addKeyword no longer exists.
4438 * Methods Title::userCanEditCssSubpage and Title::userCanEditJsSubpage,
4439 deprecated since 1.19, have been removed.
4440 * (bug 50134) Hook functions are no longer required to return a value. When a
4441 hook function does not return a value (or when it returns an explicit null),
4442 processing continues. To abort the hook, a hook function must return an
4443 explicit, boolean false or a string error message. Other falsey values are
4444 tantamount to a 'return true' in earlier versions of MediaWiki.
4445 * BREAKING CHANGE: The EditSectionLink hook was removed after being
4446 deprecated since MediaWiki 1.14. Use DoEditSectionLink instead.
4447 * (bug 48256) The 'editsection-brackets' optional message was removed.
4448 Section edit links' brackets can now be customized using CSS by
4449 styling span.mw-editsection-bracket.
4450 * The usePatrol function in ChangesList has been marked as deprecated.
4451 * (bug 50785) A "null edit", that is, a save action in which no changes to the
4452 page text are made and no revision recorded, will no longer send refreshLinks
4453 jobs to the job table to update pages which use the edited page as a template.
4454 * The LivePreviewPrepare and LivePreviewDone events triggered on "jQuery( mw )"
4455 have been deprecated in favour of using mw.hook.
4456 * The 'showjumplinks' user preference has been removed, jump links are now
4457 always included.
4458 * Methods RecentChange::notifyRC2UDP, RecentChange::sendToUDP, and
4459 RecentChange::cleanupForIRC have been deprecated, as it is now the
4460 responsibility of classes implementing the RCFeedFormatter and RCFeedEngine
4461 interfaces to implement the formatting and delivery for recent change
4462 notifications.
4463 * SpecialPrefixindex methods namespacePrefixForm() and showPrefixChunk() have
4464 been made protected. They were accepting form variance arguments, this is now
4465 using properties in the SpecialPrefixindex class.
4466 * (bug 50310) BREAKING CHANGE: wikibits: Drop support for mwCustomEditButtons.
4467 It defaults to an empty array and emits mw.log.warn when accessed.
4468 * BREAKING CHANGE: Special:Disambiguations has been removed from MediaWiki core.
4469 Functions related to disambiguation pages are now handled by the Disambiguator
4470 extension (https://www.mediawiki.org/wiki/Extension:Disambiguator) (bug
4471 35981).
4472 * BREAKING CHANGE: The 'mediawiki.legacy.wikiprintable' module has been removed.
4473 The skins/common/wikiprintable.css file no longer exists. Return value of
4474 Skin#commonPrintStylesheet is ignored. Please use the 'mediawiki.legacy.commonPrint'
4475 module instead or base your skin on SkinTemplate.
4476 * (bug 49629) The hook ExtractThumbParameters has been deprecated in favour
4477 of media handler overriding MediaHandler::parseParamString.
4478 * (bug 46512) The collapsibleNav feature from the Vector extension has been moved
4479 to the Vector skin in core.
4480 * SpecialRecentChanges::addRecentChangesJS() function has been renamed
4481 to addModules() and made protected.
4482 * Methods WatchAction::doWatch and WatchAction::doUnwatch now return a Status
4483 object instead of a boolean.
4484 * Information boxes (CSS classes errorbox, warningbox, successbox) have been
4485 made more subtle.
4486 * BREAKING CHANGE: The module 'mediawiki.legacy.IEFixes' has been removed as it was
4487 unused. The file skins/common/IEFixes.js remains but is only used by wikibits.
4488 The file never contained any re-usable components. To use it in a skin, load
4489 'mediawiki.legacy.wikibits' (which IEFixes depends on) and that will import
4490 IEFixes automatically if user agent conditions are met.
4491 * Code specific to the Math extension was marked as deprecated.
4492 * mediawiki.util: mw.util.wikiGetlink has been renamed to getUrl. (The old name
4493 still works, but is deprecated.)
4494
4495 = MediaWiki 1.21 =
4496
4497 == MediaWiki 1.21.11 ==
4498 This is a security and maintenance release of the MediaWiki 1.21 branch.
4499
4500 === Changes since 1.21.10 ===
4501 * (bug 65839) SECURITY: Prevent external resources in SVG files.
4502 * (bug 66428) MimeMagic: Don't seek before BOF. This has weird side effects like only extracting the tail of the file partially or not at all.
4503
4504 == MediaWiki 1.21.10 ==
4505 This is a security and maintenance release of the MediaWiki 1.21 branch.
4506
4507 === Changes since 1.21.9 ===
4508 * (bug 65501) SECURITY: Don't parse usernames as wikitext on Special:PasswordReset.
4509 * (bug 36356) Add space between two feed links.
4510
4511 == MediaWiki 1.21.9 ==
4512 This is a security and maintenance release of the MediaWiki 1.21 branch.
4513
4514 === Changes since 1.21.8 ===
4515 * (bug 63251) SECURITY: Escape sortKey in pageInfo.
4516 * (bug 58640) Fixed a compatibility issue with PCRE 8.34 that caused pages to appear blank or with missing text.
4517
4518 == MediaWiki 1.21.8 ==
4519 This is a security and maintenance release of the MediaWiki 1.21 branch.
4520
4521 === Changes since 1.21.7 ===
4522 * (bug 62497) SECURITY: Add CSRF token on Special:ChangePassword.
4523 * (bug 62467) Set a title for the context during import on the cli.
4524
4525 == MediaWiki 1.21.7 ==
4526 This is a maintenance release of the MediaWiki 1.21 branch.
4527
4528 === Changes since 1.21.6 ===
4529 * Use the correct branch of the extensions' git repositories.
4530
4531 == MediaWiki 1.21.6 ==
4532 This is a security release of the MediaWiki 1.21 branch.
4533
4534 === Changes since 1.21.5 ===
4535 * (bug 60771) SECURITY: Disallow uploading SVG files using non-whitelisted namespaces. Also disallow iframe elements. * User will get an error including the namespace name if they use a non- whitelisted namespace.
4536 * (bug 61346) SECURITY: Make token comparison use constant time. It seems like our token comparison would be vulnerable to timing attacks. This will take constant time.
4537 * (bug 61362) SECURITY: API: Don't find links in the middle of api.php links.
4538
4539 == MediaWiki 1.21.5 ==
4540 This is a security release of the MediaWiki 1.21 branch.
4541
4542 === Changes since 1.21.4 ===
4543 * (bug 60339) SECURITY: Sanitize shell arguments to DjVu files, and other media formats
4544
4545 == MediaWiki 1.21.4 ==
4546 This is a security release of the MediaWiki 1.21 branch.
4547
4548 === Changes since 1.21.3 ===
4549 * (bug 57550) SECURITY: Disallow stylesheets in SVG Uploads
4550 * (bug 58088) SECURITY: Don't normalize U+FF3C to \ in CSS Checks
4551 * (bug 58472) SECURITY: Disallow -o-link in styles
4552 * (bug 58553) SECURITY: Return error on invalid XML for SVG Uploads
4553 * (bug 58699) SECURITY: Fix RevDel log entry information leaks
4554
4555 == MediaWiki 1.21.3 ==
4556 This is a security and maintenance release of the MediaWiki 1.21 branch.
4557
4558 === Changes since 1.21.2 ===
4559 * (bug 53032) SECURITY: Don't cache when a call could autocreate
4560 * (bug 55332) SECURITY: Improve css javascript detection
4561 * (bug 49717) Fix behaviour $wgVerifyMimeType = false; in Upload
4562 * Fix comma errors in various js files
4563 * Translations
4564
4565 == MediaWiki 1.21.2 ==
4566 This is a security and maintenance release of the MediaWiki 1.21 branch.
4567
4568 === Changes since 1.21.1 ===
4569 * SECURITY: Fix extension detection with 2 .'s
4570 * SECURITY: Support for the 'gettoken' parameter to action=block and action=unblock, deprecated since 1.20, has been removed.
4571 * SECURITY: Sanitize ResourceLoader exception messages
4572 * Purge upstream caches when deleting file assets.
4573 * Unit test suite now runs the AutoLoader tests. Also fixed the autoloading entry for the PageORMTableForTesting class though it had no impact.
4574
4575 == MediaWiki 1.21.1 ==
4576 This is a maintenance release of the MediaWiki 1.21 branch.
4577
4578 === Changes since 1.21.0 ===
4579 * An incorrect version number was used for 1.21.0. 1.21.1 has the correct number.
4580 * A problem with the Oracle SQL table creation was fixed.
4581 * (PdfHandler extension) Fix warning if pdfinfo fails but pdftext succeeds.
4582
4583 == MediaWiki 1.21.0 ==
4584
4585 === Configuration changes in 1.21 ===
4586 * (bug 29374) $wgVectorUseSimpleSearch is now enabled by default.
4587 * Deprecated $wgAllowRealName is removed. Use $wgHiddenPrefs[] = 'realname'
4588 instead.
4589 * (bug 39957) Added $wgUnwatchedPageThreshold, specifying minimum count
4590 of page watchers required for the number to be accessible to users
4591 without the unwatchedpages permission.
4592 * $wgBug34832TransitionalRollback has been removed.
4593 * (bug 29472) $wgUseDynamicDates has been removed and its functionality
4594 disabled.
4595
4596 === New features in 1.21 ===
4597 * (bug 38110) Schema changes (adding or dropping tables, indices and
4598 fields) can be now be done separately from other changes that
4599 update.php makes. This is useful in environments that use database
4600 permissions to restrict schema changes but allow the DB user that
4601 MediaWiki normally runs as to perform other changes that update.php
4602 makes. Schema changes can be run separately. See the file UPGRADE
4603 for more information.
4604 * (bug 34876) jquery.makeCollapsible has been improved in performance.
4605 * Added ContentHandler facility to allow extensions to support other content
4606 than wikitext. See docs/contenthandler.txt for details.
4607 * New feature was developed for showing high-DPI thumbnails for high-DPI mobile
4608 and desktop displays (configurable with $wgResponsiveImages).
4609 * Added new backend to represent and store information about sites and site
4610 specific configuration.
4611 * jQuery upgraded from 1.8.2 to 1.8.3.
4612 * jQuery UI upgraded from 1.8.23 to 1.8.24.
4613 * Added separate fa_sha1 field to filearchive table. This allows sha1
4614 searches with the api in miser mode for deleted files.
4615 * Add initial and programmatic sorting for tablesorter.
4616 * Add the event "sortEnd.tablesorter", triggered after sorting has completed.
4617 * The Job system was refactored to allow for different backing stores for
4618 queues as well as cross-wiki access to queues, among other things. The schema
4619 for the DB queue was changed to support better concurrency and reduce
4620 deadlock errors.
4621 * Added ApiQueryORM class to facilitate creation of query API modules based on
4622 tables that have a corresponding ORMTable class.
4623 * (bug 40876) Icon for PSD (Adobe Photoshop) file types.
4624 * (bug 40641) Implemented Special:Version/Credits with a list of contributors.
4625 * (bug 7851) Implemented one-click AJAX patrolling.
4626 * The <data>, <time>, <meta>, and <link> elements are allowed within WikiText
4627 for use with Microdata.
4628 * The HTML5 <mark> tag has been whitelisted.
4629 * Added ParserCloned hook for when the Parser object is cloned.
4630 * Added AlternateEditPreview hook to allow extensions to replace the page
4631 preview from the edit page.
4632 * Added EditPage::showStandardInputs:options hook to allow extensions to add
4633 new fields to the "editOptions" area of the edit form.
4634 * Upload stash DB schema altered to improve upload performance.
4635 * The following global functions are now reporting deprecated warnings in
4636 debug mode: wfMsg, wfMsgNoTrans, wfMsgForContent, wfMsgForContentNoTrans,
4637 wfMsgReal, wfMsgGetKey, wfMsgHtml, wfMsgWikiHtml, wfMsgExt, wfEmptyMsg. Use
4638 the Message class, or the global method wfMessage.
4639 * Added $wgEnableCanonicalServerLink, off by default. If enabled, a
4640 <link rel=canonical> tag is added to every page indicating the correct server
4641 to use.
4642 * Debug message emitted by wfDebugLog() will now be prefixed with the group
4643 name when its logged to the default log file. That is the case whenever the
4644 group has no key in wgDebugLogGroups, that will help triage the default log.
4645 * (bug 24620) Add types to LogFormatter.
4646 * jQuery JSON upgraded from 2.3 to 2.4.0.
4647 * Added GetDoubleUnderscoreIDs hook, for modifying the list of magic words.
4648 * DatabaseUpdater class has two new methods to ease extensions schema changes:
4649 dropExtensionIndex and renameExtensionIndex.
4650 * New preference type - 'api'. Preferences of this type are not shown on
4651 Special:Preferences, but are still available via the action=options API.
4652 * (bug 39397) Hide rollback link if a user is the only contributor of the page.
4653 * $wgPageInfoTransclusionLimit limits the list size of transcluded articles
4654 on the info action. Default is 50.
4655 * Added action=createaccount to allow user account creation.
4656 * (bug 40124) action=options API also allows for setting of arbitrary
4657 preferences, provided that their names are prefixed with 'userjs-'. This
4658 officially reenables the feature that was undocumented and defective
4659 in MW 1.20 (saving preferences using Special:Preferences cleared any
4660 additional fields) and which has been disabled in 1.20.1 as a part of
4661 a security fix (bug 42202).
4662 * Added option to specify "others" as author in extension credits using
4663 "..." as author name.
4664 * Added the ability to limit the wall clock time used by shell processes,
4665 as well as the CPU time. Configurable with $wgMaxShellWallClockTime.
4666 * Allow memory of shell subprocesses to be limited using Linux cgroups
4667 instead of ulimit -v, which tends to cause deadlocks in recent versions
4668 of ImageMagick. Configurable with $wgShellCgroup.
4669 * Added $wgWhitelistReadRegexp for regex whitelisting.
4670 * (bug 5346) Categories that are redirects will be displayed italic in
4671 the category links section at the bottom of a page.
4672 * (bug 43915) New maintenance script deleteEqualMessages.php.
4673 * You can now create checkbox option matrices through the HTMLCheckMatrix
4674 subclass in HTMLForm.
4675 * WikiText now permits the use of WAI-ARIA's role="presentation" inside of
4676 html elements and tables. This allows presentational markup, especially
4677 tables. To be marked up as such.
4678 * maintenance/sql.php learned the --cluster option. Let you run the script
4679 on some external cluster instead of the primary cluster for a given wiki.
4680 * (bug 20281) test the parsing of inline URLs.
4681 * Added Special:PagesWithProp, which lists pages using a particular page property.
4682 * Implemented language-specific collations for category sorting for 67 languages
4683 based in latin, greek and cyrillic alphabets. This allows one to *finally* get
4684 articles to be correctly sorted on category pages. They are named
4685 'uca-<langcode>', where <langcode> is one of: af, ast, az, be, bg, br, bs, ca,
4686 co, cs, cy, da, de, dsb, el, en, eo, es, et, eu, fi, fo, fr, fur, fy, ga, gd,
4687 gl, hr, hsb, hu, is, it, kk, kl, ku, ky, la, lb, lt, lv, mk, mo, mt, nl, no,
4688 oc, pl, pt, rm, ro, ru, rup, sco, sk, sl, smn, sq, sr, sv, tk, tl, tr, tt, uk,
4689 uz, vi.
4690 * Added 'CategoryAfterPageAdded' and 'CategoryAfterPageRemoved' hooks.
4691 * Added 'HistoryRevisionTools' and 'DiffRevisionTools' hooks.
4692 * Added 'SpecialSearchResultsPrepend' and 'SpecialSearchResultsAppend' hooks.
4693 * (bug 33186) Add image rotation api "imagerotate"
4694 * (bug 34040) Add "User rights management" link on user page toolbox.
4695 * (bug 45526) Add QUnit assertion helper "QUnit.assert.htmlEqual" for asserting
4696 structual equality of HTML (ignoring insignificant differences like
4697 quotmarks, order and whitespace in the attribute list).
4698 * (bug 23393) HTML <hN> headings containing line breaks are now handled
4699 correctly.
4700 * (bug 45803) Whitespace within == Headline == syntax and within <hN> headings
4701 is now non-significant and not preserved in the HTML output.
4702
4703 === Bug fixes in 1.21 ===
4704 * (bug 40353) SpecialDoubleRedirect should support interwiki redirects.
4705 * (bug 40352) fixDoubleRedirects.php should support interwiki redirects.
4706 * (bug 9237) SpecialBrokenRedirect should not list interwiki redirects.
4707 * (bug 34960) Drop unused fields rc_moved_to_ns and rc_moved_to_title from
4708 recentchanges table.
4709 * (bug 32951) Do not register internal externals with absolute protocol,
4710 when server has relative protocol.
4711 * (bug 39005) When purging proxies listed in $wgSquidServers using HTTP PURGE
4712 method requests, we now send a Host header by default, for Varnish
4713 compatibility. This also works with Squid in reverse-proxy mode. If you wish
4714 to support Squid configured in forward-proxy mode, set
4715 $wgSquidPurgeUseHostHeader to false.
4716 * (bug 37020) sql.php with readline eats semicolon.
4717 * (bug 11748) Properly handle optionally-closed HTML tags when Tidy is
4718 disabled, and don't wrap HTML-syntax definition lists in paragraphs.
4719 * (bug 41409) Diffs while editing an old revision should again diff against the
4720 current revision.
4721 * (bug 41494) Honor $wgLogExceptionBacktrace when logging non-API exceptions
4722 caught during API execution.
4723 * (bug 37963) Fixed loading process for user options.
4724 * (bug 26995) Update filename field on Upload page after having sanitized it.
4725 * (bug 41793) Contribution links to users with 0 edits on Special:ListUsers
4726 didn't show up red.
4727 * (bug 41899) A PHP notice no longer occurs when using the "rvcontinue" API
4728 parameter.
4729 * (bug 42036) Account creation emails now contain canonical (not
4730 protocol-relative) URLs.
4731 * (bug 41990) Fix regression: API edit with redirect=true and lacking
4732 starttimestamp and basetimestamp should not cause an edit conflict.
4733 * (bug 41706) EditPage: Preloaded page should be converted if possible and
4734 needed.
4735 * (bug 41886) Rowspans are no longer exploded by tablesorter until the table is
4736 actually sorted.
4737 * (bug 2865) User interface HTML elements don't use lang attribute.
4738 (completed the fix by adding the lang attribute to firstHeading).
4739 * (bug 42173) Removed namespace prefixes on Special:UncategorizedCategories.
4740 * (bug 36053) Log in "returnto" feature forgets query parameters if no
4741 title parameter was specified.
4742 * (bug 42410) API action=edit now returns correct timestamp for the new edit.
4743 * (bug 14901) Email notification mistakes log action for new page creation.
4744 Enotif no longer sends "page has been created" notifications for some log
4745 actions. The following events now have a correct message: page creation,
4746 deletion, move, restore (undeletion), change (edit). Parameter
4747 $CHANGEDORCREATED is deprecated in 'enotif_body' and scheduled for removal in
4748 MediaWiki 1.23.
4749 * (bug 457) In the sidebar of Vector, CologneBlue, Monobook, and Monobook-based
4750 skins, the heading levels have been changed from (variously per skin)
4751 <h4>, <h5> or <h6> to only <h3>s, with a <h2> hidden heading above them.
4752 If you are styling or scripting the headings in a custom way, this change
4753 will require updates to your site's CSS or JS.
4754 * (bug 41342) jquery.suggestions should cancel any active (async) fetches
4755 before it triggers another fetch.
4756 * (bug 42184) $wgUploadSizeWarning missing second variable.
4757 * (bug 34581) removeUnusedAccounts.php maintenance script now ignores newuser
4758 log when determining whether an account is used.
4759 * (bug 43379) Gracefully fail if rev_len is unavailable for a revision on the
4760 History page.
4761 * (bug 42949) API no longer assumes all exceptions are MWException.
4762 * (bug 41733) Hide "New user message" (.usermessage) element from printable view.
4763 * (bug 39062) Special:Contributions will display changes that don't have
4764 a parent id instead of just an empty bullet item.
4765 * (bug 37209) "LinkCache doesn't currently know about this title" error fixed.
4766 * wfMerge() now works if $wgDiff3 contains spaces
4767 * (bug 43052) mediawiki.action.view.dblClickEdit.dblClickEdit should trigger
4768 ca-edit click instead opening URL directly.
4769 * (bug 43964) Invalid value of "link" parameter in <gallery> no longer produces
4770 a fatal error.
4771 * (bug 44775) The username field is not pre-filled when creating an account.
4772 * (bug 45069) wfParseUrl() no longer produces a PHP notice if passed a "mailto:"
4773 URL without address
4774 * (bug 45012) Creating an account by e-mail can no longer show a
4775 "password mismatch" error.
4776 * (bug 44599) On Special:Version, HEADs for submodule checkouts (e.g. for
4777 extensions) performed using Git 1.7.8+ should now appear.
4778 * (bug 42184) $wgUploadSizeWarning missing second variable
4779 * (bug 40326) Check if files exist with a different extension during uploading
4780 * (bug 34798) Updated CSS for Atom/RSS recent changes feeds to match on-wiki diffs.
4781 * (bug 42430) Calling numRows on MySQL no longer propagates unrelated errors.
4782 * (bug 44719) Removed mention of non-existing maintenance/migrateCurStubs.php
4783 script in includes/DefaultSettings.php
4784 * (bug 45143) jquery.badge: Treat non-Latin variants of zero as zero as well.
4785 * (bug 46151) mwdocgen.php should not ignore exit code of doxygen command.
4786 * (bug 41889) Fix $.tablesorter rowspan exploding for complex cases.
4787
4788 === API changes in 1.21 ===
4789 * prop=revisions can now report the contentmodel and contentformat.
4790 See docs/contenthandler.txt.
4791 * action=edit and action=parse now support contentmodel and contentformat
4792 parameters to control the interpretation of page content.
4793 See docs/contenthandler.txt for details.
4794 * (bug 35693) ApiQueryImageInfo now suppresses errors when unserializing metadata.
4795 * (bug 40111) Disable minor edit for page/section creation by API.
4796 * (bug 41042) Revert change to action=parse&page=... behavior when the page
4797 does not exist.
4798 * (bug 27202) Add timestamp sort to list=allimages.
4799 * (bug 43137) Don't return the sha1 of revisions through the API if the content is
4800 revision-deleted.
4801 * ApiQueryImageInfo now also returns imageinfo for redirects.
4802 * list=alltransclusions added to enumerate every instance of page embedding
4803 * list=alllinks & alltransclusions now allow both 'from' and 'continue' in
4804 the same query. When both are present, 'from' is simply ignored.
4805 * list=alllinks & alltransclusions now allow 'unique' in generators, to yield
4806 a list of all link/template target pages instead of source pages.
4807 * BREAKING CHANGE: list=logevents output format changed for details of some log
4808 types. Specifically, details that were formerly reported under a key like
4809 "4::foo" will now be reported under a key of simply "foo".
4810 * BREAKING CHANGE: '??_badcontinue' error code was changed to '??badcontinue'
4811 for all query modules.
4812 * ApiQueryBase adds 'badcontinue' error code if module has 'continue' parameter.
4813 * (bug 35885) Removed version parameter and all getVersion() methods.
4814 * action=options now takes a "resetkinds" option, which allows only resetting
4815 certain types of preferences when the "reset" option is set.
4816 * (bug 36751) ApiQueryImageInfo now returns imageinfo for the redirect target
4817 when queried with &redirects=.
4818 * (bug 31849) ApiQueryImageInfo no longer gets confused when asked for info on
4819 a redirect and its target.
4820 * (bug 43849) ApiQueryImageInfo no longer throws exceptions with ForeignDBRepo
4821 redirects.
4822 * On error, any warnings generated before that error will be shown in the result.
4823 * action=help supports generalized submodules (modules=query+value), querymodules obsolete
4824 * ApiQueryImageInfo continuation is more reliable. The only major change is
4825 that the imagerepository property will no longer be set on page objects not
4826 processed in the current query (i.e. non-images or those skipped due to
4827 iicontinue).
4828 * Add supports for all pageset capabilities - generators, redirects, converttitles to
4829 action=purge and action=setnotificationtimestamp.
4830 * (bug 43251) prop=pageprops&ppprop= now accepts multiple props to query.
4831 * ApiQueryImageInfo will now limit the number of calls to File::transform made
4832 in any one query. If there are too many, iicontinue will be returned.
4833 * action=query&meta=siteinfo&siprop=general will now return the regexes used for
4834 link trails and link prefixes. Added for Parsoid support.
4835 * Added an API query module list=pageswithprop, which lists pages using a
4836 particular page property.
4837 * Added an API query module list=pagepropnames, which lists all page prop names
4838 currently in use on the wiki.
4839 * (bug 44921) ApiMain::execute() will now return after the CORS check for an
4840 HTTP OPTIONS request.
4841 * (bug 44923) action=upload works correctly if the entire file is uploaded in
4842 the first chunk.
4843 * Added 'continue=' parameter to streamline client iteration over complex query results
4844 * (bug 44909) API parameters may now be marked as type "upload", which is now
4845 used for action=upload's 'file' and 'chunk' parameters. This type will raise
4846 an error during parameter validation if the parameter is given but not
4847 recognized as an uploaded file.
4848 * (bug 44244) prop=info may now return the number of people watching each page.
4849 * (bug 33304) list=allpages will no longer return duplicate entries when
4850 querying protection.
4851 * (bug 33304) list=allpages will now find really old indefinite protections.
4852 * (bug 45937) meta=allmessages will report a syntactically invalid lang as a
4853 proper error instead of as an uncaught exception.
4854 * (bug 25325) added support for wlshow filtering (bots/anon/minor/patrolled)
4855 to action=feedwatchlist
4856 * WDDX formatted output will actually be formatted (and normal output will no
4857 longer be), and will no longer choke on booleans.
4858
4859 === API internal changes in 1.21 ===
4860 * For debugging only, a new global $wgDebugAPI removes many API restrictions when true.
4861 Never use on the production servers, as this flag introduces security holes.
4862 Whenever enabled, a warning will also be added to all output.
4863 * ApiModuleManager now handles all submodules (actions,props,lists) and instantiation
4864 * Query stores prop/list/meta as submodules
4865 * ApiPageSet can now be used in any action to process titles/pageids/revids or any generator.
4866 * BREAKING CHANGE: ApiPageSet constructor now has two params instead of three, with only the
4867 first one keeping its meaning. ApiPageSet is now derived from ApiBase.
4868 * BREAKING CHANGE: ApiQuery::newGenerator() and executeGeneratorModule() were deleted.
4869 * ApiQueryGeneratorBase::setGeneratorMode() now requires a pageset param.
4870 * $wgAPIGeneratorModules is now obsolete and will be ignored.
4871 * Added flags ApiResult::OVERRIDE and ADD_ON_TOP to setElement() and addValue()
4872 * Internal API calls will now include <warnings> in case of unused parameters
4873
4874 === Languages updated in 1.21 ===
4875
4876 MediaWiki supports over 350 languages. Many localisations are updated
4877 regularly. Below only new and removed languages are listed, as well as
4878 changes to languages because of Bugzilla reports.
4879
4880 * South Azerbaijani (azb) added.
4881 * (bug 30040) Autonym for nds-nl is now 'Nedersaksies' (was 'Nedersaksisch').
4882 * (bug 45436) Autonym for pi (Pali) is now 'पालि' (was ''पाळि').
4883 * (bug 34977) Now formatted numbers in Spanish use space as separator
4884 for thousands, as mandated by the Real Academia Española.
4885 * (bug 35031) Kurdish formatted numbers now use period and comma
4886 as separators for thousands and decimals respectively.
4887
4888 === Other changes in 1.21 ===
4889 * BREAKING CHANGE: (bug 44385) Removed the jquery.collapsibleTabs module and
4890 moved it to the Vector extension. It was entirely Vector-extension-specific,
4891 deeply interconnected with the extension, and this functionality really
4892 belongs to the extension instead of the skin anyway. In the unlikely case you
4893 were using it, you have to either copy it to your extension, or install the
4894 Vector extension (and possibly disable its features using config settings if
4895 you don't want them).
4896 * Experimental IBM DB2 support was removed due to lack of interest and maintainership
4897 * BREAKING CHANGE: Filenames of maintenance scripts were standardized into
4898 lowerCamelCase format, and made more explicit:
4899 - clear_stats.php -> clearCacheStats.php
4900 - clear_interwiki_cache.php -> clearInterwikiCache.php
4901 - initStats.php -> initSiteStats.php
4902 - proxy_check.php -> proxyCheck.php
4903 - stats.php -> showCacheStats.php
4904 - showStats.php -> showSiteStats.php.
4905 Class names were renamed accordingly:
4906 - clear_stats -> ClearCacheStats
4907 - InitStats -> InitSiteStats
4908 - CacheStats -> ShowCacheStats