Merge "Minor coding style whitespace cleanup"
[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
53 == Compatibility ==
54
55 MediaWiki 1.22 requires PHP 5.3.2 or later.
56
57 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
58 support for them is somewhat less mature. There is experimental support for
59 Oracle.
60
61 The supported versions are:
62
63 * MySQL 5.0.2 or later
64 * PostgreSQL 8.3 or later
65 * SQLite 3.3.7 or later
66 * Oracle 9.0.1 or later
67
68 == Upgrading ==
69
70 1.22 has several database changes since 1.21, and will not work without schema
71 updates. Note that due to changes to some very large tables like the revision
72 table, the schema update may take quite long (minutes on a medium sized site,
73 many hours on a large site).
74
75 If upgrading from before 1.11, and you are using a wiki as a commons
76 repository, make sure that it is updated as well. Otherwise, errors may arise
77 due to database schema changes.
78
79 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
80 new database fields are filled with data.
81
82 If you are upgrading from MediaWiki 1.4.x or earlier, you should upgrade to
83 1.5 first. The upgrade script maintenance/upgrade1_5.php has been removed
84 with MediaWiki 1.21.
85
86 Don't forget to always back up your database before upgrading!
87
88 See the file UPGRADE for more detailed upgrade instructions.
89
90 For notes on 1.21.x and older releases, see HISTORY.
91
92 == Online documentation ==
93
94 Documentation for both end-users and site administrators is available on
95 MediaWiki.org, and is covered under the GNU Free Documentation License (except
96 for pages that explicitly state that their contents are in the public domain):
97
98 https://www.mediawiki.org/wiki/Documentation
99
100 == Mailing list ==
101
102 A mailing list is available for MediaWiki user support and discussion:
103
104 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
105
106 A low-traffic announcements-only list is also available:
107
108 https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
109
110 It's highly recommended that you sign up for one of these lists if you're
111 going to run a public MediaWiki, so you can be notified of security fixes.
112
113 == IRC help ==
114
115 There's usually someone online in #mediawiki on irc.freenode.net.