summaryrefslogtreecommitdiff
path: root/includes/DefaultSettings.php
diff options
context:
space:
mode:
authorPierre Schmitz <pierre@archlinux.de>2011-06-22 11:28:20 +0200
committerPierre Schmitz <pierre@archlinux.de>2011-06-22 11:28:20 +0200
commit9db190c7e736ec8d063187d4241b59feaf7dc2d1 (patch)
tree46d1a0dee7febef5c2d57a9f7b972be16a163b3d /includes/DefaultSettings.php
parent78677c7bbdcc9739f6c10c75935898a20e1acd9e (diff)
update to MediaWiki 1.17.0
Diffstat (limited to 'includes/DefaultSettings.php')
-rw-r--r--includes/DefaultSettings.php5328
1 files changed, 3139 insertions, 2189 deletions
diff --git a/includes/DefaultSettings.php b/includes/DefaultSettings.php
index 54a96d44..ae6fc1b7 100644
--- a/includes/DefaultSettings.php
+++ b/includes/DefaultSettings.php
@@ -1,5 +1,6 @@
<?php
/**
+ * @file
*
* NEVER EDIT THIS FILE
*
@@ -14,80 +15,78 @@
*
* Documentation is in the source and on:
* http://www.mediawiki.org/wiki/Manual:Configuration_settings
- *
*/
-# This is not a valid entry point, perform no further processing unless MEDIAWIKI is defined
+/**
+ * @cond file_level_code
+ * This is not a valid entry point, perform no further processing unless MEDIAWIKI is defined
+ */
if( !defined( 'MEDIAWIKI' ) ) {
echo "This file is part of MediaWiki and is not a valid entry point\n";
die( 1 );
}
-/**
- * Create a site configuration object
- * Not used for much in a default install
- */
+# Create a site configuration object. Not used for much in a default install
if ( !defined( 'MW_PHP4' ) ) {
require_once( "$IP/includes/SiteConfiguration.php" );
$wgConf = new SiteConfiguration;
}
+/** @endcond */
/** MediaWiki version number */
-$wgVersion = '1.16.5';
+$wgVersion = '1.17.0';
/** Name of the site. It must be changed in LocalSettings.php */
$wgSitename = 'MediaWiki';
/**
- * Name of the project namespace. If left set to false, $wgSitename will be
- * used instead.
- */
-$wgMetaNamespace = false;
-
-/**
- * Name of the project talk namespace.
+ * URL of the server. It will be automatically built including https mode.
*
- * Normally you can ignore this and it will be something like
- * $wgMetaNamespace . "_talk". In some languages, you may want to set this
- * manually for grammatical reasons. It is currently only respected by those
- * languages where it might be relevant and where no automatic grammar converter
- * exists.
+ * Example:
+ * <code>
+ * $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.
*/
-$wgMetaNamespaceTalk = false;
-
-
-/** URL of the server. It will be automatically built including https mode */
$wgServer = '';
+/** @cond file_level_code */
if( isset( $_SERVER['SERVER_NAME'] ) ) {
- $wgServerName = $_SERVER['SERVER_NAME'];
+ $serverName = $_SERVER['SERVER_NAME'];
} elseif( isset( $_SERVER['HOSTNAME'] ) ) {
- $wgServerName = $_SERVER['HOSTNAME'];
+ $serverName = $_SERVER['HOSTNAME'];
} elseif( isset( $_SERVER['HTTP_HOST'] ) ) {
- $wgServerName = $_SERVER['HTTP_HOST'];
+ $serverName = $_SERVER['HTTP_HOST'];
} elseif( isset( $_SERVER['SERVER_ADDR'] ) ) {
- $wgServerName = $_SERVER['SERVER_ADDR'];
+ $serverName = $_SERVER['SERVER_ADDR'];
} else {
- $wgServerName = 'localhost';
+ $serverName = 'localhost';
}
-# check if server use https:
$wgProto = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == 'on') ? 'https' : 'http';
-$wgServer = $wgProto.'://' . $wgServerName;
+$wgServer = $wgProto.'://' . $serverName;
# If the port is a non-standard one, add it to the URL
if( isset( $_SERVER['SERVER_PORT'] )
- && !strpos( $wgServerName, ':' )
- && ( ( $wgProto == 'http' && $_SERVER['SERVER_PORT'] != 80 )
+ && !strpos( $serverName, ':' )
+ && ( ( $wgProto == 'http' && $_SERVER['SERVER_PORT'] != 80 )
|| ( $wgProto == 'https' && $_SERVER['SERVER_PORT'] != 443 ) ) ) {
$wgServer .= ":" . $_SERVER['SERVER_PORT'];
}
+/** @endcond */
+/************************************************************************//**
+ * @name Script path settings
+ * @{
+ */
/**
* The path we should point to.
- * It might be a virtual path in case with use apache mod_rewrite for example
+ * It might be a virtual path in case with use apache mod_rewrite for example.
*
* This *needs* to be set correctly.
*
@@ -117,85 +116,207 @@ $wgUsePathInfo =
( strpos( php_sapi_name(), 'apache2filter' ) === false ) &&
( strpos( php_sapi_name(), 'isapi' ) === false );
+/**
+ * The extension to append to script names by default. This can either be .php
+ * or .php5.
+ *
+ * Some hosting providers use PHP 4 for *.php files, and PHP 5 for *.php5. This
+ * variable is provided to support those providers.
+ */
+$wgScriptExtension = '.php';
-/**@{
- * Script users will request to get articles
- * ATTN: Old installations used wiki.phtml and redirect.phtml - make sure that
- * LocalSettings.php is correctly set!
+/**
+ * The URL path to index.php.
*
- * Will be set based on $wgScriptPath in Setup.php if not overridden in
- * LocalSettings.php. Generally you should not need to change this unless you
- * don't like seeing "index.php".
+ * Defaults to "{$wgScriptPath}/index{$wgScriptExtension}".
*/
-$wgScriptExtension = '.php'; ///< extension to append to script names by default
-$wgScript = false; ///< defaults to "{$wgScriptPath}/index{$wgScriptExtension}"
-$wgRedirectScript = false; ///< defaults to "{$wgScriptPath}/redirect{$wgScriptExtension}"
-/**@}*/
+$wgScript = false;
+/**
+ * The URL path to redirect.php. This is a script that is used by the Nostalgia
+ * skin.
+ *
+ * Defaults to "{$wgScriptPath}/redirect{$wgScriptExtension}".
+ */
+$wgRedirectScript = false; ///< defaults to
-/**@{
+/**
+ * The URL path to load.php.
+ *
+ * Defaults to "{$wgScriptPath}/load{$wgScriptExtension}".
+ */
+$wgLoadScript = false;
+
+/**@}*/
+
+/************************************************************************//**
+ * @name URLs and file paths
+ *
* These various web and file path variables are set to their defaults
* in Setup.php if they are not explicitly set from LocalSettings.php.
* If you do override them, be sure to set them all!
*
* These will relatively rarely need to be set manually, unless you are
* splitting style sheets or images outside the main document root.
+ *
+ * In this section, a "path" is usually a host-relative URL, i.e. a URL without
+ * the host part, that starts with a slash. In most cases a full URL is also
+ * acceptable. A "directory" is a local file path.
+ *
+ * In both paths and directories, trailing slashes should not be included.
+ *
+ * @{
*/
+
/**
- * asset paths as seen by users
+ * The URL path of the skins directory. Defaults to "{$wgScriptPath}/skins"
*/
-$wgStylePath = false; ///< defaults to "{$wgScriptPath}/skins"
-$wgExtensionAssetsPath = false; ///< defaults to "{$wgScriptPath}/extensions"
+$wgStylePath = false;
+$wgStyleSheetPath = &$wgStylePath;
/**
- * filesystem stylesheets directory
+ * The URL path of the skins directory. Should not point to an external domain.
+ * Defaults to "{$wgScriptPath}/skins".
+ */
+$wgLocalStylePath = false;
+
+/**
+ * The URL path of the extensions directory.
+ * Defaults to "{$wgScriptPath}/extensions".
+ */
+$wgExtensionAssetsPath = false;
+
+/**
+ * Filesystem stylesheets directory. Defaults to "{$IP}/skins"
+ */
+$wgStyleDirectory = false;
+
+/**
+ * The URL path for primary article page views. This path should contain $1,
+ * which is replaced by the article title.
+ *
+ * Defaults to "{$wgScript}/$1" or "{$wgScript}?title=$1", depending on
+ * $wgUsePathInfo.
+ */
+$wgArticlePath = false;
+
+/**
+ * The URL path for the images directory. Defaults to "{$wgScriptPath}/images"
+ */
+$wgUploadPath = false;
+
+/**
+ * The filesystem path of the images directory. Defaults to "{$IP}/images".
+ */
+$wgUploadDirectory = false;
+
+/**
+ * The URL path of the wiki logo. The logo size should be 135x135 pixels.
+ * Defaults to "{$wgStylePath}/common/images/wiki.png".
+ */
+$wgLogo = false;
+
+/**
+ * The URL path of the shortcut icon.
*/
-$wgStyleDirectory = false; ///< defaults to "{$IP}/skins"
-$wgStyleSheetPath = &$wgStylePath;
-$wgArticlePath = false; ///< default to "{$wgScript}/$1" or "{$wgScript}?title=$1", depending on $wgUsePathInfo
-$wgUploadPath = false; ///< defaults to "{$wgScriptPath}/images"
-$wgUploadDirectory = false; ///< defaults to "{$IP}/images"
-$wgHashedUploadDirectory = true;
-$wgLogo = false; ///< defaults to "{$wgStylePath}/common/images/wiki.png"
$wgFavicon = '/favicon.ico';
-$wgAppleTouchIcon = false; ///< This one'll actually default to off. For iPhone and iPod Touch web app bookmarks
-$wgMathPath = false; ///< defaults to "{$wgUploadPath}/math"
-$wgMathDirectory = false; ///< defaults to "{$wgUploadDirectory}/math"
-$wgTmpDirectory = false; ///< defaults to "{$wgUploadDirectory}/tmp"
-$wgUploadBaseUrl = "";
-/**@}*/
/**
- * Directory for caching data in the local filesystem. Should not be accessible
- * from the web. Set this to false to not use any local caches.
+ * The URL path of the icon for iPhone and iPod Touch web app bookmarks.
+ * Defaults to no icon.
+ */
+$wgAppleTouchIcon = false;
+
+/**
+ * The URL path of the math directory. Defaults to "{$wgUploadPath}/math".
*
- * Note: if multiple wikis share the same localisation cache directory, they
- * must all have the same set of extensions. You can set a directory just for
- * the localisation cache using $wgLocalisationCacheConf['storeDirectory'].
+ * See http://www.mediawiki.org/wiki/Manual:Enable_TeX for details about how to
+ * set up mathematical formula display.
*/
-$wgCacheDirectory = false;
+$wgMathPath = false;
/**
- * Default value for chmoding of new directories.
+ * The filesystem path of the math directory.
+ * Defaults to "{$wgUploadDirectory}/math".
+ *
+ * See http://www.mediawiki.org/wiki/Manual:Enable_TeX for details about how to
+ * set up mathematical formula display.
*/
-$wgDirectoryMode = 0777;
+$wgMathDirectory = false;
/**
- * New file storage paths; currently used only for deleted files.
- * Set it like this:
+ * The local filesystem path to a temporary directory. This is not required to
+ * be web accessible.
*
- * $wgFileStore['deleted']['directory'] = '/var/wiki/private/deleted';
+ * Defaults to "{$wgUploadDirectory}/tmp".
+ */
+$wgTmpDirectory = false;
+
+/**
+ * If set, this URL is added to the start of $wgUploadPath to form a complete
+ * upload URL.
+ */
+$wgUploadBaseUrl = "";
+
+/**
+ * To enable remote on-demand scaling, set this to the thumbnail base URL.
+ * Full thumbnail URL will be like $wgUploadStashScalerBaseUrl/e/e6/Foo.jpg/123px-Foo.jpg
+ * where 'e6' are the first two characters of the MD5 hash of the file name.
+ * If $wgUploadStashScalerBaseUrl is set to false, thumbs are rendered locally as needed.
+ */
+$wgUploadStashScalerBaseUrl = false;
+
+/**
+ * To set 'pretty' URL paths for actions other than
+ * plain page views, add to this array. For instance:
+ * 'edit' => "$wgScriptPath/edit/$1"
*
+ * There must be an appropriate script or rewrite rule
+ * in place to handle these URLs.
+ */
+$wgActionPaths = array();
+
+/**@}*/
+
+/************************************************************************//**
+ * @name Files and file uploads
+ * @{
+ */
+
+/** Uploads have to be specially set up to be secure */
+$wgEnableUploads = false;
+
+/** Allows to move images and other media files */
+$wgAllowImageMoving = true;
+
+/**
+ * These are additional characters that should be replaced with '-' in file names
+ */
+$wgIllegalFileChars = ":";
+
+/**
+ * @deprecated use $wgDeletedDirectory
*/
$wgFileStore = array();
-$wgFileStore['deleted']['directory'] = false;///< Defaults to $wgUploadDirectory/deleted
-$wgFileStore['deleted']['url'] = null; ///< Private
-$wgFileStore['deleted']['hash'] = 3; ///< 3-level subdirectory split
-$wgImgAuthDetails = false; ///< defaults to false - only set to true if you use img_auth and want the user to see details on why access failed
-$wgImgAuthPublicTest = true; ///< defaults to true - if public read is turned on, no need for img_auth, config error unless other access is used
+/**
+ * What directory to place deleted uploads in
+ */
+$wgDeletedDirectory = false; // Defaults to $wgUploadDirectory/deleted
+
+/**
+ * Set this to true if you use img_auth and want the user to see details on why access failed.
+ */
+$wgImgAuthDetails = false;
-/**@{
+/**
+ * If this is enabled, img_auth.php will not allow image access unless the wiki
+ * is private. This improves security when image uploads are hosted on a
+ * separate domain.
+ */
+$wgImgAuthPublicTest = true;
+
+/**
* File repository structures
*
* $wgLocalFileRepo is a single repository structure, and $wgForeignFileRepos is
@@ -203,59 +324,62 @@ $wgImgAuthPublicTest = true; ///< defaults to true - if public read is turned on
* array of properties configuring the repository.
*
* Properties required for all repos:
- * class The class name for the repository. May come from the core or an extension.
+ * - class The class name for the repository. May come from the core or an extension.
* The core repository classes are LocalRepo, ForeignDBRepo, FSRepo.
*
- * name A unique name for the repository.
+ * - name A unique name for the repository.
*
* For most core repos:
- * url Base public URL
- * hashLevels The number of directory levels for hash-based division of files
- * thumbScriptUrl The URL for thumb.php (optional, not recommended)
- * transformVia404 Whether to skip media file transformation on parse and rely on a 404
+ * - url Base public URL
+ * - hashLevels The number of directory levels for hash-based division of files
+ * - thumbScriptUrl The URL for thumb.php (optional, not recommended)
+ * - transformVia404 Whether to skip media file transformation on parse and rely on a 404
* handler instead.
- * initialCapital Equivalent to $wgCapitalLinks (or $wgCapitalLinkOverrides[NS_FILE],
+ * - initialCapital Equivalent to $wgCapitalLinks (or $wgCapitalLinkOverrides[NS_FILE],
* determines whether filenames implicitly start with a capital letter.
* The current implementation may give incorrect description page links
* when the local $wgCapitalLinks and initialCapital are mismatched.
- * pathDisclosureProtection
+ * - pathDisclosureProtection
* May be 'paranoid' to remove all parameters from error messages, 'none' to
* leave the paths in unchanged, or 'simple' to replace paths with
* placeholders. Default for LocalRepo is 'simple'.
- * fileMode This allows wikis to set the file mode when uploading/moving files. Default
+ * - fileMode This allows wikis to set the file mode when uploading/moving files. Default
* is 0644.
- * directory The local filesystem directory where public files are stored. Not used for
+ * - directory The local filesystem directory where public files are stored. Not used for
* some remote repos.
- * thumbDir The base thumbnail directory. Defaults to <directory>/thumb.
- * thumbUrl The base thumbnail URL. Defaults to <url>/thumb.
+ * - thumbDir The base thumbnail directory. Defaults to <directory>/thumb.
+ * - thumbUrl The base thumbnail URL. Defaults to <url>/thumb.
*
*
* These settings describe a foreign MediaWiki installation. They are optional, and will be ignored
* for local repositories:
- * descBaseUrl URL of image description pages, e.g. http://en.wikipedia.org/wiki/Image:
- * scriptDirUrl URL of the MediaWiki installation, equivalent to $wgScriptPath, e.g.
- * http://en.wikipedia.org/w
- *
- * articleUrl Equivalent to $wgArticlePath, e.g. http://en.wikipedia.org/wiki/$1
- * fetchDescription Fetch the text of the remote file description page. Equivalent to
+ * - descBaseUrl URL of image description pages, e.g. http://en.wikipedia.org/wiki/File:
+ * - scriptDirUrl URL of the MediaWiki installation, equivalent to $wgScriptPath, e.g.
+ * http://en.wikipedia.org/w
+ * - scriptExtension Script extension of the MediaWiki installation, equivalent to
+ * $wgScriptExtension, e.g. .php5 defaults to .php
+ *
+ * - articleUrl Equivalent to $wgArticlePath, e.g. http://en.wikipedia.org/wiki/$1
+ * - fetchDescription Fetch the text of the remote file description page. Equivalent to
* $wgFetchCommonsDescriptions.
*
* ForeignDBRepo:
- * dbType, dbServer, dbUser, dbPassword, dbName, dbFlags
+ * - dbType, dbServer, dbUser, dbPassword, dbName, dbFlags
* equivalent to the corresponding member of $wgDBservers
- * tablePrefix Table prefix, the foreign wiki's $wgDBprefix
- * hasSharedCache True if the wiki's shared cache is accessible via the local $wgMemc
+ * - tablePrefix Table prefix, the foreign wiki's $wgDBprefix
+ * - hasSharedCache True if the wiki's shared cache is accessible via the local $wgMemc
*
* ForeignAPIRepo:
- * apibase Use for the foreign API's URL
- * apiThumbCacheExpiry How long to locally cache thumbs for
+ * - apibase Use for the foreign API's URL
+ * - apiThumbCacheExpiry How long to locally cache thumbs for
*
* The default is to initialise these arrays from the MW<1.11 backwards compatible settings:
* $wgUploadPath, $wgThumbnailScriptPath, $wgSharedUploadDirectory, etc.
*/
$wgLocalFileRepo = false;
+
+/** @see $wgLocalFileRepo */
$wgForeignFileRepos = array();
-/**@}*/
/**
* Use Commons as a remote file repository. Essentially a wrapper, when this
@@ -265,76 +389,398 @@ $wgForeignFileRepos = array();
$wgUseInstantCommons = false;
/**
- * Allowed title characters -- regex character class
- * Don't change this unless you know what you're doing
+ * Show EXIF data, on by default if available.
+ * Requires PHP's EXIF extension: http://www.php.net/manual/en/ref.exif.php
*
- * Problematic punctuation:
- * []{}|# Are needed for link syntax, never enable these
- * <> Causes problems with HTML escaping, don't use
- * % Enabled by default, minor problems with path to query rewrite rules, see below
- * + Enabled by default, but doesn't work with path to query rewrite rules, corrupted by apache
- * ? Enabled by default, but doesn't work with path to PATH_INFO rewrites
+ * NOTE FOR WINDOWS USERS:
+ * To enable EXIF functions, add the folloing lines to the
+ * "Windows extensions" section of php.ini:
*
- * All three of these punctuation problems can be avoided by using an alias, instead of a
- * rewrite rule of either variety.
+ * extension=extensions/php_mbstring.dll
+ * extension=extensions/php_exif.dll
+ */
+$wgShowEXIF = function_exists( 'exif_read_data' );
+
+/**
+ * If you operate multiple wikis, you can define a shared upload path here.
+ * Uploads to this wiki will NOT be put there - they will be put into
+ * $wgUploadDirectory.
+ * If $wgUseSharedUploads is set, the wiki will look in the shared repository if
+ * no file of the given name is found in the local repository (for [[File:..]],
+ * [[Media:..]] links). Thumbnails will also be looked for and generated in this
+ * directory.
*
- * The problem with % is that when using a path to query rewrite rule, URLs are
- * double-unescaped: once by Apache's path conversion code, and again by PHP. So
- * %253F, for example, becomes "?". Our code does not double-escape to compensate
- * for this, indeed double escaping would break if the double-escaped title was
- * passed in the query string rather than the path. This is a minor security issue
- * because articles can be created such that they are hard to view or edit.
+ * Note that these configuration settings can now be defined on a per-
+ * repository basis for an arbitrary number of file repositories, using the
+ * $wgForeignFileRepos variable.
+ */
+$wgUseSharedUploads = false;
+/** Full path on the web server where shared uploads can be found */
+$wgSharedUploadPath = "http://commons.wikimedia.org/shared/images";
+/** Fetch commons image description pages and display them on the local wiki? */
+$wgFetchCommonsDescriptions = false;
+/** Path on the file system where shared uploads can be found. */
+$wgSharedUploadDirectory = "/var/www/wiki3/images";
+/** DB name with metadata about shared directory. Set this to false if the uploads do not come from a wiki. */
+$wgSharedUploadDBname = false;
+/** Optional table prefix used in database. */
+$wgSharedUploadDBprefix = '';
+/** Cache shared metadata in memcached. Don't do this if the commons wiki is in a different memcached domain */
+$wgCacheSharedUploads = true;
+/**
+* Allow for upload to be copied from an URL. Requires Special:Upload?source=web
+* The timeout for copy uploads is set by $wgHTTPTimeout.
+*/
+$wgAllowCopyUploads = false;
+/**
+ * Allow asynchronous copy uploads.
+ * This feature is experimental.
+ */
+$wgAllowAsyncCopyUploads = false;
+
+/**
+ * Max size for uploads, in bytes. Applies to all uploads.
+ */
+$wgMaxUploadSize = 1024*1024*100; # 100MB
+
+/**
+ * Point the upload navigation link to an external URL
+ * Useful if you want to use a shared repository by default
+ * without disabling local uploads (use $wgEnableUploads = false for that)
+ * e.g. $wgUploadNavigationUrl = 'http://commons.wikimedia.org/wiki/Special:Upload';
+ */
+$wgUploadNavigationUrl = false;
+
+/**
+ * Point the upload link for missing files to an external URL, as with
+ * $wgUploadNavigationUrl. The URL will get (?|&)wpDestFile=<filename>
+ * appended to it as appropriate.
+ */
+$wgUploadMissingFileUrl = false;
+
+/**
+ * Give a path here to use thumb.php for thumbnail generation on client request, instead of
+ * generating them on render and outputting a static URL. This is necessary if some of your
+ * apache servers don't have read/write access to the thumbnail path.
*
- * In some rare cases you may wish to remove + for compatibility with old links.
+ * Example:
+ * $wgThumbnailScriptPath = "{$wgScriptPath}/thumb{$wgScriptExtension}";
+ */
+$wgThumbnailScriptPath = false;
+$wgSharedThumbnailScriptPath = false;
+
+/**
+ * Set this to false if you do not want MediaWiki to divide your images
+ * directory into many subdirectories, for improved performance.
*
- * Theoretically 0x80-0x9F of ISO 8859-1 should be disallowed, but
- * this breaks interlanguage links
+ * It's almost always good to leave this enabled. In previous versions of
+ * MediaWiki, some users set this to false to allow images to be added to the
+ * wiki by simply copying them into $wgUploadDirectory and then running
+ * maintenance/rebuildImages.php to register them in the database. This is no
+ * longer recommended, use maintenance/importImages.php instead.
+ *
+ * Note that this variable may be ignored if $wgLocalFileRepo is set.
*/
-$wgLegalTitleChars = " %!\"$&'()*,\\-.\\/0-9:;=?@A-Z\\\\^_`a-z~\\x80-\\xFF+";
-$wgIllegalFileChars = ":"; // These are additional characters that should be replaced with '-' in file names
+$wgHashedUploadDirectory = true;
+/**
+ * Set the following to false especially if you have a set of files that need to
+ * be accessible by all wikis, and you do not want to use the hash (path/a/aa/)
+ * directory layout.
+ */
+$wgHashedSharedUploadDirectory = true;
+
+/**
+ * Base URL for a repository wiki. Leave this blank if uploads are just stored
+ * in a shared directory and not meant to be accessible through a separate wiki.
+ * Otherwise the image description pages on the local wiki will link to the
+ * image description page on this wiki.
+ *
+ * Please specify the namespace, as in the example below.
+ */
+$wgRepositoryBaseUrl = "http://commons.wikimedia.org/wiki/File:";
/**
- * The external URL protocols
+ * This is the list of preferred extensions for uploading files. Uploading files
+ * with extensions not in this list will trigger a warning.
+ *
+ * WARNING: If you add any OpenOffice or Microsoft Office file formats here,
+ * such as odt or doc, and untrusted users are allowed to upload files, then
+ * your wiki will be vulnerable to cross-site request forgery (CSRF).
*/
-$wgUrlProtocols = array(
- 'http://',
- 'https://',
- 'ftp://',
- 'irc://',
- 'gopher://',
- 'telnet://', // Well if we're going to support the above.. -ævar
- 'nntp://', // @bug 3808 RFC 1738
- 'worldwind://',
- 'mailto:',
- 'news:',
- 'svn://',
+$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );
+
+/** Files with these extensions will never be allowed as uploads. */
+$wgFileBlacklist = array(
+ # HTML may contain cookie-stealing JavaScript and web bugs
+ 'html', 'htm', 'js', 'jsb', 'mhtml', 'mht', 'xhtml', 'xht',
+ # PHP scripts may execute arbitrary code on the server
+ 'php', 'phtml', 'php3', 'php4', 'php5', 'phps',
+ # Other types that may be interpreted by some servers
+ 'shtml', 'jhtml', 'pl', 'py', 'cgi',
+ # May contain harmful executables for Windows victims
+ 'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );
+
+/**
+ * Files with these mime types will never be allowed as uploads
+ * if $wgVerifyMimeType is enabled.
+ */
+$wgMimeTypeBlacklist = array(
+ # HTML may contain cookie-stealing JavaScript and web bugs
+ 'text/html', 'text/javascript', 'text/x-javascript', 'application/x-shellscript',
+ # PHP scripts may execute arbitrary code on the server
+ 'application/x-php', 'text/x-php',
+ # Other types that may be interpreted by some servers
+ 'text/x-python', 'text/x-perl', 'text/x-bash', 'text/x-sh', 'text/x-csh',
+ # Client-side hazards on Internet Explorer
+ 'text/scriptlet', 'application/x-msdownload',
+ # Windows metafile, client-side vulnerability on some systems
+ 'application/x-msmetafile',
+ # A ZIP file may be a valid Java archive containing an applet which exploits the
+ # same-origin policy to steal cookies
+ 'application/zip',
+
+ # MS Office OpenXML and other Open Package Conventions files are zip files
+ # and thus blacklisted just as other zip files. If you remove these entries
+ # from the blacklist in your local configuration, a malicious file upload
+ # will be able to compromise the wiki's user accounts, and the user
+ # accounts of any other website in the same cookie domain.
+ 'application/x-opc+zip',
+ 'application/msword',
+ 'application/vnd.ms-powerpoint',
+ 'application/vnd.msexcel',
);
-/** internal name of virus scanner. This servers as a key to the $wgAntivirusSetup array.
- * Set this to NULL to disable virus scanning. If not null, every file uploaded will be scanned for viruses.
+/**
+ * This is a flag to determine whether or not to check file extensions on upload.
+ *
+ * WARNING: setting this to false is insecure for public wikis.
*/
-$wgAntivirus= null;
+$wgCheckFileExtensions = true;
-/** Configuration for different virus scanners. This an associative array of associative arrays:
- * it contains on setup array per known scanner type. The entry is selected by $wgAntivirus, i.e.
- * valid values for $wgAntivirus are the keys defined in this array.
+/**
+ * If this is turned off, users may override the warning for files not covered
+ * by $wgFileExtensions.
+ *
+ * WARNING: setting this to false is insecure for public wikis.
+ */
+$wgStrictFileExtensions = true;
+
+/** Warn if uploaded files are larger than this (in bytes), or false to disable*/
+$wgUploadSizeWarning = false;
+
+/**
+ * list of trusted media-types and mime types.
+ * Use the MEDIATYPE_xxx constants to represent media types.
+ * This list is used by File::isSafeFile
+ *
+ * Types not listed here will have a warning about unsafe content
+ * displayed on the images description page. It would also be possible
+ * to use this for further restrictions, like disabling direct
+ * [[media:...]] links for non-trusted formats.
+ */
+$wgTrustedMediaFormats = array(
+ MEDIATYPE_BITMAP, //all bitmap formats
+ MEDIATYPE_AUDIO, //all audio formats
+ MEDIATYPE_VIDEO, //all plain video formats
+ "image/svg+xml", //svg (only needed if inline rendering of svg is not supported)
+ "application/pdf", //PDF files
+ #"application/x-shockwave-flash", //flash/shockwave movie
+);
+
+/**
+ * Plugins for media file type handling.
+ * Each entry in the array maps a MIME type to a class name
+ */
+$wgMediaHandlers = array(
+ 'image/jpeg' => 'BitmapHandler',
+ 'image/png' => 'PNGHandler',
+ 'image/gif' => 'GIFHandler',
+ 'image/tiff' => 'TiffHandler',
+ 'image/x-ms-bmp' => 'BmpHandler',
+ 'image/x-bmp' => 'BmpHandler',
+ 'image/svg+xml' => 'SvgHandler', // official
+ 'image/svg' => 'SvgHandler', // compat
+ 'image/vnd.djvu' => 'DjVuHandler', // official
+ 'image/x.djvu' => 'DjVuHandler', // compat
+ 'image/x-djvu' => 'DjVuHandler', // compat
+);
+
+/**
+ * Resizing can be done using PHP's internal image libraries or using
+ * ImageMagick or another third-party converter, e.g. GraphicMagick.
+ * These support more file formats than PHP, which only supports PNG,
+ * GIF, JPG, XBM and WBMP.
+ *
+ * Use Image Magick instead of PHP builtin functions.
+ */
+$wgUseImageMagick = false;
+/** The convert command shipped with ImageMagick */
+$wgImageMagickConvertCommand = '/usr/bin/convert';
+
+/** Sharpening parameter to ImageMagick */
+$wgSharpenParameter = '0x0.4';
+
+/** Reduction in linear dimensions below which sharpening will be enabled */
+$wgSharpenReductionThreshold = 0.85;
+
+/**
+ * Temporary directory used for ImageMagick. The directory must exist. Leave
+ * this set to false to let ImageMagick decide for itself.
+ */
+$wgImageMagickTempDir = false;
+
+/**
+ * Use another resizing converter, e.g. GraphicMagick
+ * %s will be replaced with the source path, %d with the destination
+ * %w and %h will be replaced with the width and height.
+ *
+ * Example for GraphicMagick:
+ * <code>
+ * $wgCustomConvertCommand = "gm convert %s -resize %wx%h %d"
+ * </code>
+ *
+ * Leave as false to skip this.
+ */
+$wgCustomConvertCommand = false;
+
+/**
+ * Scalable Vector Graphics (SVG) may be uploaded as images.
+ * Since SVG support is not yet standard in browsers, it is
+ * necessary to rasterize SVGs to PNG as a fallback format.
+ *
+ * An external program is required to perform this conversion.
+ */
+$wgSVGConverters = array(
+ 'ImageMagick' => '$path/convert -background white -thumbnail $widthx$height\! $input PNG:$output',
+ 'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
+ 'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
+ 'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
+ 'rsvg' => '$path/rsvg -w$width -h$height $input $output',
+ 'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
+ );
+/** Pick a converter defined in $wgSVGConverters */
+$wgSVGConverter = 'ImageMagick';
+/** If not in the executable PATH, specify the SVG converter path. */
+$wgSVGConverterPath = '';
+/** Don't scale a SVG larger than this */
+$wgSVGMaxSize = 2048;
+/** Don't read SVG metadata beyond this point.
+ * Default is 1024*256 bytes */
+$wgSVGMetadataCutoff = 262144;
+
+/**
+ * MediaWiki will reject HTMLesque tags in uploaded files due to idiotic browsers which can't
+ * perform basic stuff like MIME detection and which are vulnerable to further idiots uploading
+ * crap files as images. When this directive is on, <title> will be allowed in files with
+ * an "image/svg+xml" MIME type. You should leave this disabled if your web server is misconfigured
+ * and doesn't send appropriate MIME types for SVG images.
+ */
+$wgAllowTitlesInSVG = false;
+
+/**
+ * Don't thumbnail an image if it will use too much working memory.
+ * Default is 50 MB if decompressed to RGBA form, which corresponds to
+ * 12.5 million pixels or 3500x3500
+ */
+$wgMaxImageArea = 1.25e7;
+/**
+ * Force thumbnailing of animated GIFs above this size to a single
+ * frame instead of an animated thumbnail. As of MW 1.17 this limit
+ * is checked against the total size of all frames in the animation.
+ * It probably makes sense to keep this equal to $wgMaxImageArea.
+ */
+$wgMaxAnimatedGifArea = 1.25e7;
+/**
+ * Browsers don't support TIFF inline generally...
+ * For inline display, we need to convert to PNG or JPEG.
+ * Note scaling should work with ImageMagick, but may not with GD scaling.
*
- * The configuration array for each scanner contains the following keys: "command", "codemap", "messagepattern";
+ * Example:
+ * <code>
+ * // PNG is lossless, but inefficient for photos
+ * $wgTiffThumbnailType = array( 'png', 'image/png' );
+ * // JPEG is good for photos, but has no transparency support. Bad for diagrams.
+ * $wgTiffThumbnailType = array( 'jpg', 'image/jpeg' );
+ * </code>
+ */
+ $wgTiffThumbnailType = false;
+
+/**
+ * If rendered thumbnail files are older than this timestamp, they
+ * will be rerendered on demand as if the file didn't already exist.
+ * Update if there is some need to force thumbs and SVG rasterizations
+ * to rerender, such as fixes to rendering bugs.
+ */
+$wgThumbnailEpoch = '20030516000000';
+
+/**
+ * If set, inline scaled images will still produce <img> tags ready for
+ * output instead of showing an error message.
*
- * "command" is the full command to call the virus scanner - %f will be replaced with the name of the
- * file to scan. If not present, the filename will be appended to the command. Note that this must be
- * overwritten if the scanner is not in the system path; in that case, plase set
- * $wgAntivirusSetup[$wgAntivirus]['command'] to the desired command with full path.
+ * This may be useful if errors are transitory, especially if the site
+ * is configured to automatically render thumbnails on request.
*
- * "codemap" is a mapping of exit code to return codes of the detectVirus function in SpecialUpload.
- * An exit code mapped to AV_SCAN_FAILED causes the function to consider the scan to be failed. This will pass
- * the file if $wgAntivirusRequired is not set.
- * An exit code mapped to AV_SCAN_ABORTED causes the function to consider the file to have an usupported format,
- * which is probably imune to virusses. This causes the file to pass.
- * An exit code mapped to AV_NO_VIRUS will cause the file to pass, meaning no virus was found.
- * All other codes (like AV_VIRUS_FOUND) will cause the function to report a virus.
- * You may use "*" as a key in the array to catch all exit codes not mapped otherwise.
+ * On the other hand, it may obscure error conditions from debugging.
+ * Enable the debug log or the 'thumbnail' log group to make sure errors
+ * are logged to a file for review.
+ */
+$wgIgnoreImageErrors = false;
+
+/**
+ * Allow thumbnail rendering on page view. If this is false, a valid
+ * thumbnail URL is still output, but no file will be created at
+ * the target location. This may save some time if you have a
+ * thumb.php or 404 handler set up which is faster than the regular
+ * webserver(s).
+ */
+$wgGenerateThumbnailOnParse = true;
+
+/**
+* Show thumbnails for old images on the image description page
+*/
+$wgShowArchiveThumbnails = true;
+
+/** Obsolete, always true, kept for compatibility with extensions */
+$wgUseImageResize = true;
+
+
+/**
+ * Internal name of virus scanner. This servers as a key to the
+ * $wgAntivirusSetup array. Set this to NULL to disable virus scanning. If not
+ * null, every file uploaded will be scanned for viruses.
+ */
+$wgAntivirus= null;
+
+/**
+ * Configuration for different virus scanners. This an associative array of
+ * associative arrays. It contains one setup array per known scanner type.
+ * The entry is selected by $wgAntivirus, i.e.
+ * valid values for $wgAntivirus are the keys defined in this array.
+ *
+ * The configuration array for each scanner contains the following keys:
+ * "command", "codemap", "messagepattern":
+ *
+ * "command" is the full command to call the virus scanner - %f will be
+ * replaced with the name of the file to scan. If not present, the filename
+ * will be appended to the command. Note that this must be overwritten if the
+ * scanner is not in the system path; in that case, plase set
+ * $wgAntivirusSetup[$wgAntivirus]['command'] to the desired command with full
+ * path.
+ *
+ * "codemap" is a mapping of exit code to return codes of the detectVirus
+ * function in SpecialUpload.
+ * - An exit code mapped to AV_SCAN_FAILED causes the function to consider
+ * the scan to be failed. This will pass the file if $wgAntivirusRequired
+ * is not set.
+ * - An exit code mapped to AV_SCAN_ABORTED causes the function to consider
+ * the file to have an usupported format, which is probably imune to
+ * virusses. This causes the file to pass.
+ * - An exit code mapped to AV_NO_VIRUS will cause the file to pass, meaning
+ * no virus was found.
+ * - All other codes (like AV_VIRUS_FOUND) will cause the function to report
+ * a virus.
+ * - You may use "*" as a key in the array to catch all exit codes not mapped otherwise.
*
* "messagepattern" is a perl regular expression to extract the meaningful part of the scanners
* output. The relevant part should be matched as group one (\1).
@@ -373,13 +819,13 @@ $wgAntivirusSetup = array(
/** Determines if a failed virus scan (AV_SCAN_FAILED) will cause the file to be rejected. */
-$wgAntivirusRequired= true;
+$wgAntivirusRequired = true;
/** Determines if the mime type of uploaded files should be checked */
-$wgVerifyMimeType= true;
+$wgVerifyMimeType = true;
/** Sets the mime type definition file to use by MimeMagic.php. */
-$wgMimeTypeFile= "includes/mime.types";
+$wgMimeTypeFile = "includes/mime.types";
#$wgMimeTypeFile= "/etc/mime.types";
#$wgMimeTypeFile= null; #use built-in defaults only.
@@ -387,25 +833,30 @@ $wgMimeTypeFile= "includes/mime.types";
$wgMimeInfoFile= "includes/mime.info";
#$wgMimeInfoFile= null; #use built-in defaults only.
-/** Switch for loading the FileInfo extension by PECL at runtime.
+/**
+ * Switch for loading the FileInfo extension by PECL at runtime.
* This should be used only if fileinfo is installed as a shared object
- * or a dynamic libary
+ * or a dynamic library.
*/
-$wgLoadFileinfoExtension= false;
+$wgLoadFileinfoExtension = false;
/** Sets an external mime detector program. The command must print only
* the mime type to standard output.
* The name of the file to process will be appended to the command given here.
* If not set or NULL, mime_content_type will be used if available.
+ * Example:
+ * <code>
+ * #$wgMimeDetectorCommand = "file -bi"; # use external mime detector (Linux)
+ * </code>
*/
-$wgMimeDetectorCommand= null; # use internal mime_content_type function, available since php 4.3.0
-#$wgMimeDetectorCommand= "file -bi"; #use external mime detector (Linux)
+$wgMimeDetectorCommand = null;
-/** Switch for trivial mime detection. Used by thumb.php to disable all fance
+/**
+ * Switch for trivial mime detection. Used by thumb.php to disable all fancy
* things, because only a few types of images are needed and file extensions
* can be trusted.
*/
-$wgTrivialMimeDetection= false;
+$wgTrivialMimeDetection = false;
/**
* Additional XML types we can allow via mime-detection.
@@ -420,117 +871,136 @@ $wgXMLMimeTypes = array(
);
/**
- * To set 'pretty' URL paths for actions other than
- * plain page views, add to this array. For instance:
- * 'edit' => "$wgScriptPath/edit/$1"
- *
- * There must be an appropriate script or rewrite rule
- * in place to handle these URLs.
+ * Limit images on image description pages to a user-selectable limit. In order
+ * to reduce disk usage, limits can only be selected from a list.
+ * The user preference is saved as an array offset in the database, by default
+ * the offset is set with $wgDefaultUserOptions['imagesize']. Make sure you
+ * change it if you alter the array (see bug 8858).
+ * This is the list of settings the user can choose from:
*/
-$wgActionPaths = array();
+$wgImageLimits = array (
+ array(320,240),
+ array(640,480),
+ array(800,600),
+ array(1024,768),
+ array(1280,1024),
+ array(10000,10000) );
/**
- * If you operate multiple wikis, you can define a shared upload path here.
- * Uploads to this wiki will NOT be put there - they will be put into
- * $wgUploadDirectory.
- * If $wgUseSharedUploads is set, the wiki will look in the shared repository if
- * no file of the given name is found in the local repository (for [[Image:..]],
- * [[Media:..]] links). Thumbnails will also be looked for and generated in this
- * directory.
- *
- * Note that these configuration settings can now be defined on a per-
- * repository basis for an arbitrary number of file repositories, using the
- * $wgForeignFileRepos variable.
+ * Adjust thumbnails on image pages according to a user setting. In order to
+ * reduce disk usage, the values can only be selected from a list. This is the
+ * list of settings the user can choose from:
*/
-$wgUseSharedUploads = false;
-/** Full path on the web server where shared uploads can be found */
-$wgSharedUploadPath = "http://commons.wikimedia.org/shared/images";
-/** Fetch commons image description pages and display them on the local wiki? */
-$wgFetchCommonsDescriptions = false;
-/** Path on the file system where shared uploads can be found. */
-$wgSharedUploadDirectory = "/var/www/wiki3/images";
-/** DB name with metadata about shared directory. Set this to false if the uploads do not come from a wiki. */
-$wgSharedUploadDBname = false;
-/** Optional table prefix used in database. */
-$wgSharedUploadDBprefix = '';
-/** Cache shared metadata in memcached. Don't do this if the commons wiki is in a different memcached domain */
-$wgCacheSharedUploads = true;
+$wgThumbLimits = array(
+ 120,
+ 150,
+ 180,
+ 200,
+ 250,
+ 300
+);
+
/**
-* Allow for upload to be copied from an URL. Requires Special:Upload?source=web
-* The timeout for copy uploads is set by $wgHTTPTimeout.
-*/
-$wgAllowCopyUploads = false;
+ * Default parameters for the <gallery> tag
+ */
+$wgGalleryOptions = array (
+ 'imagesPerRow' => 0, // Default number of images per-row in the gallery. 0 -> Adapt to screensize
+ 'imageWidth' => 120, // Width of the cells containing images in galleries (in "px")
+ 'imageHeight' => 120, // Height of the cells containing images in galleries (in "px")
+ 'captionLength' => 20, // Length of caption to truncate (in characters)
+ 'showBytes' => true, // Show the filesize in bytes in categories
+);
/**
- * Max size for uploads, in bytes. Currently only works for uploads from URL
- * via CURL (see $wgAllowCopyUploads). The only way to impose limits on
- * normal uploads is currently to edit php.ini.
+ * Adjust width of upright images when parameter 'upright' is used
+ * This allows a nicer look for upright images without the need to fix the width
+ * by hardcoded px in wiki sourcecode.
*/
-$wgMaxUploadSize = 1024*1024*100; # 100MB
+$wgThumbUpright = 0.75;
/**
- * Point the upload navigation link to an external URL
- * Useful if you want to use a shared repository by default
- * without disabling local uploads (use $wgEnableUploads = false for that)
- * e.g. $wgUploadNavigationUrl = 'http://commons.wikimedia.org/wiki/Special:Upload';
- *
- * This also affects images inline images that do not exist. In that case the URL will get
- * (?|&)wpDestFile=<filename> appended to it as appropriate.
+ * Default value for chmoding of new directories.
*/
-$wgUploadNavigationUrl = false;
+$wgDirectoryMode = 0777;
/**
- * Give a path here to use thumb.php for thumbnail generation on client request, instead of
- * generating them on render and outputting a static URL. This is necessary if some of your
- * apache servers don't have read/write access to the thumbnail path.
- *
- * Example:
- * $wgThumbnailScriptPath = "{$wgScriptPath}/thumb{$wgScriptExtension}";
+ * DJVU settings
+ * Path of the djvudump executable
+ * Enable this and $wgDjvuRenderer to enable djvu rendering
*/
-$wgThumbnailScriptPath = false;
-$wgSharedThumbnailScriptPath = false;
+# $wgDjvuDump = 'djvudump';
+$wgDjvuDump = null;
/**
- * Set the following to false especially if you have a set of files that need to
- * be accessible by all wikis, and you do not want to use the hash (path/a/aa/)
- * directory layout.
+ * Path of the ddjvu DJVU renderer
+ * Enable this and $wgDjvuDump to enable djvu rendering
*/
-$wgHashedSharedUploadDirectory = true;
+# $wgDjvuRenderer = 'ddjvu';
+$wgDjvuRenderer = null;
/**
- * Base URL for a repository wiki. Leave this blank if uploads are just stored
- * in a shared directory and not meant to be accessible through a separate wiki.
- * Otherwise the image description pages on the local wiki will link to the
- * image description page on this wiki.
+ * Path of the djvutxt DJVU text extraction utility
+ * Enable this and $wgDjvuDump to enable text layer extraction from djvu files
+ */
+# $wgDjvuTxt = 'djvutxt';
+$wgDjvuTxt = null;
+
+/**
+ * Path of the djvutoxml executable
+ * This works like djvudump except much, much slower as of version 3.5.
*
- * Please specify the namespace, as in the example below.
+ * For now I recommend you use djvudump instead. The djvuxml output is
+ * probably more stable, so we'll switch back to it as soon as they fix
+ * the efficiency problem.
+ * http://sourceforge.net/tracker/index.php?func=detail&aid=1704049&group_id=32953&atid=406583
*/
-$wgRepositoryBaseUrl = "http://commons.wikimedia.org/wiki/Image:";
+# $wgDjvuToXML = 'djvutoxml';
+$wgDjvuToXML = null;
-#
-# Email settings
-#
/**
- * Site admin email address
- * Default to wikiadmin@SERVER_NAME
+ * Shell command for the DJVU post processor
+ * Default: pnmtopng, since ddjvu generates ppm output
+ * Set this to false to output the ppm file directly.
+ */
+$wgDjvuPostProcessor = 'pnmtojpeg';
+/**
+ * File extension for the DJVU post processor output
+ */
+$wgDjvuOutputExtension = 'jpg';
+
+/** @} */ # end of file uploads }
+
+/************************************************************************//**
+ * @name Email settings
+ * @{
+ */
+
+/**
+ * Site admin email address.
*/
-$wgEmergencyContact = 'wikiadmin@' . $wgServerName;
+$wgEmergencyContact = 'wikiadmin@' . $serverName;
/**
- * Password reminder email address
- * The address we should use as sender when a user is requesting his password
- * Default to apache@SERVER_NAME
+ * Password reminder email address.
+ *
+ * The address we should use as sender when a user is requesting his password.
*/
-$wgPasswordSender = 'MediaWiki Mail <apache@' . $wgServerName . '>';
+$wgPasswordSender = 'apache@' . $serverName;
+
+unset( $serverName ); # Don't leak local variables to global scope
/**
- * dummy address which should be accepted during mail send action
- * It might be necessay to adapt the address or to set it equal
- * to the $wgEmergencyContact address
+ * Password reminder name
*/
-#$wgNoReplyAddress = $wgEmergencyContact;
-$wgNoReplyAddress = 'reply@not.possible';
+$wgPasswordSenderName = 'MediaWiki Mail';
+
+/**
+ * Dummy address which should be accepted during mail send action.
+ * It might be necessary to adapt the address or to set it equal
+ * to the $wgEmergencyContact address.
+ */
+$wgNoReplyAddress = 'reply@not.possible';
/**
* Set to true to enable the e-mail basic features:
@@ -581,18 +1051,97 @@ $wgNewPasswordExpiry = 3600 * 24 * 7;
*/
$wgSMTP = false;
+/**
+ * Additional email parameters, will be passed as the last argument to mail() call.
+ */
+$wgAdditionalMailParams = null;
+
+/**
+ * True: from page editor if s/he opted-in. False: Enotif mails appear to come
+ * from $wgEmergencyContact
+ */
+$wgEnotifFromEditor = false;
+
+// TODO move UPO to preferences probably ?
+# If set to true, users get a corresponding option in their preferences and can choose to enable or disable at their discretion
+# If set to false, the corresponding input form on the user preference page is suppressed
+# It call this to be a "user-preferences-option (UPO)"
+
+/**
+ * Require email authentication before sending mail to an email addres. This is
+ * highly recommended. It prevents MediaWiki from being used as an open spam
+ * relay.
+ */
+$wgEmailAuthentication = true;
+
+/**
+ * Allow users to enable email notification ("enotif") on watchlist changes.
+ */
+$wgEnotifWatchlist = false;
+
+/**
+ * Allow users to enable email notification ("enotif") when someone edits their
+ * user talk page.
+ */
+$wgEnotifUserTalk = false;
+
+/**
+ * Set the Reply-to address in notifications to the editor's address, if user
+ * allowed this in the preferences.
+ */
+$wgEnotifRevealEditorAddress = false;
+
+/**
+ * Send notification mails on minor edits to watchlist pages. This is enabled
+ * by default. Does not affect user talk notifications.
+ */
+$wgEnotifMinorEdits = true;
+
+/**
+ * Send a generic mail instead of a personalised mail for each user. This
+ * always uses UTC as the time zone, and doesn't include the username.
+ *
+ * For pages with many users watching, this can significantly reduce mail load.
+ * Has no effect when using sendmail rather than SMTP.
+ */
+$wgEnotifImpersonal = false;
+
+/**
+ * Maximum number of users to mail at once when using impersonal mail. Should
+ * match the limit on your mail server.
+ */
+$wgEnotifMaxRecips = 500;
+
+/**
+ * Send mails via the job queue. This can be useful to reduce the time it
+ * takes to save a page that a lot of people are watching.
+ */
+$wgEnotifUseJobQ = false;
+
+/**
+ * Use real name instead of username in e-mail "from" field.
+ */
+$wgEnotifUseRealName = false;
+
+/**
+ * Array of usernames who will be sent a notification email for every change
+ * which occurs on a wiki.
+ */
+$wgUsersNotifiedOnAllChanges = array();
+
-/**@{
- * Database settings
+/** @} */ # end of email settings
+
+/************************************************************************//**
+ * @name Database settings
+ * @{
*/
-/** database host name or ip address */
+/** Database host name or IP address */
$wgDBserver = 'localhost';
-/** database port number (for PostgreSQL) */
+/** Database port number (for PostgreSQL) */
$wgDBport = 5432;
-/** name of the database */
+/** Name of the database */
$wgDBname = 'my_wiki';
-/** */
-$wgDBconnection = '';
/** Database username */
$wgDBuser = 'wikiuser';
/** Database user's password */
@@ -600,11 +1149,13 @@ $wgDBpassword = '';
/** Database type */
$wgDBtype = 'mysql';
-/** Separate username and password for maintenance tasks. Leave as null to use the default */
+/** Separate username for maintenance tasks. Leave as null to use the default. */
$wgDBadminuser = null;
+/** Separate password for maintenance tasks. Leave as null to use the default. */
$wgDBadminpassword = null;
-/** Search type
+/**
+ * Search type.
* Leave as null to select the default search engine for the
* selected database type (eg SearchMySQL), or set to a class
* name to override to a custom search engine.
@@ -616,6 +1167,14 @@ $wgDBprefix = '';
/** MySQL table options to use during installation or update */
$wgDBTableOptions = 'ENGINE=InnoDB';
+/**
+ * SQL Mode - default is turning off all modes, including strict, if set.
+ * null can be used to skip the setting for performance reasons and assume
+ * DBA has done his best job.
+ * String override can be used for some additional fun :-)
+ */
+$wgSQLMode = '';
+
/** Mediawiki schema */
$wgDBmwschema = 'mediawiki';
/** Tsearch2 schema */
@@ -624,12 +1183,6 @@ $wgDBts2schema = 'public';
/** To override default SQLite data directory ($docroot/../data) */
$wgSQLiteDataDir = '';
-/** Default directory mode for SQLite data directory on creation.
- * Note that this is different from the default directory mode used
- * elsewhere.
- */
-$wgSQLiteDataDirMode = 0700;
-
/**
* Make all database connections secretly go to localhost. Fool the load balancer
* thinking there is an arbitrarily large cluster of servers to connect to.
@@ -637,17 +1190,11 @@ $wgSQLiteDataDirMode = 0700;
*/
$wgAllDBsAreLocalhost = false;
-/**@}*/
-
-
-/** Live high performance sites should disable this - some checks acquire giant mysql locks */
-$wgCheckDBSchema = true;
-
-
/**
* Shared database for multiple wikis. Commonly used for storing a user table
* for single sign-on. The server for this database must be the same as for the
* main database.
+ *
* For backwards compatibility the shared prefix is set to the same as the local
* prefix, and the user table is listed in the default list of shared tables.
* The user_properties table is also added so that users will continue to have their
@@ -657,33 +1204,39 @@ $wgCheckDBSchema = true;
* datbase. However it is advised to limit what tables you do share as many of
* MediaWiki's tables may have side effects if you try to share them.
* EXPERIMENTAL
+ *
+ * $wgSharedPrefix is the table prefix for the shared database. It defaults to
+ * $wgDBprefix.
*/
$wgSharedDB = null;
-$wgSharedPrefix = false; # Defaults to $wgDBprefix
+
+/** @see $wgSharedDB */
+$wgSharedPrefix = false;
+/** @see $wgSharedDB */
$wgSharedTables = array( 'user', 'user_properties' );
/**
* Database load balancer
* This is a two-dimensional array, an array of server info structures
* Fields are:
- * host: Host name
- * dbname: Default database name
- * user: DB user
- * password: DB password
- * type: "mysql" or "postgres"
- * load: ratio of DB_SLAVE load, must be >=0, the sum of all loads must be >0
- * groupLoads: array of load ratios, the key is the query group name. A query may belong
- * to several groups, the most specific group defined here is used.
- *
- * flags: bit field
- * DBO_DEFAULT -- turns on DBO_TRX only if !$wgCommandLineMode (recommended)
- * DBO_DEBUG -- equivalent of $wgDebugDumpSql
- * DBO_TRX -- wrap entire request in a transaction
- * DBO_IGNORE -- ignore errors (not useful in LocalSettings.php)
- * DBO_NOBUFFER -- turn off buffering (not useful in LocalSettings.php)
- *
- * max lag: (optional) Maximum replication lag before a slave will taken out of rotation
- * max threads: (optional) Maximum number of running threads
+ * - host: Host name
+ * - dbname: Default database name
+ * - user: DB user
+ * - password: DB password
+ * - type: "mysql" or "postgres"
+ * - load: ratio of DB_SLAVE load, must be >=0, the sum of all loads must be >0
+ * - groupLoads: array of load ratios, the key is the query group name. A query may belong
+ * to several groups, the most specific group defined here is used.
+ *
+ * - flags: bit field
+ * - DBO_DEFAULT -- turns on DBO_TRX only if !$wgCommandLineMode (recommended)
+ * - DBO_DEBUG -- equivalent of $wgDebugDumpSql
+ * - DBO_TRX -- wrap entire request in a transaction
+ * - DBO_IGNORE -- ignore errors (not useful in LocalSettings.php)
+ * - DBO_NOBUFFER -- turn off buffering (not useful in LocalSettings.php)
+ *
+ * - max lag: (optional) Maximum replication lag before a slave will taken out of rotation
+ * - max threads: (optional) Maximum number of running threads
*
* These and any other user-defined properties will be assigned to the mLBInfo member
* variable of the Database object.
@@ -697,7 +1250,9 @@ $wgSharedTables = array( 'user', 'user_properties' );
* accidental misconfiguration or MediaWiki bugs, set read_only=1 on all your
* slaves in my.cnf. You can set read_only mode at runtime using:
*
+ * <code>
* SET @@read_only=1;
+ * </code>
*
* Since the effect of writing to a slave is so damaging and difficult to clean
* up, we at Wikimedia set read_only=1 in my.cnf on all our DB servers, even
@@ -763,38 +1318,218 @@ $wgDBmysql5 = false;
*/
$wgLocalDatabases = array();
-/** @{
- * Object cache settings
- * See Defines.php for types
+/**
+ * If lag is higher than $wgSlaveLagWarning, show a warning in some special
+ * pages (like watchlist). If the lag is higher than $wgSlaveLagCritical,
+ * show a more obvious warning.
+ */
+$wgSlaveLagWarning = 10;
+/** @see $wgSlaveLagWarning */
+$wgSlaveLagCritical = 30;
+
+/**
+ * Use old names for change_tags indices.
+ */
+$wgOldChangeTagsIndex = false;
+
+/**@}*/ # End of DB settings }
+
+
+/************************************************************************//**
+ * @name Text storage
+ * @{
+ */
+
+/**
+ * We can also compress text stored in the 'text' table. If this is set on, new
+ * revisions will be compressed on page save if zlib support is available. Any
+ * compressed revisions will be decompressed on load regardless of this setting
+ * *but will not be readable at all* if zlib support is not available.
+ */
+$wgCompressRevisions = false;
+
+/**
+ * External stores allow including content
+ * from non database sources following URL links
+ *
+ * Short names of ExternalStore classes may be specified in an array here:
+ * $wgExternalStores = array("http","file","custom")...
+ *
+ * CAUTION: Access to database might lead to code execution
+ */
+$wgExternalStores = false;
+
+/**
+ * An array of external mysql servers, e.g.
+ * $wgExternalServers = array( 'cluster1' => array( 'srv28', 'srv29', 'srv30' ) );
+ * Used by LBFactory_Simple, may be ignored if $wgLBFactoryConf is set to another class.
+ */
+$wgExternalServers = array();
+
+/**
+ * The place to put new revisions, false to put them in the local text table.
+ * Part of a URL, e.g. DB://cluster1
+ *
+ * Can be an array instead of a single string, to enable data distribution. Keys
+ * must be consecutive integers, starting at zero. Example:
+ *
+ * $wgDefaultExternalStore = array( 'DB://cluster1', 'DB://cluster2' );
+ *
+ */
+$wgDefaultExternalStore = false;
+
+/**
+ * Revision text may be cached in $wgMemc to reduce load on external storage
+ * servers and object extraction overhead for frequently-loaded revisions.
+ *
+ * Set to 0 to disable, or number of seconds before cache expiry.
+ */
+$wgRevisionCacheExpiry = 0;
+
+/** @} */ # end text storage }
+
+/************************************************************************//**
+ * @name Performance hacks and limits
+ * @{
+ */
+/** Disable database-intensive features */
+$wgMiserMode = false;
+/** Disable all query pages if miser mode is on, not just some */
+$wgDisableQueryPages = false;
+/** Number of rows to cache in 'querycache' table when miser mode is on */
+$wgQueryCacheLimit = 1000;
+/** Number of links to a page required before it is deemed "wanted" */
+$wgWantedPagesThreshold = 1;
+/** Enable slow parser functions */
+$wgAllowSlowParserFunctions = false;
+
+/**
+ * Do DELETE/INSERT for link updates instead of incremental
+ */
+$wgUseDumbLinkUpdate = false;
+
+/**
+ * Anti-lock flags - bitfield
+ * - ALF_PRELOAD_LINKS:
+ * Preload links during link update for save
+ * - ALF_PRELOAD_EXISTENCE:
+ * Preload cur_id during replaceLinkHolders
+ * - ALF_NO_LINK_LOCK:
+ * Don't use locking reads when updating the link table. This is
+ * necessary for wikis with a high edit rate for performance
+ * reasons, but may cause link table inconsistency
+ * - ALF_NO_BLOCK_LOCK:
+ * As for ALF_LINK_LOCK, this flag is a necessity for high-traffic
+ * wikis.
+ */
+$wgAntiLockFlags = 0;
+
+/**
+ * Maximum article size in kilobytes
+ */
+$wgMaxArticleSize = 2048;
+
+/**
+ * The minimum amount of memory that MediaWiki "needs"; MediaWiki will try to
+ * raise PHP's memory limit if it's below this amount.
+ */
+$wgMemoryLimit = "50M";
+
+/** @} */ # end performance hacks }
+
+/************************************************************************//**
+ * @name Cache settings
+ * @{
+ */
+
+/**
+ * Directory for caching data in the local filesystem. Should not be accessible
+ * from the web. Set this to false to not use any local caches.
+ *
+ * Note: if multiple wikis share the same localisation cache directory, they
+ * must all have the same set of extensions. You can set a directory just for
+ * the localisation cache using $wgLocalisationCacheConf['storeDirectory'].
+ */
+$wgCacheDirectory = false;
+
+/**
+ * Main cache type. This should be a cache with fast access, but it may have
+ * limited space. By default, it is disabled, since the database is not fast
+ * enough to make it worthwhile.
+ *
+ * The options are:
+ *
+ * - CACHE_ANYTHING: Use anything, as long as it works
+ * - CACHE_NONE: Do not cache
+ * - CACHE_DB: Store cache objects in the DB
+ * - CACHE_MEMCACHED: MemCached, must specify servers in $wgMemCachedServers
+ * - CACHE_ACCEL: eAccelerator, APC, XCache or WinCache
+ * - CACHE_DBA: Use PHP's DBA extension to store in a DBM-style
+ * database. This is slow, and is not recommended for
+ * anything other than debugging.
+ *
+ * @see $wgMessageCacheType, $wgParserCacheType
*/
$wgMainCacheType = CACHE_NONE;
+
+/**
+ * The cache type for storing the contents of the MediaWiki namespace. This
+ * cache is used for a small amount of data which is expensive to regenerate.
+ *
+ * For available types see $wgMainCacheType.
+ */
$wgMessageCacheType = CACHE_ANYTHING;
+
+/**
+ * The cache type for storing article HTML. This is used to store data which
+ * is expensive to regenerate, and benefits from having plenty of storage space.
+ *
+ * For available types see $wgMainCacheType.
+ */
$wgParserCacheType = CACHE_ANYTHING;
-/**@}*/
+/**
+ * The expiry time for the parser cache, in seconds. The default is 86.4k
+ * seconds, otherwise known as a day.
+ */
$wgParserCacheExpireTime = 86400;
-// Select which DBA handler <http://www.php.net/manual/en/dba.requirements.php> to use as CACHE_DBA backend
+/**
+ * Select which DBA handler <http://www.php.net/manual/en/dba.requirements.php> to use as CACHE_DBA backend
+ */
$wgDBAhandler = 'db3';
+/**
+ * Store sessions in MemCached. This can be useful to improve performance, or to
+ * avoid the locking behaviour of PHP's default session handler, which tends to
+ * prevent multiple requests for the same user from acting concurrently.
+ */
$wgSessionsInMemcached = false;
-/** This is used for setting php's session.save_handler. In practice, you will
+/**
+ * This is used for setting php's session.save_handler. In practice, you will
* almost never need to change this ever. Other options might be 'user' or
* 'session_mysql.' Setting to null skips setting this entirely (which might be
- * useful if you're doing cross-application sessions, see bug 11381) */
+ * useful if you're doing cross-application sessions, see bug 11381)
+ */
$wgSessionHandler = 'files';
-/**@{
- * Memcached-specific settings
- * See docs/memcached.txt
- */
-$wgUseMemCached = false;
-$wgMemCachedDebug = false; ///< Will be set to false in Setup.php, if the server isn't working
+/** If enabled, will send MemCached debugging information to $wgDebugLogFile */
+$wgMemCachedDebug = false;
+
+/** The list of MemCached servers and port numbers */
$wgMemCachedServers = array( '127.0.0.1:11000' );
+
+/**
+ * Use persistent connections to MemCached, which are shared across multiple
+ * requests.
+ */
$wgMemCachedPersistent = false;
-$wgMemCachedTimeout = 100000; //Data timeout in microseconds
-/**@}*/
+
+/**
+ * Read/write timeout for MemCached server communication, in microseconds.
+ */
+$wgMemCachedTimeout = 100000;
/**
* Set this to true to make a local copy of the message cache, for use in
@@ -837,17 +1572,222 @@ $wgLocalisationCacheConf = array(
'manualRecache' => false,
);
-# Language settings
-#
+/** Allow client-side caching of pages */
+$wgCachePages = true;
+
+/**
+ * Set this to current time to invalidate all prior cached pages. Affects both
+ * client- and server-side caching.
+ * You can get the current date on your server by using the command:
+ * date +%Y%m%d%H%M%S
+ */
+$wgCacheEpoch = '20030516000000';
+
+/**
+ * Bump this number when changing the global style sheets and JavaScript.
+ * It should be appended in the query string of static CSS and JS includes,
+ * to ensure that client-side caches do not keep obsolete copies of global
+ * styles.
+ */
+$wgStyleVersion = '301';
+
+/**
+ * This will cache static pages for non-logged-in users to reduce
+ * database traffic on public sites.
+ * Must set $wgShowIPinHeader = false
+ */
+$wgUseFileCache = false;
+
+/**
+ * Directory where the cached page will be saved.
+ * Defaults to "$wgCacheDirectory/html".
+ */
+$wgFileCacheDirectory = false;
+
+/**
+ * Depth of the subdirectory hierarchy to be created under
+ * $wgFileCacheDirectory. The subdirectories will be named based on
+ * the MD5 hash of the title. A value of 0 means all cache files will
+ * be put directly into the main file cache directory.
+ */
+$wgFileCacheDepth = 2;
+
+/**
+ * Keep parsed pages in a cache (objectcache table or memcached)
+ * to speed up output of the same page viewed by another user with the
+ * same options.
+ *
+ * This can provide a significant speedup for medium to large pages,
+ * so you probably want to keep it on. Extensions that conflict with the
+ * parser cache should disable the cache on a per-page basis instead.
+ */
+$wgEnableParserCache = true;
+
+/**
+ * Append a configured value to the parser cache and the sitenotice key so
+ * that they can be kept separate for some class of activity.
+ */
+$wgRenderHashAppend = '';
+
+/**
+ * If on, the sidebar navigation links are cached for users with the
+ * current language set. This can save a touch of load on a busy site
+ * by shaving off extra message lookups.
+ *
+ * However it is also fragile: changing the site configuration, or
+ * having a variable $wgArticlePath, can produce broken links that
+ * don't update as expected.
+ */
+$wgEnableSidebarCache = false;
+
+/**
+ * Expiry time for the sidebar cache, in seconds
+ */
+$wgSidebarCacheExpiry = 86400;
+
+/**
+ * When using the file cache, we can store the cached HTML gzipped to save disk
+ * space. Pages will then also be served compressed to clients that support it.
+ * THIS IS NOT COMPATIBLE with ob_gzhandler which is now enabled if supported in
+ * the default LocalSettings.php! If you enable this, remove that setting first.
+ *
+ * Requires zlib support enabled in PHP.
+ */
+$wgUseGzip = false;
+
+/**
+ * Whether MediaWiki should send an ETag header. Seems to cause
+ * broken behavior with Squid 2.6, see bug 7098.
+ */
+$wgUseETag = false;
+
+/** Clock skew or the one-second resolution of time() can occasionally cause cache
+ * problems when the user requests two pages within a short period of time. This
+ * variable adds a given number of seconds to vulnerable timestamps, thereby giving
+ * a grace period.
+ */
+$wgClockSkewFudge = 5;
+
+/**
+ * Invalidate various caches when LocalSettings.php changes. This is equivalent
+ * to setting $wgCacheEpoch to the modification time of LocalSettings.php, as
+ * was previously done in the default LocalSettings.php file.
+ *
+ * On high-traffic wikis, this should be set to false, to avoid the need to
+ * check the file modification time, and to avoid the performance impact of
+ * unnecessary cache invalidations.
+ */
+$wgInvalidateCacheOnLocalSettingsChange = true;
+
+/** @} */ # end of cache settings
+
+/************************************************************************//**
+ * @name HTTP proxy (Squid) settings
+ *
+ * Many of these settings apply to any HTTP proxy used in front of MediaWiki,
+ * although they are referred to as Squid settings for historical reasons.
+ *
+ * Achieving a high hit ratio with an HTTP proxy requires special
+ * configuration. See http://www.mediawiki.org/wiki/Manual:Squid_caching for
+ * more details.
+ *
+ * @{
+ */
+
+/**
+ * Enable/disable Squid.
+ * See http://www.mediawiki.org/wiki/Manual:Squid_caching
+ */
+$wgUseSquid = false;
+
+/** If you run Squid3 with ESI support, enable this (default:false): */
+$wgUseESI = false;
+
+/** Send X-Vary-Options header for better caching (requires patched Squid) */
+$wgUseXVO = false;
+
+/**
+ * Internal server name as known to Squid, if different. Example:
+ * <code>
+ * $wgInternalServer = 'http://yourinternal.tld:8000';
+ * </code>
+ */
+$wgInternalServer = $wgServer;
+
+/**
+ * Cache timeout for the squid, will be sent as s-maxage (without ESI) or
+ * Surrogate-Control (with ESI). Without ESI, you should strip out s-maxage in
+ * the Squid config. 18000 seconds = 5 hours, more cache hits with 2678400 = 31
+ * days
+ */
+$wgSquidMaxage = 18000;
+
+/**
+ * Default maximum age for raw CSS/JS accesses
+ */
+$wgForcedRawSMaxage = 300;
+
+/**
+ * List of proxy servers to purge on changes; default port is 80. Use IP addresses.
+ *
+ * When MediaWiki is running behind a proxy, it will trust X-Forwarded-For
+ * headers sent/modified from these proxies when obtaining the remote IP address
+ *
+ * For a list of trusted servers which *aren't* purged, see $wgSquidServersNoPurge.
+ */
+$wgSquidServers = array();
+
+/**
+ * As above, except these servers aren't purged on page changes; use to set a
+ * list of trusted proxies, etc.
+ */
+$wgSquidServersNoPurge = array();
+
+/** Maximum number of titles to purge in any one client operation */
+$wgMaxSquidPurgeTitles = 400;
+
+/**
+ * HTCP multicast address. Set this to a multicast IP address to enable HTCP.
+ *
+ * Note that MediaWiki uses the old non-RFC compliant HTCP format, which was
+ * present in the earliest Squid implementations of the protocol.
+ */
+$wgHTCPMulticastAddress = false;
+
+/**
+ * HTCP multicast port.
+ * @see $wgHTCPMulticastAddress
+ */
+$wgHTCPPort = 4827;
+
+/**
+ * HTCP multicast TTL.
+ * @see $wgHTCPMulticastAddress
+ */
+$wgHTCPMulticastTTL = 1;
+
+/** Should forwarded Private IPs be accepted? */
+$wgUsePrivateIPs = false;
+
+/** @} */ # end of HTTP proxy settings
+
+/************************************************************************//**
+ * @name Language, regional and character encoding settings
+ * @{
+ */
+
/** Site language code, should be one of ./languages/Language(.*).php */
$wgLanguageCode = 'en';
/**
* Some languages need different word forms, usually for different cases.
- * Used in Language::convertGrammar().
+ * Used in Language::convertGrammar(). Example:
+ *
+ * <code>
+ * $wgGrammarForms['en']['genitive']['car'] = 'car\'s';
+ * </code>
*/
$wgGrammarForms = array();
-#$wgGrammarForms['en']['genitive']['car'] = 'car\'s';
/** Treat language links as magic connectors, not inline links */
$wgInterwikiMagic = true;
@@ -863,28 +1803,48 @@ $wgExtraLanguageNames = array();
* These codes are leftoffs from renames, or other legacy things.
* Also, qqq is a dummy "language" for documenting messages.
*/
-$wgDummyLanguageCodes = array( 'qqq', 'als', 'be-x-old', 'dk', 'fiu-vro', 'iu', 'nb', 'simple', 'tp' );
+$wgDummyLanguageCodes = array(
+ 'als',
+ 'bat-smg',
+ 'be-x-old',
+ 'dk',
+ 'fiu-vro',
+ 'iu',
+ 'nb',
+ 'qqq',
+ 'simple',
+ 'tp',
+);
-/** We speak UTF-8 all the time now, unless some oddities happen */
+/** @deprecated Since MediaWiki 1.5, this must always be set to UTF-8. */
$wgInputEncoding = 'UTF-8';
+/** @deprecated Since MediaWiki 1.5, this must always be set to UTF-8. */
$wgOutputEncoding = 'UTF-8';
+
+/**
+ * Character set for use in the article edit box. Language-specific encodings
+ * may be defined.
+ *
+ * This historic feature is one of the first that was added by former MediaWiki
+ * team leader Brion Vibber, and is used to support the Esperanto x-system.
+ */
$wgEditEncoding = '';
/**
- * Set this to true to replace Arabic presentation forms with their standard
+ * Set this to true to replace Arabic presentation forms with their standard
* forms in the U+0600-U+06FF block. This only works if $wgLanguageCode is
* set to "ar".
*
- * Note that pages with titles containing presentation forms will become
+ * Note that pages with titles containing presentation forms will become
* inaccessible, run maintenance/cleanupTitles.php to fix this.
*/
$wgFixArabicUnicode = true;
/**
* Set this to true to replace ZWJ-based chillu sequences in Malayalam text
- * with their Unicode 5.1 equivalents. This only works if $wgLanguageCode is
- * set to "ml". Note that some clients (even new clients as of 2010) do not
- * support these characters.
+ * with their Unicode 5.1 equivalents. This only works if $wgLanguageCode is
+ * set to "ml". Note that some clients (even new clients as of 2010) do not
+ * support these characters.
*
* If you enable this on an existing wiki, run maintenance/cleanupTitles.php to
* fix any ZWJ sequences in existing page titles.
@@ -892,25 +1852,71 @@ $wgFixArabicUnicode = true;
$wgFixMalayalamUnicode = true;
/**
- * Locale for LC_CTYPE, to work around http://bugs.php.net/bug.php?id=45132
- * For Unix-like operating systems, set this to to a locale that has a UTF-8
- * character set. Only the character set is relevant.
+ * Set this to always convert certain Unicode sequences to modern ones
+ * regardless of the content language. This has a small performance
+ * impact.
+ *
+ * See $wgFixArabicUnicode and $wgFixMalayalamUnicode for conversion
+ * details.
+ *
+ * @since 1.17
*/
-$wgShellLocale = 'en_US.utf8';
+$wgAllUnicodeFixes = false;
/**
- * Set this to eg 'ISO-8859-1' to perform character set
- * conversion when loading old revisions not marked with
- * "utf-8" flag. Use this when converting wiki to UTF-8
- * without the burdensome mass conversion of old text data.
+ * Set this to eg 'ISO-8859-1' to perform character set conversion when
+ * loading old revisions not marked with "utf-8" flag. Use this when
+ * converting a wiki from MediaWiki 1.4 or earlier to UTF-8 without the
+ * burdensome mass conversion of old text data.
*
- * NOTE! This DOES NOT touch any fields other than old_text.
- * Titles, comments, user names, etc still must be converted
- * en masse in the database before continuing as a UTF-8 wiki.
+ * NOTE! This DOES NOT touch any fields other than old_text.Titles, comments,
+ * user names, etc still must be converted en masse in the database before
+ * continuing as a UTF-8 wiki.
*/
$wgLegacyEncoding = false;
/**
+ * Browser Blacklist for unicode non compliant browsers. Contains a list of
+ * regexps : "/regexp/" matching problematic browsers. These browsers will
+ * be served encoded unicode in the edit box instead of real unicode.
+ */
+$wgBrowserBlackList = array(
+ /**
+ * Netscape 2-4 detection
+ * The minor version may contain strings such as "Gold" or "SGoldC-SGI"
+ * Lots of non-netscape user agents have "compatible", so it's useful to check for that
+ * with a negative assertion. The [UIN] identifier specifies the level of security
+ * in a Netscape/Mozilla browser, checking for it rules out a number of fakers.
+ * The language string is unreliable, it is missing on NS4 Mac.
+ *
+ * Reference: http://www.psychedelix.com/agents/index.shtml
+ */
+ '/^Mozilla\/2\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
+ '/^Mozilla\/3\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
+ '/^Mozilla\/4\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
+
+ /**
+ * MSIE on Mac OS 9 is teh sux0r, converts þ to <thorn>, ð to <eth>, Þ to <THORN> and Ð to <ETH>
+ *
+ * Known useragents:
+ * - Mozilla/4.0 (compatible; MSIE 5.0; Mac_PowerPC)
+ * - Mozilla/4.0 (compatible; MSIE 5.15; Mac_PowerPC)
+ * - Mozilla/4.0 (compatible; MSIE 5.23; Mac_PowerPC)
+ * - [...]
+ *
+ * @link http://en.wikipedia.org/w/index.php?title=User%3A%C6var_Arnfj%F6r%F0_Bjarmason%2Ftestme&diff=12356041&oldid=12355864
+ * @link http://en.wikipedia.org/wiki/Template%3AOS9
+ */
+ '/^Mozilla\/4\.0 \(compatible; MSIE \d+\.\d+; Mac_PowerPC\)/',
+
+ /**
+ * Google wireless transcoder, seems to eat a lot of chars alive
+ * http://it.wikipedia.org/w/index.php?title=Luciano_Ligabue&diff=prev&oldid=8857361
+ */
+ '/^Mozilla\/4\.0 \(compatible; MSIE 6.0; Windows NT 5.0; Google Wireless Transcoder;\)/'
+);
+
+/**
* If set to true, the MediaWiki 1.4 to 1.5 schema conversion will
* create stub reference rows in the text table instead of copying
* the full text of all current entries from 'cur' to 'text'.
@@ -927,17 +1933,173 @@ $wgLegacyEncoding = false;
*/
$wgLegacySchemaConversion = false;
+/**
+ * Enable to allow rewriting dates in page text.
+ * DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES.
+ */
+$wgUseDynamicDates = false;
+/**
+ * Enable dates like 'May 12' instead of '12 May', this only takes effect if
+ * the interface is set to English.
+ */
+$wgAmericanDates = false;
+/**
+ * For Hindi and Arabic use local numerals instead of Western style (0-9)
+ * numerals in interface.
+ */
+$wgTranslateNumerals = true;
+
+/**
+ * Translation using MediaWiki: namespace.
+ * Interface messages will be loaded from the database.
+ */
+$wgUseDatabaseMessages = true;
+
+/**
+ * Expiry time for the message cache key
+ */
+$wgMsgCacheExpiry = 86400;
+
+/**
+ * Maximum entry size in the message cache, in bytes
+ */
+$wgMaxMsgCacheEntrySize = 10000;
+
+/** Whether to enable language variant conversion. */
+$wgDisableLangConversion = false;
+
+/** Whether to enable language variant conversion for links. */
+$wgDisableTitleConversion = false;
+
+/** Whether to enable cononical language links in meta data. */
+$wgCanonicalLanguageLinks = true;
+
+/** Default variant code, if false, the default will be the language code */
+$wgDefaultLanguageVariant = false;
+
+/**
+ * Disabled variants array of language variant conversion. Example:
+ * <code>
+ * $wgDisabledVariants[] = 'zh-mo';
+ * $wgDisabledVariants[] = 'zh-my';
+ * </code>
+ *
+ * or:
+ *
+ * <code>
+ * $wgDisabledVariants = array('zh-mo', 'zh-my');
+ * </code>
+ */
+$wgDisabledVariants = array();
+
+/**
+ * Like $wgArticlePath, but on multi-variant wikis, this provides a
+ * path format that describes which parts of the URL contain the
+ * language variant. For Example:
+ *
+ * $wgLanguageCode = 'sr';
+ * $wgVariantArticlePath = '/$2/$1';
+ * $wgArticlePath = '/wiki/$1';
+ *
+ * A link to /wiki/ would be redirected to /sr/Главна_страна
+ *
+ * It is important that $wgArticlePath not overlap with possible values
+ * of $wgVariantArticlePath.
+ */
+$wgVariantArticlePath = false;
+
+/**
+ * Show a bar of language selection links in the user login and user
+ * registration forms; edit the "loginlanguagelinks" message to
+ * customise these.
+ */
+$wgLoginLanguageSelector = false;
+
+/**
+ * When translating messages with wfMsg(), it is not always clear what should
+ * be considered UI messages and what should be content messages.
+ *
+ * For example, for the English Wikipedia, there should be only one 'mainpage',
+ * so when getting the link for 'mainpage', we should treat it as site content
+ * and call wfMsgForContent(), but for rendering the text of the link, we call
+ * wfMsg(). The code behaves this way by default. However, sites like the
+ * Wikimedia Commons do offer different versions of 'mainpage' and the like for
+ * different languages. This array provides a way to override the default
+ * behavior. For example, to allow language-specific main page and community
+ * portal, set
+ *
+ * $wgForceUIMsgAsContentMsg = array( 'mainpage', 'portal-url' );
+ */
+$wgForceUIMsgAsContentMsg = array();
+
+/**
+ * Fake out the timezone that the server thinks it's in. This will be used for
+ * date display and not for what's stored in the DB. Leave to null to retain
+ * your server's OS-based timezone value.
+ *
+ * This variable is currently used only for signature formatting and for local
+ * time/date parser variables ({{LOCALTIME}} etc.)
+ *
+ * Timezones can be translated by editing MediaWiki messages of type
+ * timezone-nameinlowercase like timezone-utc.
+ *
+ * Examples:
+ * <code>
+ * $wgLocaltimezone = 'GMT';
+ * $wgLocaltimezone = 'PST8PDT';
+ * $wgLocaltimezone = 'Europe/Sweden';
+ * $wgLocaltimezone = 'CET';
+ * </code>
+ */
+$wgLocaltimezone = null;
+
+/**
+ * Set an offset from UTC in minutes to use for the default timezone setting
+ * for anonymous users and new user accounts.
+ *
+ * This setting is used for most date/time displays in the software, and is
+ * overrideable in user preferences. It is *not* used for signature timestamps.
+ *
+ * You can set it to match the configured server timezone like this:
+ * $wgLocalTZoffset = date("Z") / 60;
+ *
+ * If your server is not configured for the timezone you want, you can set
+ * this in conjunction with the signature timezone and override the PHP default
+ * timezone like so:
+ * $wgLocaltimezone="Europe/Berlin";
+ * date_default_timezone_set( $wgLocaltimezone );
+ * $wgLocalTZoffset = date("Z") / 60;
+ *
+ * Leave at NULL to show times in universal time (UTC/GMT).
+ */
+$wgLocalTZoffset = null;
+
+/** @} */ # End of language/charset settings
+
+/*************************************************************************//**
+ * @name Output format and skin settings
+ * @{
+ */
+
+/** The default Content-Type header. */
$wgMimeType = 'text/html';
+
+/** The content type used in script tags. */
$wgJsMimeType = 'text/javascript';
+
+/** The HTML document type. */
$wgDocType = '-//W3C//DTD XHTML 1.0 Transitional//EN';
+
+/** The URL of the document type declaration. */
$wgDTD = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd';
+
+/** The default xmlns attribute. */
$wgXhtmlDefaultNamespace = 'http://www.w3.org/1999/xhtml';
/**
- * Should we output an HTML5 doctype? This mode is still experimental, but
- * all indications are that it should be usable, so it's enabled by default.
- * If all goes well, it will be removed and become always true before the 1.16
- * release.
+ * Should we output an HTML5 doctype? If false, use XHTML 1.0 Transitional
+ * instead, and disable HTML5 features. This may eventually be removed and set
+ * to always true.
*/
$wgHtml5 = true;
@@ -986,106 +2148,421 @@ $wgWellFormedXml = true;
*/
$wgXhtmlNamespaces = array();
-/** Enable to allow rewriting dates in page text.
- * DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES */
-$wgUseDynamicDates = false;
-/** Enable dates like 'May 12' instead of '12 May', this only takes effect if
- * the interface is set to English
+/**
+ * Show IP address, for non-logged in users. It's necessary to switch this off
+ * for some forms of caching.
*/
-$wgAmericanDates = false;
+$wgShowIPinHeader = true;
+
/**
- * For Hindi and Arabic use local numerals instead of Western style (0-9)
- * numerals in interface.
+ * Site notice shown at the top of each page
+ *
+ * MediaWiki:Sitenotice page, which will override this. You can also
+ * provide a separate message for logged-out users using the
+ * MediaWiki:Anonnotice page.
*/
-$wgTranslateNumerals = true;
+$wgSiteNotice = '';
/**
- * Translation using MediaWiki: namespace.
- * Interface messages will be loaded from the database.
+ * A subtitle to add to the tagline, for skins that have it/
*/
-$wgUseDatabaseMessages = true;
+$wgExtraSubtitle = '';
/**
- * Expiry time for the message cache key
+ * If this is set, a "donate" link will appear in the sidebar. Set it to a URL.
*/
-$wgMsgCacheExpiry = 86400;
+$wgSiteSupportPage = '';
/**
- * Maximum entry size in the message cache, in bytes
+ * Validate the overall output using tidy and refuse
+ * to display the page if it's not valid.
*/
-$wgMaxMsgCacheEntrySize = 10000;
+$wgValidateAllHtml = false;
/**
- * If true, serialized versions of the messages arrays will be
- * read from the 'serialized' subdirectory if they are present.
- * Set to false to always use the Messages files, regardless of
- * whether they are up to date or not.
+ * Default skin, for new users and anonymous visitors. Registered users may
+ * change this to any one of the other available skins in their preferences.
+ * This has to be completely lowercase; see the "skins" directory for the list
+ * of available skins.
*/
-$wgEnableSerializedMessages = true;
+$wgDefaultSkin = 'vector';
+
+/**
+* Should we allow the user's to select their own skin that will override the default?
+* @deprecated in 1.16, use $wgHiddenPrefs[] = 'skin' to disable it
+*/
+$wgAllowUserSkin = true;
/**
- * Set to false if you are thorough system admin who always remembers to keep
- * serialized files up to date to save few mtime calls.
+ * Specify the name of a skin that should not be presented in the list of
+ * available skins. Use for blacklisting a skin which you do not want to
+ * remove from the .../skins/ directory
*/
-$wgCheckSerialized = true;
+$wgSkipSkin = '';
+/** Array for more like $wgSkipSkin. */
+$wgSkipSkins = array();
-/** Whether to enable language variant conversion. */
-$wgDisableLangConversion = false;
+/**
+ * Optionally, we can specify a stylesheet to use for media="handheld".
+ * This is recognized by some, but not all, handheld/mobile/PDA browsers.
+ * If left empty, compliant handheld browsers won't pick up the skin
+ * stylesheet, which is specified for 'screen' media.
+ *
+ * Can be a complete URL, base-relative path, or $wgStylePath-relative path.
+ * Try 'chick/main.css' to apply the Chick styles to the MonoBook HTML.
+ *
+ * Will also be switched in when 'handheld=yes' is added to the URL, like
+ * the 'printable=yes' mode for print media.
+ */
+$wgHandheldStyle = false;
-/** Whether to enable language variant conversion for links. */
-$wgDisableTitleConversion = false;
+/**
+ * If set, 'screen' and 'handheld' media specifiers for stylesheets are
+ * transformed such that they apply to the iPhone/iPod Touch Mobile Safari,
+ * which doesn't recognize 'handheld' but does support media queries on its
+ * screen size.
+ *
+ * Consider only using this if you have a *really good* handheld stylesheet,
+ * as iPhone users won't have any way to disable it and use the "grown-up"
+ * styles instead.
+ */
+$wgHandheldForIPhone = false;
-/** Default variant code, if false, the default will be the language code */
-$wgDefaultLanguageVariant = false;
+/**
+ * Allow user Javascript page?
+ * This enables a lot of neat customizations, but may
+ * increase security risk to users and server load.
+ */
+$wgAllowUserJs = false;
-/** Disabled variants array of language variant conversion.
- * example:
- * $wgDisabledVariants[] = 'zh-mo';
- * $wgDisabledVariants[] = 'zh-my';
+/**
+ * Allow user Cascading Style Sheets (CSS)?
+ * This enables a lot of neat customizations, but may
+ * increase security risk to users and server load.
+ */
+$wgAllowUserCss = false;
+
+/**
+ * Allow user-preferences implemented in CSS?
+ * This allows users to customise the site appearance to a greater
+ * degree; disabling it will improve page load times.
+ */
+$wgAllowUserCssPrefs = true;
+
+/** Use the site's Javascript page? */
+$wgUseSiteJs = true;
+
+/** Use the site's Cascading Style Sheets (CSS)? */
+$wgUseSiteCss = true;
+
+/**
+ * Set to false to disable application of access keys and tooltips,
+ * eg to avoid keyboard conflicts with system keys or as a low-level
+ * optimization.
+ */
+$wgEnableTooltipsAndAccesskeys = true;
+
+/**
+ * Break out of framesets. This can be used to prevent clickjacking attacks,
+ * or to prevent external sites from framing your site with ads.
+ */
+$wgBreakFrames = false;
+
+/**
+ * The X-Frame-Options header to send on pages sensitive to clickjacking
+ * attacks, such as edit pages. This prevents those pages from being displayed
+ * in a frame or iframe. The options are:
*
- * or:
- * $wgDisabledVariants = array('zh-mo', 'zh-my');
+ * - 'DENY': Do not allow framing. This is recommended for most wikis.
+ *
+ * - 'SAMEORIGIN': Allow framing by pages on the same domain. This can be used
+ * to allow framing within a trusted domain. This is insecure if there
+ * is a page on the same domain which allows framing of arbitrary URLs.
+ *
+ * - false: Allow all framing. This opens up the wiki to XSS attacks and thus
+ * full compromise of local user accounts. Private wikis behind a
+ * corporate firewall are especially vulnerable. This is not
+ * recommended.
+ *
+ * For extra safety, set $wgBreakFrames = true, to prevent framing on all pages,
+ * not just edit pages.
*/
-$wgDisabledVariants = array();
+$wgEditPageFrameOptions = 'DENY';
/**
- * Like $wgArticlePath, but on multi-variant wikis, this provides a
- * path format that describes which parts of the URL contain the
- * language variant. For Example:
+ * Disable output compression (enabled by default if zlib is available)
+ */
+$wgDisableOutputCompression = false;
+
+/**
+ * Should we allow a broader set of characters in id attributes, per HTML5? If
+ * not, use only HTML 4-compatible IDs. This option is for testing -- when the
+ * functionality is ready, it will be on by default with no option.
*
- * $wgLanguageCode = 'sr';
- * $wgVariantArticlePath = '/$2/$1';
- * $wgArticlePath = '/wiki/$1';
+ * Currently this appears to work fine in all browsers, but it's disabled by
+ * default because it normalizes id's a bit too aggressively, breaking preexisting
+ * content (particularly Cite). See bug 27733, bug 27694, bug 27474.
+ */
+$wgExperimentalHtmlIds = false;
+
+/**
+ * Abstract list of footer icons for skins in place of old copyrightico and poweredbyico code
+ * You can add new icons to the built in copyright or poweredby, or you can create
+ * a new block. Though note that you may need to add some custom css to get good styling
+ * of new blocks in monobook. vector and modern should work without any special css.
+ *
+ * $wgFooterIcons itself is a key/value array.
+ * The key is the name of a block that the icons will be wrapped in. The final id varies
+ * by skin; Monobook and Vector will turn poweredby into f-poweredbyico while Modern
+ * turns it into mw_poweredby.
+ * The value is either key/value array of icons or a string.
+ * In the key/value array the key may or may not be used by the skin but it can
+ * be used to find the icon and unset it or change the icon if needed.
+ * This is useful for disabling icons that are set by extensions.
+ * The value should be either a string or an array. If it is a string it will be output
+ * directly as html, however some skins may choose to ignore it. An array is the preferred format
+ * for the icon, the following keys are used:
+ * src: An absolute url to the image to use for the icon, this is recommended
+ * but not required, however some skins will ignore icons without an image
+ * url: The url to use in the <a> arround the text or icon, if not set an <a> will not be outputted
+ * alt: This is the text form of the icon, it will be displayed without an image in
+ * skins like Modern or if src is not set, and will otherwise be used as
+ * the alt="" for the image. This key is required.
+ * width and height: If the icon specified by src is not of the standard size
+ * you can specify the size of image to use with these keys.
+ * Otherwise they will default to the standard 88x31.
+ */
+$wgFooterIcons = array(
+ "copyright" => array(
+ "copyright" => array(), // placeholder for the built in copyright icon
+ ),
+ "poweredby" => array(
+ "mediawiki" => array(
+ "src" => null, // Defaults to "$wgStylePath/common/images/poweredby_mediawiki_88x31.png"
+ "url" => "http://www.mediawiki.org/",
+ "alt" => "Powered by MediaWiki",
+ )
+ ),
+);
+
+/**
+ * Search form behavior for Vector skin only
+ * true = use an icon search button
+ * false = use Go & Search buttons
+ */
+$wgVectorUseSimpleSearch = false;
+
+/**
+ * Watch and unwatch as an icon rather than a link for Vector skin only
+ * true = use an icon watch/unwatch button
+ * false = use watch/unwatch text link
+ */
+$wgVectorUseIconWatch = false;
+
+/**
+ * Show the name of the current variant as a label in the variants drop-down menu
+ */
+$wgVectorShowVariantName = false;
+
+/**
+ * Display user edit counts in various prominent places.
+ */
+$wgEdititis = false;
+
+/**
+ * Experimental better directionality support.
+ */
+$wgBetterDirectionality = false;
+
+
+/** @} */ # End of output format settings }
+
+/*************************************************************************//**
+ * @name Resource loader settings
+ * @{
+ */
+
+/**
+ * Client-side resource modules. Extensions should add their module definitions
+ * here.
*
- * A link to /wiki/ would be redirected to /sr/Главна_страна
+ * Example:
+ * $wgResourceModules['ext.myExtension'] = array(
+ * 'scripts' => 'myExtension.js',
+ * 'styles' => 'myExtension.css',
+ * 'dependencies' => array( 'jquery.cookie', 'jquery.tabIndex' ),
+ * 'localBasePath' => dirname( __FILE__ ),
+ * 'remoteExtPath' => 'MyExtension',
+ * );
+ */
+$wgResourceModules = array();
+
+/**
+ * Maximum time in seconds to cache resources served by the resource loader
+ */
+$wgResourceLoaderMaxage = array(
+ 'versioned' => array(
+ // Squid/Varnish but also any other public proxy cache between the client and MediaWiki
+ 'server' => 30 * 24 * 60 * 60, // 30 days
+ // On the client side (e.g. in the browser cache).
+ 'client' => 30 * 24 * 60 * 60, // 30 days
+ ),
+ 'unversioned' => array(
+ 'server' => 5 * 60, // 5 minutes
+ 'client' => 5 * 60, // 5 minutes
+ ),
+);
+
+/**
+ * Whether to embed private modules inline with HTML output or to bypass
+ * caching and check the user parameter against $wgUser to prevent
+ * unauthorized access to private modules.
+ */
+$wgResourceLoaderInlinePrivateModules = true;
+
+/**
+ * The default debug mode (on/off) for of ResourceLoader requests. This will still
+ * be overridden when the debug URL parameter is used.
+ */
+$wgResourceLoaderDebug = false;
+
+/**
+ * Enable embedding of certain resources using Edge Side Includes. This will
+ * improve performance but only works if there is something in front of the
+ * web server (e..g a Squid or Varnish server) configured to process the ESI.
+ */
+$wgResourceLoaderUseESI = false;
+
+/**
+ * Put each statement on its own line when minifying JavaScript. This makes
+ * debugging in non-debug mode a bit easier.
+ */
+$wgResourceLoaderMinifierStatementsOnOwnLine = false;
+
+/**
+ * Maximum line length when minifying JavaScript. This is not a hard maximum:
+ * the minifier will try not to produce lines longer than this, but may be
+ * forced to do so in certain cases.
+ */
+$wgResourceLoaderMinifierMaxLineLength = 1000;
+
+/**
+ * Whether to include the mediawiki.legacy JS library (old wikibits.js), and its
+ * dependencies
+ */
+$wgIncludeLegacyJavaScript = true;
+
+/**
+ * If set to a positive number, ResourceLoader will not generate URLs whose
+ * query string is more than this many characters long, and will instead use
+ * multiple requests with shorter query strings. This degrades performance,
+ * but may be needed if your web server has a low (less than, say 1024)
+ * query string length limit or a low value for suhosin.get.max_value_length
+ * that you can't increase.
*
- * It is important that $wgArticlePath not overlap with possible values
- * of $wgVariantArticlePath.
+ * If set to a negative number, ResourceLoader will assume there is no query
+ * string length limit.
+ */
+$wgResourceLoaderMaxQueryLength = -1;
+
+/** @} */ # End of resource loader settings }
+
+
+/*************************************************************************//**
+ * @name Page title and interwiki link settings
+ * @{
*/
-$wgVariantArticlePath = false;///< defaults to false
/**
- * Show a bar of language selection links in the user login and user
- * registration forms; edit the "loginlanguagelinks" message to
- * customise these
+ * Name of the project namespace. If left set to false, $wgSitename will be
+ * used instead.
*/
-$wgLoginLanguageSelector = false;
+$wgMetaNamespace = false;
+
+/**
+ * Name of the project talk namespace.
+ *
+ * Normally you can ignore this and it will be something like
+ * $wgMetaNamespace . "_talk". In some languages, you may want to set this
+ * manually for grammatical reasons.
+ */
+$wgMetaNamespaceTalk = false;
+
+/**
+ * Additional namespaces. If the namespaces defined in Language.php and
+ * Namespace.php are insufficient, you can create new ones here, for example,
+ * to import Help files in other languages. You can also override the namespace
+ * names of existing namespaces. Extensions developers should use
+ * $wgCanonicalNamespaceNames.
+ *
+ * PLEASE NOTE: Once you delete a namespace, the pages in that namespace will
+ * no longer be accessible. If you rename it, then you can access them through
+ * the new namespace name.
+ *
+ * Custom namespaces should start at 100 to avoid conflicting with standard
+ * namespaces, and should always follow the even/odd main/talk pattern.
+ */
+#$wgExtraNamespaces =
+# array(100 => "Hilfe",
+# 101 => "Hilfe_Diskussion",
+# 102 => "Aide",
+# 103 => "Discussion_Aide"
+# );
+$wgExtraNamespaces = array();
/**
- * Whether to use zhdaemon to perform Chinese text processing
- * zhdaemon is under developement, so normally you don't want to
- * use it unless for testing
+ * Namespace aliases
+ * These are alternate names for the primary localised namespace names, which
+ * are defined by $wgExtraNamespaces and the language file. If a page is
+ * requested with such a prefix, the request will be redirected to the primary
+ * name.
+ *
+ * Set this to a map from namespace names to IDs.
+ * Example:
+ * $wgNamespaceAliases = array(
+ * 'Wikipedian' => NS_USER,
+ * 'Help' => 100,
+ * );
*/
-$wgUseZhdaemon = false;
-$wgZhdaemonHost="localhost";
-$wgZhdaemonPort=2004;
+$wgNamespaceAliases = array();
+/**
+ * Allowed title characters -- regex character class
+ * Don't change this unless you know what you're doing
+ *
+ * Problematic punctuation:
+ * - []{}|# Are needed for link syntax, never enable these
+ * - <> Causes problems with HTML escaping, don't use
+ * - % Enabled by default, minor problems with path to query rewrite rules, see below
+ * - + Enabled by default, but doesn't work with path to query rewrite rules, corrupted by apache
+ * - ? Enabled by default, but doesn't work with path to PATH_INFO rewrites
+ *
+ * All three of these punctuation problems can be avoided by using an alias, instead of a
+ * rewrite rule of either variety.
+ *
+ * The problem with % is that when using a path to query rewrite rule, URLs are
+ * double-unescaped: once by Apache's path conversion code, and again by PHP. So
+ * %253F, for example, becomes "?". Our code does not double-escape to compensate
+ * for this, indeed double escaping would break if the double-escaped title was
+ * passed in the query string rather than the path. This is a minor security issue
+ * because articles can be created such that they are hard to view or edit.
+ *
+ * In some rare cases you may wish to remove + for compatibility with old links.
+ *
+ * Theoretically 0x80-0x9F of ISO 8859-1 should be disallowed, but
+ * this breaks interlanguage links
+ */
+$wgLegalTitleChars = " %!\"$&'()*,\\-.\\/0-9:;=?@A-Z\\\\^_`a-z~\\x80-\\xFF+";
-# Miscellaneous configuration settings
-#
+/**
+ * The interwiki prefix of the current wiki, or false if it doesn't have one.
+ */
+$wgLocalInterwiki = false;
-$wgLocalInterwiki = 'w';
-$wgInterwikiExpiry = 10800; # Expiry time for cache of interwiki table
+/**
+ * Expiry time for cache of interwiki table
+ */
+$wgInterwikiExpiry = 10800;
/** Interwiki caching settings.
$wgInterwikiCache specifies path to constant database file
@@ -1121,15 +2598,110 @@ $wgInterwikiFallbackSite = 'wiki';
*/
$wgRedirectSources = false;
+/**
+ * Set this to false to avoid forcing the first letter of links to capitals.
+ * WARNING: may break links! This makes links COMPLETELY case-sensitive. Links
+ * appearing with a capital at the beginning of a sentence will *not* go to the
+ * same place as links in the middle of a sentence using a lowercase initial.
+ */
+$wgCapitalLinks = true;
-$wgShowIPinHeader = true; # For non-logged in users
-$wgMaxSigChars = 255; # Maximum number of Unicode characters in signature
-$wgMaxArticleSize = 2048; # Maximum article size in kilobytes
-# Maximum number of bytes in username. You want to run the maintenance
-# script ./maintenancecheckUsernames.php once you have changed this value
-$wgMaxNameChars = 255;
+/**
+ * @since 1.16 - This can now be set per-namespace. Some special namespaces (such
+ * as Special, see MWNamespace::$alwaysCapitalizedNamespaces for the full list) must be
+ * true by default (and setting them has no effect), due to various things that
+ * require them to be so. Also, since Talk namespaces need to directly mirror their
+ * associated content namespaces, the values for those are ignored in favor of the
+ * subject namespace's setting. Setting for NS_MEDIA is taken automatically from
+ * NS_FILE.
+ * EX: $wgCapitalLinkOverrides[ NS_FILE ] = false;
+ */
+$wgCapitalLinkOverrides = array();
+
+/** Which namespaces should support subpages?
+ * See Language.php for a list of namespaces.
+ */
+$wgNamespacesWithSubpages = array(
+ NS_TALK => true,
+ NS_USER => true,
+ NS_USER_TALK => true,
+ NS_PROJECT_TALK => true,
+ NS_FILE_TALK => true,
+ NS_MEDIAWIKI => true,
+ NS_MEDIAWIKI_TALK => true,
+ NS_TEMPLATE_TALK => true,
+ NS_HELP_TALK => true,
+ NS_CATEGORY_TALK => true
+);
+
+/**
+ * Array of namespaces which can be deemed to contain valid "content", as far
+ * as the site statistics are concerned. Useful if additional namespaces also
+ * contain "content" which should be considered when generating a count of the
+ * number of articles in the wiki.
+ */
+$wgContentNamespaces = array( NS_MAIN );
+
+/**
+ * Max number of redirects to follow when resolving redirects.
+ * 1 means only the first redirect is followed (default behavior).
+ * 0 or less means no redirects are followed.
+ */
+$wgMaxRedirects = 1;
+
+/**
+ * Array of invalid page redirect targets.
+ * Attempting to create a redirect to any of the pages in this array
+ * will make the redirect fail.
+ * Userlogout is hard-coded, so it does not need to be listed here.
+ * (bug 10569) Disallow Mypage and Mytalk as well.
+ *
+ * As of now, this only checks special pages. Redirects to pages in
+ * other namespaces cannot be invalidated by this variable.
+ */
+$wgInvalidRedirectTargets = array( 'Filepath', 'Mypage', 'Mytalk' );
+
+/** @} */ # End of title and interwiki settings }
+
+/************************************************************************//**
+ * @name Parser settings
+ * These settings configure the transformation from wikitext to HTML.
+ * @{
+ */
+
+/**
+ * Parser configuration. Associative array with the following members:
+ *
+ * class The class name
+ *
+ * preprocessorClass The preprocessor class. Two classes are currently available:
+ * Preprocessor_Hash, which uses plain PHP arrays for tempoarary
+ * storage, and Preprocessor_DOM, which uses the DOM module for
+ * temporary storage. Preprocessor_DOM generally uses less memory;
+ * the speed of the two is roughly the same.
+ *
+ * If this parameter is not given, it uses Preprocessor_DOM if the
+ * DOM module is available, otherwise it uses Preprocessor_Hash.
+ *
+ * The entire associative array will be passed through to the constructor as
+ * the first parameter. Note that only Setup.php can use this variable --
+ * the configuration will change at runtime via $wgParser member functions, so
+ * the contents of this variable will be out-of-date. The variable can only be
+ * changed during LocalSettings.php, in particular, it can't be changed during
+ * an extension setup function.
+ */
+$wgParserConf = array(
+ 'class' => 'Parser',
+ #'preprocessorClass' => 'Preprocessor_Hash',
+);
+
+/** Maximum indent level of toc. */
+$wgMaxTocLevel = 999;
-$wgMaxPPNodeCount = 1000000; # A complexity limit on template expansion
+/**
+ * A complexity limit on template expansion
+ */
+$wgMaxPPNodeCount = 1000000;
/**
* Maximum recursion depth for templates within templates.
@@ -1138,207 +2710,460 @@ $wgMaxPPNodeCount = 1000000; # A complexity limit on template expansion
* stop the parser before it hits the xdebug limit.
*/
$wgMaxTemplateDepth = 40;
+
+/** @see $wgMaxTemplateDepth */
$wgMaxPPExpandDepth = 40;
+/** The external URL protocols */
+$wgUrlProtocols = array(
+ 'http://',
+ 'https://',
+ 'ftp://',
+ 'irc://',
+ 'gopher://',
+ 'telnet://', // Well if we're going to support the above.. -ævar
+ 'nntp://', // @bug 3808 RFC 1738
+ 'worldwind://',
+ 'mailto:',
+ 'news:',
+ 'svn://',
+ 'git://',
+ 'mms://',
+);
+
/**
* If true, removes (substitutes) templates in "~~~~" signatures.
*/
$wgCleanSignatures = true;
-$wgExtraSubtitle = '';
-$wgSiteSupportPage = ''; # A page where you users can receive donations
+/** Whether to allow inline image pointing to other websites */
+$wgAllowExternalImages = false;
/**
- * Set this to a string to put the wiki into read-only mode. The text will be
- * used as an explanation to users.
+ * If the above is false, you can specify an exception here. Image URLs
+ * that start with this string are then rendered, while all others are not.
+ * You can use this to set up a trusted, simple repository of images.
+ * You may also specify an array of strings to allow multiple sites
*
- * This prevents most write operations via the web interface. Cache updates may
- * still be possible. To prevent database writes completely, use the read_only
- * option in MySQL.
+ * Examples:
+ * <code>
+ * $wgAllowExternalImagesFrom = 'http://127.0.0.1/';
+ * $wgAllowExternalImagesFrom = array( 'http://127.0.0.1/', 'http://example.com' );
+ * </code>
*/
-$wgReadOnly = null;
+$wgAllowExternalImagesFrom = '';
-/***
- * If this lock file exists (size > 0), the wiki will be forced into read-only mode.
- * Its contents will be shown to users as part of the read-only warning
- * message.
+/** If $wgAllowExternalImages is false, you can allow an on-wiki
+ * whitelist of regular expression fragments to match the image URL
+ * against. If the image matches one of the regular expression fragments,
+ * The image will be displayed.
+ *
+ * Set this to true to enable the on-wiki whitelist (MediaWiki:External image whitelist)
+ * Or false to disable it
*/
-$wgReadOnlyFile = false; ///< defaults to "{$wgUploadDirectory}/lock_yBgMBwiR";
+$wgEnableImageWhitelist = true;
/**
- * Filename for debug logging. See http://www.mediawiki.org/wiki/How_to_debug
- * The debug log file should be not be publicly accessible if it is used, as it
- * may contain private data.
+ * A different approach to the above: simply allow the <img> tag to be used.
+ * This allows you to specify alt text and other attributes, copy-paste HTML to
+ * your wiki more easily, etc. However, allowing external images in any manner
+ * will allow anyone with editing rights to snoop on your visitors' IP
+ * addresses and so forth, if they wanted to, by inserting links to images on
+ * sites they control.
*/
-$wgDebugLogFile = '';
+$wgAllowImageTag = false;
/**
- * Prefix for debug log lines
+ * $wgUseTidy: use tidy to make sure HTML output is sane.
+ * Tidy is a free tool that fixes broken HTML.
+ * See http://www.w3.org/People/Raggett/tidy/
+ *
+ * - $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.
+ * 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.
*/
-$wgDebugLogPrefix = '';
+$wgUseTidy = false;
+/** @see $wgUseTidy */
+$wgAlwaysUseTidy = false;
+/** @see $wgUseTidy */
+$wgTidyBin = 'tidy';
+/** @see $wgUseTidy */
+$wgTidyConf = $IP.'/includes/tidy.conf';
+/** @see $wgUseTidy */
+$wgTidyOpts = '';
+/** @see $wgUseTidy */
+$wgTidyInternal = extension_loaded( 'tidy' );
/**
- * If true, instead of redirecting, show a page with a link to the redirect
- * destination. This allows for the inspection of PHP error messages, and easy
- * resubmission of form data. For developer use only.
+ * Put tidy warnings in HTML comments
+ * Only works for internal tidy.
*/
-$wgDebugRedirects = false;
+$wgDebugTidy = false;
+
+/** Allow raw, unchecked HTML in <html>...</html> sections.
+ * THIS IS VERY DANGEROUS on a publically editable site, so USE wgGroupPermissions
+ * TO RESTRICT EDITING to only those that you trust
+ */
+$wgRawHtml = false;
/**
- * If true, log debugging data from action=raw.
- * This is normally false to avoid overlapping debug entries due to gen=css and
- * gen=js requests.
+ * Set a default target for external links, e.g. _blank to pop up a new window
*/
-$wgDebugRawPage = false;
+$wgExternalLinkTarget = false;
/**
- * Send debug data to an HTML comment in the output.
+ * If true, external URL links in wiki text will be given the
+ * rel="nofollow" attribute as a hint to search engines that
+ * they should not be followed for ranking purposes as they
+ * are user-supplied and thus subject to spamming.
+ */
+$wgNoFollowLinks = true;
+
+/**
+ * Namespaces in which $wgNoFollowLinks doesn't apply.
+ * See Language.php for a list of namespaces.
+ */
+$wgNoFollowNsExceptions = array();
+
+/**
+ * If this is set to an array of domains, external links to these domain names
+ * (or any subdomains) will not be set to rel="nofollow" regardless of the
+ * value of $wgNoFollowLinks. For instance:
*
- * This may occasionally be useful when supporting a non-technical end-user. It's
- * more secure than exposing the debug log file to the web, since the output only
- * contains private data for the current user. But it's not ideal for development
- * use since data is lost on fatal errors and redirects.
+ * $wgNoFollowDomainExceptions = array( 'en.wikipedia.org', 'wiktionary.org' );
+ *
+ * This would add rel="nofollow" to links to de.wikipedia.org, but not
+ * en.wikipedia.org, wiktionary.org, en.wiktionary.org, us.en.wikipedia.org,
+ * etc.
*/
-$wgDebugComments = false;
+$wgNoFollowDomainExceptions = array();
/**
- * Write SQL queries to the debug log
+ * Allow DISPLAYTITLE to change title display
*/
-$wgDebugDumpSql = false;
+$wgAllowDisplayTitle = true;
/**
- * Set to an array of log group keys to filenames.
- * If set, wfDebugLog() output for that group will go to that file instead
- * of the regular $wgDebugLogFile. Useful for enabling selective logging
- * in production.
+ * For consistency, restrict DISPLAYTITLE to titles that normalize to the same
+ * canonical DB key.
*/
-$wgDebugLogGroups = array();
+$wgRestrictDisplayTitle = true;
/**
- * Display debug data at the bottom of the main content area.
- *
- * Useful for developers and technical users trying to working on a closed wiki.
+ * Maximum number of calls per parse to expensive parser functions such as
+ * PAGESINCATEGORY.
*/
-$wgShowDebug = false;
+$wgExpensiveParserFunctionLimit = 100;
/**
- * Prefix debug messages with relative timestamp. Very-poor man's profiler.
+ * Preprocessor caching threshold
*/
-$wgDebugTimestamps = false;
+$wgPreprocessorCacheThreshold = 1000;
/**
- * Print HTTP headers for every request in the debug information.
+ * Enable interwiki transcluding. Only when iw_trans=1.
*/
-$wgDebugPrintHttpHeaders = true;
+$wgEnableScaryTranscluding = false;
/**
- * Show the contents of $wgHooks in Special:Version
+ * Expiry time for interwiki transclusion
+ */
+$wgTranscludeCacheExpiry = 3600;
+
+/** @} */ # end of parser settings }
+
+/************************************************************************//**
+ * @name Statistics
+ * @{
*/
-$wgSpecialVersionShowHooks = false;
/**
- * Whether to show "we're sorry, but there has been a database error" pages.
- * Displaying errors aids in debugging, but may display information useful
- * to an attacker.
+ * Under which condition should a page in the main namespace be counted
+ * as a valid article? If $wgUseCommaCount is set to true, it will be
+ * counted if it contains at least one comma. If it is set to false
+ * (default), it will only be counted if it contains at least one [[wiki
+ * link]]. See http://www.mediawiki.org/wiki/Manual:Article_count
+ *
+ * Retroactively changing this variable will not affect
+ * the existing count (cf. maintenance/recount.sql).
*/
-$wgShowSQLErrors = false;
+$wgUseCommaCount = false;
/**
- * If true, some error messages will be colorized when running scripts on the
- * command line; this can aid picking important things out when debugging.
- * Ignored when running on Windows or when output is redirected to a file.
+ * wgHitcounterUpdateFreq sets how often page counters should be updated, higher
+ * values are easier on the database. A value of 1 causes the counters to be
+ * updated on every hit, any higher value n cause them to update *on average*
+ * every n hits. Should be set to either 1 or something largish, eg 1000, for
+ * maximum efficiency.
*/
-$wgColorErrors = true;
+$wgHitcounterUpdateFreq = 1;
/**
- * If set to true, uncaught exceptions will print a complete stack trace
- * to output. This should only be used for debugging, as it may reveal
- * private information in function parameters due to PHP's backtrace
- * formatting.
+ * How many days user must be idle before he is considered inactive. Will affect
+ * the number shown on Special:Statistics and Special:ActiveUsers special page.
+ * You might want to leave this as the default value, to provide comparable
+ * numbers between different wikis.
*/
-$wgShowExceptionDetails = false;
+$wgActiveUserDays = 30;
+
+/** @} */ # End of statistics }
+
+/************************************************************************//**
+ * @name User accounts, authentication
+ * @{
+ */
+
+/** For compatibility with old installations set to false */
+$wgPasswordSalt = true;
/**
- * If true, show a backtrace for database errors
+ * Specifies the minimal length of a user password. If set to 0, empty pass-
+ * words are allowed.
*/
-$wgShowDBErrorBacktrace = false;
+$wgMinimalPasswordLength = 1;
/**
- * Expose backend server host names through the API and various HTML comments
+ * Enabes or disables JavaScript-based suggestions of password strength
*/
-$wgShowHostnames = false;
+$wgLivePasswordStrengthChecks = false;
/**
- * If set to true MediaWiki will throw notices for some possible error
- * conditions and for deprecated functions.
+ * Maximum number of Unicode characters in signature
*/
-$wgDevelopmentWarnings = false;
+$wgMaxSigChars = 255;
/**
- * Use experimental, DMOZ-like category browser
+ * Maximum number of bytes in username. You want to run the maintenance
+ * script ./maintenance/checkUsernames.php once you have changed this value.
*/
-$wgUseCategoryBrowser = false;
+$wgMaxNameChars = 255;
/**
- * Keep parsed pages in a cache (objectcache table or memcached)
- * to speed up output of the same page viewed by another user with the
- * same options.
+ * Array of usernames which may not be registered or logged in from
+ * Maintenance scripts can still use these
+ */
+$wgReservedUsernames = array(
+ 'MediaWiki default', // Default 'Main Page' and MediaWiki: message pages
+ 'Conversion script', // Used for the old Wikipedia software upgrade
+ 'Maintenance script', // Maintenance scripts which perform editing, image import script
+ 'Template namespace initialisation script', // Used in 1.2->1.3 upgrade
+ 'msg:double-redirect-fixer', // Automatic double redirect fix
+ 'msg:usermessage-editor', // Default user for leaving user messages
+ 'msg:proxyblocker', // For Special:Blockme
+);
+
+/**
+ * Settings added to this array will override the default globals for the user
+ * preferences used by anonymous visitors and newly created accounts.
+ * For instance, to disable section editing links:
+ * $wgDefaultUserOptions ['editsection'] = 0;
*
- * This can provide a significant speedup for medium to large pages,
- * so you probably want to keep it on. Extensions that conflict with the
- * parser cache should disable the cache on a per-page basis instead.
*/
-$wgEnableParserCache = true;
+$wgDefaultUserOptions = array(
+ 'ccmeonemails' => 0,
+ 'cols' => 80,
+ 'contextchars' => 50,
+ 'contextlines' => 5,
+ 'date' => 'default',
+ 'diffonly' => 0,
+ 'disablemail' => 0,
+ 'disablesuggest' => 0,
+ 'editfont' => 'default',
+ 'editondblclick' => 0,
+ 'editsection' => 1,
+ 'editsectiononrightclick' => 0,
+ 'enotifminoredits' => 0,
+ 'enotifrevealaddr' => 0,
+ 'enotifusertalkpages' => 1,
+ 'enotifwatchlistpages' => 0,
+ 'extendwatchlist' => 0,
+ 'externaldiff' => 0,
+ 'externaleditor' => 0,
+ 'fancysig' => 0,
+ 'forceeditsummary' => 0,
+ 'gender' => 'unknown',
+ 'hideminor' => 0,
+ 'hidepatrolled' => 0,
+ 'highlightbroken' => 1,
+ 'imagesize' => 2,
+ 'justify' => 0,
+ 'math' => 1,
+ 'minordefault' => 0,
+ 'newpageshidepatrolled' => 0,
+ 'nocache' => 0,
+ 'noconvertlink' => 0,
+ 'norollbackdiff' => 0,
+ 'numberheadings' => 0,
+ 'previewonfirst' => 0,
+ 'previewontop' => 1,
+ 'quickbar' => 1,
+ 'rcdays' => 7,
+ 'rclimit' => 50,
+ 'rememberpassword' => 0,
+ 'rows' => 25,
+ 'searchlimit' => 20,
+ 'showhiddencats' => 0,
+ 'showjumplinks' => 1,
+ 'shownumberswatching' => 1,
+ 'showtoc' => 1,
+ 'showtoolbar' => 1,
+ 'skin' => false,
+ 'stubthreshold' => 0,
+ 'thumbsize' => 2,
+ 'underline' => 2,
+ 'uselivepreview' => 0,
+ 'usenewrc' => 0,
+ 'watchcreations' => 0,
+ 'watchdefault' => 0,
+ 'watchdeletion' => 0,
+ 'watchlistdays' => 3.0,
+ 'watchlisthideanons' => 0,
+ 'watchlisthidebots' => 0,
+ 'watchlisthideliu' => 0,
+ 'watchlisthideminor' => 0,
+ 'watchlisthideown' => 0,
+ 'watchlisthidepatrolled' => 0,
+ 'watchmoves' => 0,
+ 'wllimit' => 250,
+);
/**
- * Append a configured value to the parser cache and the sitenotice key so
- * that they can be kept separate for some class of activity.
+ * Whether or not to allow and use real name fields.
+ * @deprecated in 1.16, use $wgHiddenPrefs[] = 'realname' below to disable real
+ * names
*/
-$wgRenderHashAppend = '';
+$wgAllowRealName = true;
+
+/** An array of preferences to not show for the user */
+$wgHiddenPrefs = array();
/**
- * If on, the sidebar navigation links are cached for users with the
- * current language set. This can save a touch of load on a busy site
- * by shaving off extra message lookups.
+ * Characters to prevent during new account creations.
+ * This is used in a regular expression character class during
+ * registration (regex metacharacters like / are escaped).
+ */
+$wgInvalidUsernameCharacters = '@';
+
+/**
+ * Character used as a delimiter when testing for interwiki userrights
+ * (In Special:UserRights, it is possible to modify users on different
+ * databases if the delimiter is used, e.g. Someuser@enwiki).
*
- * However it is also fragile: changing the site configuration, or
- * having a variable $wgArticlePath, can produce broken links that
- * don't update as expected.
+ * It is recommended that you have this delimiter in
+ * $wgInvalidUsernameCharacters above, or you will not be able to
+ * modify the user rights of those users via Special:UserRights
*/
-$wgEnableSidebarCache = false;
+$wgUserrightsInterwikiDelimiter = '@';
/**
- * Expiry time for the sidebar cache, in seconds
+ * Use some particular type of external authentication. The specific
+ * authentication module you use will normally require some extra settings to
+ * be specified.
+ *
+ * null indicates no external authentication is to be used. Otherwise,
+ * $wgExternalAuthType must be the name of a non-abstract class that extends
+ * ExternalUser.
+ *
+ * Core authentication modules can be found in includes/extauth/.
*/
-$wgSidebarCacheExpiry = 86400;
+$wgExternalAuthType = null;
/**
- * Under which condition should a page in the main namespace be counted
- * as a valid article? If $wgUseCommaCount is set to true, it will be
- * counted if it contains at least one comma. If it is set to false
- * (default), it will only be counted if it contains at least one [[wiki
- * link]]. See http://www.mediawiki.org/wiki/Manual:Article_count
+ * Configuration for the external authentication. This may include arbitrary
+ * keys that depend on the authentication mechanism. For instance,
+ * authentication against another web app might require that the database login
+ * info be provided. Check the file where your auth mechanism is defined for
+ * info on what to put here.
+ */
+$wgExternalAuthConf = array();
+
+/**
+ * When should we automatically create local accounts when external accounts
+ * already exist, if using ExternalAuth? Can have three values: 'never',
+ * 'login', 'view'. 'view' requires the external database to support cookies,
+ * and implies 'login'.
*
- * Retroactively changing this variable will not affect
- * the existing count (cf. maintenance/recount.sql).
+ * TODO: Implement 'view' (currently behaves like 'login').
*/
-$wgUseCommaCount = false;
+$wgAutocreatePolicy = 'login';
/**
- * wgHitcounterUpdateFreq sets how often page counters should be updated, higher
- * values are easier on the database. A value of 1 causes the counters to be
- * updated on every hit, any higher value n cause them to update *on average*
- * every n hits. Should be set to either 1 or something largish, eg 1000, for
- * maximum efficiency.
+ * Policies for how each preference is allowed to be changed, in the presence
+ * of external authentication. The keys are preference keys, e.g., 'password'
+ * or 'emailaddress' (see Preferences.php et al.). The value can be one of the
+ * following:
+ *
+ * - local: Allow changes to this pref through the wiki interface but only
+ * apply them locally (default).
+ * - semiglobal: Allow changes through the wiki interface and try to apply them
+ * to the foreign database, but continue on anyway if that fails.
+ * - global: Allow changes through the wiki interface, but only let them go
+ * through if they successfully update the foreign database.
+ * - message: Allow no local changes for linked accounts; replace the change
+ * form with a message provided by the auth plugin, telling the user how to
+ * change the setting externally (maybe providing a link, etc.). If the auth
+ * plugin provides no message for this preference, hide it entirely.
+ *
+ * Accounts that are not linked to an external account are never affected by
+ * this setting. You may want to look at $wgHiddenPrefs instead.
+ * $wgHiddenPrefs supersedes this option.
+ *
+ * TODO: Implement message, global.
*/
-$wgHitcounterUpdateFreq = 1;
+$wgAllowPrefChange = array();
-# Basic user rights and block settings
-$wgSysopUserBans = true; # Allow sysops to ban logged-in users
-$wgSysopRangeBans = true; # Allow sysops to ban IP ranges
-$wgAutoblockExpiry = 86400; # Number of seconds before autoblock entries expire
-$wgBlockAllowsUTEdit = false; # Default setting for option on block form to allow self talkpage editing whilst blocked
-$wgSysopEmailBans = true; # Allow sysops to ban users from accessing Emailuser
+/**
+ * This is to let user authenticate using https when they come from http.
+ * Based on an idea by George Herbert on wikitech-l:
+ * http://lists.wikimedia.org/pipermail/wikitech-l/2010-October/050065.html
+ * @since 1.17
+ */
+$wgSecureLogin = false;
+
+/** @} */ # end user accounts }
+
+/************************************************************************//**
+ * @name User rights, access control and monitoring
+ * @{
+ */
+
+/**
+ * Allow sysops to ban logged-in users
+ * @deprecated since 1.17, will be made permanently true in 1.18
+ */
+$wgSysopUserBans = true;
+
+/**
+ * Allow sysops to ban IP ranges
+ * @deprecated since 1.17; set $wgBlockCIDRLimit to array( 'IPv4' => 32, 'IPv6 => 128 ) instead.
+ */
+$wgSysopRangeBans = true;
+
+/**
+ * Number of seconds before autoblock entries expire. Default 86400 = 1 day.
+ */
+$wgAutoblockExpiry = 86400;
+
+/**
+ * Set this to true to allow blocked users to edit their own user talk page.
+ */
+$wgBlockAllowsUTEdit = false;
+
+/** Allow sysops to ban users from accessing Emailuser */
+$wgSysopEmailBans = true;
+
+/**
+ * Limits on the possible sizes of range blocks.
+ *
+ * CIDR notation is hard to understand, it's easy to mistakenly assume that a
+ * /1 is a small range and a /31 is a large range. Setting this to half the
+ * number of bits avoids such errors.
+ */
$wgBlockCIDRLimit = array(
'IPv4' => 16, # Blocks larger than a /16 (64k addresses) will not be allowed
'IPv6' => 64, # 2^64 = ~1.8x10^19 addresses
@@ -1351,24 +3176,31 @@ $wgBlockCIDRLimit = array(
* logging the user out will again allow reading and editing, just as for
* anonymous visitors.
*/
-$wgBlockDisablesLogin = false; #
-
-# Pages anonymous user may see as an array, e.g.:
-# array ( "Main Page", "Wikipedia:Help");
-# Special:Userlogin and Special:Resetpass are always whitelisted.
-# NOTE: This will only work if $wgGroupPermissions['*']['read']
-# is false -- see below. Otherwise, ALL pages are accessible,
-# regardless of this setting.
-# Also note that this will only protect _pages in the wiki_.
-# Uploaded files will remain readable. Make your upload
-# directory name unguessable, or use .htaccess to protect it.
+$wgBlockDisablesLogin = false;
+
+/**
+ * Pages anonymous user may see as an array, e.g.
+ *
+ * <code>
+ * $wgWhitelistRead = array ( "Main Page", "Wikipedia:Help");
+ * </code>
+ *
+ * Special:Userlogin and Special:Resetpass are always whitelisted.
+ *
+ * NOTE: This will only work if $wgGroupPermissions['*']['read'] is false --
+ * see below. Otherwise, ALL pages are accessible, regardless of this setting.
+ *
+ * Also note that this will only protect _pages in the wiki_. Uploaded files
+ * will remain readable. You can use img_auth.php to protect uploaded files,
+ * see http://www.mediawiki.org/wiki/Manual:Image_Authorization
+ */
$wgWhitelistRead = false;
/**
* Should editors be required to have a validated e-mail
* address before being allowed to edit?
*/
-$wgEmailConfirmToEdit=false;
+$wgEmailConfirmToEdit = false;
/**
* Permission keys given to users in each group.
@@ -1389,6 +3221,7 @@ $wgEmailConfirmToEdit=false;
*/
$wgGroupPermissions = array();
+/** @cond file_level_code */
// Implicit group for all visitors
$wgGroupPermissions['*']['createaccount'] = true;
$wgGroupPermissions['*']['read'] = true;
@@ -1463,8 +3296,9 @@ $wgGroupPermissions['sysop']['markbotedits'] = true;
$wgGroupPermissions['sysop']['apihighlimits'] = true;
$wgGroupPermissions['sysop']['browsearchive'] = true;
$wgGroupPermissions['sysop']['noratelimit'] = true;
-$wgGroupPermissions['sysop']['versiondetail'] = true;
$wgGroupPermissions['sysop']['movefile'] = true;
+$wgGroupPermissions['sysop']['unblockself'] = true;
+$wgGroupPermissions['sysop']['suppressredirect'] = true;
#$wgGroupPermissions['sysop']['mergehistory'] = true;
// Permission to change users' group assignments
@@ -1491,6 +3325,8 @@ $wgGroupPermissions['bureaucrat']['noratelimit'] = true;
*/
# $wgGroupPermissions['developer']['siteadmin'] = true;
+/** @endcond */
+
/**
* Permission keys revoked from users in each group.
* This acts the same way as wgGroupPermissions above, except that
@@ -1525,14 +3361,18 @@ $wgImplicitGroups = array( '*', 'user', 'autoconfirmed' );
*
*/
$wgGroupsAddToSelf = array();
+
+/** @see $wgGroupsAddToSelf */
$wgGroupsRemoveFromSelf = array();
/**
* Set of available actions that can be restricted via action=protect
* You probably shouldn't change this.
* Translated through restriction-* messages.
+ * Title::getRestrictionTypes() will remove restrictions that are not
+ * applicable to a specific title (create and upload)
*/
-$wgRestrictionTypes = array( 'edit', 'move' );
+$wgRestrictionTypes = array( 'create', 'edit', 'move', 'upload' );
/**
* Rights which can be required for each protection level (via action=protect)
@@ -1541,8 +3381,8 @@ $wgRestrictionTypes = array( 'edit', 'move' );
* permission by manipulating this array. The ordering of elements
* dictates the order on the protection form's lists.
*
- * '' will be ignored (i.e. unprotected)
- * 'sysop' is quietly rewritten to 'protect' for backwards compatibility
+ * - '' will be ignored (i.e. unprotected)
+ * - 'sysop' is quietly rewritten to 'protect' for backwards compatibility
*/
$wgRestrictionLevels = array( '', 'autoconfirmed', 'sysop' );
@@ -1564,24 +3404,32 @@ $wgNamespaceProtection = array();
$wgNonincludableNamespaces = array();
/**
- * Number of seconds an account is required to age before
- * it's given the implicit 'autoconfirm' group membership.
- * This can be used to limit privileges of new accounts.
+ * Number of seconds an account is required to age before it's given the
+ * implicit 'autoconfirm' group membership. This can be used to limit
+ * privileges of new accounts.
*
- * Accounts created by earlier versions of the software
- * may not have a recorded creation date, and will always
- * be considered to pass the age test.
+ * Accounts created by earlier versions of the software may not have a
+ * recorded creation date, and will always be considered to pass the age test.
*
* When left at 0, all registered accounts will pass.
+ *
+ * Example:
+ * <code>
+ * $wgAutoConfirmAge = 600; // ten minutes
+ * $wgAutoConfirmAge = 3600*24; // one day
+ * </code>
*/
$wgAutoConfirmAge = 0;
-//$wgAutoConfirmAge = 600; // ten minutes
-//$wgAutoConfirmAge = 3600*24; // one day
-# Number of edits an account requires before it is autoconfirmed
-# Passing both this AND the time requirement is needed
+/**
+ * Number of edits an account requires before it is autoconfirmed.
+ * Passing both this AND the time requirement is needed. Example:
+ *
+ * <code>
+ * $wgAutoConfirmCount = 50;
+ * </code>
+ */
$wgAutoConfirmCount = 0;
-//$wgAutoConfirmCount = 50;
/**
* Automatically add a usergroup to any user who matches certain conditions.
@@ -1610,9 +3458,10 @@ $wgAutopromote = array(
);
/**
- * These settings can be used to give finer control over who can assign which
- * groups at Special:Userrights. Example configuration:
+ * $wgAddGroups and $wgRemoveGroups can be used to give finer control over who
+ * can assign which groups at Special:Userrights. Example configuration:
*
+ * @code
* // Bureaucrat can add any group
* $wgAddGroups['bureaucrat'] = true;
* // Bureaucrats can only remove bots and sysops
@@ -1621,8 +3470,10 @@ $wgAutopromote = array(
* $wgAddGroups['sysop'] = array( 'bot' );
* // Sysops can disable other sysops in an emergency, and disable bots
* $wgRemoveGroups['sysop'] = array( 'sysop', 'bot' );
+ * @endcode
*/
$wgAddGroups = array();
+/** @see $wgAddGroups */
$wgRemoveGroups = array();
/**
@@ -1637,219 +3488,178 @@ $wgAvailableRights = array();
*/
$wgDeleteRevisionsLimit = 0;
-# Proxy scanner settings
-#
+/** Number of accounts each IP address may create, 0 to disable.
+ * Requires memcached */
+$wgAccountCreationThrottle = 0;
/**
- * If you enable this, every editor's IP address will be scanned for open HTTP
- * proxies.
+ * Edits matching these regular expressions in body text
+ * will be recognised as spam and rejected automatically.
*
- * Don't enable this. Many sysops will report "hostile TCP port scans" to your
- * ISP and ask for your server to be shut down.
+ * There's no administrator override on-wiki, so be careful what you set. :)
+ * May be an array of regexes or a single string for backwards compatibility.
*
- * You have been warned.
+ * See http://en.wikipedia.org/wiki/Regular_expression
+ * Note that each regex needs a beginning/end delimiter, eg: # or /
*/
-$wgBlockOpenProxies = false;
-/** Port we want to scan for a proxy */
-$wgProxyPorts = array( 80, 81, 1080, 3128, 6588, 8000, 8080, 8888, 65506 );
-/** Script used to scan */
-$wgProxyScriptPath = "$IP/includes/proxy_check.php";
-/** */
-$wgProxyMemcExpiry = 86400;
-/** This should always be customised in LocalSettings.php */
-$wgSecretKey = false;
-/** big list of banned IP addresses, in the keys not the values */
-$wgProxyList = array();
-/** deprecated */
-$wgProxyKey = false;
-
-/** Number of accounts each IP address may create, 0 to disable.
- * Requires memcached */
-$wgAccountCreationThrottle = 0;
-
-# Client-side caching:
+$wgSpamRegex = array();
-/** Allow client-side caching of pages */
-$wgCachePages = true;
+/** Same as the above except for edit summaries */
+$wgSummarySpamRegex = array();
/**
- * Set this to current time to invalidate all prior cached pages. Affects both
- * client- and server-side caching.
- * You can get the current date on your server by using the command:
- * date +%Y%m%d%H%M%S
+ * Similarly you can get a function to do the job. The function will be given
+ * the following args:
+ * - a Title object for the article the edit is made on
+ * - the text submitted in the textarea (wpTextbox1)
+ * - the section number.
+ * The return should be boolean indicating whether the edit matched some evilness:
+ * - true : block it
+ * - false : let it through
+ *
+ * @deprecated Use hooks. See SpamBlacklist extension.
*/
-$wgCacheEpoch = '20030516000000';
+$wgFilterCallback = false;
/**
- * Bump this number when changing the global style sheets and JavaScript.
- * It should be appended in the query string of static CSS and JS includes,
- * to ensure that client-side caches do not keep obsolete copies of global
- * styles.
+ * Whether to use DNS blacklists in $wgDnsBlacklistUrls to check for open proxies
+ * @since 1.16
*/
-$wgStyleVersion = '270';
-
-
-# Server-side caching:
+$wgEnableDnsBlacklist = false;
/**
- * This will cache static pages for non-logged-in users to reduce
- * database traffic on public sites.
- * Must set $wgShowIPinHeader = false
+ * @deprecated Use $wgEnableDnsBlacklist instead, only kept for backward
+ * compatibility
*/
-$wgUseFileCache = false;
-
-/** Directory where the cached page will be saved */
-$wgFileCacheDirectory = false; ///< defaults to "$wgCacheDirectory/html";
+$wgEnableSorbs = false;
/**
- * When using the file cache, we can store the cached HTML gzipped to save disk
- * space. Pages will then also be served compressed to clients that support it.
- * THIS IS NOT COMPATIBLE with ob_gzhandler which is now enabled if supported in
- * the default LocalSettings.php! If you enable this, remove that setting first.
- *
- * Requires zlib support enabled in PHP.
+ * List of DNS blacklists to use, if $wgEnableDnsBlacklist is true
+ * @since 1.16
*/
-$wgUseGzip = false;
-
-/** Whether MediaWiki should send an ETag header */
-$wgUseETag = false;
-
-# Email notification settings
-#
-
-/** For email notification on page changes */
-$wgPasswordSender = $wgEmergencyContact;
-
-# true: from page editor if s/he opted-in
-# false: Enotif mails appear to come from $wgEmergencyContact
-$wgEnotifFromEditor = false;
-
-// TODO move UPO to preferences probably ?
-# If set to true, users get a corresponding option in their preferences and can choose to enable or disable at their discretion
-# If set to false, the corresponding input form on the user preference page is suppressed
-# It call this to be a "user-preferences-option (UPO)"
-$wgEmailAuthentication = true; # UPO (if this is set to false, texts referring to authentication are suppressed)
-$wgEnotifWatchlist = false; # UPO
-$wgEnotifUserTalk = false; # UPO
-$wgEnotifRevealEditorAddress = false; # UPO; reply-to address may be filled with page editor's address (if user allowed this in the preferences)
-$wgEnotifMinorEdits = true; # UPO; false: "minor edits" on pages do not trigger notification mails.
-# # Attention: _every_ change on a user_talk page trigger a notification mail (if the user is not yet notified)
-
-# Send a generic mail instead of a personalised mail for each user. This
-# always uses UTC as the time zone, and doesn't include the username.
-#
-# For pages with many users watching, this can significantly reduce mail load.
-# Has no effect when using sendmail rather than SMTP;
-
-$wgEnotifImpersonal = false;
-
-# Maximum number of users to mail at once when using impersonal mail. Should
-# match the limit on your mail server.
-$wgEnotifMaxRecips = 500;
-
-# Send mails via the job queue.
-$wgEnotifUseJobQ = false;
-
-# Use real name instead of username in e-mail "from" field
-$wgEnotifUseRealName = false;
+$wgDnsBlacklistUrls = array( 'http.dnsbl.sorbs.net.' );
/**
- * Array of usernames who will be sent a notification email for every change which occurs on a wiki
+ * @deprecated Use $wgDnsBlacklistUrls instead, only kept for backward
+ * compatibility
*/
-$wgUsersNotifiedOnAllChanges = array();
-
-/** Show watching users in recent changes, watchlist and page history views */
-$wgRCShowWatchingUsers = false; # UPO
-/** Show watching users in Page views */
-$wgPageShowWatchingUsers = false;
-/** Show the amount of changed characters in recent changes */
-$wgRCShowChangedSize = true;
+$wgSorbsUrl = array();
/**
- * If the difference between the character counts of the text
- * before and after the edit is below that value, the value will be
- * highlighted on the RC page.
+ * Proxy whitelist, list of addresses that are assumed to be non-proxy despite
+ * what the other methods might say.
*/
-$wgRCChangedSizeThreshold = 500;
+$wgProxyWhitelist = array();
/**
- * Show "Updated (since my last visit)" marker in RC view, watchlist and history
- * view for watched pages with new changes */
-$wgShowUpdatedMarker = true;
+ * Simple rate limiter options to brake edit floods. Maximum number actions
+ * allowed in the given number of seconds; after that the violating client re-
+ * ceives HTTP 500 error pages until the period elapses.
+ *
+ * array( 4, 60 ) for a maximum of 4 hits in 60 seconds.
+ *
+ * This option set is experimental and likely to change. Requires memcached.
+ */
+$wgRateLimits = array(
+ 'edit' => array(
+ 'anon' => null, // for any and all anonymous edits (aggregate)
+ 'user' => null, // for each logged-in user
+ 'newbie' => null, // for each recent (autoconfirmed) account; overrides 'user'
+ 'ip' => null, // for each anon and recent account
+ 'subnet' => null, // ... with final octet removed
+ ),
+ 'move' => array(
+ 'user' => null,
+ 'newbie' => null,
+ 'ip' => null,
+ 'subnet' => null,
+ ),
+ 'mailpassword' => array(
+ 'anon' => null,
+ ),
+ 'emailuser' => array(
+ 'user' => null,
+ ),
+ );
/**
- * Default cookie expiration time. Setting to 0 makes all cookies session-only.
+ * Set to a filename to log rate limiter hits.
*/
-$wgCookieExpiration = 30*86400;
+$wgRateLimitLog = null;
-/** Clock skew or the one-second resolution of time() can occasionally cause cache
- * problems when the user requests two pages within a short period of time. This
- * variable adds a given number of seconds to vulnerable timestamps, thereby giving
- * a grace period.
+/**
+ * Array of groups which should never trigger the rate limiter
+ *
+ * @deprecated as of 1.13.0, the preferred method is using
+ * $wgGroupPermissions[]['noratelimit']. However, this will still
+ * work if desired.
+ *
+ * $wgRateLimitsExcludedGroups = array( 'sysop', 'bureaucrat' );
*/
-$wgClockSkewFudge = 5;
-
-# Squid-related settings
-#
-
-/** Enable/disable Squid */
-$wgUseSquid = false;
-
-/** If you run Squid3 with ESI support, enable this (default:false): */
-$wgUseESI = false;
-
-/** Send X-Vary-Options header for better caching (requires patched Squid) */
-$wgUseXVO = false;
-
-/** Internal server name as known to Squid, if different */
-# $wgInternalServer = 'http://yourinternal.tld:8000';
-$wgInternalServer = $wgServer;
+$wgRateLimitsExcludedGroups = array();
/**
- * Cache timeout for the squid, will be sent as s-maxage (without ESI) or
- * Surrogate-Control (with ESI). Without ESI, you should strip out s-maxage in
- * the Squid config. 18000 seconds = 5 hours, more cache hits with 2678400 = 31
- * days
+ * Array of IPs which should be excluded from rate limits.
+ * This may be useful for whitelisting NAT gateways for conferences, etc.
*/
-$wgSquidMaxage = 18000;
+$wgRateLimitsExcludedIPs = array();
/**
- * Default maximum age for raw CSS/JS accesses
+ * Log IP addresses in the recentchanges table; can be accessed only by
+ * extensions (e.g. CheckUser) or a DB admin
*/
-$wgForcedRawSMaxage = 300;
+$wgPutIPinRC = true;
/**
- * List of proxy servers to purge on changes; default port is 80. Use IP addresses.
- *
- * When MediaWiki is running behind a proxy, it will trust X-Forwarded-For
- * headers sent/modified from these proxies when obtaining the remote IP address
- *
- * For a list of trusted servers which *aren't* purged, see $wgSquidServersNoPurge.
+ * Limit password attempts to X attempts per Y seconds per IP per account.
+ * Requires memcached.
+ */
+$wgPasswordAttemptThrottle = array( 'count' => 5, 'seconds' => 300 );
+
+/** @} */ # end of user rights settings
+
+/************************************************************************//**
+ * @name Proxy scanner settings
+ * @{
*/
-$wgSquidServers = array();
/**
- * As above, except these servers aren't purged on page changes; use to set a
- * list of trusted proxies, etc.
+ * If you enable this, every editor's IP address will be scanned for open HTTP
+ * proxies.
+ *
+ * Don't enable this. Many sysops will report "hostile TCP port scans" to your
+ * ISP and ask for your server to be shut down.
+ *
+ * You have been warned.
*/
-$wgSquidServersNoPurge = array();
+$wgBlockOpenProxies = false;
+/** Port we want to scan for a proxy */
+$wgProxyPorts = array( 80, 81, 1080, 3128, 6588, 8000, 8080, 8888, 65506 );
+/** Script used to scan */
+$wgProxyScriptPath = "$IP/includes/proxy_check.php";
+/** */
+$wgProxyMemcExpiry = 86400;
+/** This should always be customised in LocalSettings.php */
+$wgSecretKey = false;
+/** big list of banned IP addresses, in the keys not the values */
+$wgProxyList = array();
+/** deprecated */
+$wgProxyKey = false;
-/** Maximum number of titles to purge in any one client operation */
-$wgMaxSquidPurgeTitles = 400;
+/** @} */ # end of proxy scanner settings
-/** HTCP multicast purging */
-$wgHTCPPort = 4827;
-$wgHTCPMulticastTTL = 1;
-# $wgHTCPMulticastAddress = "224.0.0.85";
-$wgHTCPMulticastAddress = false;
+/************************************************************************//**
+ * @name Cookie settings
+ * @{
+ */
-/** Should forwarded Private IPs be accepted? */
-$wgUsePrivateIPs = false;
+/**
+ * Default cookie expiration time. Setting to 0 makes all cookies session-only.
+ */
+$wgCookieExpiration = 30*86400;
-# Cookie settings:
-#
/**
- * Set to set an explicit domain on the login cookies eg, "justthis.domain. org"
+ * Set to set an explicit domain on the login cookies eg, "justthis.domain.org"
* or ".any.subdomain.net"
*/
$wgCookieDomain = '';
@@ -1889,65 +3699,12 @@ $wgCacheVaryCookies = array();
/** Override to customise the session name */
$wgSessionName = false;
-/** Whether to allow inline image pointing to other websites */
-$wgAllowExternalImages = false;
-
-/** If the above is false, you can specify an exception here. Image URLs
- * that start with this string are then rendered, while all others are not.
- * You can use this to set up a trusted, simple repository of images.
- * You may also specify an array of strings to allow multiple sites
- *
- * Examples:
- * $wgAllowExternalImagesFrom = 'http://127.0.0.1/';
- * $wgAllowExternalImagesFrom = array( 'http://127.0.0.1/', 'http://example.com' );
- */
-$wgAllowExternalImagesFrom = '';
+/** @} */ # end of cookie settings }
-/** If $wgAllowExternalImages is false, you can allow an on-wiki
- * whitelist of regular expression fragments to match the image URL
- * against. If the image matches one of the regular expression fragments,
- * The image will be displayed.
- *
- * Set this to true to enable the on-wiki whitelist (MediaWiki:External image whitelist)
- * Or false to disable it
+/************************************************************************//**
+ * @name LaTeX (mathematical formulas)
+ * @{
*/
-$wgEnableImageWhitelist = true;
-
-/** Allows to move images and other media files */
-$wgAllowImageMoving = true;
-
-/** Disable database-intensive features */
-$wgMiserMode = false;
-/** Disable all query pages if miser mode is on, not just some */
-$wgDisableQueryPages = false;
-/** Number of rows to cache in 'querycache' table when miser mode is on */
-$wgQueryCacheLimit = 1000;
-/** Number of links to a page required before it is deemed "wanted" */
-$wgWantedPagesThreshold = 1;
-/** Enable slow parser functions */
-$wgAllowSlowParserFunctions = false;
-
-/**
- * Maps jobs to their handling classes; extensions
- * can add to this to provide custom jobs
- */
-$wgJobClasses = array(
- 'refreshLinks' => 'RefreshLinksJob',
- 'refreshLinks2' => 'RefreshLinksJob2',
- 'htmlCacheUpdate' => 'HTMLCacheUpdateJob',
- 'html_cache_update' => 'HTMLCacheUpdateJob', // backwards-compatible
- 'sendMail' => 'EmaillingJob',
- 'enotifNotify' => 'EnotifNotifyJob',
- 'fixDoubleRedirect' => 'DoubleRedirectJob',
-);
-
-/**
- * Additional functions to be performed with updateSpecialPages.
- * Expensive Querypages are already updated.
- */
-$wgSpecialPageCacheUpdates = array(
- 'Statistics' => array('SiteStatsUpdate','cacheUpdate')
-);
/**
* To use inline TeX, you need to compile 'texvc' (in the 'math' subdirectory of
@@ -1957,7 +3714,7 @@ $wgSpecialPageCacheUpdates = array(
*/
$wgUseTeX = false;
/** Location of the texvc binary */
-$wgTexvc = './math/texvc';
+$wgTexvc = $IP . '/math/texvc';
/**
* Texvc background color
* use LaTeX color format as used in \special function
@@ -1979,31 +3736,157 @@ $wgTexvcBackgroundColor = 'transparent';
*/
$wgMathCheckFiles = true;
-#
-# Profiling / debugging
-#
-# You have to create a 'profiling' table in your database before using
-# profiling see maintenance/archives/patch-profiling.sql .
-#
-# To enable profiling, edit StartProfiler.php
+/* @} */ # end LaTeX }
+
+/************************************************************************//**
+ * @name Profiling, testing and debugging
+ *
+ * To enable profiling, edit StartProfiler.php
+ *
+ * @{
+ */
+
+/**
+ * Filename for debug logging. See http://www.mediawiki.org/wiki/How_to_debug
+ * The debug log file should be not be publicly accessible if it is used, as it
+ * may contain private data.
+ */
+$wgDebugLogFile = '';
+
+/**
+ * Prefix for debug log lines
+ */
+$wgDebugLogPrefix = '';
+
+/**
+ * If true, instead of redirecting, show a page with a link to the redirect
+ * destination. This allows for the inspection of PHP error messages, and easy
+ * resubmission of form data. For developer use only.
+ */
+$wgDebugRedirects = false;
+
+/**
+ * If true, log debugging data from action=raw.
+ * This is normally false to avoid overlapping debug entries due to gen=css and
+ * gen=js requests.
+ */
+$wgDebugRawPage = false;
+
+/**
+ * Send debug data to an HTML comment in the output.
+ *
+ * This may occasionally be useful when supporting a non-technical end-user. It's
+ * more secure than exposing the debug log file to the web, since the output only
+ * contains private data for the current user. But it's not ideal for development
+ * use since data is lost on fatal errors and redirects.
+ */
+$wgDebugComments = false;
+
+/**
+ * Write SQL queries to the debug log
+ */
+$wgDebugDumpSql = false;
+
+/**
+ * Set to an array of log group keys to filenames.
+ * If set, wfDebugLog() output for that group will go to that file instead
+ * of the regular $wgDebugLogFile. Useful for enabling selective logging
+ * in production.
+ */
+$wgDebugLogGroups = array();
+
+/**
+ * Display debug data at the bottom of the main content area.
+ *
+ * Useful for developers and technical users trying to working on a closed wiki.
+ */
+$wgShowDebug = false;
+
+/**
+ * Prefix debug messages with relative timestamp. Very-poor man's profiler.
+ */
+$wgDebugTimestamps = false;
+
+/**
+ * Print HTTP headers for every request in the debug information.
+ */
+$wgDebugPrintHttpHeaders = true;
+
+/**
+ * Show the contents of $wgHooks in Special:Version
+ */
+$wgSpecialVersionShowHooks = false;
+
+/**
+ * Whether to show "we're sorry, but there has been a database error" pages.
+ * Displaying errors aids in debugging, but may display information useful
+ * to an attacker.
+ */
+$wgShowSQLErrors = false;
+
+/**
+ * If set to true, uncaught exceptions will print a complete stack trace
+ * to output. This should only be used for debugging, as it may reveal
+ * private information in function parameters due to PHP's backtrace
+ * formatting.
+ */
+$wgShowExceptionDetails = false;
+
+/**
+ * If true, show a backtrace for database errors
+ */
+$wgShowDBErrorBacktrace = false;
+
+/**
+ * Expose backend server host names through the API and various HTML comments
+ */
+$wgShowHostnames = false;
+
+/**
+ * If set to true MediaWiki will throw notices for some possible error
+ * conditions and for deprecated functions.
+ */
+$wgDevelopmentWarnings = false;
/** Only record profiling info for pages that took longer than this */
$wgProfileLimit = 0.0;
+
/** Don't put non-profiling info into log file */
$wgProfileOnly = false;
-/** Log sums from profiling into "profiling" table in db. */
+
+/**
+ * Log sums from profiling into "profiling" table in db.
+ *
+ * You have to create a 'profiling' table in your database before using
+ * this feature, see maintenance/archives/patch-profiling.sql
+ *
+ * To enable profiling, edit StartProfiler.php
+ */
$wgProfileToDatabase = false;
+
/** If true, print a raw call tree instead of per-function report */
$wgProfileCallTree = false;
+
/** Should application server host be put into profiling table */
$wgProfilePerHost = false;
-/** Settings for UDP profiler */
+/**
+ * Host for UDP profiler.
+ *
+ * The host should be running a daemon which can be obtained from MediaWiki
+ * Subversion at: http://svn.wikimedia.org/svnroot/mediawiki/trunk/udpprofile
+ */
$wgUDPProfilerHost = '127.0.0.1';
+
+/**
+ * Port for UDP profiler.
+ * @see $wgUDPProfilerHost
+ */
$wgUDPProfilerPort = '3811';
/** Detects non-matching wfProfileIn/wfProfileOut calls */
$wgDebugProfiling = false;
+
/** Output debug message on every wfProfileIn/wfProfileOut */
$wgDebugFunctionEntry = 0;
@@ -2020,9 +3903,52 @@ $wgStatsMethod = 'cache';
*/
$wgDisableCounters = false;
-$wgDisableTextSearch = false;
-$wgDisableSearchContext = false;
+/**
+ * Support blog-style "trackbacks" for articles. See
+ * http://www.sixapart.com/pronet/docs/trackback_spec for details.
+ */
+$wgUseTrackbacks = false;
+
+/**
+ * Parser test suite files to be run by parserTests.php when no specific
+ * filename is passed to it.
+ *
+ * Extensions may add their own tests to this array, or site-local tests
+ * may be added via LocalSettings.php
+ *
+ * Use full paths.
+ */
+$wgParserTestFiles = array(
+ "$IP/maintenance/tests/parser/parserTests.txt",
+ "$IP/maintenance/tests/parser/ExtraParserTests.txt"
+);
+
+/**
+ * If configured, specifies target CodeReview installation to send test
+ * result data from 'parserTests.php --upload'
+ *
+ * Something like this:
+ * $wgParserTestRemote = array(
+ * 'api-url' => 'http://www.mediawiki.org/w/api.php',
+ * 'repo' => 'MediaWiki',
+ * 'suite' => 'ParserTests',
+ * 'path' => '/trunk/phase3', // not used client-side; for reference
+ * 'secret' => 'qmoicj3mc4mcklmqw', // Shared secret used in HMAC validation
+ * );
+ */
+$wgParserTestRemote = false;
+
+/** @} */ # end of profiling, testing and debugging }
+/************************************************************************//**
+ * @name Search
+ * @{
+ */
+
+/**
+ * Set this to true to disable the full text search feature.
+ */
+$wgDisableTextSearch = false;
/**
* Set to true to have nicer highligted text in search results,
@@ -2033,6 +3959,8 @@ $wgAdvancedSearchHighlighting = false;
/**
* Regexp to match word boundaries, defaults for non-CJK languages
* should be empty for CJK since the words are not separate
+ *
+ * @todo FIXME: checks for lower than required PHP version (5.1.x).
*/
$wgSearchHighlightBoundaries = version_compare("5.1", PHP_VERSION, "<")? '[\p{Z}\p{P}\p{C}]'
: '[ ,.;:!?~!@#$%\^&*\(\)+=\-\\|\[\]"\'<>\n\r\/{}]'; // PHP 5.0 workaround
@@ -2092,149 +4020,15 @@ $wgMWSuggestTemplate = false;
* table. If you ever re-enable, be sure to rebuild the search table.
*/
$wgDisableSearchUpdate = false;
-/** Uploads have to be specially set up to be secure */
-$wgEnableUploads = false;
-/**
- * Show EXIF data, on by default if available.
- * Requires PHP's EXIF extension: http://www.php.net/manual/en/ref.exif.php
- *
- * NOTE FOR WINDOWS USERS:
- * To enable EXIF functions, add the folloing lines to the
- * "Windows extensions" section of php.ini:
- *
- * extension=extensions/php_mbstring.dll
- * extension=extensions/php_exif.dll
- */
-$wgShowEXIF = function_exists( 'exif_read_data' );
-
-/**
- * Set to true to enable the upload _link_ while local uploads are disabled.
- * Assumes that the special page link will be bounced to another server where
- * uploads do work.
- */
-$wgRemoteUploads = false;
-
-/**
- * Disable links to talk pages of anonymous users (IPs) in listings on special
- * pages like page history, Special:Recentchanges, etc.
- */
-$wgDisableAnonTalk = false;
-/**
- * Do DELETE/INSERT for link updates instead of incremental
- */
-$wgUseDumbLinkUpdate = false;
-
-/**
- * Anti-lock flags - bitfield
- * ALF_PRELOAD_LINKS
- * Preload links during link update for save
- * ALF_PRELOAD_EXISTENCE
- * Preload cur_id during replaceLinkHolders
- * ALF_NO_LINK_LOCK
- * Don't use locking reads when updating the link table. This is
- * necessary for wikis with a high edit rate for performance
- * reasons, but may cause link table inconsistency
- * ALF_NO_BLOCK_LOCK
- * As for ALF_LINK_LOCK, this flag is a necessity for high-traffic
- * wikis.
- */
-$wgAntiLockFlags = 0;
-
-/**
- * Path to the GNU diff3 utility. If the file doesn't exist, edit conflicts will
- * fall back to the old behaviour (no merging).
- */
-$wgDiff3 = '/usr/bin/diff3';
/**
- * Path to the GNU diff utility.
- */
-$wgDiff = '/usr/bin/diff';
-
-/**
- * We can also compress text stored in the 'text' table. If this is set on, new
- * revisions will be compressed on page save if zlib support is available. Any
- * compressed revisions will be decompressed on load regardless of this setting
- * *but will not be readable at all* if zlib support is not available.
- */
-$wgCompressRevisions = false;
-
-/**
- * This is the list of preferred extensions for uploading files. Uploading files
- * with extensions not in this list will trigger a warning.
- */
-$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );
-
-/** Files with these extensions will never be allowed as uploads. */
-$wgFileBlacklist = array(
- # HTML may contain cookie-stealing JavaScript and web bugs
- 'html', 'htm', 'js', 'jsb', 'mhtml', 'mht', 'xhtml', 'xht',
- # PHP scripts may execute arbitrary code on the server
- 'php', 'phtml', 'php3', 'php4', 'php5', 'phps',
- # Other types that may be interpreted by some servers
- 'shtml', 'jhtml', 'pl', 'py', 'cgi',
- # May contain harmful executables for Windows victims
- 'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );
-
-/** Files with these mime types will never be allowed as uploads
- * if $wgVerifyMimeType is enabled.
- */
-$wgMimeTypeBlacklist= array(
- # HTML may contain cookie-stealing JavaScript and web bugs
- 'text/html', 'text/javascript', 'text/x-javascript', 'application/x-shellscript',
- # PHP scripts may execute arbitrary code on the server
- 'application/x-php', 'text/x-php',
- # Other types that may be interpreted by some servers
- 'text/x-python', 'text/x-perl', 'text/x-bash', 'text/x-sh', 'text/x-csh',
- # Client-side hazards on Internet Explorer
- 'text/scriptlet', 'application/x-msdownload',
- # Windows metafile, client-side vulnerability on some systems
- 'application/x-msmetafile',
- # A ZIP file may be a valid Java archive containing an applet which exploits the
- # same-origin policy to steal cookies
- 'application/zip',
-);
-
-/** This is a flag to determine whether or not to check file extensions on upload. */
-$wgCheckFileExtensions = true;
-
-/**
- * If this is turned off, users may override the warning for files not covered
- * by $wgFileExtensions.
- */
-$wgStrictFileExtensions = true;
-
-/** Warn if uploaded files are larger than this (in bytes), or false to disable*/
-$wgUploadSizeWarning = false;
-
-/** For compatibility with old installations set to false */
-$wgPasswordSalt = true;
-
-/** Which namespaces should support subpages?
- * See Language.php for a list of namespaces.
- */
-$wgNamespacesWithSubpages = array(
- NS_TALK => true,
- NS_USER => true,
- NS_USER_TALK => true,
- NS_PROJECT_TALK => true,
- NS_FILE_TALK => true,
- NS_MEDIAWIKI => true,
- NS_MEDIAWIKI_TALK => true,
- NS_TEMPLATE_TALK => true,
- NS_HELP_TALK => true,
- NS_CATEGORY_TALK => true
-);
-
-/**
- * Which namespaces have special treatment where they should be preview-on-open
- * Internaly only Category: pages apply, but using this extensions (e.g. Semantic MediaWiki)
- * can specify namespaces of pages they have special treatment for
+ * List of namespaces which are searched by default. Example:
+ *
+ * <code>
+ * $wgNamespacesToBeSearchedDefault[NS_MAIN] = true;
+ * $wgNamespacesToBeSearchedDefault[NS_PROJECT] = true;
+ * </code>
*/
-$wgPreviewOnOpenNamespaces = array(
- NS_CATEGORY => true
-);
-
$wgNamespacesToBeSearchedDefault = array(
NS_MAIN => true,
);
@@ -2258,158 +4052,104 @@ $wgNamespacesToBeSearchedHelp = array(
$wgSearchEverythingOnlyLoggedIn = false;
/**
- * Site notice shown at the top of each page
- *
- * MediaWiki:Sitenotice page, which will override this. You can also
- * provide a separate message for logged-out users using the
- * MediaWiki:Anonnotice page.
- */
-$wgSiteNotice = '';
-
-#
-# Images settings
-#
-
-/**
- * Plugins for media file type handling.
- * Each entry in the array maps a MIME type to a class name
+ * Disable the internal MySQL-based search, to allow it to be
+ * implemented by an extension instead.
*/
-$wgMediaHandlers = array(
- 'image/jpeg' => 'BitmapHandler',
- 'image/png' => 'BitmapHandler',
- 'image/gif' => 'GIFHandler',
- 'image/tiff' => 'TiffHandler',
- 'image/x-ms-bmp' => 'BmpHandler',
- 'image/x-bmp' => 'BmpHandler',
- 'image/svg+xml' => 'SvgHandler', // official
- 'image/svg' => 'SvgHandler', // compat
- 'image/vnd.djvu' => 'DjVuHandler', // official
- 'image/x.djvu' => 'DjVuHandler', // compat
- 'image/x-djvu' => 'DjVuHandler', // compat
-);
-
+$wgDisableInternalSearch = false;
/**
- * Resizing can be done using PHP's internal image libraries or using
- * ImageMagick or another third-party converter, e.g. GraphicMagick.
- * These support more file formats than PHP, which only supports PNG,
- * GIF, JPG, XBM and WBMP.
+ * Set this to a URL to forward search requests to some external location.
+ * If the URL includes '$1', this will be replaced with the URL-encoded
+ * search term.
*
- * Use Image Magick instead of PHP builtin functions.
+ * For example, to forward to Google you'd have something like:
+ * $wgSearchForwardUrl = 'http://www.google.com/search?q=$1' .
+ * '&domains=http://example.com' .
+ * '&sitesearch=http://example.com' .
+ * '&ie=utf-8&oe=utf-8';
*/
-$wgUseImageMagick = false;
-/** The convert command shipped with ImageMagick */
-$wgImageMagickConvertCommand = '/usr/bin/convert';
-
-/** Sharpening parameter to ImageMagick */
-$wgSharpenParameter = '0x0.4';
-
-/** Reduction in linear dimensions below which sharpening will be enabled */
-$wgSharpenReductionThreshold = 0.85;
+$wgSearchForwardUrl = null;
/**
- * Temporary directory used for ImageMagick. The directory must exist. Leave
- * this set to false to let ImageMagick decide for itself.
+ * Search form behavior
+ * true = use Go & Search buttons
+ * false = use Go button & Advanced search link
*/
-$wgImageMagickTempDir = false;
+$wgUseTwoButtonsSearchForm = true;
/**
- * Use another resizing converter, e.g. GraphicMagick
- * %s will be replaced with the source path, %d with the destination
- * %w and %h will be replaced with the width and height
- *
- * An example is provided for GraphicMagick
- * Leave as false to skip this
+ * Array of namespaces to generate a Google sitemap for when the
+ * maintenance/generateSitemap.php script is run, or false if one is to be ge-
+ * nerated for all namespaces.
*/
-#$wgCustomConvertCommand = "gm convert %s -resize %wx%h %d"
-$wgCustomConvertCommand = false;
+$wgSitemapNamespaces = false;
-# Scalable Vector Graphics (SVG) may be uploaded as images.
-# Since SVG support is not yet standard in browsers, it is
-# necessary to rasterize SVGs to PNG as a fallback format.
-#
-# An external program is required to perform this conversion:
-$wgSVGConverters = array(
- 'ImageMagick' => '$path/convert -background white -thumbnail $widthx$height\! $input PNG:$output',
- 'sodipodi' => '$path/sodipodi -z -w $width -f $input -e $output',
- 'inkscape' => '$path/inkscape -z -w $width -f $input -e $output',
- 'batik' => 'java -Djava.awt.headless=true -jar $path/batik-rasterizer.jar -w $width -d $output $input',
- 'rsvg' => '$path/rsvg -w$width -h$height $input $output',
- 'imgserv' => '$path/imgserv-wrapper -i svg -o png -w$width $input $output',
- );
-/** Pick one of the above */
-$wgSVGConverter = 'ImageMagick';
-/** If not in the executable PATH, specify */
-$wgSVGConverterPath = '';
-/** Don't scale a SVG larger than this */
-$wgSVGMaxSize = 2048;
-/**
- * Don't thumbnail an image if it will use too much working memory
- * Default is 50 MB if decompressed to RGBA form, which corresponds to
- * 12.5 million pixels or 3500x3500
+/** @} */ # end of search settings
+
+/************************************************************************//**
+ * @name Edit user interface
+ * @{
*/
-$wgMaxImageArea = 1.25e7;
+
/**
- * Force thumbnailing of animated GIFs above this size to a single
- * frame instead of an animated thumbnail. ImageMagick seems to
- * get real unhappy and doesn't play well with resource limits. :P
- * Defaulting to 1 megapixel (1000x1000)
+ * Path to the GNU diff3 utility. If the file doesn't exist, edit conflicts will
+ * fall back to the old behaviour (no merging).
*/
-$wgMaxAnimatedGifArea = 1.0e6;
+$wgDiff3 = '/usr/bin/diff3';
+
/**
- * Browsers don't support TIFF inline generally...
- * For inline display, we need to convert to PNG or JPEG.
- * Note scaling should work with ImageMagick, but may not with GD scaling.
- * // PNG is lossless, but inefficient for photos
- * $wgTiffThumbnailType = array( 'png', 'image/png' );
- * // JPEG is good for photos, but has no transparency support. Bad for diagrams.
- * $wgTiffThumbnailType = array( 'jpg', 'image/jpeg' );
+ * Path to the GNU diff utility.
*/
- $wgTiffThumbnailType = false;
+$wgDiff = '/usr/bin/diff';
/**
- * If rendered thumbnail files are older than this timestamp, they
- * will be rerendered on demand as if the file didn't already exist.
- * Update if there is some need to force thumbs and SVG rasterizations
- * to rerender, such as fixes to rendering bugs.
+ * Which namespaces have special treatment where they should be preview-on-open
+ * Internaly only Category: pages apply, but using this extensions (e.g. Semantic MediaWiki)
+ * can specify namespaces of pages they have special treatment for
*/
-$wgThumbnailEpoch = '20030516000000';
+$wgPreviewOnOpenNamespaces = array(
+ NS_CATEGORY => true
+);
/**
- * If set, inline scaled images will still produce <img> tags ready for
- * output instead of showing an error message.
- *
- * This may be useful if errors are transitory, especially if the site
- * is configured to automatically render thumbnails on request.
- *
- * On the other hand, it may obscure error conditions from debugging.
- * Enable the debug log or the 'thumbnail' log group to make sure errors
- * are logged to a file for review.
+ * Activate external editor interface for files and pages
+ * See http://www.mediawiki.org/wiki/Manual:External_editors
*/
-$wgIgnoreImageErrors = false;
+$wgUseExternalEditor = true;
+
+/** Go button goes straight to the edit screen if the article doesn't exist. */
+$wgGoToEdit = false;
/**
- * Allow thumbnail rendering on page view. If this is false, a valid
- * thumbnail URL is still output, but no file will be created at
- * the target location. This may save some time if you have a
- * thumb.php or 404 handler set up which is faster than the regular
- * webserver(s).
+ * Enable the UniversalEditButton for browsers that support it
+ * (currently only Firefox with an extension)
+ * See http://universaleditbutton.org for more background information
*/
-$wgGenerateThumbnailOnParse = true;
+$wgUniversalEditButton = true;
/**
-* Show thumbnails for old images on the image description page
-*/
-$wgShowArchiveThumbnails = true;
+ * If user doesn't specify any edit summary when making a an edit, MediaWiki
+ * will try to automatically create one. This feature can be disabled by set-
+ * ting this variable false.
+ */
+$wgUseAutomaticEditSummaries = true;
-/** Obsolete, always true, kept for compatibility with extensions */
-$wgUseImageResize = true;
+/** @} */ # end edit UI }
+/************************************************************************//**
+ * @name Maintenance
+ * See also $wgSiteNotice
+ * @{
+ */
-/** Set $wgCommandLineMode if it's not set already, to avoid notices */
+/**
+ * @cond file_level_code
+ * Set $wgCommandLineMode if it's not set already, to avoid notices
+ */
if( !isset( $wgCommandLineMode ) ) {
$wgCommandLineMode = false;
}
+/** @endcond */
/** For colorized maintenance script output, is your terminal background dark ? */
$wgCommandLineDarkBg = false;
@@ -2421,12 +4161,42 @@ $wgCommandLineDarkBg = false;
*/
$wgMaintenanceScripts = array();
-#
-# Recent changes settings
-#
+/**
+ * Set this to a string to put the wiki into read-only mode. The text will be
+ * used as an explanation to users.
+ *
+ * This prevents most write operations via the web interface. Cache updates may
+ * still be possible. To prevent database writes completely, use the read_only
+ * option in MySQL.
+ */
+$wgReadOnly = null;
-/** Log IP addresses in the recentchanges table; can be accessed only by extensions (e.g. CheckUser) or a DB admin */
-$wgPutIPinRC = true;
+/**
+ * If this lock file exists (size > 0), the wiki will be forced into read-only mode.
+ * Its contents will be shown to users as part of the read-only warning
+ * message.
+ *
+ * Defaults to "{$wgUploadDirectory}/lock_yBgMBwiR".
+ */
+$wgReadOnlyFile = false;
+
+/**
+ * When you run the web-based upgrade utility, it will tell you what to set
+ * this to in order to authorize the upgrade process. It will subsequently be
+ * used as a password, to authorize further upgrades.
+ *
+ * For security, do not set this to a guessable string. Use the value supplied
+ * by the install/upgrade process. To cause the upgrader to generate a new key,
+ * delete the old key from LocalSettings.php.
+ */
+$wgUpgradeKey = false;
+
+/** @} */ # End of maintenance }
+
+/************************************************************************//**
+ * @name Recent changes, new pages, watchlist and history
+ * @{
+ */
/**
* Recentchanges items are periodically purged; entries older than this many
@@ -2436,14 +4206,17 @@ $wgPutIPinRC = true;
$wgRCMaxAge = 13 * 7 * 24 * 3600;
/**
- * Filter $wgRCLinkDays by $wgRCMaxAge to avoid showing links for numbers higher than what will be stored.
- * Note that this is disabled by default because we sometimes do have RC data which is beyond the limit
- * for some reason, and some users may use the high numbers to display that data which is still there.
+ * Filter $wgRCLinkDays by $wgRCMaxAge to avoid showing links for numbers
+ * higher than what will be stored. Note that this is disabled by default
+ * because we sometimes do have RC data which is beyond the limit for some
+ * reason, and some users may use the high numbers to display that data which
+ * is still there.
*/
$wgRCFilterByAge = false;
/**
- * List of Days and Limits options to list in the Special:Recentchanges and Special:Recentchangeslinked pages.
+ * List of Days and Limits options to list in the Special:Recentchanges and
+ * Special:Recentchangeslinked pages.
*/
$wgRCLinkLimits = array( 50, 100, 250, 500 );
$wgRCLinkDays = array( 1, 3, 7, 14, 30 );
@@ -2486,9 +4259,88 @@ $wgRC2UDPOmitBots = false;
*/
$wgEnableNewpagesUserFilter = true;
-#
-# Copyright and credits settings
-#
+/** Use RC Patrolling to check for vandalism */
+$wgUseRCPatrol = true;
+
+/** Use new page patrolling to check new pages on Special:Newpages */
+$wgUseNPPatrol = true;
+
+/** Provide syndication feeds (RSS, Atom) for, e.g., Recentchanges, Newpages */
+$wgFeed = true;
+
+/** Set maximum number of results to return in syndication feeds (RSS, Atom) for
+ * eg Recentchanges, Newpages. */
+$wgFeedLimit = 50;
+
+/** _Minimum_ timeout for cached Recentchanges feed, in seconds.
+ * A cached version will continue to be served out even if changes
+ * are made, until this many seconds runs out since the last render.
+ *
+ * If set to 0, feed caching is disabled. Use this for debugging only;
+ * feed generation can be pretty slow with diffs.
+ */
+$wgFeedCacheTimeout = 60;
+
+/** When generating Recentchanges RSS/Atom feed, diffs will not be generated for
+ * pages larger than this size. */
+$wgFeedDiffCutoff = 32768;
+
+/** Override the site's default RSS/ATOM feed for recentchanges that appears on
+ * every page. Some sites might have a different feed they'd like to promote
+ * instead of the RC feed (maybe like a "Recent New Articles" or "Breaking news" one).
+ * Ex: $wgSiteFeed['format'] = "http://example.com/somefeed.xml"; Format can be one
+ * of either 'rss' or 'atom'.
+ */
+$wgOverrideSiteFeed = array();
+
+/**
+ * Which feed types should we provide by default? This can include 'rss',
+ * 'atom', neither, or both.
+ */
+$wgAdvertisedFeedTypes = array( 'atom' );
+
+/** Show watching users in recent changes, watchlist and page history views */
+$wgRCShowWatchingUsers = false; # UPO
+/** Show watching users in Page views */
+$wgPageShowWatchingUsers = false;
+/** Show the amount of changed characters in recent changes */
+$wgRCShowChangedSize = true;
+
+/**
+ * If the difference between the character counts of the text
+ * before and after the edit is below that value, the value will be
+ * highlighted on the RC page.
+ */
+$wgRCChangedSizeThreshold = 500;
+
+/**
+ * Show "Updated (since my last visit)" marker in RC view, watchlist and history
+ * view for watched pages with new changes */
+$wgShowUpdatedMarker = true;
+
+/**
+ * Disable links to talk pages of anonymous users (IPs) in listings on special
+ * pages like page history, Special:Recentchanges, etc.
+ */
+$wgDisableAnonTalk = false;
+
+/**
+ * Enable filtering of categories in Recentchanges
+ */
+$wgAllowCategorizedRecentChanges = false;
+
+/**
+ * Allow filtering by change tag in recentchanges, history, etc
+ * Has no effect if no tags are defined in valid_tag.
+ */
+$wgUseTagFilter = true;
+
+/** @} */ # end RC/watchlist }
+
+/************************************************************************//**
+ * @name Copyright and credits settings
+ * @{
+ */
/** RDF metadata toggles */
$wgEnableDublinCoreRdf = false;
@@ -2507,7 +4359,10 @@ $wgRightsIcon = null;
*/
$wgLicenseTerms = false;
-/** Set this to some HTML to override the rights icon with an arbitrary logo */
+/**
+ * Set this to some HTML to override the rights icon with an arbitrary logo
+ * @deprecated Use $wgFooterIcons['copyright']['copyright']
+ */
$wgCopyrightIcon = null;
/** Set this to true if you want detailed copyright information forms on Upload. */
@@ -2530,27 +4385,12 @@ $wgMaxCredits = 0;
* Otherwise, link to a separate credits page. */
$wgShowCreditsIfMax = true;
+/** @} */ # end of copyright and credits settings }
-
-/**
- * Set this to false to avoid forcing the first letter of links to capitals.
- * WARNING: may break links! This makes links COMPLETELY case-sensitive. Links
- * appearing with a capital at the beginning of a sentence will *not* go to the
- * same place as links in the middle of a sentence using a lowercase initial.
- */
-$wgCapitalLinks = true;
-
-/**
- * @since 1.16 - This can now be set per-namespace. Some special namespaces (such
- * as Special, see MWNamespace::$alwaysCapitalizedNamespaces for the full list) must be
- * true by default (and setting them has no effect), due to various things that
- * require them to be so. Also, since Talk namespaces need to directly mirror their
- * associated content namespaces, the values for those are ignored in favor of the
- * subject namespace's setting. Setting for NS_MEDIA is taken automatically from
- * NS_FILE.
- * EX: $wgCapitalLinkOverrides[ NS_FILE ] = false;
+/************************************************************************//**
+ * @name Import / Export
+ * @{
*/
-$wgCapitalLinkOverrides = array();
/**
* List of interwiki prefixes for wikis we'll accept as sources for
@@ -2608,199 +4448,11 @@ $wgExportMaxLinkDepth = 0;
*/
$wgExportFromNamespaces = false;
-/**
- * Edits matching these regular expressions in body text
- * will be recognised as spam and rejected automatically.
- *
- * There's no administrator override on-wiki, so be careful what you set. :)
- * May be an array of regexes or a single string for backwards compatibility.
- *
- * See http://en.wikipedia.org/wiki/Regular_expression
- * Note that each regex needs a beginning/end delimiter, eg: # or /
- */
-$wgSpamRegex = array();
-
-/** Same as the above except for edit summaries */
-$wgSummarySpamRegex = array();
-
-/** Similarly you can get a function to do the job. The function will be given
- * the following args:
- * - a Title object for the article the edit is made on
- * - the text submitted in the textarea (wpTextbox1)
- * - the section number.
- * The return should be boolean indicating whether the edit matched some evilness:
- * - true : block it
- * - false : let it through
- *
- * For a complete example, have a look at the SpamBlacklist extension.
- */
-$wgFilterCallback = false;
-
-/** Go button goes straight to the edit screen if the article doesn't exist. */
-$wgGoToEdit = false;
-
-/** Allow raw, unchecked HTML in <html>...</html> sections.
- * THIS IS VERY DANGEROUS on a publically editable site, so USE wgGroupPermissions
- * TO RESTRICT EDITING to only those that you trust
- */
-$wgRawHtml = false;
-
-/**
- * $wgUseTidy: use tidy to make sure HTML output is sane.
- * Tidy is a free tool that fixes broken HTML.
- * See http://www.w3.org/People/Raggett/tidy/
- * $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.
- * 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.
- */
-$wgUseTidy = false;
-$wgAlwaysUseTidy = false;
-$wgTidyBin = 'tidy';
-$wgTidyConf = $IP.'/includes/tidy.conf';
-$wgTidyOpts = '';
-$wgTidyInternal = extension_loaded( 'tidy' );
-
-/**
- * Put tidy warnings in HTML comments
- * Only works for internal tidy.
- */
-$wgDebugTidy = false;
-
-/**
- * Validate the overall output using tidy and refuse
- * to display the page if it's not valid.
- */
-$wgValidateAllHtml = false;
-
-/** See list of skins and their symbolic names in languages/Language.php */
-$wgDefaultSkin = 'monobook';
-
-/**
-* Should we allow the user's to select their own skin that will override the default?
-* @deprecated in 1.16, use $wgHiddenPrefs[] = 'skin' to disable it
-*/
-$wgAllowUserSkin = true;
-
-/**
- * Optionally, we can specify a stylesheet to use for media="handheld".
- * This is recognized by some, but not all, handheld/mobile/PDA browsers.
- * If left empty, compliant handheld browsers won't pick up the skin
- * stylesheet, which is specified for 'screen' media.
- *
- * Can be a complete URL, base-relative path, or $wgStylePath-relative path.
- * Try 'chick/main.css' to apply the Chick styles to the MonoBook HTML.
- *
- * Will also be switched in when 'handheld=yes' is added to the URL, like
- * the 'printable=yes' mode for print media.
- */
-$wgHandheldStyle = false;
-
-/**
- * If set, 'screen' and 'handheld' media specifiers for stylesheets are
- * transformed such that they apply to the iPhone/iPod Touch Mobile Safari,
- * which doesn't recognize 'handheld' but does support media queries on its
- * screen size.
- *
- * Consider only using this if you have a *really good* handheld stylesheet,
- * as iPhone users won't have any way to disable it and use the "grown-up"
- * styles instead.
- */
-$wgHandheldForIPhone = false;
-
-/**
- * Settings added to this array will override the default globals for the user
- * preferences used by anonymous visitors and newly created accounts.
- * For instance, to disable section editing links:
- * $wgDefaultUserOptions ['editsection'] = 0;
- *
- */
-$wgDefaultUserOptions = array(
- 'quickbar' => 1,
- 'underline' => 2,
- 'cols' => 80,
- 'rows' => 25,
- 'searchlimit' => 20,
- 'contextlines' => 5,
- 'contextchars' => 50,
- 'disablesuggest' => 0,
- 'skin' => false,
- 'math' => 1,
- 'usenewrc' => 0,
- 'rcdays' => 7,
- 'rclimit' => 50,
- 'wllimit' => 250,
- 'hideminor' => 0,
- 'hidepatrolled' => 0,
- 'newpageshidepatrolled' => 0,
- 'highlightbroken' => 1,
- 'stubthreshold' => 0,
- 'previewontop' => 1,
- 'previewonfirst' => 0,
- 'editsection' => 1,
- 'editsectiononrightclick' => 0,
- 'editondblclick' => 0,
- 'editwidth' => 0,
- 'showtoc' => 1,
- 'showtoolbar' => 1,
- 'minordefault' => 0,
- 'date' => 'default',
- 'imagesize' => 2,
- 'thumbsize' => 2,
- 'rememberpassword' => 0,
- 'nocache' => 0,
- 'diffonly' => 0,
- 'showhiddencats' => 0,
- 'norollbackdiff' => 0,
- 'enotifwatchlistpages' => 0,
- 'enotifusertalkpages' => 1,
- 'enotifminoredits' => 0,
- 'enotifrevealaddr' => 0,
- 'shownumberswatching' => 1,
- 'fancysig' => 0,
- 'externaleditor' => 0,
- 'externaldiff' => 0,
- 'forceeditsummary' => 0,
- 'showjumplinks' => 1,
- 'justify' => 0,
- 'numberheadings' => 0,
- 'uselivepreview' => 0,
- 'watchlistdays' => 3.0,
- 'extendwatchlist' => 0,
- 'watchlisthideminor' => 0,
- 'watchlisthidebots' => 0,
- 'watchlisthideown' => 0,
- 'watchlisthideanons' => 0,
- 'watchlisthideliu' => 0,
- 'watchlisthidepatrolled' => 0,
- 'watchcreations' => 0,
- 'watchdefault' => 0,
- 'watchmoves' => 0,
- 'watchdeletion' => 0,
- 'noconvertlink' => 0,
- 'gender' => 'unknown',
- 'ccmeonemails' => 0,
- 'disablemail' => 0,
- 'editfont' => 'default',
-);
-
-/**
- * Whether or not to allow and use real name fields.
- * @deprecated in 1.16, use $wgHiddenPrefs[] = 'realname' below to disable real
- * names
- */
-$wgAllowRealName = true;
-
-/** An array of preferences to not show for the user */
-$wgHiddenPrefs = array();
+/** @} */ # end of import/export }
-/*****************************************************************************
- * Extensions
+/*************************************************************************//**
+ * @name Extensions
+ * @{
*/
/**
@@ -2892,157 +4544,78 @@ $wgAutoloadClasses = array();
* 'descriptionmsg' => array( 'exampleextension-desc', param1, param2, ... ),
*/
$wgExtensionCredits = array();
-/*
- * end extensions
- ******************************************************************************/
/**
- * Allow user Javascript page?
- * This enables a lot of neat customizations, but may
- * increase security risk to users and server load.
+ * Authentication plugin.
*/
-$wgAllowUserJs = false;
+$wgAuth = null;
/**
- * Allow user Cascading Style Sheets (CSS)?
- * This enables a lot of neat customizations, but may
- * increase security risk to users and server load.
+ * Global list of hooks.
+ * Add a hook by doing:
+ * $wgHooks['event_name'][] = $function;
+ * or:
+ * $wgHooks['event_name'][] = array($function, $data);
+ * or:
+ * $wgHooks['event_name'][] = array($object, 'method');
*/
-$wgAllowUserCss = false;
-
-/** Use the site's Javascript page? */
-$wgUseSiteJs = true;
-
-/** Use the site's Cascading Style Sheets (CSS)? */
-$wgUseSiteCss = true;
+$wgHooks = array();
/**
- * Filter for Special:Randompage. Part of a WHERE clause
- * @deprecated as of 1.16, use the SpecialRandomGetRandomTitle hook
-*/
-
-$wgExtraRandompageSQL = false;
-
-/** Allow the "info" action, very inefficient at the moment */
-$wgAllowPageInfo = false;
-
-/** Maximum indent level of toc. */
-$wgMaxTocLevel = 999;
-
-/** Name of the external diff engine to use */
-$wgExternalDiffEngine = false;
-
-/** Use RC Patrolling to check for vandalism */
-$wgUseRCPatrol = true;
-
-/** Use new page patrolling to check new pages on Special:Newpages */
-$wgUseNPPatrol = true;
-
-/** Provide syndication feeds (RSS, Atom) for, e.g., Recentchanges, Newpages */
-$wgFeed = true;
-
-/** Set maximum number of results to return in syndication feeds (RSS, Atom) for
- * eg Recentchanges, Newpages. */
-$wgFeedLimit = 50;
-
-/** _Minimum_ timeout for cached Recentchanges feed, in seconds.
- * A cached version will continue to be served out even if changes
- * are made, until this many seconds runs out since the last render.
- *
- * If set to 0, feed caching is disabled. Use this for debugging only;
- * feed generation can be pretty slow with diffs.
- */
-$wgFeedCacheTimeout = 60;
-
-/** When generating Recentchanges RSS/Atom feed, diffs will not be generated for
- * pages larger than this size. */
-$wgFeedDiffCutoff = 32768;
-
-/** Override the site's default RSS/ATOM feed for recentchanges that appears on
- * every page. Some sites might have a different feed they'd like to promote
- * instead of the RC feed (maybe like a "Recent New Articles" or "Breaking news" one).
- * Ex: $wgSiteFeed['format'] = "http://example.com/somefeed.xml"; Format can be one
- * of either 'rss' or 'atom'.
+ * Maps jobs to their handling classes; extensions
+ * can add to this to provide custom jobs
*/
-$wgOverrideSiteFeed = array();
+$wgJobClasses = array(
+ 'refreshLinks' => 'RefreshLinksJob',
+ 'refreshLinks2' => 'RefreshLinksJob2',
+ 'htmlCacheUpdate' => 'HTMLCacheUpdateJob',
+ 'html_cache_update' => 'HTMLCacheUpdateJob', // backwards-compatible
+ 'sendMail' => 'EmaillingJob',
+ 'enotifNotify' => 'EnotifNotifyJob',
+ 'fixDoubleRedirect' => 'DoubleRedirectJob',
+ 'uploadFromUrl' => 'UploadFromUrlJob',
+);
/**
- * Which feed types should we provide by default? This can include 'rss',
- * 'atom', neither, or both.
+ * Additional functions to be performed with updateSpecialPages.
+ * Expensive Querypages are already updated.
*/
-$wgAdvertisedFeedTypes = array( 'atom' );
+$wgSpecialPageCacheUpdates = array(
+ 'Statistics' => array('SiteStatsUpdate','cacheUpdate')
+);
/**
- * Additional namespaces. If the namespaces defined in Language.php and
- * Namespace.php are insufficient, you can create new ones here, for example,
- * to import Help files in other languages.
- * PLEASE NOTE: Once you delete a namespace, the pages in that namespace will
- * no longer be accessible. If you rename it, then you can access them through
- * the new namespace name.
- *
- * Custom namespaces should start at 100 to avoid conflicting with standard
- * namespaces, and should always follow the even/odd main/talk pattern.
+ * Hooks that are used for outputting exceptions. Format is:
+ * $wgExceptionHooks[] = $funcname
+ * or:
+ * $wgExceptionHooks[] = array( $class, $funcname )
+ * Hooks should return strings or false
*/
-#$wgExtraNamespaces =
-# array(100 => "Hilfe",
-# 101 => "Hilfe_Diskussion",
-# 102 => "Aide",
-# 103 => "Discussion_Aide"
-# );
-$wgExtraNamespaces = null;
+$wgExceptionHooks = array();
-/**
- * Namespace aliases
- * These are alternate names for the primary localised namespace names, which
- * are defined by $wgExtraNamespaces and the language file. If a page is
- * requested with such a prefix, the request will be redirected to the primary
- * name.
- *
- * Set this to a map from namespace names to IDs.
- * Example:
- * $wgNamespaceAliases = array(
- * 'Wikipedian' => NS_USER,
- * 'Help' => 100,
- * );
- */
-$wgNamespaceAliases = array();
/**
- * Limit images on image description pages to a user-selectable limit. In order
- * to reduce disk usage, limits can only be selected from a list.
- * The user preference is saved as an array offset in the database, by default
- * the offset is set with $wgDefaultUserOptions['imagesize']. Make sure you
- * change it if you alter the array (see bug 8858).
- * This is the list of settings the user can choose from:
+ * Page property link table invalidation lists. When a page property
+ * changes, this may require other link tables to be updated (eg
+ * adding __HIDDENCAT__ means the hiddencat tracking category will
+ * have been added, so the categorylinks table needs to be rebuilt).
+ * This array can be added to by extensions.
*/
-$wgImageLimits = array (
- array(320,240),
- array(640,480),
- array(800,600),
- array(1024,768),
- array(1280,1024),
- array(10000,10000) );
+$wgPagePropLinkInvalidations = array(
+ 'hiddencat' => 'categorylinks',
+);
-/**
- * Adjust thumbnails on image pages according to a user setting. In order to
- * reduce disk usage, the values can only be selected from a list. This is the
- * list of settings the user can choose from:
+/** @} */ # End extensions }
+
+/*************************************************************************//**
+ * @name Categories
+ * @{
*/
-$wgThumbLimits = array(
- 120,
- 150,
- 180,
- 200,
- 250,
- 300
-);
/**
- * Adjust width of upright images when parameter 'upright' is used
- * This allows a nicer look for upright images without the need to fix the width
- * by hardcoded px in wiki sourcecode.
+ * Use experimental, DMOZ-like category browser
*/
-$wgThumbUpright = 0.75;
+$wgUseCategoryBrowser = false;
/**
* On category pages, show thumbnail gallery for images belonging to that
@@ -3056,123 +4629,33 @@ $wgCategoryMagicGallery = true;
$wgCategoryPagingLimit = 200;
/**
- * Should the default category sortkey be the prefixed title?
- * Run maintenance/refreshLinks.php after changing this.
- */
-$wgCategoryPrefixedDefaultSortkey = true;
-
-/**
- * Browser Blacklist for unicode non compliant browsers
- * Contains a list of regexps : "/regexp/" matching problematic browsers
- */
-$wgBrowserBlackList = array(
- /**
- * Netscape 2-4 detection
- * The minor version may contain strings such as "Gold" or "SGoldC-SGI"
- * Lots of non-netscape user agents have "compatible", so it's useful to check for that
- * with a negative assertion. The [UIN] identifier specifies the level of security
- * in a Netscape/Mozilla browser, checking for it rules out a number of fakers.
- * The language string is unreliable, it is missing on NS4 Mac.
- *
- * Reference: http://www.psychedelix.com/agents/index.shtml
- */
- '/^Mozilla\/2\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
- '/^Mozilla\/3\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
- '/^Mozilla\/4\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
-
- /**
- * MSIE on Mac OS 9 is teh sux0r, converts þ to <thorn>, ð to <eth>, Þ to <THORN> and Ð to <ETH>
- *
- * Known useragents:
- * - Mozilla/4.0 (compatible; MSIE 5.0; Mac_PowerPC)
- * - Mozilla/4.0 (compatible; MSIE 5.15; Mac_PowerPC)
- * - Mozilla/4.0 (compatible; MSIE 5.23; Mac_PowerPC)
- * - [...]
- *
- * @link http://en.wikipedia.org/w/index.php?title=User%3A%C6var_Arnfj%F6r%F0_Bjarmason%2Ftestme&diff=12356041&oldid=12355864
- * @link http://en.wikipedia.org/wiki/Template%3AOS9
- */
- '/^Mozilla\/4\.0 \(compatible; MSIE \d+\.\d+; Mac_PowerPC\)/',
-
- /**
- * Google wireless transcoder, seems to eat a lot of chars alive
- * http://it.wikipedia.org/w/index.php?title=Luciano_Ligabue&diff=prev&oldid=8857361
- */
- '/^Mozilla\/4\.0 \(compatible; MSIE 6.0; Windows NT 5.0; Google Wireless Transcoder;\)/'
-);
-
-/**
- * Fake out the timezone that the server thinks it's in. This will be used for
- * date display and not for what's stored in the DB. Leave to null to retain
- * your server's OS-based timezone value.
+ * Specify how category names should be sorted, when listed on a category page.
+ * A sorting scheme is also known as a collation.
*
- * This variable is currently used only for signature formatting and for local
- * time/date parser variables ({{LOCALTIME}} etc.)
+ * Available values are:
*
- * Timezones can be translated by editing MediaWiki messages of type
- * timezone-nameinlowercase like timezone-utc.
- */
-# $wgLocaltimezone = 'GMT';
-# $wgLocaltimezone = 'PST8PDT';
-# $wgLocaltimezone = 'Europe/Sweden';
-# $wgLocaltimezone = 'CET';
-$wgLocaltimezone = null;
-
-/**
- * Set an offset from UTC in minutes to use for the default timezone setting
- * for anonymous users and new user accounts.
- *
- * This setting is used for most date/time displays in the software, and is
- * overrideable in user preferences. It is *not* used for signature timestamps.
+ * - uppercase: Converts the category name to upper case, and sorts by that.
*
- * You can set it to match the configured server timezone like this:
- * $wgLocalTZoffset = date("Z") / 60;
+ * - 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".
*
- * If your server is not configured for the timezone you want, you can set
- * this in conjunction with the signature timezone and override the PHP default
- * timezone like so:
- * $wgLocaltimezone="Europe/Berlin";
- * date_default_timezone_set( $wgLocaltimezone );
- * $wgLocalTZoffset = date("Z") / 60;
- *
- * Leave at NULL to show times in universal time (UTC/GMT).
- */
-$wgLocalTZoffset = null;
-
-
-/**
- * When translating messages with wfMsg(), it is not always clear what should
- * be considered UI messages and what should be content messages.
- *
- * For example, for the English Wikipedia, there should be only one 'mainpage',
- * so when getting the link for 'mainpage', we should treat it as site content
- * and call wfMsgForContent(), but for rendering the text of the link, we call
- * wfMsg(). The code behaves this way by default. However, sites like the
- * Wikimedia Commons do offer different versions of 'mainpage' and the like for
- * different languages. This array provides a way to override the default
- * behavior. For example, to allow language-specific main page and community
- * portal, set
+ * To use the uca-default collation, you must have PHP's intl extension
+ * installed. See http://php.net/manual/en/intl.setup.php . The details of the
+ * resulting collation will depend on the version of ICU installed on the
+ * server.
*
- * $wgForceUIMsgAsContentMsg = array( 'mainpage', 'portal-url' );
+ * After you change this, you must run maintenance/updateCollation.php to fix
+ * the sort keys in the database.
*/
-$wgForceUIMsgAsContentMsg = array();
+$wgCategoryCollation = 'uppercase';
+/** @} */ # End categories }
-/**
- * Authentication plugin.
+/*************************************************************************//**
+ * @name Logging
+ * @{
*/
-$wgAuth = null;
-
-/**
- * Global list of hooks.
- * Add a hook by doing:
- * $wgHooks['event_name'][] = $function;
- * or:
- * $wgHooks['event_name'][] = array($function, $data);
- * or:
- * $wgHooks['event_name'][] = array($object, 'method');
- */
-$wgHooks = array();
/**
* The logging system has two levels: an event type, which describes the
@@ -3283,6 +4766,7 @@ $wgLogActions = array(
'protect/unprotect' => 'unprotectedarticle',
'protect/move_prot' => 'movedarticleprotection',
'rights/rights' => 'rightslogentry',
+ 'rights/disable' => 'disableaccount-logentry',
'delete/delete' => 'deletedarticle',
'delete/restore' => 'undeletedarticle',
'delete/revision' => 'revdelete-logentry',
@@ -3299,13 +4783,15 @@ $wgLogActions = array(
'suppress/file' => 'revdelete-logentry',
'suppress/event' => 'logdelete-logentry',
'suppress/delete' => 'suppressedarticle',
- 'suppress/block' => 'blocklogentry',
+ '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
+ * not messages.
+ * @see LogPage::actionText
*/
$wgLogActionsHandlers = array();
@@ -3315,6 +4801,29 @@ $wgLogActionsHandlers = array();
$wgNewUserLog = true;
/**
+ * Log the automatic creations of new users accounts?
+ */
+$wgLogAutocreatedAccounts = false;
+
+/** @} */ # end logging }
+
+/*************************************************************************//**
+ * @name Special pages (general and miscellaneous)
+ * @{
+ */
+
+/**
+ * Allow special page inclusions such as {{Special:Allpages}}
+ */
+$wgAllowSpecialInclusion = true;
+
+/**
+ * Set this to an array of special page names to prevent
+ * maintenance/updateSpecialPages.php from updating those pages.
+ */
+$wgDisableQueryPageUpdate = false;
+
+/**
* List of special pages, followed by what subtitle they should go under
* at Special:SpecialPages
*/
@@ -3396,6 +4905,7 @@ $wgSpecialPageGroups = array(
'Search' => 'redirects',
'LinkSearch' => 'redirects',
+ 'ComparePages' => 'pagetools',
'Movepage' => 'pagetools',
'MergeHistory' => 'pagetools',
'Revisiondelete' => 'pagetools',
@@ -3416,56 +4926,35 @@ $wgSpecialPageGroups = array(
'Booksources' => 'other',
);
-/**
- * Disable the internal MySQL-based search, to allow it to be
- * implemented by an extension instead.
- */
-$wgDisableInternalSearch = false;
+/** Whether or not to sort special pages in Special:Specialpages */
-/**
- * Set this to a URL to forward search requests to some external location.
- * If the URL includes '$1', this will be replaced with the URL-encoded
- * search term.
- *
- * For example, to forward to Google you'd have something like:
- * $wgSearchForwardUrl = 'http://www.google.com/search?q=$1' .
- * '&domains=http://example.com' .
- * '&sitesearch=http://example.com' .
- * '&ie=utf-8&oe=utf-8';
- */
-$wgSearchForwardUrl = null;
+$wgSortSpecialPages = true;
/**
- * Set a default target for external links, e.g. _blank to pop up a new window
+ * Filter for Special:Randompage. Part of a WHERE clause
+ * @deprecated as of 1.16, use the SpecialRandomGetRandomTitle hook
*/
-$wgExternalLinkTarget = false;
+$wgExtraRandompageSQL = false;
/**
- * If true, external URL links in wiki text will be given the
- * rel="nofollow" attribute as a hint to search engines that
- * they should not be followed for ranking purposes as they
- * are user-supplied and thus subject to spamming.
+ * On Special:Unusedimages, consider images "used", if they are put
+ * into a category. Default (false) is not to count those as used.
*/
-$wgNoFollowLinks = true;
+$wgCountCategorizedImagesAsUsed = false;
/**
- * Namespaces in which $wgNoFollowLinks doesn't apply.
- * See Language.php for a list of namespaces.
+ * Maximum number of links to a redirect page listed on
+ * Special:Whatlinkshere/RedirectDestination
*/
-$wgNoFollowNsExceptions = array();
+$wgMaxRedirectLinksRetrieved = 500;
-/**
- * If this is set to an array of domains, external links to these domain names
- * (or any subdomains) will not be set to rel="nofollow" regardless of the
- * value of $wgNoFollowLinks. For instance:
- *
- * $wgNoFollowDomainExceptions = array( 'en.wikipedia.org', 'wiktionary.org' );
- *
- * This would add rel="nofollow" to links to de.wikipedia.org, but not
- * en.wikipedia.org, wiktionary.org, en.wiktionary.org, us.en.wikipedia.org,
- * etc.
+/** @} */ # end special pages }
+
+/*************************************************************************//**
+ * @name Robot (search engine crawler) policy
+ * See also $wgNoFollowLinks.
+ * @{
*/
-$wgNoFollowDomainExceptions = array();
/**
* Default robot policy. The default policy is to encourage indexing and fol-
@@ -3516,251 +5005,76 @@ $wgArticleRobotPolicies = array();
*/
$wgExemptFromUserRobotsControl = null;
-/**
- * Specifies the minimal length of a user password. If set to 0, empty pass-
- * words are allowed.
- */
-$wgMinimalPasswordLength = 1;
-
-/**
- * Activate external editor interface for files and pages
- * See http://www.mediawiki.org/wiki/Manual:External_editors
- */
-$wgUseExternalEditor = true;
-
-/** Whether or not to sort special pages in Special:Specialpages */
-
-$wgSortSpecialPages = true;
-
-/**
- * Specify the name of a skin that should not be presented in the list of a-
- * vailable skins. Use for blacklisting a skin which you do not want to remove
- * from the .../skins/ directory
- */
-$wgSkipSkin = '';
-$wgSkipSkins = array(); # More of the same
-
-/**
- * Array of disabled article actions, e.g. view, edit, dublincore, delete, etc.
- */
-$wgDisabledActions = array();
-
-/**
- * Disable redirects to special pages and interwiki redirects, which use a 302
- * and have no "redirected from" link.
- */
-$wgDisableHardRedirects = false;
-
-/**
- * Set to false to disable application of access keys and tooltips,
- * eg to avoid keyboard conflicts with system keys or as a low-level
- * optimization.
- */
-$wgEnableTooltipsAndAccesskeys = true;
-
-/**
- * Whether to use DNS blacklists in $wgDnsBlacklistUrls to check for open proxies
- * @since 1.16
- */
-$wgEnableDnsBlacklist = false;
-
-/**
- * @deprecated Use $wgEnableDnsBlacklist instead, only kept for backward
- * compatibility
- */
-$wgEnableSorbs = false;
-
-/**
- * List of DNS blacklists to use, if $wgEnableDnsBlacklist is true
- * @since 1.16
- */
-$wgDnsBlacklistUrls = array( 'http.dnsbl.sorbs.net.' );
-
-/**
- * @deprecated Use $wgDnsBlacklistUrls instead, only kept for backward
- * compatibility
- */
-$wgSorbsUrl = array();
-
-/**
- * Proxy whitelist, list of addresses that are assumed to be non-proxy despite
- * what the other methods might say.
- */
-$wgProxyWhitelist = array();
-
-/**
- * Simple rate limiter options to brake edit floods. Maximum number actions
- * allowed in the given number of seconds; after that the violating client re-
- * ceives HTTP 500 error pages until the period elapses.
- *
- * array( 4, 60 ) for a maximum of 4 hits in 60 seconds.
- *
- * This option set is experimental and likely to change. Requires memcached.
- */
-$wgRateLimits = array(
- 'edit' => array(
- 'anon' => null, // for any and all anonymous edits (aggregate)
- 'user' => null, // for each logged-in user
- 'newbie' => null, // for each recent (autoconfirmed) account; overrides 'user'
- 'ip' => null, // for each anon and recent account
- 'subnet' => null, // ... with final octet removed
- ),
- 'move' => array(
- 'user' => null,
- 'newbie' => null,
- 'ip' => null,
- 'subnet' => null,
- ),
- 'mailpassword' => array(
- 'anon' => null,
- ),
- 'emailuser' => array(
- 'user' => null,
- ),
- );
-
-/**
- * Set to a filename to log rate limiter hits.
- */
-$wgRateLimitLog = null;
-
-/**
- * Array of groups which should never trigger the rate limiter
- *
- * @deprecated as of 1.13.0, the preferred method is using
- * $wgGroupPermissions[]['noratelimit']. However, this will still
- * work if desired.
- *
- * $wgRateLimitsExcludedGroups = array( 'sysop', 'bureaucrat' );
- */
-$wgRateLimitsExcludedGroups = array();
-
-/**
- * Array of IPs which should be excluded from rate limits.
- * This may be useful for whitelisting NAT gateways for conferences, etc.
- */
-$wgRateLimitsExcludedIPs = array();
+/** @} */ # End robot policy }
-/**
- * On Special:Unusedimages, consider images "used", if they are put
- * into a category. Default (false) is not to count those as used.
+/************************************************************************//**
+ * @name AJAX and API
+ * Note: The AJAX entry point which this section refers to is gradually being
+ * replaced by the API entry point, api.php. They are essentially equivalent.
+ * Both of them are used for dynamic client-side features, via XHR.
+ * @{
*/
-$wgCountCategorizedImagesAsUsed = false;
-
-/**
- * External stores allow including content
- * from non database sources following URL links
- *
- * Short names of ExternalStore classes may be specified in an array here:
- * $wgExternalStores = array("http","file","custom")...
- *
- * CAUTION: Access to database might lead to code execution
- */
-$wgExternalStores = false;
-
-/**
- * An array of external mysql servers, e.g.
- * $wgExternalServers = array( 'cluster1' => array( 'srv28', 'srv29', 'srv30' ) );
- * Used by LBFactory_Simple, may be ignored if $wgLBFactoryConf is set to another class.
- */
-$wgExternalServers = array();
-
-/**
- * The place to put new revisions, false to put them in the local text table.
- * Part of a URL, e.g. DB://cluster1
- *
- * Can be an array instead of a single string, to enable data distribution. Keys
- * must be consecutive integers, starting at zero. Example:
- *
- * $wgDefaultExternalStore = array( 'DB://cluster1', 'DB://cluster2' );
- *
- */
-$wgDefaultExternalStore = false;
-
-/**
- * Revision text may be cached in $wgMemc to reduce load on external storage
- * servers and object extraction overhead for frequently-loaded revisions.
- *
- * Set to 0 to disable, or number of seconds before cache expiry.
- */
-$wgRevisionCacheExpiry = 0;
/**
- * list of trusted media-types and mime types.
- * Use the MEDIATYPE_xxx constants to represent media types.
- * This list is used by Image::isSafeFile
+ * Enable the MediaWiki API for convenient access to
+ * machine-readable data via api.php
*
- * Types not listed here will have a warning about unsafe content
- * displayed on the images description page. It would also be possible
- * to use this for further restrictions, like disabling direct
- * [[media:...]] links for non-trusted formats.
- */
-$wgTrustedMediaFormats= array(
- MEDIATYPE_BITMAP, //all bitmap formats
- MEDIATYPE_AUDIO, //all audio formats
- MEDIATYPE_VIDEO, //all plain video formats
- "image/svg+xml", //svg (only needed if inline rendering of svg is not supported)
- "application/pdf", //PDF files
- #"application/x-shockwave-flash", //flash/shockwave movie
-);
-
-/**
- * Allow special page inclusions such as {{Special:Allpages}}
- */
-$wgAllowSpecialInclusion = true;
-
-/**
- * Timeout for HTTP requests done internally
+ * See http://www.mediawiki.org/wiki/API
*/
-$wgHTTPTimeout = 25;
+$wgEnableAPI = true;
/**
- * Timeout for Asynchronous (background) HTTP requests
+ * Allow the API to be used to perform write operations
+ * (page edits, rollback, etc.) when an authorised user
+ * accesses it
*/
-$wgAsyncHTTPTimeout = 25;
+$wgEnableWriteAPI = true;
/**
- * Proxy to use for CURL requests.
+ * API module extensions
+ * Associative array mapping module name to class name.
+ * Extension modules may override the core modules.
*/
-$wgHTTPProxy = false;
+$wgAPIModules = array();
+$wgAPIMetaModules = array();
+$wgAPIPropModules = array();
+$wgAPIListModules = array();
/**
- * Enable interwiki transcluding. Only when iw_trans=1.
- */
-$wgEnableScaryTranscluding = false;
-/**
- * Expiry time for interwiki transclusion
+ * Maximum amount of rows to scan in a DB query in the API
+ * The default value is generally fine
*/
-$wgTranscludeCacheExpiry = 3600;
+$wgAPIMaxDBRows = 5000;
/**
- * Support blog-style "trackbacks" for articles. See
- * http://www.sixapart.com/pronet/docs/trackback_spec for details.
+ * The maximum size (in bytes) of an API result.
+ * Don't set this lower than $wgMaxArticleSize*1024
*/
-$wgUseTrackbacks = false;
+$wgAPIMaxResultSize = 8388608;
/**
- * Enable filtering of categories in Recentchanges
+ * The maximum number of uncached diffs that can be retrieved in one API
+ * request. Set this to 0 to disable API diffs altogether
*/
-$wgAllowCategorizedRecentChanges = false ;
+$wgAPIMaxUncachedDiffs = 1;
/**
- * Number of jobs to perform per request. May be less than one in which case
- * jobs are performed probabalistically. If this is zero, jobs will not be done
- * during ordinary apache requests. In this case, maintenance/runJobs.php should
- * be run periodically.
+ * Log file or URL (TCP or UDP) to log API requests to, or false to disable
+ * API request logging
*/
-$wgJobRunRate = 1;
+$wgAPIRequestLog = false;
/**
- * Number of rows to update per job
+ * Cache the API help text for up to an hour. Disable this during API
+ * debugging and development
*/
-$wgUpdateRowsPerJob = 500;
+$wgAPICacheHelp = true;
/**
- * Number of rows to update per query
+ * Set the timeout for the API help text cache. Ignored if $wgAPICacheHelp
+ * is false.
*/
-$wgUpdateRowsPerQuery = 100;
+$wgAPICacheHelpTimeout = 60*60;
/**
* Enable AJAX framework
@@ -3771,7 +5085,7 @@ $wgUseAjax = true;
* List of Ajax-callable functions.
* Extensions acting as Ajax callbacks must register here
*/
-$wgAjaxExportList = array( 'wfAjaxGetThumbnailUrl', 'wfAjaxGetFileUrl' );
+$wgAjaxExportList = array( 'wfAjaxGetFileUrl' );
/**
* Enable watching/unwatching pages using AJAX.
@@ -3791,43 +5105,40 @@ $wgAjaxUploadDestCheck = true;
$wgAjaxLicensePreview = true;
/**
- * Allow DISPLAYTITLE to change title display
+ * Settings for incoming cross-site AJAX requests:
+ * Newer browsers support cross-site AJAX when the target resource allows requests
+ * from the origin domain by the Access-Control-Allow-Origin header.
+ * This is currently only used by the API (requests to api.php)
+ * $wgCrossSiteAJAXdomains can be set using a wildcard syntax:
+ *
+ * '*' matches any number of characters
+ * '?' matches any 1 character
+ *
+ * Example:
+ $wgCrossSiteAJAXdomains = array(
+ 'www.mediawiki.org',
+ '*.wikipedia.org',
+ '*.wikimedia.org',
+ '*.wiktionary.org',
+ );
+ *
*/
-$wgAllowDisplayTitle = true;
+$wgCrossSiteAJAXdomains = array();
/**
- * for consistency, restrict DISPLAYTITLE to titles that normalize to the same canonical DB key
+ * Domains that should not be allowed to make AJAX requests,
+ * even if they match one of the domains allowed by $wgCrossSiteAJAXdomains
+ * Uses the same syntax as $wgCrossSiteAJAXdomains
*/
-$wgRestrictDisplayTitle = true;
-/**
- * Array of usernames which may not be registered or logged in from
- * Maintenance scripts can still use these
- */
-$wgReservedUsernames = array(
- 'MediaWiki default', // Default 'Main Page' and MediaWiki: message pages
- 'Conversion script', // Used for the old Wikipedia software upgrade
- 'Maintenance script', // Maintenance scripts which perform editing, image import script
- 'Template namespace initialisation script', // Used in 1.2->1.3 upgrade
- 'msg:double-redirect-fixer', // Automatic double redirect fix
-);
+$wgCrossSiteAJAXdomainExceptions = array();
-/**
- * MediaWiki will reject HTMLesque tags in uploaded files due to idiotic browsers which can't
- * perform basic stuff like MIME detection and which are vulnerable to further idiots uploading
- * crap files as images. When this directive is on, <title> will be allowed in files with
- * an "image/svg+xml" MIME type. You should leave this disabled if your web server is misconfigured
- * and doesn't send appropriate MIME types for SVG images.
- */
-$wgAllowTitlesInSVG = false;
+/** @} */ # End AJAX and API }
-/**
- * Array of namespaces which can be deemed to contain valid "content", as far
- * as the site statistics are concerned. Useful if additional namespaces also
- * contain "content" which should be considered when generating a count of the
- * number of articles in the wiki.
+/************************************************************************//**
+ * @name Shell and process control
+ * @{
*/
-$wgContentNamespaces = array( NS_MAIN );
/**
* Maximum amount of virtual memory available to shell processes under linux, in KB.
@@ -3851,211 +5162,85 @@ $wgMaxShellTime = 180;
$wgPhpCli = '/usr/bin/php';
/**
- * DJVU settings
- * Path of the djvudump executable
- * Enable this and $wgDjvuRenderer to enable djvu rendering
- */
-# $wgDjvuDump = 'djvudump';
-$wgDjvuDump = null;
-
-/**
- * Path of the ddjvu DJVU renderer
- * Enable this and $wgDjvuDump to enable djvu rendering
- */
-# $wgDjvuRenderer = 'ddjvu';
-$wgDjvuRenderer = null;
-
-/**
- * Path of the djvutxt DJVU text extraction utility
- * Enable this and $wgDjvuDump to enable text layer extraction from djvu files
- */
-# $wgDjvuTxt = 'djvutxt';
-$wgDjvuTxt = null;
-
-/**
- * Path of the djvutoxml executable
- * This works like djvudump except much, much slower as of version 3.5.
- *
- * For now I recommend you use djvudump instead. The djvuxml output is
- * probably more stable, so we'll switch back to it as soon as they fix
- * the efficiency problem.
- * http://sourceforge.net/tracker/index.php?func=detail&aid=1704049&group_id=32953&atid=406583
- */
-# $wgDjvuToXML = 'djvutoxml';
-$wgDjvuToXML = null;
-
-
-/**
- * Shell command for the DJVU post processor
- * Default: pnmtopng, since ddjvu generates ppm output
- * Set this to false to output the ppm file directly.
- */
-$wgDjvuPostProcessor = 'pnmtojpeg';
-/**
- * File extension for the DJVU post processor output
- */
-$wgDjvuOutputExtension = 'jpg';
-
-/**
- * Enable the MediaWiki API for convenient access to
- * machine-readable data via api.php
- *
- * See http://www.mediawiki.org/wiki/API
+ * Locale for LC_CTYPE, to work around http://bugs.php.net/bug.php?id=45132
+ * For Unix-like operating systems, set this to to a locale that has a UTF-8
+ * character set. Only the character set is relevant.
*/
-$wgEnableAPI = true;
+$wgShellLocale = 'en_US.utf8';
-/**
- * Allow the API to be used to perform write operations
- * (page edits, rollback, etc.) when an authorised user
- * accesses it
- */
-$wgEnableWriteAPI = true;
+/** @} */ # End shell }
-/**
- * API module extensions
- * Associative array mapping module name to class name.
- * Extension modules may override the core modules.
+/************************************************************************//**
+ * @name HTTP client
+ * @{
*/
-$wgAPIModules = array();
-$wgAPIMetaModules = array();
-$wgAPIPropModules = array();
-$wgAPIListModules = array();
/**
- * Maximum amount of rows to scan in a DB query in the API
- * The default value is generally fine
+ * Timeout for HTTP requests done internally
*/
-$wgAPIMaxDBRows = 5000;
+$wgHTTPTimeout = 25;
/**
- * The maximum size (in bytes) of an API result.
- * Don't set this lower than $wgMaxArticleSize*1024
+ * Timeout for Asynchronous (background) HTTP requests
*/
-$wgAPIMaxResultSize = 8388608;
+$wgAsyncHTTPTimeout = 25;
/**
- * The maximum number of uncached diffs that can be retrieved in one API
- * request. Set this to 0 to disable API diffs altogether
+ * Proxy to use for CURL requests.
*/
-$wgAPIMaxUncachedDiffs = 1;
+$wgHTTPProxy = false;
-/**
- * Log file or URL (TCP or UDP) to log API requests to, or false to disable
- * API request logging
- */
-$wgAPIRequestLog = false;
+/** @} */ # End HTTP client }
-/**
- * Cache the API help text for up to an hour. Disable this during API
- * debugging and development
+/************************************************************************//**
+ * @name Job queue
+ * See also $wgEnotifUseJobQ.
+ * @{
*/
-$wgAPICacheHelp = true;
/**
- * Set the timeout for the API help text cache. Ignored if $wgAPICacheHelp
- * is false.
+ * Number of jobs to perform per request. May be less than one in which case
+ * jobs are performed probabalistically. If this is zero, jobs will not be done
+ * during ordinary apache requests. In this case, maintenance/runJobs.php should
+ * be run periodically.
*/
-$wgAPICacheHelpTimeout = 60*60;
+$wgJobRunRate = 1;
/**
- * Parser test suite files to be run by parserTests.php when no specific
- * filename is passed to it.
- *
- * Extensions may add their own tests to this array, or site-local tests
- * may be added via LocalSettings.php
- *
- * Use full paths.
+ * Number of rows to update per job
*/
-$wgParserTestFiles = array(
- "$IP/maintenance/parserTests.txt",
-);
+$wgUpdateRowsPerJob = 500;
/**
- * If configured, specifies target CodeReview installation to send test
- * result data from 'parserTests.php --upload'
- *
- * Something like this:
- * $wgParserTestRemote = array(
- * 'api-url' => 'http://www.mediawiki.org/w/api.php',
- * 'repo' => 'MediaWiki',
- * 'suite' => 'ParserTests',
- * 'path' => '/trunk/phase3', // not used client-side; for reference
- * 'secret' => 'qmoicj3mc4mcklmqw', // Shared secret used in HMAC validation
- * );
+ * Number of rows to update per query
*/
-$wgParserTestRemote = false;
+$wgUpdateRowsPerQuery = 100;
-/**
- * Break out of framesets. This can be used to prevent clickjacking attacks,
- * or to prevent external sites from framing your site with ads.
- */
-$wgBreakFrames = false;
+/** @} */ # End job queue }
-/**
- * The X-Frame-Options header to send on pages sensitive to clickjacking
- * attacks, such as edit pages. This prevents those pages from being displayed
- * in a frame or iframe. The options are:
- *
- * - 'DENY': Do not allow framing. This is recommended for most wikis.
- *
- * - 'SAMEORIGIN': Allow framing by pages on the same domain. This can be used
- * to allow framing within a trusted domain. This is insecure if there
- * is a page on the same domain which allows framing of arbitrary URLs.
- *
- * - false: Allow all framing. This opens up the wiki to XSS attacks and thus
- * full compromise of local user accounts. Private wikis behind a
- * corporate firewall are especially vulnerable. This is not
- * recommended.
- *
- * For extra safety, set $wgBreakFrames = true, to prevent framing on all pages,
- * not just edit pages.
+/************************************************************************//**
+ * @name Miscellaneous
+ * @{
*/
-$wgEditPageFrameOptions = 'DENY';
-/**
- * Set this to an array of special page names to prevent
- * maintenance/updateSpecialPages.php from updating those pages.
- */
-$wgDisableQueryPageUpdate = false;
+/** Allow the "info" action, very inefficient at the moment */
+$wgAllowPageInfo = false;
-/**
- * Disable output compression (enabled by default if zlib is available)
- */
-$wgDisableOutputCompression = false;
+/** Name of the external diff engine to use */
+$wgExternalDiffEngine = false;
/**
- * If lag is higher than $wgSlaveLagWarning, show a warning in some special
- * pages (like watchlist). If the lag is higher than $wgSlaveLagCritical,
- * show a more obvious warning.
+ * Array of disabled article actions, e.g. view, edit, dublincore, delete, etc.
*/
-$wgSlaveLagWarning = 10;
-$wgSlaveLagCritical = 30;
+$wgDisabledActions = array();
/**
- * Parser configuration. Associative array with the following members:
- *
- * class The class name
- *
- * preprocessorClass The preprocessor class. Two classes are currently available:
- * Preprocessor_Hash, which uses plain PHP arrays for tempoarary
- * storage, and Preprocessor_DOM, which uses the DOM module for
- * temporary storage. Preprocessor_DOM generally uses less memory;
- * the speed of the two is roughly the same.
- *
- * If this parameter is not given, it uses Preprocessor_DOM if the
- * DOM module is available, otherwise it uses Preprocessor_Hash.
- *
- * The entire associative array will be passed through to the constructor as
- * the first parameter. Note that only Setup.php can use this variable --
- * the configuration will change at runtime via $wgParser member functions, so
- * the contents of this variable will be out-of-date. The variable can only be
- * changed during LocalSettings.php, in particular, it can't be changed during
- * an extension setup function.
+ * Disable redirects to special pages and interwiki redirects, which use a 302
+ * and have no "redirected from" link. Note this is only for articles with #Redirect
+ * in them. URL's containing a local interwiki prefix (or a non-canonical special
+ * page name) are still hard redirected regardless of this setting.
*/
-$wgParserConf = array(
- 'class' => 'Parser',
- #'preprocessorClass' => 'Preprocessor_Hash',
-);
+$wgDisableHardRedirects = false;
/**
* LinkHolderArray batch size
@@ -4070,38 +5255,6 @@ $wgLinkHolderBatchSize = 1000;
$wgRegisterInternalExternals = false;
/**
- * Hooks that are used for outputting exceptions. Format is:
- * $wgExceptionHooks[] = $funcname
- * or:
- * $wgExceptionHooks[] = array( $class, $funcname )
- * Hooks should return strings or false
- */
-$wgExceptionHooks = array();
-
-/**
- * Page property link table invalidation lists. When a page property
- * changes, this may require other link tables to be updated (eg
- * adding __HIDDENCAT__ means the hiddencat tracking category will
- * have been added, so the categorylinks table needs to be rebuilt).
- * This array can be added to by extensions.
- */
-$wgPagePropLinkInvalidations = array(
- 'hiddencat' => 'categorylinks',
-);
-
-/**
- * Maximum number of links to a redirect page listed on
- * Special:Whatlinkshere/RedirectDestination
- */
-$wgMaxRedirectLinksRetrieved = 500;
-
-/**
- * Maximum number of calls per parse to expensive parser functions such as
- * PAGESINCATEGORY.
- */
-$wgExpensiveParserFunctionLimit = 100;
-
-/**
* Maximum number of pages to move at once when moving subpages with a page.
*/
$wgMaximumMovedPages = 100;
@@ -4113,133 +5266,12 @@ $wgMaximumMovedPages = 100;
$wgFixDoubleRedirects = false;
/**
- * Max number of redirects to follow when resolving redirects.
- * 1 means only the first redirect is followed (default behavior).
- * 0 or less means no redirects are followed.
- */
-$wgMaxRedirects = 1;
-
-/**
- * Array of invalid page redirect targets.
- * Attempting to create a redirect to any of the pages in this array
- * will make the redirect fail.
- * Userlogout is hard-coded, so it does not need to be listed here.
- * (bug 10569) Disallow Mypage and Mytalk as well.
- *
- * As of now, this only checks special pages. Redirects to pages in
- * other namespaces cannot be invalidated by this variable.
- */
-$wgInvalidRedirectTargets = array( 'Filepath', 'Mypage', 'Mytalk' );
-
-/**
- * Array of namespaces to generate a sitemap for when the
- * maintenance/generateSitemap.php script is run, or false if one is to be ge-
- * nerated for all namespaces.
- */
-$wgSitemapNamespaces = false;
-
-
-/**
- * If user doesn't specify any edit summary when making a an edit, MediaWiki
- * will try to automatically create one. This feature can be disabled by set-
- * ting this variable false.
- */
-$wgUseAutomaticEditSummaries = true;
-
-/**
- * Limit password attempts to X attempts per Y seconds per IP per account.
- * Requires memcached.
- */
-$wgPasswordAttemptThrottle = array( 'count' => 5, 'seconds' => 300 );
-
-/**
- * Display user edit counts in various prominent places.
- */
-$wgEdititis = false;
-
-/**
- * Enable the UniversalEditButton for browsers that support it
- * (currently only Firefox with an extension)
- * See http://universaleditbutton.org for more background information
- */
-$wgUniversalEditButton = true;
-
-/**
- * Should we allow a broader set of characters in id attributes, per HTML5? If
- * not, use only HTML 4-compatible IDs. This option is for testing -- when the
- * functionality is ready, it will be on by default with no option.
- *
- * Currently this appears to work fine in Chrome 4 and 5, Firefox 3.5 and 3.6, IE6
- * and 8, and Opera 10.50, but it fails in Opera 10.10: Unicode IDs don't seem
- * to work as anchors. So not quite ready for general use yet.
- */
-$wgExperimentalHtmlIds = false;
-
-/**
- * Search form behavior
- * true = use Go & Search buttons
- * false = use Go button & Advanced search link
- */
-$wgUseTwoButtonsSearchForm = true;
-
-/**
- * Search form behavior for Vector skin only
- * true = use an icon search button
- * false = use Go & Search buttons
- */
-$wgVectorUseSimpleSearch = false;
-
-/**
- * Watch and unwatch as an icon rather than a link for Vector skin only
- * true = use an icon watch/unwatch button
- * false = use watch/unwatch text link
- */
-$wgVectorUseIconWatch = false;
-
-/**
- * Add extra stylesheets for Vector - This is only being used so that we can play around with different options while
- * keeping our CSS code in the SVN and not having to change the main Vector styles. This will probably go away later on.
- * null = add no extra styles
- * array = list of style paths relative to skins/vector/
- */
-$wgVectorExtraStyles = null;
-
-/**
- * Preprocessor caching threshold
- */
-$wgPreprocessorCacheThreshold = 1000;
-
-/**
- * Allow filtering by change tag in recentchanges, history, etc
- * Has no effect if no tags are defined in valid_tag.
- */
-$wgUseTagFilter = true;
-
-/**
* Allow redirection to another page when a user logs in.
* To enable, set to a string like 'Main Page'
*/
$wgRedirectOnLogin = null;
/**
- * Characters to prevent during new account creations.
- * This is used in a regular expression character class during
- * registration (regex metacharacters like / are escaped).
- */
-$wgInvalidUsernameCharacters = '@';
-
-/**
- * Character used as a delimiter when testing for interwiki userrights
- * (In Special:UserRights, it is possible to modify users on different
- * databases if the delimiter is used, e.g. Someuser@enwiki).
- *
- * It is recommended that you have this delimiter in
- * $wgInvalidUsernameCharacters above, or you will not be able to
- * modify the user rights of those users via Special:UserRights
- */
-$wgUserrightsInterwikiDelimiter = '@';
-
-/**
* Configuration for processing pool control, for use in high-traffic wikis.
* An implementation is provided in the PoolCounter extension.
*
@@ -4248,112 +5280,30 @@ $wgUserrightsInterwikiDelimiter = '@';
* The remaining elements are passed through to the class as constructor
* parameters. Example:
*
- * $wgPoolCounterConf = array( 'Article::view' => array(
+ * $wgPoolCounterConf = array( 'ArticleView' => array(
* 'class' => 'PoolCounter_Client',
+ * 'timeout' => 15, // wait timeout in seconds
+ * 'workers' => 5, // maximum number of active threads in each pool
+ * 'maxqueue' => 50, // maximum number of total threads in each pool
* ... any extension-specific options...
* );
*/
$wgPoolCounterConf = null;
/**
- * Use some particular type of external authentication. The specific
- * authentication module you use will normally require some extra settings to
- * be specified.
- *
- * null indicates no external authentication is to be used. Otherwise,
- * $wgExternalAuthType must be the name of a non-abstract class that extends
- * ExternalUser.
- *
- * Core authentication modules can be found in includes/extauth/.
- */
-$wgExternalAuthType = null;
-
-/**
- * Configuration for the external authentication. This may include arbitrary
- * keys that depend on the authentication mechanism. For instance,
- * authentication against another web app might require that the database login
- * info be provided. Check the file where your auth mechanism is defined for
- * info on what to put here.
- */
-$wgExternalAuthConfig = array();
-
-/**
- * When should we automatically create local accounts when external accounts
- * already exist, if using ExternalAuth? Can have three values: 'never',
- * 'login', 'view'. 'view' requires the external database to support cookies,
- * and implies 'login'.
- *
- * TODO: Implement 'view' (currently behaves like 'login').
- */
-$wgAutocreatePolicy = 'login';
-
-/**
- * Policies for how each preference is allowed to be changed, in the presence
- * of external authentication. The keys are preference keys, e.g., 'password'
- * or 'emailaddress' (see Preferences.php et al.). The value can be one of the
- * following:
- *
- * - local: Allow changes to this pref through the wiki interface but only
- * apply them locally (default).
- * - semiglobal: Allow changes through the wiki interface and try to apply them
- * to the foreign database, but continue on anyway if that fails.
- * - global: Allow changes through the wiki interface, but only let them go
- * through if they successfully update the foreign database.
- * - message: Allow no local changes for linked accounts; replace the change
- * form with a message provided by the auth plugin, telling the user how to
- * change the setting externally (maybe providing a link, etc.). If the auth
- * plugin provides no message for this preference, hide it entirely.
- *
- * Accounts that are not linked to an external account are never affected by
- * this setting. You may want to look at $wgHiddenPrefs instead.
- * $wgHiddenPrefs supersedes this option.
- *
- * TODO: Implement message, global.
- */
-$wgAllowPrefChange = array();
-
-
-/**
- * Settings for incoming cross-site AJAX requests:
- * Newer browsers support cross-site AJAX when the target resource allows requests
- * from the origin domain by the Access-Control-Allow-Origin header.
- * This is currently only used by the API (requests to api.php)
- * $wgCrossSiteAJAXdomains can be set using a wildcard syntax:
- *
- * '*' matches any number of characters
- * '?' matches any 1 character
- *
- * Example:
- $wgCrossSiteAJAXdomains = array(
- 'www.mediawiki.org',
- '*.wikipedia.org',
- '*.wikimedia.org',
- '*.wiktionary.org',
- );
- *
- */
-$wgCrossSiteAJAXdomains = array();
-
-/**
- * Domains that should not be allowed to make AJAX requests,
- * even if they match one of the domains allowed by $wgCrossSiteAJAXdomains
- * Uses the same syntax as $wgCrossSiteAJAXdomains
- */
-
-$wgCrossSiteAJAXdomainExceptions = array();
-
-/**
- * The minimum amount of memory that MediaWiki "needs"; MediaWiki will try to raise PHP's memory limit if it's below this amount.
- */
-$wgMemoryLimit = "50M";
-
-/**
* To disable file delete/restore temporarily
*/
$wgUploadMaintenance = false;
/**
- * Use old names for change_tags indices.
+ * Allows running of selenium tests via maintenance/tests/RunSeleniumTests.php
*/
-$wgOldChangeTagsIndex = false;
+$wgEnableSelenium = false;
+$wgSeleniumTestConfigs = array();
+$wgSeleniumConfigFile = null;
+/**
+ * For really cool vim folding this needs to be at the end:
+ * vim: foldmarker=@{,@} foldmethod=marker
+ * @}
+ */