Add support for a second argument to wfDeprecated so we can start using it right...
[lhc/web/wiklou.git] / includes / DefaultSettings.php
index 240ec13..c407aff 100644 (file)
@@ -39,19 +39,31 @@ $wgVersion = '1.19alpha';
 $wgSitename         = 'MediaWiki';
 
 /**
- * URL of the server. It will be automatically built including https mode.
+ * URL of the server.
  *
  * Example:
  * <code>
- * $wgServer = http://example.com
+ * $wgServer = 'http://example.com';
  * </code>
  *
  * This is usually detected correctly by MediaWiki. If MediaWiki detects the
  * wrong server, it will redirect incorrectly after you save a page. In that
  * case, set this variable to fix it.
+ *
+ * If you want to use protocol-relative URLs on your wiki, set this to a
+ * protocol-relative URL like '//example.com' and set $wgCanonicalServer
+ * to a fully qualified URL.
  */
 $wgServer = WebRequest::detectServer();
 
+/**
+ * Canonical URL of the server, to use in IRC feeds and notification e-mails.
+ * Must be fully qualified, even if $wgServer is protocol-relative.
+ *
+ * Defaults to $wgServer, expanded to a fully qualified http:// URL if needed.
+ */
+$wgCanonicalServer = false;
+
 /************************************************************************//**
  * @name   Script path settings
  * @{
@@ -120,6 +132,7 @@ $wgRedirectScript   = false;
  */
 $wgLoadScript           = false;
 
+
 /**@}*/
 
 /************************************************************************//**
@@ -1740,9 +1753,9 @@ $wgUseESI = false;
 $wgUseXVO = false;
 
 /** Add X-Forwarded-Proto to the Vary and X-Vary-Options headers for API
- * requests. Use this if you have an SSL termination setup and want to split
- * the cache between HTTP and HTTPS for API requests. This does not affect
- * 'regular' requests.
+ * requests and RSS/Atom feeds. Use this if you have an SSL termination setup
+ * and need to split the cache between HTTP and HTTPS for API and feed requests
+ * in order to prevent cache pollution. This does not affect 'normal' requests.
  */
 $wgVaryOnXFPForAPI = false;
 
@@ -1840,20 +1853,24 @@ $wgExtraLanguageNames = array();
 
 /**
  * List of language codes that don't correspond to an actual language.
- * These codes are leftoffs from renames, or other legacy things.
- * Also, qqq is a dummy "language" for documenting messages.
+ * These codes are mostly leftoffs from renames, or other legacy things.
+ * This array makes them not appear as a selectable language on the installer,
+ * and excludes them when running the transstat.php script.
  */
 $wgDummyLanguageCodes = array(
-       'als',
-       'bat-smg',
-       'be-x-old',
-       'fiu-vro',
-       'iu',
-       'nb',
-       'qqq',
-       'qqx',
-       'roa-rup',
-       'simple',
+       'als',          # => 'gsw'
+       'bat-smg',      # => 'sgs'
+       'be-x-old',     # => 'be-tarask'
+       'bh',           # => 'bho'
+       'fiu-vro',      # => 'vro'
+       'nb',           # => 'no'
+       'qqq',          # Used for message documentation.
+       'qqx',          # Used for viewing message keys.
+       'roa-rup',      # => 'rup'
+       'simple',       # => 'en'
+       'zh-classical', # => 'lzh'
+       'zh-min-nan',   # => 'nan'
+       'zh-yue',       # => 'yue'
 );
 
 /**
@@ -2970,12 +2987,34 @@ $wgExpensiveParserFunctionLimit = 100;
 $wgPreprocessorCacheThreshold = 1000;
 
 /**
- * Enable interwiki transcluding.  Only when iw_trans=1.
+ * Enable interwiki transcluding.  Only when iw_trans=1 in the interwiki table.
+ * If the interwiki prefix is associated with a wiki ID in the interwiki table,
+ * then the distant templates will be retrieved in the distant DB. If there is
+ * no wiki ID but a API URL for that prefix, the distant templates will be
+ * retrieved using the API and cached in memcached.
+ */
+$wgEnableInterwikiTranscluding = false;
+
+/**
+ * If $wgEnableInterwikiTranscluding is set to true and if an interwiki prefix
+ * is associated with a wiki ID, then, this option should be set to true to
+ * enable the cache invalidation of the distant pages when the local templates
+ * are edited and also to display the list of the distant templates used by
+ * the local pages. Enabling this requires to set up a global shared database
+ * (see next option $wgGlobalDatabase).
+ */
+$wgEnableInterwikiTemplatesTracking = false;
+
+/**
+ * If $wgEnableInterwikiTemplatesTracking is set to true, this option should
+ * contain the wiki ID of the database that hosts the globaltemplatelinks table.
  */
