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 * Changed LoginAuthenticateAudit hook so that it may be called before a
  15   valid user is available.  In those cases, an anonymouse user object
  16   will be supplied.
  17 * Removed SkinTemplateSetupPageCss hook; use BeforePageDisplay instead.
  18 * (bug 27132) movefile right granted by default to registered users.
  19 * Default cookie lifetime ($wgCookieExpiration) is increased to 180 days.
  20 * (bug 31204) Removed old user.user_options.
  21 * $wgMaxImageArea now applies to jpeg files if they are not scaled with
  22   ImageMagick.
  23 * Introduced $wgQueryPageDefaultLimit (defaults to 50) for the number of
  24   items to show by default on query pages (special pages such as Whatlinkshere).
  25 * (bug 32470) Increase the length of ug_group.
  26 * (bug 32239) Removed wgEnableTooltipsAndAccesskeys.
  27 * Removed $wgVectorShowVariantName.
  28
  29 === New features in 1.19 ===
  30 * (bug 19838) Possibility to get all interwiki prefixes if the interwiki
  31   cache is used.
  32 * $wgDnsBlacklistUrls now accepts an array with url and key as the
  33   elements to work with DNSBLs that require keys, such as
  34   Project Honeypot.
  35 * (bug 30022) Add support for custom loadScript sources to ResourceLoader.
  36 * (bug 19052) Unicode space separator characters (Zs) now terminates external
  37   links and images links.
  38 * (bug 30160) Add public method to mw.loader to get module names from registry.
  39 * (bug 15558) Parameters to special pages included in wikitext can now be passed
  40   as with templates.
  41 * Installer now issues a warning if mod_security is present.
  42 * (bug 29455) Add support for a filter callback function in jQuery byteLimit
  43   plugin.
  44 * Added two new GetLocalURL hooks to better serve extensions working on a
  45   limited type of titles.
  46 * Added a --no-updates flag to importDump.php that skips updating the links
  47   tables.
  48 * Most presentational html attributes like valign are now converted to inline
  49   css style rules. These attributes were removed from html5 and so we clean
  50   them up when $wgHtml5 is enabled. This can be disabled using
  51   $wgCleanupPresentationalAttributes.
  52 * Magic words (time and number-formatting ones, plus DIRECTIONMARK, but not
  53   NAMESPACE) now depend on the page content language instead of the site
  54   language. In theory this sets the right magic words in system messages,
  55   although they are not used there.
  56 * (bug 30451) Add page_props to RefreshLinks::deleteLinksFromNonexistent.
  57 * (bug 30450) Clear page_props table on page deletion.
  58 * Hook added to check for exempt from account creation throttle.
  59 * (bug 30344) Add configuration variable for setting custom priorities when
  60   generating sitemaps.
  61 * (bug 96170) Add array support for space-separated list attributes (like
  62   'class') in the Html helper class.
  63 * (bug 26470) Add checkered background image on hover on files pages.
  64 * (bug 30774) mediawiki.html: Add support for numbers and booleans in the
  65   attribute values and element contents.
  66 * Conversion script between Tifinagh and Latin for the Tachelhit language.
  67 * (bug 16755) Add options 'noreplace' and 'noerror' to {{DEFAULTSORT:...}}
  68   to stop it from replace an already existing default sort, and suppress error.
  69 * (bug 18578) Rewrote revision delete related messages to allow better
  70   localisation.
  71 * (bug 30364) LanguageConverter now depends on the page content language
  72   instead of the wiki content language.
  73 * Jump links will now be usable in css-capable browsers instead of only
  74   in outdated text browsers.
  75 * New common*.css files usable by skins instead of having to copy piles
  76   of generic styles from MonoBook or Vector's css.
  77 * Some deprecated presentational html attributes will now be automatically
  78   converted to css.
  79 * (bug 31297) Add support for namespaces in Special:RecentChanges subpage filter
  80   syntax.
  81 * The default user signature now contains a talk link in addition to the user link.
  82 * (bug 25306) Add link of old page title to MediaWiki:Delete_and_move_reason.
  83 * Added hook BitmapHandlerCheckImageArea.
  84 * (experimental) $wgRealNameInInterface can be enabled to display a user's
  85   real name in some parts of the interface instead of a username.
  86 * (bug 30062) Add $wgDBprefix option to cli installer.
  87 * getUserPermissionsErrors and getUserPermissionsErrorsExpensive hooks are now
  88   also called when checking for 'read' permission.
  89 * Introduce $wgEnableSearchContributorsByIP which controls whether searching
  90   for an IP address redirects to the contributions list for that IP.
  91 * (bug 8859) Database::update should take array of tables too.
  92 * (bug 19698) Inverse selection for Special:Contributions.
  93 * (bug 24037) Add byte length of revision to Special:Contributions.
  94 * (bug 1672) Added $wgDisableUploadScriptChecks to allow uploading of files
  95   containing HTML or JS. DISABLING THESE CHECKS IS VERY DANGEROUS.
  96 * New path mappings can be added using the WebRequestPathInfoRouter hook
  97   and adding paths to the PathRouter.
  98 * (bug 32666) Special:ActiveUsers now allows a subpage to be used as the
  99   username (eg. Special:ActiveUsers/Username)
 100 * New JavaScript variable wgPageContentLanguage
 101 * Added new debugging toolbar, enabled with $wgDebugToolbar
 102 * Differences in the history page now uses slightly better colors for people
 103   perceiving colors differently. Colors comes from the French Wikipedia.
 104 * (bug 32879) Upgrade jQuery to 1.7.1
 105 * jQuery UI upgraded to 1.8.17
 106 * Extensions can use the 'Language::getMessagesFileName' hook to define new
 107   languages using messages files outside of core.
 108 * (bug 32512) Include 'associated namespace' checkbox on Special:Contributions
 109
 110 === Bug fixes in 1.19 ===
 111 * $wgUploadNavigationUrl should be used for file redlinks if.
 112   $wgUploadMissingFileUrl is not set. The first was used for this
 113   until the second was introduced in 1.17.
 114 * (bug 25355) Parser generates edit section links for special pages.
 115 * (bug 27894) Move 'editondblclick' event listener down from body to
 116   div#bodyContent.
 117 * (bug 30172) The check for posix_isatty() in maintenance scripts did not detect
 118   when the function exists but is disabled. Introduced
 119   Maintenance::posix_isatty().
 120 * (bug 30264) Changed installer-generated LocalSettings.php to use
 121   require_once() instead require() for included extensions.
 122 * Do not convert text in the user interface language to another script.
 123 * (bug 26283) Previewing user JS/CSS pages didn't load other user JS/CSS pages.
 124 * (bug 11374) Improved diff readability for colorblind people.
 125 * (bug 26486) ResourceLoader modules with paths to nonexistent files cause PHP
 126   warnings/notices to be thrown.
 127 * (bug 30335) Fix for HTMLForms using GET breaking when non-friendly URLs are
 128   used.
 129 * (bug 28649) Avoiding half truncated multi-byte unicode characters when
 130   truncating log comments.
 131 * Show --batch-size option in help of maintenance scripts that support it
 132 * (bug 4381) Magic quotes cleaning was not comprehensive, key strings were not
 133   unescaped.
 134 * (bug 23057) Importers no longer can 'edit' or 'create' a fully-protected page by
 135   importing a new revision into it.
 136 * Allow moving the associated talk pages of subpages even if the base page
 137   has no subpage.
 138 * Per page edit-notices now work in namespaces without subpages enabled.
 139 * (bug 30245) Use the correct way to construct a log page title.
 140 * (bug 31081) $wgEnotifUseJobQ caused many unnecessary jobs to be queued.
 141 * (bug 30202) File names are now restricted on upload to 240 bytes, because of
 142   restrictions on some of the database fields.
 143 * Timezones are now recognised in user preferences when offset is different
 144   due to DST.
 145 * (bug 31692) "summary" parameter now also work when undoing revisions.
 146 * (bug 18823) "move succeeded" text displayed bluelinks even when redirect was
 147    suppressed.
 148 * (bug 31921) Magic words REVISIONDAY, REVISIONMONTH and REVISIONYEAR now give
 149   current values on preview.
 150 * (bug 19186) Special:UserLogin's title on Special:SpecialPages now says
 151   "create account" when the user cannot create an account.
 152 * (bug 31818) 'usercreated' message now supports GENDER.
 153 * (bug 32022) Our phpunit.php script can now be executed from another directory.
 154 * (bug 26020) Setting $wgEmailConfirmToEdit to true no longer removes diffs
 155   from recent changes feeds.
 156 * (bug 30232) add current time to message wlnote on Special:Watchlist.
 157 * (bug 29110) $wgFeedDiffCutoff did not affect new pages.
 158 * (bug 32168) Add wfRemoveDotSegments for use in wfExpandUrl.
 159 * (bug 32358) Do not display "No higher resolution available" for dimensionless
 160   files (like audio files).
 161 * (bug 32168) Add wfAssembleUrl for use in wfExpandUrl.
 162 * (bug 32168) fixed - wfExpandUrl expands dot segments now.
 163 * (bug 31535) Upload comments now truncated properly, and don't have brackets.
 164 * (bug 32858) Do not register links, categories, etc. from CSS/JS pages in the
 165   database.
 166 * (bug 32086) Special:PermanentLink now show an error message when no subpage
 167   was specified.
 168 * (bug 30368) Special:Newpages now shows the new page name for moved pages.
 169 * (bug 1697) The way to search blocked usernames in block log should be clearer.
 170 * (bug 29747) eAccelerator shared memory caching has been removed since it is
 171   now disabled by default and is buggy. APC, XCache and WinCache are not affected.
 172 * Installer now refuses to install if php was not compiled with Ctype support.
 173 * (bug 29475) Remove "trackback" feature entirely from core.
 174 * (bug 32665) Special:BlockList prefills the username in the input field if
 175   using the Special:BlockList/username URL.
 176 * (bug 27721) Make JavaScript variables wgSeparatorTransformTable and
 177   wgDigitTransformTable depend on page content language so the sort script
 178   sorts correctly more often.
 179 * (bug 32230) Expose wgRedirectedFrom in JavaScript.
 180 * (bug 31212) History tab not collapsed when the screen is narrow
 181 * (bug 15521) Use new section summary when the action of adding a new section
 182   also happens to create the page.
 183 * (bug 32960) Remove EmailAuthenticationTimestamp from database when a
 184   email address is removed.
 185 * (bug 32414) Empty page get a empty bytes attribute in Export/Dump.
 186 * (bug 33101) Viewing a User or User talk of username resembling IP ending
 187   with .xxx causes Internal error
 188 * Warning about undefined index in certain situations when $wgLogRestrictions
 189   causes the first log type requested to be removed but not the others
 190 * Use separate message ('prefixindex-namespace') for title of
 191   Special:PrefixIndex rather then re-using Special:AllPages's allinnamespace
 192
 193 === API changes in 1.19 ===
 194 * (bug 19838) siprop=interwikimap can now use the interwiki cache.
 195 * (bug 29748) Add API search prefix support.
 196 * (bug 29684) Set forgotten parameter types in ApiQueryIWLinks.
 197 * (bug 29685) do not output NULL parentid with list=deletedrevs&drprop=parentid.
 198 * siprop=interwikimap and siprop=languages can use silanguagecode to have
 199   a best effort language name translation. Use CLDR extension for best result.
 200 * (bug 30230) action=expandtemplates should not silently override invalid title
 201   inputs.
 202 * (bug 18634) Create API to fetch MediaWiki's language fallback tree structure.
 203 * (bug 26885) Allow show/hide of account blocks, temporary blocks and single IP
 204   address blocks for list=blocks.
 205 * (bug 30591) Add support to only return keys in ApiAllMessages.
 206 * The API now respects $wgShowHostnames and won't share the hostname in
 207   severedby if it's set to false.
 208 * wlexcludeuser parameter added to ApiFeedWatchlist.
 209 * (bug 7304) Links on redirect pages no longer cause the redirect page to show
 210   up as a redirect to the linked page on Special:Whatlinkshere.
 211 * (bug 32609) API: Move captchaid/captchaword of action=edit from core
 212   to Captcha extension(s).
 213 * Added 'APIGetDescription' hook.
 214 * (bug 32688) Paraminfo for parameter "generator" of the query module shows too
 215   many types.
 216 * (bug 32415) Empty page get no size attribute in API output.
 217 * (bug 31759) Undefined property notice in querypages API.
 218 * (bug 32495) API should allow purge by pageids.
 219 * (bug 33147) API examples should explain what they do.
 220
 221 === Languages updated in 1.19 ===
 222
 223 MediaWiki supports over 350 languages. Many localisations are updated
 224 regularly. Below only new and removed languages are listed, as well as
 225 changes to languages because of Bugzilla reports.
 226
 227 * Canadian English (en-ca) (new).
 228 * Uighur (Latin) (ug-latn) was incorrectly marked as right-to-left language.
 229 * (bug 30217) Make pt-br a fallback of pt.
 230 * (bug 31193) Set fallback language of Assamese from Bengali to English.
 231 * Update date format for dsb and hsb: month names need the genitive.
 232 * (bug 28643) Serbian variant conversion improvements (Nikola Smolenski).
 233 * (bug 29405, bug 30809) Lower diacritics are invisible in titles in Indic
 234   languages Assamese, Bengali, Hindi, Malyalam and Odiya.
 235 * (bug 32826) Titles in indic languages are partially cut.
 236
 237 === Other changes in 1.19 ===
 238 * jquery.mwPrototypes module was renamed to jquery.mwExtension.
 239 * The maintenance script populateSha1.php was renamed to the more concise
 240   populateImageSha1.php
 241 * The Client-IP header is no longer checked for when trying to resolve a client's
 242   real IP address.
 243 * (bug 22096) Although IE5.x and below was already unsupported officially, stylesheets
 244   existing exclusively for IE5.0 and IE5.5 have now been removed (which were in skins
 245   'chick' and 'monobook').
 246 * The constructor for CategoryView has changed, the second parameter is now a
 247   Context source and is required.
 248 * The Title::escape{Local,Full,Canonical}URL methods are deprecated, please use
 249   proper html building methods to escape the normal get{...}URL methods instead.
 250 * The $variant arguments in the Title::get{Local,Full,Link,Canonical}URL methods
 251   have been replaced with a secondary query argument.
 252 * The $variant argument in the hooks for the Title::get{Local,Full,Link,Canonical}URL
 253   methods have been removed, the variant is now part of the $query argument.
 254 * Removed Title::isValidCssJsSubpage(), deprecated since 1.17 in favor of
 255   using Title::isCssJsSubpage() or checking Title::isWrongCaseCssJsPage()
 256
 257 == Compatibility ==
 258
 259 MediaWiki 1.19 requires PHP 5.2.3. PHP 4 is no longer supported.
 260
 261 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
 262 support for them is somewhat less mature. There is experimental support for IBM
 263 DB2 and Microsoft SQL Server.
 264
 265 The supported versions are:
 266
 267 * MySQL 5.0.2 or later
 268 * PostgreSQL 8.3 or later
 269 * SQLite 3
 270 * Oracle 9.0.1 or later
 271
 272 == Upgrading ==
 273
 274 1.19 has several database changes since 1.18, and will not work without schema
 275 updates.
 276
 277 If upgrading from before 1.11, and you are using a wiki as a commons
 278 repository, make sure that it is updated as well. Otherwise, errors may arise
 279 due to database schema changes.
 280
 281 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 282 new database fields are filled with data.
 283
 284 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 285 changes are made, and there is a slightly higher chance that things could
 286 break. Don't forget to always back up your database before upgrading!
 287
 288 See the file UPGRADE for more detailed upgrade instructions.
 289
 290 For notes on 1.18.x and older releases, see HISTORY.
 291
 292 == Online documentation ==
 293
 294 Documentation for both end-users and site administrators is available on
 295 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 296 for pages that explicitly state that their contents are in the public domain):
 297
 298         http://www.mediawiki.org/wiki/Documentation
 299
 300 == Mailing list ==
 301
 302 A mailing list is available for MediaWiki user support and discussion:
 303
 304         http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 305
 306 A low-traffic announcements-only list is also available:
 307
 308         http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 309
 310 It's highly recommended that you sign up for one of these lists if you're
 311 going to run a public MediaWiki, so you can be notified of security fixes.
 312
 313 == IRC help ==
 314
 315 There's usually someone online in #mediawiki on irc.freenode.net.