Localisation updates from https://translatewiki.net.
[lhc/web/wiklou.git] / RELEASE-NOTES-1.33
1 == MediaWiki 1.33 ==
2
3 THIS IS NOT A RELEASE YET
4
5 MediaWiki 1.33 is an alpha-quality branch and is not recommended for use in
6 production.
7
8 === Configuration changes in 1.33 ===
9
10 ==== New configuration ====
11 * $wgEnablePartialBlocks – This enables the Partial Blocks feature, which gives
12 accounts with block permissions the ability to block users, IPs, and IP ranges
13 from editing specific pages, while allowing them to edit the rest of the wiki.
14 * $wgMediaInTargetLanguage – whether multilingual images should be dispalyed in
15 the current parse language where available.
16
17 ==== Changed configuration ====
18 * Some external link searches will not work correctly until update.php (or
19 refreshExternallinksIndex.php) is run. These include searches for links using
20 IP addresses, internationalized domain names, and possibly mailto links.
21 * (T193868) $wgChangeTagsSchemaMigrationStage — This temporary setting, added in
22 MediaWiki 1.32, now defaults to MIGRATION_NEW instead of MIGRATION_WRITE_BOTH.
23 * …
24
25 ==== Removed configuration ====
26 * (T199334) $wgTagStatisticsNewTable — This temporary setting, added in
27 MediaWiki 1.32, has now been removed. When loading Special:Tags, MediaWiki
28 will now always use the `change_tag_def` instead of the `change_tag` table.
29 * MediaWiki now always tidies user output, and most related
30 configuration has been removed. Thus $wgUseTidy, $wgTidyBin,
31 $wgTidyConf, $wgTidyOpts, $wgTidyInternal, and $wgDebugTidy, all
32 deprecated since 1.26, have now all been removed. The $wgTidyConfig
33 setting remains only for Remex experimental features or debugging.
34 * …
35
36 === New features in 1.33 ===
37 * (T96041) __EXPECTUNUSEDCATEGORY__ on a category page causes the category
38 to be hidden on Special:UnusedCategories.
39 * Add PasswordPolicy to check the password isn't in the large blacklist.
40 * The AuthManagerLoginAuthenticateAudit hook has a new parameter for
41 additional information about the authentication event.
42 * TextContent::getText() was introduced as a replacement for
43 Content::getNativeData() for text-based content models.
44 * …
45
46 === External library changes in 1.33 ===
47
48 ==== New external libraries ====
49 * Added wikimedia/password-blacklist 0.1.4.
50 * Added guzzlehttp/guzzle 6.3.3.
51 * …
52
53 ==== Changed external libraries ====
54 * Updated wikimedia/xmp-reader from 0.6.0 to 0.6.1.
55 * Updated wikimedia/scoped-callback from 2.0.0 to 3.0.0.
56 * Updated wikimedia/ip-set from 1.2.0 to 2.0.0.
57 * The deprecated IPSet\IPSet alias was removed, Wikimedia\IPSet must be
58 used instead.
59 * Updated qunitjs from 2.6.2 to 2.9.1.
60 * …
61
62 ==== Removed external libraries ====
63 * …
64
65 === Bug fixes in 1.33 ===
66 * (T164211) Special:UserRights could sometimes fail with a
67 "conflict detected" error when there weren't any conflicts.
68 * …
69
70 === Action API changes in 1.33 ===
71 * (T198913) Added 'ApiOptions' hook.
72 * The JSON formatversion=2 is no longer experimental.
73 * Internal API errors (those with code beginning "internal_api_error") will
74 include the exception class name in a data field named "errorclass".
75 * Class names are not guaranteed to remain stable, and in particular database
76 exceptions will now include the "Wikimedia\Rdbms\" prefix in the class name.
77 * The code including an exception class name is deprecated. In the future,
78 all internal errors will use code "internal_api_error".
79 * (T212356) When using action=delete on pages with many revisions, the module
80 may return a boolean-true 'scheduled' and no 'logid'. This signifies that the
81 deletion will be processed via the job queue.
82 * action=setnotificationtimestamp will now update the watchlist asynchronously
83 if entirewatchlist is set, so updates may not be visible immediately
84
85 === Action API internal changes in 1.33 ===
86 * A number of deprecated methods for API documentation, intended for overriding
87 by extensions, are no longer called by MediaWiki, and will emit deprecation
88 notices if your extension attempts to use them:
89 * ApiBase::getDescription() (deprecated in 1.25)
90 * ApiBase::getParamDescription() (deprecated in 1.25)
91 * ApiBase::getExamples() (deprecated in 1.25)
92 * ApiBase::getDescriptionMessage() (deprecated in 1.30)
93 Additionally, the 'APIGetDescription' and 'APIGetParamDescription' hooks have
94 been removed, as their only use was to let extensions override values returned
95 by getDescription() and getParamDescription(), respectively.
96 * API error codes may only contain ASCII letters, numbers, underscore, and
97 hyphen. Methods such as ApiBase::dieWithError() and
98 ApiMessageTrait::setApiCode() will throw an InvalidArgumentException if
99 passed a bad code.
100 * …
101
102 === Languages updated in 1.33 ===
103 MediaWiki supports over 350 languages. Many localisations are updated regularly.
104 Below only new and removed languages are listed, as well as changes to languages
105 because of Phabricator reports.
106
107 * (T203908) Added language support for Eastern Pwo (kjp).
108 * (T213717) Fixed a translation error on Goan Konkani (gom-deva) translations
109 for NS_TEMPLATE.
110 * (T212221) Added $digitTransformTable for Santali (sat).
111
112 === Breaking changes in 1.33 ===
113 * The parameteter $lang in DifferenceEngine::setTextLanguage must be of type
114 Language. Other types are deprecated since 1.32.
115 * Skin::doEditSectionLink requires type Language for the parameter $lang.
116 The parameters $tooltip and $lang are mandatory. Omitting the parameters is
117 deprecated since 1.32.
118 * Language::truncate(), deprecated in 1.31, has been removed.
119 * UtfNormal, deprecated in 1.25, was removed. Use UtfNormal\Validator directly
120 instead.
121 * (T197179) In OOUI HTMLForm fields, the parameters 'notice', 'notice-messages',
122 and 'notice-message', which were deprecated in 1.32, were removed. Instead,
123 use 'help', 'help-message', and 'help-messages'.
124 * (T197179) HTMLFormField::getNotices(), deprecated in 1.32, was removed.
125 * The "Parsoid v1" compatibility mappings in ParsoidVirtualRESTService and
126 RestbaseVirtualRESTService, deprecated since 1.26, have been removed.
127 Use the RESTBase v1 or Parsoid v3 API instead.
128 * ParserOptions defaults 'tidy' to true now, since the untidy modes of the
129 parser are being deprecated and ParserOptions::getCanonicalOverrides()
130 has always been true at any rate.
131 * Support for disabling tidy and external tidy implementations has been removed.
132 This was deprecated in 1.32. The pure PHP Remex tidy implementation is now
133 used and no configuration is necessary.
134 * A number of deprecated methods for API documentation, intended for overriding
135 by extensions, are no longer called by MediaWiki, and will emit deprecation
136 notices if your extension attempts to use them:
137 * ApiBase::getDescription() (deprecated in 1.25)
138 * ApiBase::getParamDescription() (deprecated in 1.25)
139 * ApiBase::getExamples() (deprecated in 1.25)
140 * ApiBase::getDescriptionMessage() (deprecated in 1.30)
141 Additionally, the 'APIGetDescription' and 'APIGetParamDescription' hooks have
142 been removed, as their only use was to let extensions override values returned
143 by getDescription() and getParamDescription(), respectively.
144 * The authentication hooks 'AbortAutoAccount' 'AbortNewAccount', 'AbortLogin',
145 'LoginUserMigrated', 'UserCreateForm', and 'UserLoginForm', all deprecated by
146 the creation of AuthManager in 1.27, have been removed. This also means that
147 the FakeAuthTemplate and LoginForm classes are removed, that FakeAuthTemplate
148 is no longer passed into LoginSignupSpecialPage->getFieldDefinitions(), and
149 that LoginSignupSpecialPage->getBCFieldDefinitions() is removed.
150 * The 'jquery.localize' module, deprecated in 1.32, has been removed. Instead,
151 use 'jquery.i18n'.
152 * The hooks LanguageGetSpecialPageAliases and LanguageGetMagic, deprecated since
153 1.16, have now been removed. Instead, use $specialPageAliases or $magicWords
154 respectively in a $wgExtensionMessagesFiles file.
155 * The following methods of the Preferences class, deprecated in 1.31, have been
156 removed:
157 * getSaveBlacklist()
158 * loadPreferenceValues()
159 * getOptionFromUser()
160 * profilePreferences()
161 * skinPreferences()
162 * filesPreferences()
163 * datetimePreferences()
164 * renderingPreferences()
165 * editingPreferences()
166 * rcPreferences()
167 * watchlistPreferences()
168 * searchPreferences()
169 * miscPreferences()
170 * generateSkinOptions()
171 * getDateOptions()
172 * getImageSizes()
173 * getThumbSizes()
174 * validateSignature()
175 * cleanSignature()
176 * getTimezoneOptions()
177 * filterIntval()
178 * filterTimezoneInput()
179 * getTimeZoneList()
180 * mw.util.jsMessage(), deprecated in 1.20, was removed. Use mw.notify instead.
181 * (T61113) User::EDIT_TOKEN_SUFFIX was removed. It was deprecated since 1.27.
182
183 === Deprecations in 1.33 ===
184 * The configuration option $wgUseESI has been deprecated, and is expected
185 to be removed in a future release.
186 * The configuration option $wgSquidPurgeUseHostHeader has been deprecated,
187 and is expected to be removed in a future release.
188 * The configuration options $wgFixArabicUnicode and $wgFixMalayalamUnicode,
189 introduced in MW 1.17, have been deprecated. These fixes will always be
190 applied for Arabic and Malayalam in the future. Please enable these on
191 your local wiki (if you have them explicitly set to false) and run
192 maintenance/cleanupTitles.php to fix any existing page titles.
193 * The LegacyHookPreAuthenticationProvider class, deprecated since its creation
194 in 1.27 as part of the AuthManager re-write, now emits deprecation warnings.
195 This will help identify the issue if you added it to $wgAuthManagerConfig.
196 * wfSplitWikiId() is now deprecated. Cache key generation should have the wiki
197 domain ID as a key component and use makeGlobalKey().
198 * (T202094) Title::getUserCaseDBKey() is deprecated; instead, please use
199 Title::getDBKey(), which doesn't vary case.
200 * User::getPasswordValidity() is now deprecated. User::checkPasswordValidity()
201 returns the same information in a more useful format.
202 * For Linker::generateTOC() and Linker::tocList(), passing strings or booleans
203 as the $lang parameter was deprecated. The same applies to DummyLinker.
204 * The PasswordPolicy 'PasswordCannotBePopular' has been deprecated. To
205 follow best practices, it is reccommended to use 'PasswordNotInLargeBlacklist'
206 instead which blacklists 100,000 commonly used passwords.
207 * (T208862) Action::requiresUnblock() is now called from
208 Title::getUserPermissionsErrors() and Title::userCan(). Previously, the method
209 was only called in Action::checkCanExecute(). Actions should ensure that their
210 requiresUnblock() returns the proper result (the default is `true`).
211 * (T211608) The MediaWiki\Services namespace has been renamed to
212 Wikimedia\Services. The old name is still supported, but deprecated.
213 * (T155582) Content::getNativeData has been deprecated. Please use model-
214 specific getters, such as TextContent::getText().
215 * …
216
217 === Other changes in 1.33 ===
218 * (T208871) The hard-coded Google search form on the database error page was
219 removed.
220 * (T201747) Html::openElement() warns if given an element name wiht a space
221 in it.
222 * …
223
224 == Compatibility ==
225 MediaWiki 1.33 requires PHP 7.0.0 or later. Although HHVM 3.18.5 or later is
226 supported, it is generally advised to use PHP 7.0.0 or later for long term
227 support.
228
229 MySQL/MariaDB is the recommended DBMS. PostgreSQL or SQLite can also be used,
230 but support for them is somewhat less mature. There is experimental support for
231 Oracle and Microsoft SQL Server.
232
233 The supported versions are:
234
235 * MySQL 5.5.8 or later
236 * PostgreSQL 9.2 or later
237 * SQLite 3.3.7 or later
238 * Oracle 9.0.1 or later
239 * Microsoft SQL Server 2005 (9.00.1399)
240
241 == Upgrading ==
242 1.33 has several database changes since 1.32, and will not work without schema
243 updates. Note that due to changes to some very large tables like the revision
244 table, the schema update may take quite long (minutes on a medium sized site,
245 many hours on a large site).
246
247 Don't forget to always back up your database before upgrading!
248
249 See the file UPGRADE for more detailed upgrade instructions, including
250 important information when upgrading from versions prior to 1.11.
251
252 For notes on 1.32.x and older releases, see HISTORY.
253
254 == Online documentation ==
255 Documentation for both end-users and site administrators is available on
256 MediaWiki.org, and is covered under the GNU Free Documentation License (except
257 for pages that explicitly state that their contents are in the public domain):
258
259 https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation
260
261 == Mailing list ==
262 A mailing list is available for MediaWiki user support and discussion:
263
264 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
265
266 A low-traffic announcements-only list is also available:
267
268 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
269
270 It's highly recommended that you sign up for one of these lists if you're
271 going to run a public MediaWiki, so you can be notified of security fixes.
272
273 == IRC help ==
274 There's usually someone online in #mediawiki on irc.freenode.net.