Merge "Consistency tweak: Wrap variable names into <code></code>"
[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
27 === API changes in 1.22 ===
28 * (bug 46626) xmldoublequote parameter was removed. Because of a bug, the
29 parameter has had no effect since MediaWiki 1.16, and so its removal is
30 unlikely to impact existing clients.
31
32 === Languages updated in 1.22===
33
34 MediaWiki supports over 350 languages. Many localisations are updated
35 regularly. Below only new and removed languages are listed, as well as
36 changes to languages because of Bugzilla reports.
37
38 === Other changes in 1.22 ===
39 * redirect.php was removed. It was unused.
40 * ClickTracking integration was dropped from the mediaWiki.user.bucket
41 JavaScript function. The 'tracked' option is now ignored.
42 * BREAKING CHANGE: Legacy skins Simple, MySkin and Standard were all removed.
43 Nostalgia was moved to an extension.
44 * Event namespace used by jquery.makeCollapsible has been changed from
45 'mw-collapse' to 'mw-collapsible' for consistency with the module name.
46 * BREAKING CHANGE: The "ExternalAuth" authentication subsystem was removed, along
47 with its associated globals of $wgExternalAuthType, $wgExternalAuthConf,
48 $wgAutocreatePolicy and $wgAllowPrefChange. Affected users are encouraged to
49 use AuthPlugin for external authentication/authorization needs.
50 * The Quickbar feature of the legacy skin model and the last remnants of it
51 throughout the code base have been removed.
52 * Externaledit/externaldiff preference was removed. Very few users used this
53 feature, and improper configuration can actually prevent a user from editing
54
55 == Compatibility ==
56
57 MediaWiki 1.22 requires PHP 5.3.2 or later.
58
59 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
60 support for them is somewhat less mature. There is experimental support for
61 Oracle.
62
63 The supported versions are:
64
65 * MySQL 5.0.2 or later
66 * PostgreSQL 8.3 or later
67 * SQLite 3.3.7 or later
68 * Oracle 9.0.1 or later
69
70 == Upgrading ==
71
72 1.22 has several database changes since 1.21, and will not work without schema
73 updates. Note that due to changes to some very large tables like the revision
74 table, the schema update may take quite long (minutes on a medium sized site,
75 many hours on a large site).
76
77 If upgrading from before 1.11, and you are using a wiki as a commons
78 repository, make sure that it is updated as well. Otherwise, errors may arise
79 due to database schema changes.
80
81 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
82 new database fields are filled with data.
83
84 If you are upgrading from MediaWiki 1.4.x or earlier, you should upgrade to
85 1.5 first. The upgrade script maintenance/upgrade1_5.php has been removed
86 with MediaWiki 1.21.
87
88 Don't forget to always back up your database before upgrading!
89
90 See the file UPGRADE for more detailed upgrade instructions.
91
92 For notes on 1.21.x and older releases, see HISTORY.
93
94 == Online documentation ==
95
96 Documentation for both end-users and site administrators is available on
97 MediaWiki.org, and is covered under the GNU Free Documentation License (except
98 for pages that explicitly state that their contents are in the public domain):
99
100 https://www.mediawiki.org/wiki/Documentation
101
102 == Mailing list ==
103
104 A mailing list is available for MediaWiki user support and discussion:
105
106 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
107
108 A low-traffic announcements-only list is also available:
109
110 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
111
112 It's highly recommended that you sign up for one of these lists if you're
113 going to run a public MediaWiki, so you can be notified of security fixes.
114
115 == IRC help ==
116
117 There's usually someone online in #mediawiki on irc.freenode.net.