Merge "Moved ChronologyProtector to its own file."
[lhc/web/wiklou.git] / RELEASE-NOTES-1.22
1 Security reminder: MediaWiki does not require PHP's register_globals. If you
2 have it on, turn it '''off''' if you can.
3
4 == MediaWiki 1.22 ==
5
6 THIS IS NOT A RELEASE YET
7
8 MediaWiki 1.22 is an alpha-quality branch and is not recommended for use in
9 production.
10
11 === Configuration changes in 1.22 ===
12 * $wgRedirectScript was removed. It was unused.
13 * Removed $wgLocalMessageCacheSerialized, it is now always true.
14
15 === New features in 1.22 ===
16 * (bug 44525) mediawiki.jqueryMsg can now parse (whitelisted) HTML elements and attributes.
17 * (bug 33454) Language::sprintfDate now has a timezone parameter, and supports
18 the "eIOPTZ" formatting characters.
19 * EditWarning: A warning is shown when an editor leaves the edit form without
20 saving (enabled by default, users can opt-out via the 'useeditwarning'
21 preference). This feature was moved from the Vector extension, and is now part
22 of core for all skins. Take care when upgrading that you don't use an older
23 version of the Vector extension as this feature may conflict.
24
25 === Bug fixes in 1.22 ===
26 * Disable Special:PasswordReset when $wgEnableEmail. Previously one could still
27 navigate to the page by entering the URL directly.
28
29
30 === API changes in 1.22 ===
31 * (bug 46626) xmldoublequote parameter was removed. Because of a bug, the
32 parameter has had no effect since MediaWiki 1.16, and so its removal is
33 unlikely to impact existing clients.
34
35 === Languages updated in 1.22===
36
37 MediaWiki supports over 350 languages. Many localisations are updated
38 regularly. Below only new and removed languages are listed, as well as
39 changes to languages because of Bugzilla reports.
40
41 === Other changes in 1.22 ===
42 * redirect.php was removed. It was unused.
43 * ClickTracking integration was dropped from the mediaWiki.user.bucket
44 JavaScript function. The 'tracked' option is now ignored.
45 * BREAKING CHANGE: Legacy skins Simple, MySkin and Standard were all removed.
46 Nostalgia was moved to an extension.
47 * Event namespace used by jquery.makeCollapsible has been changed from
48 'mw-collapse' to 'mw-collapsible' for consistency with the module name.
49 * BREAKING CHANGE: The "ExternalAuth" authentication subsystem was removed, along
50 with its associated globals of $wgExternalAuthType, $wgExternalAuthConf,
51 $wgAutocreatePolicy and $wgAllowPrefChange. Affected users are encouraged to
52 use AuthPlugin for external authentication/authorization needs.
53 * The Quickbar feature of the legacy skin model and the last remnants of it
54 throughout the code base have been removed.
55 * Externaledit/externaldiff preference was removed. Very few users used this
56 feature, and improper configuration can actually prevent a user from editing
57
58 == Compatibility ==
59
60 MediaWiki 1.22 requires PHP 5.3.2 or later.
61
62 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
63 support for them is somewhat less mature. There is experimental support for
64 Oracle.
65
66 The supported versions are:
67
68 * MySQL 5.0.2 or later
69 * PostgreSQL 8.3 or later
70 * SQLite 3.3.7 or later
71 * Oracle 9.0.1 or later
72
73 == Upgrading ==
74
75 1.22 has several database changes since 1.21, and will not work without schema
76 updates. Note that due to changes to some very large tables like the revision
77 table, the schema update may take quite long (minutes on a medium sized site,
78 many hours on a large site).
79
80 If upgrading from before 1.11, and you are using a wiki as a commons
81 repository, make sure that it is updated as well. Otherwise, errors may arise
82 due to database schema changes.
83
84 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
85 new database fields are filled with data.
86
87 If you are upgrading from MediaWiki 1.4.x or earlier, you should upgrade to
88 1.5 first. The upgrade script maintenance/upgrade1_5.php has been removed
89 with MediaWiki 1.21.
90
91 Don't forget to always back up your database before upgrading!
92
93 See the file UPGRADE for more detailed upgrade instructions.
94
95 For notes on 1.21.x and older releases, see HISTORY.
96
97 == Online documentation ==
98
99 Documentation for both end-users and site administrators is available on
100 MediaWiki.org, and is covered under the GNU Free Documentation License (except
101 for pages that explicitly state that their contents are in the public domain):
102
103 https://www.mediawiki.org/wiki/Documentation
104
105 == Mailing list ==
106
107 A mailing list is available for MediaWiki user support and discussion:
108
109 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
110
111 A low-traffic announcements-only list is also available:
112
113 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
114
115 It's highly recommended that you sign up for one of these lists if you're
116 going to run a public MediaWiki, so you can be notified of security fixes.
117
118 == IRC help ==
119
120 There's usually someone online in #mediawiki on irc.freenode.net.