}
# Create a site configuration object. Not used for much in a default install.
-# Note: this (and other things) will break if the autoloader is not enabled.
+# Note: this (and other things) will break if the autoloader is not enabled.
# Please include includes/AutoLoader.php before including this file.
$wgConf = new SiteConfiguration;
/** @endcond */
$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
* @{
*
* Defaults to "{$wgScriptPath}/redirect{$wgScriptExtension}".
*/
-$wgRedirectScript = false; ///< defaults to
+$wgRedirectScript = false;
/**
* The URL path to load.php.
*/
$wgLoadScript = false;
+
/**@}*/
/************************************************************************//**
*/
$wgUploadPath = false;
+/**
+ * The maximum age of temporary (incomplete) uploaded files
+ */
+$wgUploadStashMaxAge = 6 * 3600; // 6 hours
+
/**
* The filesystem path of the images directory. Defaults to "{$IP}/images".
*/
$wgCustomConvertCommand = false;
/**
- * Some tests and extensions use exiv2 to manipulate the EXIF metadata in some image formats.
+ * Some tests and extensions use exiv2 to manipulate the EXIF metadata in some image formats.
*/
$wgExiv2Command = '/usr/bin/exiv2';
* 'session_mysql.' Setting to null skips setting this entirely (which might be
* useful if you're doing cross-application sessions, see bug 11381)
*/
-$wgSessionHandler = 'files';
+$wgSessionHandler = null;
/** If enabled, will send MemCached debugging information to $wgDebugLogFile */
$wgMemCachedDebug = false;
/** Send X-Vary-Options header for better caching (requires patched Squid) */
$wgUseXVO = false;
+/** Add X-Forwarded-Proto to the Vary and X-Vary-Options headers for API
+ * 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;
+
/**
* Internal server name as known to Squid, if different. Example:
* <code>
/**
* 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',
- 'dk',
- 'fiu-vro',
- 'iu',
- 'nb',
- 'qqq',
- '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'
);
/**
*/
$wgAllowMicrodataAttributes = false;
+/**
+ * Cleanup as much presentational html like valign -> css vertical-align as we can
+ */
+$wgCleanupPresentationalAttributes = false;
+
/**
* Should we try to make our HTML output well-formed XML? If set to false,
* output will be a few bytes shorter, and the HTML will arguably be more
$wgEdititis = false;
/**
- * Experimental better directionality support.
+ * Better directionality support (bug 6100 and related).
+ * Removed in 1.18, still kept here for LiquidThreads backwards compatibility.
+ *
+ * @deprecated since 1.18
*/
-$wgBetterDirectionality = false;
+$wgBetterDirectionality = true;
/** @} */ # End of output format settings }
*/
$wgResourceModules = array();
+/**
+ * Extensions should register foreign module sources here. 'local' is a
+ * built-in source that is not in this array, but defined by
+ * ResourceLoader::__construct() so that it cannot be unset.
+ *
+ * Example:
+ * $wgResourceLoaderSources['foo'] = array( 'loadScript' => 'http://example.org/w/load.php' );
+ */
+$wgResourceLoaderSources = array();
+
/**
* Maximum time in seconds to cache resources served by the resource loader
*/
*/
$wgResourceLoaderMaxQueryLength = -1;
+/**
+ * If set to true, JavaScript modules loaded from wiki pages will be parsed prior
+ * to minification to validate it.
+ *
+ * Parse errors will result in a JS exception being thrown during module load,
+ * which avoids breaking other modules loaded in the same request.
+ */
+$wgResourceLoaderValidateJS = true;
+
+/**
+ * If set to true, statically-sourced (file-backed) JavaScript resources will
+ * be parsed for validity before being bundled up into ResourceLoader modules.
+ *
+ * This can be helpful for development by providing better error messages in
+ * default (non-debug) mode, but JavaScript parsing is slow and memory hungry
+ * and may fail on large pre-bundled frameworks.
+ */
+$wgResourceLoaderValidateStaticJS = false;
+
/** @} */ # End of resource loader settings }
'svn://',
'git://',
'mms://',
+ '//', // for protocol-relative URLs
);
/**
* - $wgTidyBin should be set to the path of the binary and
* - $wgTidyConf to the path of the configuration file.
* - $wgTidyOpts can include any number of parameters.
- * - $wgTidyInternal controls the use of the PECL extension to use an in-
- * process tidy library instead of spawning a separate program.
+ * - $wgTidyInternal controls the use of the PECL extension or the
+ * libtidy (PHP >= 5) extension to use an in-process tidy library instead
+ * of spawning a separate program.
* Normally you shouldn't need to override the setting except for
* debugging. To install, use 'pear install tidy' and add a line
* 'extension=tidy.so' to php.ini.
$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).
*/
-$wgEnableScaryTranscluding = false;
+$wgEnableInterwikiTemplatesTracking = false;
/**
- * Expiry time for interwiki transclusion
+ * If $wgEnableInterwikiTemplatesTracking is set to true, this option should
+ * contain the wiki ID of the database that hosts the globaltemplatelinks table.
+ */
+$wgGlobalDatabase = '';
+
+/**
+ * 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;
/**
* Backward compatibility setting, will set $wgArticleCountMethod if it is null.
- * @deprecated since 1.19; use $wgArticleCountMethod instead
+ * @deprecated since 1.18; use $wgArticleCountMethod instead
*/
$wgUseCommaCount = false;
'numberheadings' => 0,
'previewonfirst' => 0,
'previewontop' => 1,
- 'quickbar' => 1,
+ 'quickbar' => 5,
'rcdays' => 7,
'rclimit' => 50,
'rememberpassword' => 0,
* unable to perform certain essential tasks or access new functionality
* when new permissions are introduced and default grants established.
*
+ * If set to an array instead of a boolean, it is assumed that the array is in
+ * NS => bool form in order to support per-namespace permissions. Note that
+ * this feature does not fully work for all permission types.
+ *
* Functionality to make pages inaccessible has not been extensively tested
* for security. Use at your own risk!
*
$wgGroupPermissions['user']['move'] = true;
$wgGroupPermissions['user']['move-subpages'] = true;
$wgGroupPermissions['user']['move-rootuserpages'] = true; // can move root userpages
-//$wgGroupPermissions['user']['movefile'] = true; // Disabled for now due to possible bugs and security concerns
+$wgGroupPermissions['user']['movefile'] = true;
$wgGroupPermissions['user']['read'] = true;
$wgGroupPermissions['user']['edit'] = true;
$wgGroupPermissions['user']['createpage'] = true;
'onView' => array()
);
+/*
+ * Put user rights log entries for autopromotion in recent changes?
+ * @since 1.18
+ */
+$wgAutopromoteOnceLogInRC = true;
+
/**
* $wgAddGroups and $wgRemoveGroups can be used to give finer control over who
* can assign which groups at Special:Userrights. Example configuration:
$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.' );
*/
$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.
/**
* Default cookie expiration time. Setting to 0 makes all cookies session-only.
*/
-$wgCookieExpiration = 30*86400;
+$wgCookieExpiration = 180*86400;
/**
* Set to set an explicit domain on the login cookies eg, "justthis.domain.org"
/**
- * Set this variable if you want to restrict cookies to a certain path within
+ * Set this variable if you want to restrict cookies to a certain path within
* the domain specified by $wgCookieDomain.
*/
$wgCookiePath = '/';
$wgCookieSecure = 'detect';
/**
- * By default, MediaWiki checks if the client supports cookies during the
- * login process, so that it can display an informative error message if
+ * By default, MediaWiki checks if the client supports cookies during the
+ * login process, so that it can display an informative error message if
* cookies are disabled. Set this to true if you want to disable this cookie
* check.
*/
*/
$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;
*/
$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
/************************************************************************//**
* @{
*/
-/** Override for copyright metadata.
- * TODO: these options need documentation
+/**
+ * Override for copyright metadata.
+ *
+ * This is the name of the page containing information about the wiki's copyright status,
+ * which will be added as a link in the footer if it is specified. It overrides
+ * $wgRightsUrl if both are specified.
*/
$wgRightsPage = null;
+
+/**
+ * Set this to specify an external URL containing details about the content license used on your wiki.
+ * If $wgRightsPage is set then this setting is ignored.
+ */
$wgRightsUrl = null;
+
+/**
+ * If either $wgRightsUrl or $wgRightsPage is specified then this variable gives the text for the link.
+ * If using $wgRightsUrl then this value must be specified. If using $wgRightsPage then the name of the
+ * page will also be used as the link if this variable is not set.
+ */
$wgRightsText = null;
+
+/**
+ * Override for copyright metadata.
+ */
$wgRightsIcon = null;
/**
*
* - 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".
* 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';
* an action, which is a specific kind of event that can exist in that
* log type.
*/
-$wgLogTypes = array( '',
+$wgLogTypes = array(
+ '',
'block',
'protect',
'rights',
* 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',
* 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',
'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',
* 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?
'Block' => 'users',
'Unblock' => 'users',
'Preferences' => 'users',
+ 'ChangeEmail' => 'users',
'ChangePassword' => 'users',
'DeletedContributions' => 'users',
+ 'PasswordReset' => 'users',
'Mostlinked' => 'highuse',
'Mostlinkedcategories' => 'highuse',
'Export' => 'pagetools',
'Import' => 'pagetools',
'Whatlinkshere' => 'pagetools',
+ 'GlobalFileUsage' => 'pagetools',
+ 'GlobalTemplateUsage' => 'pagetools',
'Statistics' => 'wiki',
'Version' => 'wiki',
*/
/**
- * The build directory for HipHop compilation.
+ * The build directory for HipHop compilation.
* Defaults to $IP/maintenance/hiphop/build.
*/
$wgHipHopBuildDirectory = false;
/**
* Filesystem extensions directory. Defaults to $IP/../extensions.
*
- * To compile extensions with HipHop, set $wgExtensionsDirectory correctly,
+ * To compile extensions with HipHop, set $wgExtensionsDirectory correctly,
* and use code like:
- *
+ *
* require( MWInit::extensionSetupPath( 'Extension/Extension.php' ) );
*
- * to include the extension setup file from LocalSettings.php. It is not
+ * to include the extension setup file from LocalSettings.php. It is not
* necessary to set this variable unless you use MWInit::extensionSetupPath().
*/
$wgExtensionsDirectory = false;
/**
- * A list of files that should be compiled into a HipHop build, in addition to
- * those listed in $wgAutoloadClasses. Add to this array in an extension setup
- * file in order to add files to the build.
+ * A list of files that should be compiled into a HipHop build, in addition to
+ * those listed in $wgAutoloadClasses. Add to this array in an extension setup
+ * file in order to add files to the build.
*
- * The files listed here must either be either absolute paths under $IP or
+ * The files listed here must either be either absolute paths under $IP or
* under $wgExtensionsDirectory, or paths relative to the virtual source root
- * "$IP/..", i.e. starting with "phase3" for core files, and "extensions" for
+ * "$IP/..", i.e. starting with "phase3" for core files, and "extensions" for
* extension files.
*/
$wgCompiledFiles = array();