RELEASE-NOTES-1.25

   1 Security reminder: If you have PHP's register_globals option set, you must
   2 turn it off. MediaWiki will not work with it enabled.
   3
   4 == MediaWiki 1.25 ==
   5
   6 THIS IS NOT A RELEASE YET
   7
   8 MediaWiki 1.25 is an alpha-quality branch and is not recommended for use in
   9 production.
  10
  11 === Configuration changes in 1.25 ===
  12
  13 === New features in 1.25 ===
  14
  15 === Bug fixes in 1.25 ===
  16
  17 === Action API changes in 1.25 ===
  18 * (bug 65403) XML tag highlighting is now only performed for formats
  19   "xmlfm" and "wddxfm".
  20 * action=paraminfo supports generalized submodules (modules=query+value),
  21   querymodules and formatmodules are deprecated
  22 * action=paraminfo no longer outputs descriptions and other help text by
  23   default. If needed, it may be requested using the new 'helpformat' parameter.
  24 * action=help has been completely rewritten, and outputs help in HTML
  25   rather than plain text.
  26 * Hitting api.php without specifying an action now displays only the help for
  27   the main module, with links to submodule help.
  28 * API help is no longer displayed on errors.
  29 * Internationalized messages returned by the API will be in the wiki's content
  30   language by default. 'uselang' is now a recognized API parameter;
  31   "uselang=user" may be used to select the language from the current user's
  32   preferences.
  33
  34 === Action API internal changes in 1.25 ===
  35 * ApiHelp has been rewritten to support i18n and paginated HTML output.
  36   Most existing modules should continue working without changes, but should do
  37   the following:
  38   * Add an i18n message "apihelp-{$moduleName}-description" to replace getDescription().
  39   * Add i18n messages "apihelp-{$moduleName}-param-{$param}" for each parameter
  40     to replace getParamDescription(). If necessary, the settings array returned
  41     by getParams() can use the new ApiBase::PARAM_HELP_MSG key to override the
  42     message.
  43   * Implement getExamplesMessages() to replace getExamples().
  44 * Modules with submodules (like action=query) must have their submodules
  45   override ApiBase::getParent() to return the correct parent object.
  46 * The 'APIGetDescription' and 'APIGetParamDescription' hooks are deprecated,
  47   and will have no effect for modules using i18n messages. Use
  48   'APIGetDescriptionMessages' and 'APIGetParamDescriptionMessages' instead.
  49 * Api formatters will no longer be asked to display the help screen on errors.
  50 * ApiMain::getCredits() was removed. The credits are available in the
  51   'api-credits' i18n message.
  52 * The following methods have been deprecated and may be removed in a future
  53   release:
  54   * ApiBase::getDescription
  55   * ApiBase::getParamDescription
  56   * ApiBase::getExamples
  57   * ApiBase::makeHelpMsg
  58   * ApiBase::makeHelpArrayToString
  59   * ApiBase::makeHelpMsgParameters
  60   * ApiFormatBase::setUnescapeAmps
  61   * ApiFormatBase::getWantsHelp
  62   * ApiFormatBase::setHelp
  63   * ApiMain::setHelp
  64   * ApiMain::reallyMakeHelpMsg
  65   * ApiMain::makeHelpMsgHeader
  66
  67 === Languages updated in 1.25 ===
  68
  69 MediaWiki supports over 350 languages. Many localisations are updated
  70 regularly. Below only new and removed languages are listed, as well as
  71 changes to languages because of Bugzilla reports.
  72
  73 === Other changes in 1.25 ===
  74 * The skin autodiscovery mechanism, deprecated in MediaWiki 1.23, has been
  75   removed. See https://www.mediawiki.org/wiki/Manual:Skin_autodiscovery for
  76   migration guide for creators and users of custom skins that relied on it.
  77 * Javascript variable 'wgFileCanRotate' now only available on Special:Upload.
  78 * (bug 56257) Set site logo url in ResourceLoaderSiteModule instead of inline
  79   styles in the HTML output.
  80
  81 == Compatibility ==
  82
  83 MediaWiki 1.25 requires PHP 5.3.2 or later. There is experimental support for
  84 HHVM 3.3.0.
  85
  86 MySQL is the recommended DBMS. PostgreSQL or SQLite can also be used, but
  87 support for them is somewhat less mature. There is experimental support for
  88 Oracle and Microsoft SQL Server.
  89
  90 The supported versions are:
  91
  92 * MySQL 5.0.2 or later
  93 * PostgreSQL 8.3 or later
  94 * SQLite 3.3.7 or later
  95 * Oracle 9.0.1 or later
  96 * Microsoft SQL Server 2005 (9.00.1399)
  97
  98 == Upgrading ==
  99
 100 1.25 has several database changes since 1.24, and will not work without schema
 101 updates. Note that due to changes to some very large tables like the revision
 102 table, the schema update may take quite long (minutes on a medium sized site,
 103 many hours on a large site).
 104
 105 If upgrading from before 1.11, and you are using a wiki as a commons
 106 repository, make sure that it is updated as well. Otherwise, errors may arise
 107 due to database schema changes.
 108
 109 If upgrading from before 1.7, you may want to run refreshLinks.php to ensure
 110 new database fields are filled with data.
 111
 112 If you are upgrading from MediaWiki 1.4.x or earlier, you should upgrade to
 113 1.5 first. The upgrade script maintenance/upgrade1_5.php has been removed
 114 with MediaWiki 1.21.
 115
 116 Don't forget to always back up your database before upgrading!
 117
 118 See the file UPGRADE for more detailed upgrade instructions.
 119
 120 For notes on 1.23.x and older releases, see HISTORY.
 121
 122 == Online documentation ==
 123
 124 Documentation for both end-users and site administrators is available on
 125 MediaWiki.org, and is covered under the GNU Free Documentation License (except
 126 for pages that explicitly state that their contents are in the public domain):
 127
 128         https://www.mediawiki.org/wiki/Documentation
 129
 130 == Mailing list ==
 131
 132 A mailing list is available for MediaWiki user support and discussion:
 133
 134         https://lists.wikimedia.org/mailman/listinfo/mediawiki-l
 135
 136 A low-traffic announcements-only list is also available:
 137
 138         https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce
 139
 140 It's highly recommended that you sign up for one of these lists if you're
 141 going to run a public MediaWiki, so you can be notified of security fixes.
 142
 143 == IRC help ==
 144
 145 There's usually someone online in #mediawiki on irc.freenode.net.