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 * (bug 31204) Removed old user.user_options
  18 * $wgMaxImageArea now applies to jpeg files if they are not scaled with
  19   ImageMagick.
  20 * Introduced $wgQueryPageDefaultLimit (defaults to 50) for the number of
  21   items to show by default on query pages (special pages such as Whatlinkshere).
  22
  23 === New features in 1.19 ===
  24 * (bug 19838) Possibility to get all interwiki prefixes if the interwiki
  25   cache is used.
  26 * $wgDnsBlacklistUrls now accepts an array with url and key as the
  27   elements to work with DNSBLs that require keys, such as
  28   Project Honeypot.
  29 * (bug 30022) Add support for custom loadScript sources to ResourceLoader.
  30 * (bug 19052) Unicode space separator characters (Zs) now terminates external
  31   links and images links.
  32 * (bug 30160) Add public method to mw.loader to get module names from registry.
  33 * (bug 15558) Parameters to special pages included in wikitext can now be passed
  34   as with templates.
  35 * Installer now issues a warning if mod_security is present.
  36 * (bug 29455) Add support for a filter callback function in jQuery byteLimit
  37   plugin.
  38 * Extensions can now participate in the extraction of titles from url paths
  39 * Added two new GetLocalURL hooks to better serve extensions working on a
  40   limited type of titles.
  41 * Added a --no-updates flag to importDump.php that skips updating the links
  42   tables.
  43 * Most presentational html attributes like valign are now converted to inline
  44   css style rules. These attributes were removed from html5 and so we clean
  45   them up when $wgHtml5 is enabled. This can be disabled using
  46   $wgCleanupPresentationalAttributes.
  47 * Magic words (time and number-formatting ones, plus DIRECTIONMARK, but not
  48   NAMESPACE) now depend on the page content language instead of the site
  49   language. In theory this sets the right magic words in system messages,
  50   although they are not used there.
  51 * (bug 30451) Add page_props to RefreshLinks::deleteLinksFromNonexistent
  52 * (bug 30450) Clear page_props table on page deletion
  53 * Hook added to check for exempt from account creation throttle
  54 * (bug 30344) Add configuration variable for setting custom priorities when
  55   generating sitemaps
  56 * (bug 96170) Add array support for space-separated list attributes (like
  57   'class') in the Html helper class.
  58 * (bug 26470) Add checkered background image on hover on files pages.
  59 * (bug 30774) mediawiki.html: Add support for numbers and booleans in the
  60   attribute values and element contents.
  61 * Conversion script between Tifinagh and Latin for the Tachelhit language
  62 * (bug 16755) Add options 'noreplace' and 'noerror' to {{DEFAULTSORT:...}}
  63   to stop it from replace an already existing default sort, and suppress error.
  64 * (bug 18578) Rewrote revision delete related messages to allow better
  65   localisation
  66 * (bug 30364) LanguageConverter now depends on the page content language
  67   instead of the wiki content language
  68 * Jump links will now be usable in css-capable browsers instead of only
  69   in outdated text browsers.
  70 * New common*.css files usable by skins instead of having to copy piles
  71   of generic styles from MonoBook or Vector's css.
  72 * Some deprecated presentational html attributes will now be automatically
  73   converted to css.
  74 * (bug 31297) Add support for namespaces in Special:RecentChanges subpage filter
  75   syntax.
  76 * The default user signature now contains a talk link in addition to the user link.
  77 * (bug 25306) Add link of old page title to MediaWiki:Delete_and_move_reason
  78 * Added hook BitmapHandlerCheckImageArea
  79 * (experimental) $wgRealNameInInterface can be enabled to display a user's
  80   real name in some parts of the interface instead of a username.
  81
  82 === Bug fixes in 1.19 ===
  83 * $wgUploadNavigationUrl should be used for file redlinks if
  84   $wgUploadMissingFileUrl is not set. The first was used for this
  85   until the second was introduced in 1.17.
  86 * (bug 25355) Parser generates edit section links for special pages.
  87 * (bug 27894) Move 'editondblclick' event listener down from body to
  88   div#bodyContent.
  89 * (bug 30172) The check for posix_isatty() in maintenance scripts did not detect
  90   when the function exists but is disabled. Introduced
  91   Maintenance::posix_isatty().
  92 * (bug 30264) Changed installer-generated LocalSettings.php to use
  93   require_once() instead require() for included extensions.
  94 * Do not convert text in the user interface language to another script.
  95 * (bug 26283) Previewing user JS/CSS pages didn't load other user JS/CSS pages
  96 * (bug 11374) Improved diff readability for colorblind people.
  97 * (bug 26486) ResourceLoader modules with paths to nonexistent files cause PHP
  98   warnings/notices to be thrown.
  99 * (bug 30335) Fix for HTMLForms using GET breaking when non-friendly URLs are
 100   used
 101 * (bug 28649) Avoiding half truncated multi-byte unicode characters when
 102   truncating log comments.
 103 * Show --batch-size option in help of maintenance scripts that support it
 104 * (bug 4381) Magic quotes cleaning was not comprehensive, key strings were not
 105   unescaped
 106 * (bug 23057) Importers no longer can 'edit' or 'create' a fully-protected page by
 107   importing a new revision into it
 108 * Allow moving the associated talk pages of subpages even if the base page
 109   has no subpage.
 110 * Per page edit-notices now work in namespaces without subpages enabled.
 111 * (bug 30245) Use the correct way to construct a log page title
 112 * (bug 31081) $wgEnotifUseJobQ caused many unnecessary jobs to be queued
 113 * (bug 30202) File names are now restricted on upload to 240 bytes, because of
 114   restrictions on some of the database fields.
 115 * Timezones are now recognised in user preferences when offset is different
 116   due to DST
 117 * (bug 31692) "summary" parameter now also work when undoing revisions
 118 * (bug 18823) "move succeeded" text displayed bluelinks even when redirect was
 119    suppressed
 120 * (bug 31921) Magic words REVISIONDAY, REVISIONMONTH and REVISIONYEAR now give
 121   current values on preview
 122 * (bug 19186) Special:UserLogin's title on Special:SpecialPages now says
 123   "create account" when the user cannot create an account
 124 * (bug 31818) 'usercreated' message now supports GENDER
 125 * (bug 32022) Our phpunit.php script can now be executed from another directory
 126 * (bug 26020) Setting $wgEmailConfirmToEdit to true no longer removes diffs
 127   from recent changes feeds
 128 * (bug 30232) add current time to message wlnote on Special:Watchlist
 129 * (bug 29110) $wgFeedDiffCutoff did not affect new pages
 130 * (bug 32168) Add wfRemoveDotSegments for use in wfExpandUrl
 131
 132 === API changes in 1.19 ===
 133 * (bug 19838) siprop=interwikimap can now use the interwiki cache.
 134 * (bug 29748) Add API search prefix support.
 135 * (bug 29684) Set forgotten parameter types in ApiQueryIWLinks.
 136 * (bug 29685) do not output NULL parentid with list=deletedrevs&drprop=parentid.
 137 * siprop=interwikimap and siprop=languages can use silanguagecode to have
 138   a best effort language name translation. Use CLDR extension for best result.
 139 * (bug 30230) action=expandtemplates should not silently override invalid title
 140   inputs.
 141 * (bug 18634) Create API to fetch MediaWiki's language fallback tree structure.
 142 * (bug 26885) Allow show/hide of account blocks, temporary blocks and single IP
 143   address blocks for list=blocks.
 144 * (bug 30591) Add support to only return keys in ApiAllMessages.
 145 * The API now respects $wgShowHostnames and won't share the hostname in
 146   severedby if it's set to false
 147
 148 === Languages updated in 1.19 ===
 149
 150 MediaWiki supports over 330 languages. Many localisations are updated
 151 regularly. Below only new and removed languages are listed, as well as
 152 changes to languages because of Bugzilla reports.
 153
 154 * Uighur (Latin) (ug-latn) was incorrectly marked as right-to-left language.
 155 * (bug 30217) Make pt-br a fallback of pt
 156 * (bug 31193) Set fallback language of Assamese from Bengali to English
 157 * Update date format for dsb and hsb: month names need the genitive
 158
 159 === Other changes in 1.19 ===
 160 * jquery.mwPrototypes module was renamed to jquery.mwExtension.
 161 * The maintenance script populateSha1.php was renamed to the more concise
 162   populateImageSha1.php
 163 * The Client-IP header is no longer checked for when trying to resolve a client's
 164   real IP address.
 165 * (bug 22096) Although IE5.x and below was already unsupported officially, stylesheets
 166   existing exclusively for IE5.0 and IE5.5 have now been removed (which were in skins
 167   'chick' and 'monobook').
 168 * The constructor for CategoryView has changed, the second parameter is now a
 169   Context source and is required.
 170
 171 == Compatibility ==
 172
 173 MediaWiki 1.19 requires PHP 5.2.3. PHP 4 is no longer supported.
 174
 175 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
 176 support for them is somewhat less mature. There is experimental support for IBM
 177 DB2 and Microsoft SQL Server.
 178
 179 The supported versions are:
 180
 181 * MySQL 4.0 or later
 182 * PostgreSQL 8.3 or later
 183 * SQLite 3
 184 * Oracle 9.0.1 or later
 185
 186 == Upgrading ==
 187
 188 1.19 has several database changes since 1.18, and will not work without schema
 189 updates.
 190
 191 If upgrading from before 1.11, and you are using a wiki as a commons
 192 repository, make sure that it is updated as well. Otherwise, errors may arise
 193 due to database schema changes.
 194
 195 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 196 new database fields are filled with data.
 197
 198 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 199 changes are made, and there is a slightly higher chance that things could
 200 break. Don't forget to always back up your database before upgrading!
 201
 202 See the file UPGRADE for more detailed upgrade instructions.
 203
 204 For notes on 1.17.x and older releases, see HISTORY.
 205
 206 == Online documentation ==
 207
 208 Documentation for both end-users and site administrators is available on
 209 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 210 for pages that explicitly state that their contents are in the public domain):
 211
 212         http://www.mediawiki.org/wiki/Documentation
 213
 214 == Mailing list ==
 215
 216 A mailing list is available for MediaWiki user support and discussion:
 217
 218         http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 219
 220 A low-traffic announcements-only list is also available:
 221
 222         http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 223
 224 It's highly recommended that you sign up for one of these lists if you're
 225 going to run a public MediaWiki, so you can be notified of security fixes.
 226
 227 == IRC help ==
 228
 229 There's usually someone online in #mediawiki on irc.freenode.net.