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