-$wgEnableScaryTranscluding = false;
+$wgGlobalDatabase = '';
 
 /**
- * Expiry time for interwiki transclusion
+ * If $wgEnableInterwikiTranscluding is set to true and if an interwiki
+ * prefix is associated with an API URL and no wiki ID, this will be
+ * the expiry time for the transcluded templates cached in memcached.
  */
 $wgTranscludeCacheExpiry = 3600;
 
@@ -3681,7 +3720,20 @@ $wgEnableDnsBlacklist = false;
 $wgEnableSorbs = false;
 
 /**
- * List of DNS blacklists to use, if $wgEnableDnsBlacklist is true
+ * List of DNS blacklists to use, if $wgEnableDnsBlacklist is true. This is an
+ * array of either a URL or an array with the URL and a key (should the blacklist
+ * require a key). For example:
+ * @code
+ * $wgDnsBlacklistUrls = array(
+ *   // String containing URL
+ *   'http.dnsbl.sorbs.net',
+ *   // Array with URL and key, for services that require a key
+ *   array( 'dnsbl.httpbl.net', 'mykey' ),
+ *   // Array with just the URL. While this works, it is recommended that you
+ *   // just use a string as shown above
+ *   array( 'opm.tornevall.org' )
+ * );
+ * @endcode
  * @since 1.16
  */
 $wgDnsBlacklistUrls = array( 'http.dnsbl.sorbs.net.' );
@@ -3746,6 +3798,12 @@ $wgRateLimitsExcludedIPs = array();
  */
 $wgPutIPinRC = true;
 
+/**
+ * Integer defining default number of entries to show on
+ * Special:Whatlinkshere
+ */
+$wgWhatlinkshereLimit = 50;
+
 /**
  * Limit password attempts to X attempts per Y seconds per IP per account.
  * Requires memcached.
@@ -3981,6 +4039,13 @@ $wgShowHostnames = false;
  */
 $wgDevelopmentWarnings = false;
 
+/**
+ * Release limitation to wfDeprecated warnings, if set to a release number
+ * development warnings will not be generated for deprecations added in releases
+ * after the limit.
+ */
+$wgDeprecationReleaseLimit = false;
+
 /** Only record profiling info for pages that took longer than this */
 $wgProfileLimit = 0.0;
 
@@ -4224,6 +4289,20 @@ $wgUseTwoButtonsSearchForm = true;
  */
 $wgSitemapNamespaces = false;
 
+/**
+ * Custom namespace priorities for sitemaps. Setting this will allow you to
+ * set custom priorities to namsepaces when sitemaps are generated using the
+ * maintenance/generateSitemap.php script.
+ *
+ * This should be a map of namespace IDs to priority
+ * Example:
+ *  $wgSitemapNamespacesPriorities = array(
+ *      NS_USER => '0.9',
+ *      NS_HELP => '0.0',
+ *  );
+ */
+$wgSitemapNamespacesPriorities = false;
+
 /** @} */ # end of search settings
 
 /************************************************************************//**
@@ -4813,6 +4892,8 @@ $wgCategoryPagingLimit = 200;
  *
  *   - uppercase: Converts the category name to upper case, and sorts by that.
  *
+ *   - identity: Does no conversion. Sorts by binary value of the string.
+ *
  *   - uca-default: Provides access to the Unicode Collation Algorithm with
  *     the default element table. This is a compromise collation which sorts
  *     all languages in a mediocre way. However, it is better than "uppercase".
@@ -4826,7 +4907,7 @@ $wgCategoryPagingLimit = 200;
  * the sort keys in the database.
  *
  * Extensions can define there own collations by subclassing Collation
- * and using the class name as the value of this variable.
+ * and using the Collation::factory hook.
  */
 $wgCategoryCollation = 'uppercase';
 
