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 upgraded from 1.8.2 to 1.8.3.
  27 * jQuery UI upgraded from 1.8.23 to 1.8.24.
  28 * Added separate fa_sha1 field to filearchive table. This allows sha1
  29   searches with the api in miser mode for deleted files.
  30 * Add initial and programmatic sorting for tablesorter.
  31 * Add the event "sortEnd.tablesorter", triggered after sorting has completed.
  32 * The Job system was refactored to allow for different backing stores for queues
  33   as well as cross-wiki access to queues, among other things. The schema for the
  34   DB queue was changed to support better concurrency and reduce deadlock errors.
  35 * Added ApiQueryORM class to facilitate creation of query API modules based on
  36   tables that have a corresponding ORMTable class.
  37 * (bug 40876) Icon for PSD (Adobe Photoshop) file types.
  38 * (bug 40641) Implemented Special:Version/Credits with a list of contributors.
  39 * (bug 7851) Implemented one-click AJAX patrolling.
  40 * The <data>, <time>, <meta>, and <link> elements are allowed within WikiText
  41   for use with Microdata.
  42
  43 === Bug fixes in 1.21 ===
  44 * (bug 40353) SpecialDoubleRedirect should support interwiki redirects.
  45 * (bug 40352) fixDoubleRedirects.php should support interwiki redirects.
  46 * (bug 9237) SpecialBrokenRedirect should not list interwiki redirects.
  47 * (bug 34960) Drop unused fields rc_moved_to_ns and rc_moved_to_title from
  48   recentchanges table.
  49 * (bug 32951) Do not register internal externals with absolute protocol,
  50   when server has relative protocol.
  51 * (bug 39005) When purging proxies listed in $wgSquidServers using HTTP PURGE
  52   method requests, we now send a Host header by default, for Varnish
  53   compatibility. This also works with Squid in reverse-proxy mode. If you wish
  54   to support Squid configured in forward-proxy mode, set
  55   $wgSquidPurgeUseHostHeader to false.
  56 * (bug 37020) sql.php with readline eats semicolon
  57 * (bug 11748) Properly handle optionally-closed HTML tags when Tidy is
  58   disabled, and don't wrap HTML-syntax definition lists in paragraphs.
  59 * (bug 41409) Diffs while editing an old revision should again diff against the
  60   current revision.
  61 * (bug 41494) Honor $wgLogExceptionBacktrace when logging non-API exceptions
  62   caught during API execution.
  63 * (bug 37963) Fixed loading process for user options
  64 * (bug 26995) Update filename field on Upload page after having sanitized it.
  65 * (bug 41793) Contribution links to users with 0 edits on Special:ListUsers didn't
  66   show up red.
  67 * (bug 41899) A PHP notice no longer occurs when using the "rvcontinue" API parameter.
  68 * (bug 42036) Account creation emails now contain canonical (not
  69   protocol-relative) URLs.
  70 * (bug 41990) Fix regression: API edit with redirect=true and lacking
  71   starttimestamp and basetimestamp should not cause an edit conflict.
  72 * (bug 41706) EditPage: Preloaded page should be converted if possible and needed.
  73 * (bug 41886) Rowspans are no longer exploded by tablesorter until the table is
  74   actually sorted.
  75 * (bug 2865)  User interface HTML elements don't use lang attribute
  76   (completed the fix by adding the lang attribute to firstHeading)
  77 * (bug 42173) Removed namespace prefixes on Special:UncategorizedCategories.
  78
  79 === API changes in 1.21 ===
  80 * prop=revisions can now report the contentmodel and contentformat, see docs/contenthandler.txt
  81 * action=edit and action=parse now support contentmodel and contentformat parameters to control the interpretation of
  82   page content; See docs/contenthandler.txt for details.
  83 * (bug 35693) ApiQueryImageInfo now suppresses errors when unserializing metadata.
  84 * (bug 40111) Disable minor edit for page/section creation by API
  85 * (bug 41042) Revert change to action=parse&page=... behavior when the page does not exist.
  86
  87 === Languages updated in 1.21 ===
  88
  89 MediaWiki supports over 350 languages. Many localisations are updated
  90 regularly. Below only new and removed languages are listed, as well as
  91 changes to languages because of Bugzilla reports.
  92 === Other changes in 1.21 ===
  93
  94 == Compatibility ==
  95
  96 MediaWiki 1.21 requires PHP 5.3.2 or later.
  97
  98 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
  99 support for them is somewhat less mature. There is experimental support for IBM
 100 DB2 and Oracle.
 101
 102 The supported versions are:
 103
 104 * MySQL 5.0.2 or later
 105 * PostgreSQL 8.3 or later
 106 * SQLite 3.3.7 or later
 107 * Oracle 9.0.1 or later
 108
 109 == Upgrading ==
 110
 111 1.21 has several database changes since 1.20, and will not work without schema
 112 updates. Note that due to changes to some very large tables like the revision
 113 table, the schema update may take quite long (minutes on a medium sized site,
 114 many hours on a large site).
 115
 116 If upgrading from before 1.11, and you are using a wiki as a commons
 117 repository, make sure that it is updated as well. Otherwise, errors may arise
 118 due to database schema changes.
 119
 120 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 121 new database fields are filled with data.
 122
 123 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 124 changes are made, and there is a slightly higher chance that things could
 125 break. Don't forget to always back up your database before upgrading!
 126
 127 See the file UPGRADE for more detailed upgrade instructions.
 128
 129 For notes on 1.19.x and older releases, see HISTORY.
 130
 131 == Online documentation ==
 132
 133 Documentation for both end-users and site administrators is available on
 134 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 135 for pages that explicitly state that their contents are in the public domain):
 136
 137         https://www.mediawiki.org/wiki/Documentation
 138
 139 == Mailing list ==
 140
 141 A mailing list is available for MediaWiki user support and discussion:
 142
 143         https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 144
 145 A low-traffic announcements-only list is also available:
 146
 147         https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 148
 149 It's highly recommended that you sign up for one of these lists if you're
 150 going to run a public MediaWiki, so you can be notified of security fixes.
 151
 152 == IRC help ==
 153
 154 There's usually someone online in #mediawiki on irc.freenode.net.