RELEASE-NOTES-1.20

   1 = MediaWiki release notes =
   2
   3 Security reminder: MediaWiki does not require PHP's register_globals
   4 setting since version 1.2.0. If you have it on, turn it '''off''' if you can.
   5
   6 == MediaWiki 1.20 ==
   7
   8 THIS IS NOT A RELEASE YET
   9
  10 MediaWiki 1.20 is an alpha-quality branch and is not recommended for use in
  11 production.
  12
  13 === Configuration changes in 1.20 ===
  14 * `$wgUsePathInfo = true;` is no longer needed to make $wgArticlePath work on servers
  15   using like nginx, lighttpd, and apache over fastcgi. MediaWiki now always extracts
  16   path info from REQUEST_URI if it's available.
  17
  18 === New features in 1.20 ===
  19 * Added TitleIsAlwaysKnown hook which gets called when determining if a page exists.
  20 * (bug 32341) Add upload by URL domain limitation.
  21 * &useskin=default will now always display the default skin. Useful for users with a
  22   preference for the non-default skin to look at something using the default skin.
  23 * (bug 27619) Remove preference option to display broken links as link?
  24 * (bug 34896) Update jQuery JSON plugin to v2.3 (2011-09-17).
  25 * (bug 34302) Add CSS classes to email fields in user preferences.
  26 * Introduced $wgDebugDBTransactions to trace transaction status (currently PostgreSQL only).
  27 * (bug 23795) Add parser itself to ParserMakeImageParams hook.
  28 * Introduce a cryptographic random number generator source api for use when
  29   generating various tokens.
  30 * (bug 30963) Option on Special:Prefixindex and Special:Allpages to not show redirects.
  31 * (bug 18062) new message when edit or create the local page of a shared file.
  32 * (bug 22870) Separate interface message when creating a page.
  33 * (bug 17615) nosummary option should be reassigned on preview/captcha.
  34 * (bug 34355) add a variable and parser function for the namespace number.
  35 * (bug 35649) Special:Version now shows hashes of extensions checked out from git.
  36 * (bug 35728) Git revisions are now linked on Special:Version.
  37 * "Show Changes" on default messages shows now diff against default message text
  38 * (bug 23006) create #speciale parser function.
  39 * generateSitemap can now optionally skip redirect pages.
  40 * (bug 27757) new API command just for retrieving tokens (not page-based)
  41
  42 === Bug fixes in 1.20 ===
  43 * (bug 30245) Use the correct way to construct a log page title.
  44 * (bug 34237) Regenerate an empty user_token and save to the database
  45   when we try to set the user's cookies for login.
  46 * (bug 32210) New edit emails for watched pages always provide a link to the
  47   edit which triggered the mail.
  48 * (bug 12021) Added user talk link on Special:Listusers.
  49 * (bug 34445) section edit and TOC hide/show links are excluded from selection and
  50   copy/paste on supporting browsers.
  51 * (bug 34428) Fixed incorrect hash mismatch errors in the DiffHistoryBlob
  52   history compression method.
  53 * (bug 34702) Localised parentheses are now used in more special pages.
  54 * (bug 34723) When editing a script page on a RTL wiki the textbox should be LTR.
  55 * (bug 34762) Calling close() on a DatabaseBase object now clears the connection.
  56 * (bug 34863) Show deletion log extract on non-existent file pages if applicable.
  57 * (bug 28019) Let ?preloadtitle=foo be passed on to target of
  58   Special:MyPage and Special:MyTalk.
  59 * (bug 34929) Show the correct diff when a section edit is rejected by the spam
  60   filter.
  61 * (bug 15816) Add a switch for SETting the search_path (Postgres).
  62 * (bug 34521) Returning to the previous page after logging in loses any array-
  63   valued parameters in the query string.
  64 * (bug 34735) Updated compressOld.php documentation to mention the different
  65   usages of -s and -n parameters depending on compression type.
  66 * (bug 13896) Rendering of devanagari numbers in automatic '#' number lists.
  67 * (bug 33689) Upgrade to 1.19 on Postgres fails due to incomplete query when.
  68   trying to defer foreign key for externallinks.
  69 * (bug 32748) Printer friendly version of article decode Unicode chars as a
  70   pretty IRI in footer.
  71 * Removed white border around thumbnails in galleries.
  72 * (bug 31236) "Next" and "Previous" buttons are shown incorrectly in
  73   an RTL environment.
  74 * (bug 35680) jQuery upgraded to 1.7.2.
  75 * (bug 35681) jQuery UI upgraded to 1.8.18.
  76 * (bug 35705) QUnit upgraded from 1.2.0 to 1.5.0
  77 * (bug 35749) Updated maintenance/checkSyntax.php to use Git instead of
  78   Subversion when invoked with the --modified option.
  79
  80 === API changes in 1.20 ===
  81 * (bug 34316) Add ability to retrieve maximum upload size from MediaWiki API.
  82 * (bug 34313) MediaWiki API intro message about "HTML format" should mention
  83   the format parameter.
  84 * (bug 32384) Allow descending order for list=watchlistraw.
  85 * (bug 31883) Limit of bkusers of list=blocks and titles of action=query is not documented in API help.
  86 * (bug 32492) API now allows editing using pageid
  87
  88 === Languages updated in 1.20 ===
  89
  90 MediaWiki supports over 350 languages. Many localisations are updated
  91 regularly. Below only new and removed languages are listed, as well as
  92 changes to languages because of Bugzilla reports.
  93
  94 * (bug 34192) Namespace gender aliases for Albanian languages (sq & aln).
  95 * (bug 35541) Namespace gender aliases for Croatian (hr).
  96 * Mizo (lus) added.
  97
  98 === Other changes in 1.20 ===
  99 * The user_token field is now left empty until a user attempts to login and
 100   cookies need to be set. It is also now possible to reset every user's
 101   user_token simply by clearing the values in the user_token column.
 102 * Removed ./tests/qunit/index.html from core. It wasn't actively maintained and
 103   has been made obsolete when [[Special:JavaScriptTest/qunit]] was introduced,
 104   which actually uses ResourceLoader, LocalSettings and the Skin.
 105
 106 == Compatibility ==
 107
 108 MediaWiki 1.20 requires PHP 5.2.3. PHP 4 is no longer supported.
 109
 110 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
 111 support for them is somewhat less mature. There is experimental support for IBM
 112 DB2 and Oracle.
 113
 114 The supported versions are:
 115
 116 * MySQL 5.0.2 or later
 117 * PostgreSQL 8.3 or later
 118 * SQLite 3.3.7 or later
 119 * Oracle 9.0.1 or later
 120
 121 == Upgrading ==
 122
 123 1.20 has several database changes since 1.19, and will not work without schema
 124 updates.
 125
 126 If upgrading from before 1.11, and you are using a wiki as a commons
 127 repository, make sure that it is updated as well. Otherwise, errors may arise
 128 due to database schema changes.
 129
 130 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 131 new database fields are filled with data.
 132
 133 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 134 changes are made, and there is a slightly higher chance that things could
 135 break. Don't forget to always back up your database before upgrading!
 136
 137 See the file UPGRADE for more detailed upgrade instructions.
 138
 139 For notes on 1.19.x and older releases, see HISTORY.
 140
 141 == Online documentation ==
 142
 143 Documentation for both end-users and site administrators is available on
 144 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 145 for pages that explicitly state that their contents are in the public domain):
 146
 147         https://www.mediawiki.org/wiki/Documentation
 148
 149 == Mailing list ==
 150
 151 A mailing list is available for MediaWiki user support and discussion:
 152
 153         https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 154
 155 A low-traffic announcements-only list is also available:
 156
 157         https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 158
 159 It's highly recommended that you sign up for one of these lists if you're
 160 going to run a public MediaWiki, so you can be notified of security fixes.
 161
 162 == IRC help ==
 163
 164 There's usually someone online in #mediawiki on irc.freenode.net.