RELEASE-NOTES-1.19

   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.19 ==
   7
   8 THIS IS NOT A RELEASE YET
   9
  10 MediaWiki 1.19 is an alpha-quality branch and is not recommended for use in
  11 production.
  12
  13 === Configuration changes in 1.19 ===
  14 * Removed SkinTemplateSetupPageCss hook; use BeforePageDisplay instead.
  15 * (bug 27132) movefile right granted by default to registered users.
  16 * Default cookie lifetime ($wgCookieExpiration) is increased to 180 days.
  17
  18 === New features in 1.19 ===
  19 * (bug 30497) Add client-nojs and client-js classes on document element
  20   to let styles easily hide or show things based on general JS availability
  21 * (bug 19838) Possibility to get all interwiki prefixes if the interwiki
  22   cache is used.
  23 * $wgDnsBlacklistUrls now accepts an array with url and key as the
  24   elements to work with DNSBLs that require keys, such as
  25   Project Honeypot.
  26 * (bug 30022) Add support for custom loadScript sources to ResourceLoader.
  27 * (bug 19052) Unicode space separator characters (Zs) now terminates external
  28   links and images links.
  29 * (bug 30160) Add public method to mw.loader to get module names from registry.
  30 * (bug 15558) Parameters to special pages included in wikitext can now be passed
  31   as with templates.
  32 * Installer now issues a warning if mod_security is present.
  33 * (bug 29455) Add support for a filter callback function in jQuery byteLimit
  34   plugin.
  35 * Extensions can now participate in the extraction of titles from url paths
  36 * Added two new GetLocalURL hooks to better serve extensions working on a
  37   limited type of titles.
  38 * Added a --no-updates flag to importDump.php that skips updating the links
  39   tables.
  40 * Most presentational html attributes like valign are now converted to inline
  41   css style rules. These attributes were removed from html5 and so we clean
  42   them up when $wgHtml5 is enabled. This can be disabled using
  43   $wgCleanupPresentationalAttributes.
  44 * Magic words (time and number-formatting ones, plus DIRECTIONMARK, but not
  45   NAMESPACE) now depend on the page content language instead of the site
  46   language. In theory this sets the right magic words in system messages,
  47   although they are not used there.
  48 * (bug 30451) Add page_props to RefreshLinks::deleteLinksFromNonexistent
  49 * (bug 30450) Clear page_props table on page deletion
  50 * Hook added to check for exempt from account creation throttle
  51 * (bug 30344) Add configuration variable for setting custom priorities when
  52   generating sitemaps
  53 * (bug 16428) Include permalink in printable version
  54 * (bug 5865) Warning on editing other user's userpage
  55
  56 === Bug fixes in 1.19 ===
  57 * $wgUploadNavigationUrl should be used for file redlinks if
  58   $wgUploadMissingFileUrl is not set. The first was used for this
  59   until the second was introduced in 1.17.
  60 * (bug 25355) Parser generates edit section links for special pages.
  61 * (bug 27894) Move 'editondblclick' event listener down from body to
  62   div#bodyContent.
  63 * (bug 30172) The check for posix_isatty() in maintenance scripts did not detect
  64   when the function exists but is disabled. Introduced
  65   Maintenance::posix_isatty().
  66 * (bug 30264) Changed installer-generated LocalSettings.php to use
  67   require_once() instead require() for included extensions.
  68 * Do not convert text in the user interface language to another script.
  69 * (bug 26283) Previewing user JS/CSS pages doesn't load other user JS/CSS pages
  70 * (bug 11374) Improved diff readability for colorblind people.
  71 * (bug 26486) ResourceLoader modules with paths to nonexistent files cause PHP
  72   warnings/notices to be thrown.
  73 * (bug 30335) Fix for HTMLForms using GET breaking when non-friendly URLs are
  74   used
  75 * (bug 28649) Avoiding half truncated multi-byte unicode characters when
  76   truncating log comments.
  77 * Show --batch-size option in help of maintenance scripts that support it
  78 * (bug 4381) Magic quotes cleaning is not comprehensive, key strings not
  79   unescaped
  80 * (bug 30684) Fix bad escaping in mw.message for inexistent messages (i.e. <key>)
  81
  82 === API changes in 1.19 ===
  83 * (bug 19838) siprop=interwikimap can now use the interwiki cache.
  84 * (bug 29748) Add API search prefix support.
  85 * (bug 29684) Set forgotten parameter types in ApiQueryIWLinks.
  86 * (bug 29685) do not output NULL parentid with list=deletedrevs&drprop=parentid.
  87 * siprop=interwikimap and siprop=languages can use silanguagecode to have
  88   a best effort language name translation. Use CLDR extension for best result.
  89 * (bug 30230) action=expandtemplates should not silently override invalid title
  90   inputs.
  91 * (bug 18634) Create API to fetch MediaWiki's language fallback tree structure.
  92 * (bug 26885) Allow show/hide of account blocks, temporary blocks and single IP
  93   address blocks for list=blocks.
  94 * (bug 30591) Add support to only return keys in ApiAllMessages.
  95
  96 === Languages updated in 1.19 ===
  97
  98 MediaWiki supports over 330 languages. Many localisations are updated
  99 regularly. Below only new and removed languages are listed, as well as
 100 changes to languages because of Bugzilla reports.
 101
 102 * Kichwa (qug) (new).
 103 * Uighur (Latin) (ug-latn) was incorrectly marked as right-to-left language.
 104 * (bug 30217) Make pt-br a fallback of pt
 105
 106 === Other changes in 1.19 ===
 107 * jquery.mwPrototypes module was renamed to jquery.mwExtension.
 108 * The maintenance script populateSha1.php was renamed to the more concise
 109   populateImageSha1.php
 110 * The Client-IP header is no longer checked for when trying to resolve a client's
 111   real IP address.
 112
 113 == Compatibility ==
 114
 115 MediaWiki 1.19 requires PHP 5.2.3. PHP 4 is no longer supported.
 116
 117 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
 118 support for them is somewhat less mature. There is experimental support for IBM
 119 DB2 and Microsoft SQL Server.
 120
 121 The supported versions are:
 122
 123 * MySQL 4.0 or later
 124 * PostgreSQL 8.3 or later
 125 * SQLite 3
 126 * Oracle 9.0.1 or later
 127
 128 == Upgrading ==
 129
 130 1.19 has several database changes since 1.18, and will not work without schema
 131 updates.
 132
 133 If upgrading from before 1.11, and you are using a wiki as a commons
 134 repository, make sure that it is updated as well. Otherwise, errors may arise
 135 due to database schema changes.
 136
 137 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 138 new database fields are filled with data.
 139
 140 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 141 changes are made, and there is a slightly higher chance that things could
 142 break. Don't forget to always back up your database before upgrading!
 143
 144 See the file UPGRADE for more detailed upgrade instructions.
 145
 146 For notes on 1.15.x and older releases, see HISTORY.
 147
 148 == Online documentation ==
 149
 150 Documentation for both end-users and site administrators is available on
 151 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 152 for pages that explicitly state that their contents are in the public domain):
 153
 154         http://www.mediawiki.org/wiki/Documentation
 155
 156 == Mailing list ==
 157
 158 A mailing list is available for MediaWiki user support and discussion:
 159
 160         http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 161
 162 A low-traffic announcements-only list is also available:
 163
 164         http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 165
 166 It's highly recommended that you sign up for one of these lists if you're
 167 going to run a public MediaWiki, so you can be notified of security fixes.
 168
 169 == IRC help ==
 170
 171 There's usually someone online in #mediawiki on irc.freenode.net.