@@ -4843,7 +4924,8 @@ $wgCategoryCollation = 'uppercase';
  * an action, which is a specific kind of event that can exist in that
  * log type.
  */
-$wgLogTypes = array( '',
+$wgLogTypes = array(
+       '',
        'block',
        'protect',
        'rights',
@@ -4896,6 +4978,9 @@ $wgFilterLogTypes = array(
  * will be listed in the user interface.
  *
  * Extensions with custom log types may add to this array.
+ *
+ * Since 1.19, if you follow the naming convention log-name-TYPE,
+ * where TYPE is your log type, yoy don't need to use this array.
  */
 $wgLogNames = array(
        ''        => 'all-logs-page',
@@ -4916,6 +5001,9 @@ $wgLogNames = array(
  * top of each log type.
  *
  * Extensions with custom log types may add to this array.
+ *
+ * Since 1.19, if you follow the naming convention log-description-TYPE,
+ * where TYPE is your log type, yoy don't need to use this array.
  */
 $wgLogHeaders = array(
        ''        => 'alllogstext',
@@ -4947,22 +5035,12 @@ $wgLogActions = array(
        'protect/move_prot'  => 'movedarticleprotection',
        'rights/rights'      => 'rightslogentry',
        'rights/autopromote' => 'rightslogentry-autopromote',
-       'delete/delete'      => 'deletedarticle',
-       'delete/restore'     => 'undeletedarticle',
-       'delete/revision'    => 'revdelete-logentry',
-       'delete/event'       => 'logdelete-logentry',
        'upload/upload'      => 'uploadedimage',
        'upload/overwrite'   => 'overwroteimage',
        'upload/revert'      => 'uploadedimage',
-       'move/move'          => '1movedto2',
-       'move/move_redir'    => '1movedto2_redir',
        'import/upload'      => 'import-logentry-upload',
        'import/interwiki'   => 'import-logentry-interwiki',
        'merge/merge'        => 'pagemerge-logentry',
-       'suppress/revision'  => 'revdelete-logentry',
-       'suppress/file'      => 'revdelete-logentry',
-       'suppress/event'     => 'logdelete-logentry',
-       'suppress/delete'    => 'suppressedarticle',
        'suppress/block'     => 'blocklogentry',
        'suppress/reblock'   => 'reblock-logentry',
        'patrol/patrol'      => 'patrol-log-line',
@@ -4972,8 +5050,17 @@ $wgLogActions = array(
  * The same as above, but here values are names of functions,
  * not messages.
  * @see LogPage::actionText
- */
-$wgLogActionsHandlers = array();
+ * @see LogFormatter
+ */
+$wgLogActionsHandlers = array(
+       // move, move_redir
+       'move/*'            => 'MoveLogFormatter',
+       // delete, restore, revision, event
+       'delete/*'          => 'DeleteLogFormatter',
+       'suppress/revision' => 'DeleteLogFormatter',
+       'suppress/event'    => 'DeleteLogFormatter',
+       'suppress/delete'   => 'DeleteLogFormatter',
+);
 
 /**
  * Maintain a log of newusers at Log/newusers?
@@ -5091,6 +5178,8 @@ $wgSpecialPageGroups = array(
        'Export'                    => 'pagetools',
        'Import'                    => 'pagetools',
        'Whatlinkshere'             => 'pagetools',
+       'GlobalFileUsage'           => 'pagetools',
+       'GlobalTemplateUsage'       => 'pagetools',
 
        'Statistics'                => 'wiki',
        'Version'                   => 'wiki',
@@ -5551,19 +5640,6 @@ $wgSeleniumConfigFile = null;
 $wgDBtestuser = ''; //db user that has permission to create and drop the test databases only
 $wgDBtestpassword = '';
 
-/**
- * Whether or not to use the AJAX categories system.
- */
-$wgUseAJAXCategories = false;
-
-/**
- * Only enable AJAXCategories on configured namespaces. Default is all.
- *
- * Example:
- *   $wgAJAXCategoriesNamespaces = array( NS_MAIN, NS_PROJECT );
- */
-$wgAJAXCategoriesNamespaces = array();
-
 /**
  * For really cool vim folding this needs to be at the end:
  * vim: foldmarker=@{,@} foldmethod=marker