RELEASE-NOTES-1.21

   1 = MediaWiki release notes =
   2
   3 Security reminder: MediaWiki does not require PHP's register_globals. If you
   4 have it on, turn it '''off''' if you can.
   5
   6 == MediaWiki 1.21 ==
   7
   8 THIS IS NOT A RELEASE YET
   9
  10 MediaWiki 1.21 is an alpha-quality branch and is not recommended for use in
  11 production.
  12
  13 === Configuration changes in 1.21 ===
  14 * (bug 29374) $wgVectorUseSimpleSearch is now enabled by default.
  15 * Deprecated $wgAllowRealName is removed. Use $wgHiddenPrefs[] = 'realname'
  16   instead.
  17
  18 === New features in 1.21 ===
  19 * (bug 34876) jquery.makeCollapsible has been improved in performance.
  20 * Added ContentHandler facility to allow extensions to support other content than wikitext.
  21   See docs/contenthandler.txt for details.
  22 * New feature was developed for showing high-DPI thumbnails for high-DPI mobile
  23   and desktop displays (configurable with $wgResponsiveImages).
  24 * Added new backend to represent and store information about sites and site
  25   specific configuration.
  26 * jQuery UI upgraded from 1.8.23 to 1.8.24.
  27 * Added separate fa_sha1 field to filearchive table. This allows sha1
  28   searches with the api in miser mode for deleted files.
  29 * Add initial and programmatic sorting for tablesorter.
  30 * Add the event "sortEnd.tablesorter", triggered after sorting has completed.
  31 * The Job system was refactored to allow for different backing stores for queues
  32   as well as cross-wiki access to queues, among other things. The schema for the
  33   DB queue was changed to support better concurrency and reduce deadlock errors.
  34 * Added ApiQueryORM class to facilitate creation of query API modules based on
  35   tables that have a corresponding ORMTable class.
  36
  37 === Bug fixes in 1.21 ===
  38 * (bug 40353) SpecialDoubleRedirect should support interwiki redirects.
  39 * (bug 40352) fixDoubleRedirects.php should support interwiki redirects.
  40 * (bug 9237) SpecialBrokenRedirect should not list interwiki redirects.
  41 * (bug 34960) Drop unused fields rc_moved_to_ns and rc_moved_to_title from
  42   recentchanges table.
  43 * (bug 32951) Do not register internal externals with absolute protocol,
  44   when server has relative protocol.
  45 * (bug 39005) When purging proxies listed in $wgSquidServers using HTTP PURGE
  46   method requests, we now send a Host header by default, for Varnish
  47   compatibility. This also works with Squid in reverse-proxy mode. If you wish
  48   to support Squid configured in forward-proxy mode, set
  49   $wgSquidPurgeUseHostHeader to false.
  50
  51 === API changes in 1.21 ===
  52 * prop=revisions can now report the contentmodel and contentformat, see docs/contenthandler.txt
  53 * action=edit and action=parse now support contentmodel and contentformat parameters to control the interpretation of
  54   page content; See docs/contenthandler.txt for details.
  55 * (bug 35693) ApiQueryImageInfo now suppresses errors when unserializing metadata.
  56 * (bug 40111) Disable minor edit for page/section creation by API
  57
  58 === Languages updated in 1.21 ===
  59
  60 MediaWiki supports over 350 languages. Many localisations are updated
  61 regularly. Below only new and removed languages are listed, as well as
  62 changes to languages because of Bugzilla reports.
  63 === Other changes in 1.21 ===
  64
  65 == Compatibility ==
  66
  67 MediaWiki 1.21 requires PHP 5.3.2 or later.
  68
  69 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
  70 support for them is somewhat less mature. There is experimental support for IBM
  71 DB2 and Oracle.
  72
  73 The supported versions are:
  74
  75 * MySQL 5.0.2 or later
  76 * PostgreSQL 8.3 or later
  77 * SQLite 3.3.7 or later
  78 * Oracle 9.0.1 or later
  79
  80 == Upgrading ==
  81
  82 1.21 has several database changes since 1.20, and will not work without schema
  83 updates. Note that due to changes to some very large tables like the revision
  84 table, the schema update may take quite long (minutes on a medium sized site,
  85 many hours on a large site).
  86
  87 If upgrading from before 1.11, and you are using a wiki as a commons
  88 repository, make sure that it is updated as well. Otherwise, errors may arise
  89 due to database schema changes.
  90
  91 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
  92 new database fields are filled with data.
  93
  94 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
  95 changes are made, and there is a slightly higher chance that things could
  96 break. 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.19.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.