RELEASE-NOTES

   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.18 ==
   7
   8 THIS IS NOT A RELEASE YET
   9
  10 MediaWiki is now using a "continuous integration" development model with
  11 quarterly snapshot releases. The latest development code is always kept
  12 "ready to run", and in fact runs our own sites on Wikipedia.
  13
  14 Release branches will continue to receive security updates for about a year
  15 from first release, but nonessential bugfixes and feature developments
  16 will be made on the development trunk and appear in the next quarterly release.
  17
  18 Those wishing to use the latest code instead of a branch release can obtain
  19 it from source control: http://www.mediawiki.org/wiki/Download_from_SVN
  20
  21 === PHP 5.2 now required ==
  22 In 1.18, the lowest supported version of MediaWiki is now 5.2.x. Please upgrade
  23 PHP if you have not done so prior to upgrading MediaWiki.
  24
  25 === Configuration changes in 1.18 ===
  26 * The WantedPages::getSQL hook has been removed and replaced with
  27   WantedPages::getQueryInfo . This may break older extensions.
  28 * $wgUseCombinedLoginLink controls whether to output a combined
  29   login / create account link in the personal bar, or to output separate login
  30   and create account links
  31 * Skin names are no longer created based on a ucfirst version of the key in
  32   $wgValidSkinNames but now the value. This means for
  33   $wgValidSkinNames["monobook"] = "MonoBook"; the skin loader will no longer try
  34   loading SkinMonobook and will instead load SkinMonoBook.
  35 * The parser now attempts to output markers for editsection tokens and defer the
  36   rendering of them so skin and language specific markup does not need to be
  37   saved inside the parser cache note that this changes the cache key making all
  38   old entries in the parser cache invalid you can set $wgUseEditSectionTokens to
  39   false to disable this and keep your old parser cache entries.
  40   Note that this feature should reduce parser cache fragmentation when enabled.
  41 * $wgMaxUploadSize may now be set to an array to specify the upload size limit
  42   per upload type.
  43 * $wgAPICacheHelp added in 1.16 is now removed. To disable API help caching, set
  44   $wgAPICacheHelpTimeout = 0;
  45 * OutputPage::isUserJsAllowed() no longer returns false when scripts are allowed
  46   by the page, but $wgAllowUserJs is set to false.
  47 * Pure "Skin" class based custom skins are no longer supported, all custom skins
  48   should be put together using SkinTemplate and BaseTemplate or QuickTemplate.
  49 * The transliteration for passwords in case they were migrated from an old Latin-1
  50   install (previous to MediaWiki 1.5) is now only done for wikis with
  51   $wgLegacyEncoding set.
  52 * (bug 27508) Add $wgSVGMetadataCutoff to limit the maximum amount of an svg we
  53   look at when finding metadata to prevent excessive resource usage.
  54
  55 === New features in 1.18 ===
  56 * Added a special page, disabled by default, that allows users with the
  57   'disableaccount' privilege to permanently deactivate user accounts.
  58 * (bug 8130) Query pages should limit to content namespaces, not just main
  59   namespace
  60 * Search suggestions (other than in the Vector skin) will now use the HTML5
  61   datalist feature where supported, currently only Firefox 4.
  62 * Special:Contribs now redirects to Special:Contributions
  63 * (bug 6672) Images are now autorotated according to their EXIF orientation.
  64   This only affects thumbnails; the source remains unrotated.
  65 * (bug 25708) Update case mappings and normalization to Unicode 6.0.0
  66 * New hook ArticlePrepareTextForEdit added, called when preparing text to be
  67   saved.
  68 * New parser option PreSaveTransform added, allows the pre-save transformation
  69   to be selectively disabled.
  70 * Alternative to $wgHooks implemented, using the new Hooks class.
  71 * Add width parameter to Special:Filepath to allow getting the file path of a
  72   thumbnail.
  73 * (bug 26870) Add size to {{filepath:}}
  74 * Upload warnings now show a thumbnail of the uploaded file
  75 * Introduced the edittools-upload message, which will be inserted under the
  76   upload form instead of edittools if available
  77 * (bug 26285) Extensions will be automatically generated on upload if the user
  78   specified a filename without extension.
  79 * (bug 26851) Special:UserRights now allows to prefill the reason field
  80 * New maintenance script to fix double redirects
  81   (maintenance/fixDoubleRedirects.php)
  82 * (bug 23315) New body classes to allow easier styling of special pages
  83 * (bug 27159) Make email confirmation code expiration time configurable
  84 * CSS/JS for each user group is imported from MediaWiki:Sysop.js,
  85   MediaWiki:Autoconfirmed.css, etc.
  86 * (bug 24230) Uploads of ZIP types, such as MS Office or OpenOffice can now be
  87   safely enabled. A ZIP file reader was added which can scan a ZIP file for
  88   potentially dangerous Java applets. This allows applets to be blocked
  89   specifically, rather than all ZIP files being blocked.
  90 * (bug 2429) Allow selection of associated namespace in recent changes
  91 * (bug 26217) File size is now checked before uploading in HTML5 browsers
  92 * CSS stylesheet MediaWiki:Noscript.css is now loaded for users with JavaScript
  93   disabled (enclosed in the head in a <noscript> tag)
  94
  95 === Bug fixes in 1.18 ===
  96 * (bug 23119) WikiError class and subclasses are now marked as deprecated
  97 * (bug 10871) Javascript and CSS pages in MediaWiki namespace are no longer
  98   treated as wikitext on preview.
  99 * (bug 22753) Output from update.php is more clear when things changed, entries
 100   indicating nothing changed are now all prefixed by "..."
 101 * Page existence is now not revealed (in the colour of the tabs) to users who
 102   cannot read the page in question.
 103 * (bug 19006) {{REVISIONUSER}} no longer acts like {{CURRENTUSER}} in some cases
 104 * (bug 16019) $wgArticlePath = "/$1" no longer breaks API edit/watch actions
 105 * (bug 18372) File types blacklisted by $wgFileBlacklist will no longer be shown
 106   as "Permitted file types" on the upload form
 107 * (bug 26379) importImages.php gives more descriptive error message on failure.
 108 * (bug 26410) + signs are no longer treated as spaces in internal links if
 109   link has a % sign in it.
 110 * (bug 26412) Search results headers no longer show a bogus edit link.
 111 * (bug 26540) Fixed wrong call to applyPatch in MysqlUpdater
 112 * (bug 26574) Added 'upload' to $wgRestrictionTypes, allowing upload protected
 113   pages to be queried via the API and Special:ProtectedPages, and allowing
 114   disabling upload protection by removing it from $wgRestrictionTypes.
 115 * If an edit summary exceeds 250 bytes and is truncated, add an ellipse
 116 * (bug 26638) Database error pages display correctly in RTL languages
 117 * (bug 26187) Confirmrecreate no longer parses the edit summary
 118 * (bug 25506) Exception is thrown if OutputPage::parse is called inside a tag
 119   hook, which would reset parser state
 120 * (bug 26208) Mark directionality of some interlanguage links
 121 * (bug 26034) Make the "View / Read" tab in content_navigation style tabs remain
 122   selected when the action is "purge".
 123 * (bug 14267) Support a MediaWiki:Mainpage-nstab override for the subject
 124   namespace tab on the mainpage of a wiki.
 125 * (bug 10158) Do not mention allowing others to contact you when the feature
 126   is disabled ($wgEnableUserEmail=false)
 127 * (bug 26733) Wrap initial table creation in transaction
 128 * (bug 26729) Category pages should return 404 if they do not exist and have no
 129   members.
 130 * (bug 2585) Image pages should send 404 if no image, no shared image and no
 131   description page.
 132 * Custom editintro's using the editintro url parameter will no longer show
 133   <noinclude> sections on pages they are included on.
 134 * (bug 26449) Keep underlines from headings outside of tables and thumbs by
 135   adding overflow:hidden to h1,h2,h3,h4,h5,h6 (also fixes editsection bunching).
 136 * (bug 26708) Remove background-color:white from tables in Monobook and Vector.
 137 * (bug 26781) {{PAGENAME}} and related parser functions escape their output
 138   better.
 139 * (bug 26716) Provide link to instructions for external editor related
 140   preferences and add a comment to the ini control file explaining what is
 141   going on.
 142 * Trying to upload a file with no extension or with a disallowed MIME type now
 143   gives the right message instead of complaining about a MIME/extension mismatch
 144 * (bug 26809) Uploading files with multiple extensions where one of the
 145   extensions is blacklisted now gives the proper extension in the error message.
 146 * (bug 26961) Hide anon edits in watchlist preference now actually works.
 147 * (bug 19751) Filesystem is now checked during image undeletion
 148 * Send last modified headers for Special:Recentchanges when RC patrol is
 149   enabled, but user cannot see rc patrol links.
 150 * (bug 26548) ForeignAPIRepo (InstantCommons) now works with PDF files
 151   and other multi-paged file formats.
 152 * Files with a mime type that does not match the extension are now properly
 153   thumbnailed
 154 * (bug 27201) Special:WhatLinksHere output no longer contains duplicate IDs
 155 * (bug 15905) Nostalgia skin could become more usable by including a Talk:
 156   link at the top of the page
 157 * (bug 27560) Search queries no longer fail in walloon language
 158 * (bug 27679) Broken embedded files with special characters are no longer
 159   double HTML escaped
 160 * (bug 27700) The upload protection can now also be set for files that do not
 161   exist.
 162 * (bug 27763) Article::getParserOutput() no longer throws a fatal given when an
 163   incorrect revision ID is passed.
 164 * Trim the form field for uploading by url to remove extra spaces which could
 165   cause confusing error messages.
 166 * (bug 27854) Http::isValidURI is way too lax.
 167 * Do not show enotifminoredits preference, if disabled by $wgEnotifMinorEdits.
 168 * AbortLogin returning "ABORTED" now handled.  Also allows message identifier
 169   for "ABORTED" reason to be returned and displayed to user.
 170
 171 === API changes in 1.18 ===
 172 * (bug 26339) Throw warning when truncating an overlarge API result
 173 * (bug 14869) Add API module for accessing QueryPage-based special pages
 174 * (bug 14020) API for Special:Unwatchedpages
 175 * (bug 24287) Wrap API Help output at 100 characters
 176 * Add a realname uiprop option to query=userinfo so a user's realname can be
 177   extracted
 178 * Add a &watchuser option to ApiBlock
 179 * (bug 26541) Generator-ise ApiQueryRecentChanges
 180 * action=parse now correctly returns an error for nonexistent pages
 181 * (bug 25767) Add userrights properties to allusers and users query lists
 182 * (bug 26558) list=allusers auprop=groups does not list groups a user is
 183   automatically a member of
 184 * (bug 26559) list=allusers auprop=rights does not match
 185   list=users usprop=rights
 186 * (bug 26560) On allusers if limit < total number of users, last user gets
 187   duplicate
 188 * (bug 25135) add "normalized" to action=parse
 189 * (bug 26460) Add support for listing category members by category pageid
 190 * (bug 26482) add a imimages param to prop=images
 191 * (bug 26498) allow LinksUpdate with API
 192 * (bug 26485) add a elextlinks param to prop=extlinks
 193 * (bug 26483) add a iwtitles param to prop=iwlinks
 194 * (bug 26484) add a lltitles param to prop=langlinks
 195 * (bug 26480) add a pppageprops param to prop=pageprops
 196 * (bug 26650) Remove $wgAPICacheHelp in favour of $wgAPICacheHelpTimeout
 197 * (bug 24650) Fix API to work with categorylinks changes
 198 * Expose list of skins in meta=siteinfo
 199 * (bug 26548) Add iiurlparam param to query=imageinfo and query=stashimageinfo
 200 * (bug 27205) aiprop=metadata and aiprop=parsedcomment need help text
 201 * Add a amtitle param to meta=allmessages
 202 * (bug 25832) query=allimages now outputs ns/title as well
 203 * (bug 27199) Thumbnail urls can be fetched for old files as well
 204 * (bug 27376) when using ApiBase::PARAM_TYPE => 'integer' without a min or
 205   max value, api doesn't validate the input is actually an integer
 206 * (bug 27479) API error when using both prop=pageprops and
 207   prop=info&inprop=displaytitle
 208 * (bug 27554) Update api information text to reflect change in bug 26125
 209 * (bug 27611) list=blocks: Use ipb_by_text instead of join with user table
 210 * (bug 27616) Add userid of blocked user and blocker to list=blocks
 211 * (bug 27688) Simplify queries to list user block information
 212 * (bug 27708) list=users does not have a property to return user id
 213 * (bug 27715) imageinfo didn't respect revdelete
 214 * (bug 27862) Useremail module didn't properly return success on success.
 215 * (bug 27590) prop=imageinfo now allows querying the media type
 216 * (bug 27587) list=filearchive now outputs full title info
 217 (bug 27018) Added action=filerevert to revert files to an old version
 218
 219 === Languages updated in 1.18 ===
 220
 221 MediaWiki supports over 330 languages. Many localisations are updated
 222 regularly. Below only new and removed languages are listed, as well as
 223 changes to languages because of Bugzilla reports.
 224
 225 * Liv (liv) (new)
 226
 227 * (bug 17160) Gender specific display text for User namespace
 228 * Link trail added for sl and sh
 229 * (bug 27633) Add characters to linkTrail for Potuguese (pt and pt-br)
 230 * (bug 27426) Set $namespaceGenderAliases for Arabic (ar)
 231 * (bug 27385) Set Polish $namespaceGenderAliases
 232 * (bug 27681) Set $namespaceGenderAliases for Portuguese (pt and pt-br)
 233 * (bug 27785) Fallback language for Kabardian (kbd) is English now.
 234 * (bug 27825) Raw watchlist edit message now uses formatted numbers.
 235
 236 == Compatibility ==
 237
 238 MediaWiki 1.18 requires PHP 5.1 (5.2 recommended). PHP 4 is no longer
 239 supported.
 240
 241 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
 242 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
 243
 244
 245 == Upgrading ==
 246
 247 1.18 has several database changes since 1.17, and will not work without schema
 248 updates.
 249
 250 If upgrading from before 1.11, and you are using a wiki as a commons reposito-
 251 ry, make sure that it is updated as well. Otherwise, errors may arise due to
 252 database schema changes.
 253
 254 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 255 new database fields are filled with data.
 256
 257 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 258 changes are made, and there is a slightly higher chance that things could
 259 break. Don't forget to always back up your database before upgrading!
 260
 261 See the file UPGRADE for more detailed upgrade instructions.
 262
 263
 264 === Caveats ===
 265
 266 Some output, particularly involving user-supplied inline HTML, may not
 267 produce 100% valid or well-formed XHTML output. Testers are welcome to
 268 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 269 cases, but this is not recommended on live sites. (This must be set for
 270 MathML to display properly in Mozilla.)
 271
 272 For notes on 1.17.x and older releases, see HISTORY.
 273
 274
 275 === Online documentation ===
 276
 277 Documentation for both end-users and site administrators is currently being
 278 built up on MediaWiki.org, and is covered under the GNU Free Documentation
 279 License (except for pages that explicitly state that their contents are in
 280 the public domain) :
 281
 282         http://www.mediawiki.org/wiki/Documentation
 283
 284
 285 === Mailing list ===
 286
 287 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 288 wikitech-l list:
 289
 290         http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 291
 292 A low-traffic announcements-only list is also available:
 293
 294         http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 295
 296 It's highly recommended that you sign up for one of these lists if you're
 297 going to run a public MediaWiki, so you can be notified of security fixes.
 298
 299
 300 === IRC help ===
 301
 302 There's usually someone online in #mediawiki on irc.freenode.net