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