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.17 ==
   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 === Configuration changes in 1.17 ===
  22 * DatabaseFunctions.php that was needed for compatibility with pre-1.3
  23   extensions has been removed.
  24 * $wgLogAutocreatedAccounts controls whether autocreation of accounts is logged
  25   to new users log.
  26 * $wgAllowImageTag can be set to true to whitelist the <img> tag in wikitext.
  27
  28 === New features in 1.17 ===
  29 * (bug 10183) Users can now add personal styles and scripts to all skins via
  30   User:<name>/common.css and /common.js (if user css/js is enabled)
  31 * (bug 22748) Add anchors on Special:ListGroupRights
  32 * (bug 21981) Add parameter 'showfilename' to <gallery> to automatically apply
  33   the names of the individual files within the gallery
  34 * (bug 12797) Add $wgGalleryOptions for adjusting of default gallery display
  35   options
  36 * $wgAllowUserCssPrefs option allows disabling CSS-based preferences; which can
  37   improve page loading speed.
  38 * Future-proof redirection to fragments in Gecko, so things work a little nicer
  39   if they fix <https://bugzilla.mozilla.org/show_bug.cgi?id=516293>.
  40 * Support git:// and mms:// protocols by default for external links
  41 * (bug 15810) Blocked admins can no longer unblock themselves without the
  42   'unblockself' permission (which they have by default)
  43 * (bug 18499) Added "enhanced" URL parameter to switch between old and enhanced
  44   changes list
  45 * (bug 22925) "sp-contributions-blocked-notice-anon" message now displayed when
  46   viewing contributions of a blocked IP address
  47 * (bug 22474) {{urlencode:}} now takes an optional second paramter for type of
  48   escaping.
  49 * Special:Listfiles now supports a username parameter
  50 * Special:Random carries over query string parameters
  51 * (bug 23206) Add Special::Search hook for detecting successful "Go"
  52 * When visiting a "red link" of a deleted file, a deletion and move log excerpt
  53   is provided on the Upload form.
  54 * (bug 22647) Add category details in search results.
  55 * (bug 23276) Add hook to Special:NewPages to modify query
  56 * Add accesskey 's' and tooltip to 'Save' button at Special:Preferences
  57 * Add accesskey 'b' and tooltip to the summary field of edit mode
  58 * (bug 20186) Allow filtering Special:Contributions for RevisionDeleted edits
  59 * (bug 22858) $wgLocalStylePath is by default set to the same value as
  60   $wgStylePath but should never point to a different domain than the site is
  61   on, allowing skins to use .htc files which are not cross-domain friendly.
  62 * ajaxwatch now uses the API and JQuery, and can be used to animate arbitrary
  63   watch links, not just to watch the page the link is on.
  64 * (bug 20193) Added $wgVectorShowVariantName global configuration variable
  65   which causes Vector to render the variants drop-down menu with a label
  66   showing the current variant name. This is off by default, pending further
  67   research into its user experience implications.
  68 * (bug 20976) "searchmenu-new-nocreate" message now displayed when when there
  69   is no title match in search and the user has no rights to create pages.
  70 * Added $wgJQueryVersion, $wgJQueryMinified and $wgJQueryOnEveryPage (true by
  71   default) to configure loading of jQuery by MediaWiki
  72 * (bug 23429) Added new hook WatchlistEditorBuildRemoveLine
  73
  74 === Bug fixes in 1.17 ===
  75 * (bug 17560) Half-broken deletion moved image files to deletion archive
  76   without updating database
  77 * (bug 22666) Submitting user block form with an invalid user name no longer
  78   throws an error
  79 * (bugs 22665 and 22667) User '0' can now be unblocked and have its block
  80   settings changed
  81 * (bug 22606) The body of e-mail address confirmation message is now different
  82   when the address changed
  83 * (bug 22664) Special:Userrights now accepts '0' as a valid user name
  84 * (bug 5210) preload parser now parses <noinclude>, <includeonly> and redirects
  85 * (bug 22709) IIS7 mishandles redirects generated by OutputPage::output() when
  86   the URL contains a colon.
  87 * (bug 22353) Categorised recent changes now works again
  88 * (bug 22747) "Reveal my e-mail address in notification e-mails" preference is
  89   now only displayed when relevant
  90 * (bug 22772) {{#special:}} parser function now works with subpages
  91 * (bug 18664) Relative URIs in interwiki links cause failed redirects
  92 * (bug 19270) Relative URIs in interwiki links break interwiki transclusion
  93 * (bug 22903) Revdelete log entries now show in the user preferred language.
  94 * (bug 22905) Correctly handle <abbr> followed by ISBN
  95 * (bug 22940) Namespace aliases pointing to main namespace don't work
  96 * (bug 15810) Blocked admins can no longer block/unblock other users
  97 * (bug 22876) Avoid possible PHP Notice if $wgDefaultUserOptions is not
  98   correctly set
  99 * (bug 14952) Page titles are renormalized after html entities are removed so
 100   that links with non-NFC character references work correctly.
 101 * (bug 22991) wgUserGroups JavaScript variable now reports * group for
 102   anonymous users instead of null.
 103 * (bug 22627) Remove PHP notice when deleting a page only hidden users edited.
 104 * (bug 21520) Anonymous previews now also gives a warning about not being
 105   logged in (anonpreviewwarning).
 106 * (bug 22935) image/x-ms-bmp mime type added for BMP files
 107 * (bug 23024) Special:ListFiles now escapes file names correctly
 108 * (bug 22867) "View source" tab is now only displayed if there's source text
 109 * (bug 19393) Feeds now format dates in user language rather than content
 110   language
 111 * (bug 22852) "Served in" comment is now the time used to cache a single page
 112   when using rebuildFileCache.php
 113 * (bug 22496) Viewing diff of a redirect page without specifying "oldid"
 114   parameter no longer makes the page displayed as being the redirect target
 115 * (bug 22918) Feed cache keys now use $wgRenderHashAppend
 116 * (bug 21916) Last-Modified header is now correct when outputting cached feed
 117 * (bug 20049) Fixed PHP notice in search highlighter that occurs in some cases
 118 * (bug 23017) Special:Disambiguations now list pages in content namespaces
 119   rather than only main namespace
 120 * (bug 23063) $wgMaxAnimatedGifArea is checked against the total size of all
 121   frames, and $wgMaxImageArea against the size of the first frame, rather than
 122   the other way around.  Both now default to 12.5 megapixels.  Also, images
 123   exceeding $wgMaxImageArea can still be embedded at original size
 124 * (bug 23078) "All public logs" option on Special:Log is now always the first
 125   item
 126 * (bug 16817) Group names in user rights log are now singular and in lowercase
 127 * Special:Preferences no longer crashes if the wiki default date formatting
 128   style is not valid for the user's interface language
 129 * (bug 23167) Check the watch checkbox by default if the watchcreations
 130   preference is set
 131 * Maintenance script cleanupTitles is now able to fix titles stored
 132 in a negative namespace (which is invalid).
 133 * (bug 19858) Removed obsolete <big> in interface messages.
 134 * (bug 21456) "Bad title" error when showing non-local interwiki pages no longer
 135   displays incorrect tabs
 136 * (bug 23190) Improved math representation for text browsers.
 137 * (bug 22015) Improved upload-by-url error handling and error display
 138 * (bug 17941) $wgMaxUploadSize is now honored by all upload sources
 139 * (bug 23080) New usernames now limited to 235 bytes so that custom skin files
 140   work.
 141 * (bug 23075) Correct MediaTransformError default width in gallery.
 142 * (bug 16487) The Anonymous user account used on Postgres is no longer
 143   displayed on Special:Listusers.
 144 * (bug 23313) Move watchlisthidepatrolled above token in watchlist preferences
 145   to enhance preference grouping.
 146 * (bug 23298) Interwiki links with prefix only in log summaries now link to the
 147   correct link
 148 * (bug 23284) Times are now rounded correctly
 149 * (bug 23375) Added ogv, oga, spx as extensions for ogg files
 150 * (bug 18408) All required permissions for uploading (upload, edit, create)
 151   are now checked when loading Special:Upload. Toolbar link for Special:Upload
 152   is no longer shown if the user does not have the required permissions.
 153 * (Bug 23397) texvc in html mode renders \sim as &tilde; not &sim;
 154 * (Bug 23241) Remove License selector, because it is not used when uploading a
 155   new version.
 156 * (bug 23240) Add ID to namespace selector form on Special:Watchlist
 157 * The pipe | character in urls is now escaped.
 158 * (bug 23422) mp3 files can now be moved
 159 * (bug 23448) MediaWiki:Summary-preview is now displayed instead of
 160   MediaWiki:Subject-preview when previewing summary
 161
 162 === API changes in 1.17 ===
 163 * (bug 22738) Allow filtering by action type on query=logevent
 164 * (bug 22764) uselang parameter for action=parse
 165 * (bug 22944) API: watchlist options are inconsistent
 166 * (bug 22339) "Go" result should be available through the API
 167 * (bug 22868) don't list infinite block expiry date as "now" in API logevents
 168 * (bug 22290) prop=revisions now outputs "comment" field even when comment
 169   is empty, for consistency with list=recentchanges
 170 * (bug 19721) API action=help should have a way to just list for a specific module
 171
 172 === Languages updated in 1.17 ===
 173
 174 MediaWiki supports over 330 languages. Many localisations are updated
 175 regularly. Below only new and removed languages are listed, as well as
 176 changes to languages because of MediaZilla reports.
 177
 178 * Latgalian (ltg) (new)
 179 * Rusyn (rue) (new)
 180
 181 * (bug 23156) Commafy and search normalization updated for Belarusian
 182   (Taraškievica)
 183 * (bug 23283) Native name for Old English -> Ænglisc
 184 * (bug 23364) Native name for Azerbaijani -> Azərbaycanca
 185
 186 == Compatibility ==
 187
 188 MediaWiki 1.17 requires PHP 5.1 (5.2 recommended). PHP 4 is no longer
 189 supported.
 190
 191 MySQL 3.23.x is no longer supported; some older hosts may need to upgrade.
 192 At this time we still recommend 4.0, but 4.1/5.0 will work fine in most cases.
 193
 194
 195 == Upgrading ==
 196
 197 1.17 has several database changes since 1.16, and will not work without schema
 198 updates.
 199
 200 If upgrading from before 1.11, and you are using a wiki as a commons reposito-
 201 ry, make sure that it is updated as well. Otherwise, errors may arise due to
 202 database schema changes.
 203
 204 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 205 new database fields are filled with data.
 206
 207 If you are upgrading from MediaWiki 1.4.x or earlier, some major database
 208 changes are made, and there is a slightly higher chance that things could
 209 break. Don't forget to always back up your database before upgrading!
 210
 211 See the file UPGRADE for more detailed upgrade instructions.
 212
 213
 214 === Caveats ===
 215
 216 Some output, particularly involving user-supplied inline HTML, may not
 217 produce 100% valid or well-formed XHTML output. Testers are welcome to
 218 set $wgMimeType = "application/xhtml+xml"; to test for remaining problem
 219 cases, but this is not recommended on live sites. (This must be set for
 220 MathML to display properly in Mozilla.)
 221
 222 For notes on 1.16.x and older releases, see HISTORY.
 223
 224
 225 === Online documentation ===
 226
 227 Documentation for both end-users and site administrators is currently being
 228 built up on MediaWiki.org, and is covered under the GNU Free Documentation
 229 License (except for pages that explicitly state that their contents are in
 230 the public domain) :
 231
 232   http://www.mediawiki.org/wiki/Documentation
 233
 234
 235 === Mailing list ===
 236
 237 A MediaWiki-l mailing list has been set up distinct from the Wikipedia
 238 wikitech-l list:
 239
 240   http://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 241
 242 A low-traffic announcements-only list is also available:
 243
 244   http://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 245
 246 It's highly recommended that you sign up for one of these lists if you're
 247 going to run a public MediaWiki, so you can be notified of security fixes.
 248
 249
 250 === IRC help ===
 251
 252 There's usually someone online in #mediawiki on irc.freenode.net