MediaWiki  REL1_19
DefaultSettings.php File Reference

NEVER EDIT THIS FILE. More...

Go to the source code of this file.

Variables

 $wgCanonicalServer = false
 Canonical URL of the server, to use in IRC feeds and notification e-mails.
 $wgServer = WebRequest::detectServer()
 URL of the server.
 $wgSitename = 'MediaWiki'
 Name of the site.
 $wgVersion = '1.19.20'
 MediaWiki version number.
Script path settings
 $wgScriptPath = '/wiki'
 The path we should point to.
 $wgUsePathInfo
 Whether to support URLs like index.php/Page_title These often break when PHP is set up in CGI mode.
 $wgScriptExtension = '.php'
 The extension to append to script names by default.
 $wgScript = false
 The URL path to index.php.
 $wgRedirectScript = false
 The URL path to redirect.php.
 $wgLoadScript = false
 The URL path to load.php.
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.

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.

 $wgStylePath = false
 The URL path of the skins directory.
 $wgStyleSheetPath = &$wgStylePath
 The URL path of the skins directory.
 $wgLocalStylePath = false
 The URL path of the skins directory.
 $wgExtensionAssetsPath = false
 The URL path of the extensions directory.
 $wgStyleDirectory = false
 Filesystem stylesheets directory.
 $wgArticlePath = false
 The URL path for primary article page views.
 $wgUploadPath = false
 The URL path for the images directory.
 $wgUploadStashMaxAge = 6 * 3600
 The maximum age of temporary (incomplete) uploaded files.
 $wgUploadDirectory = false
 The filesystem path of the images directory.
 $wgLogo = false
 The URL path of the wiki logo.
 $wgFavicon = '/favicon.ico'
 The URL path of the shortcut icon.
 $wgAppleTouchIcon = false
 The URL path of the icon for iPhone and iPod Touch web app bookmarks.
 $wgTmpDirectory = false
 The local filesystem path to a temporary directory.
 $wgUploadBaseUrl = ''
 If set, this URL is added to the start of $wgUploadPath to form a complete upload URL.
 $wgUploadStashScalerBaseUrl = false
 To enable remote on-demand scaling, set this to the thumbnail base URL.
 $wgActionPaths = array()
 To set 'pretty' URL paths for actions other than plain page views, add to this array.
Files and file uploads
 $wgEnableUploads = false
 Uploads have to be specially set up to be secure.
 $wgAllowImageMoving = true
 Allows to move images and other media files.
 $wgIllegalFileChars = ":"
 These are additional characters that should be replaced with '-' in file names.
 $wgFileStore = array()
 $wgDeletedDirectory = false
 What directory to place deleted uploads in.
 $wgImgAuthDetails = false
 Set this to true if you use img_auth and want the user to see details on why access failed.
 $wgImgAuthPublicTest = true
 If this is enabled, img_auth.php will not allow image access unless the wiki is private.
 $wgLocalFileRepo = false
 File repository structures.
 $wgForeignFileRepos = array()
 $wgUseInstantCommons = false
 Use Commons as a remote file repository.
 $wgFileBackends = array()
 File backend structure configuration.
 $wgLockManagers = array()
 Array of configuration arrays for each lock manager.
 $wgShowEXIF = function_exists( 'exif_read_data' )
 Show EXIF data, on by default if available.
 $wgUpdateCompatibleMetadata = false
 If to automatically update the img_metadata field if the metadata field is outdated but compatible with the current version.
 $wgUseSharedUploads = false
 If you operate multiple wikis, you can define a shared upload path here.
 $wgSharedUploadPath = "http://commons.wikimedia.org/shared/images"
 Full path on the web server where shared uploads can be found.
 $wgFetchCommonsDescriptions = false
 Fetch commons image description pages and display them on the local wiki?
 $wgSharedUploadDirectory = "/var/www/wiki3/images"
 Path on the file system where shared uploads can be found.
 $wgSharedUploadDBname = false
 DB name with metadata about shared directory.
 $wgSharedUploadDBprefix = ''
 Optional table prefix used in database.
 $wgCacheSharedUploads = true
 Cache shared metadata in memcached.
 $wgAllowCopyUploads = false
 Allow for upload to be copied from an URL.
 $wgAllowAsyncCopyUploads = false
 Allow asynchronous copy uploads.
 $wgMaxUploadSize = 1024*1024*100
 Max size for uploads, in bytes.
 $wgUploadNavigationUrl = false
 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.
 $wgUploadMissingFileUrl = false
 Point the upload link for missing files to an external URL, as with $wgUploadNavigationUrl.
 $wgThumbnailScriptPath = 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.
 $wgSharedThumbnailScriptPath = false
 Uploads have to be specially set up to be secure.
 $wgHashedUploadDirectory = true
 Set this to false if you do not want MediaWiki to divide your images directory into many subdirectories, for improved performance.
 $wgHashedSharedUploadDirectory = 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.
 $wgRepositoryBaseUrl = "http://commons.wikimedia.org/wiki/File:"
 Base URL for a repository wiki.
 $wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' )
 This is the list of preferred extensions for uploading files.
 $wgFileBlacklist
 Files with these extensions will never be allowed as uploads.
 $wgMimeTypeBlacklist
 Files with these mime types will never be allowed as uploads if $wgVerifyMimeType is enabled.
 $wgAllowJavaUploads = false
 Allow Java archive uploads.
 $wgCheckFileExtensions = true
 This is a flag to determine whether or not to check file extensions on upload.
 $wgStrictFileExtensions = true
 If this is turned off, users may override the warning for files not covered by $wgFileExtensions.
 $wgDisableUploadScriptChecks = false
 Setting this to true will disable the upload system's checks for HTML/JavaScript.
 $wgUploadSizeWarning = false
 Warn if uploaded files are larger than this (in bytes), or false to disable.
 $wgTrustedMediaFormats
 list of trusted media-types and mime types.
 $wgMediaHandlers
 Plugins for media file type handling.
 $wgUseImageMagick = false
 Resizing can be done using PHP's internal image libraries or using ImageMagick or another third-party converter, e.g.
 $wgImageMagickConvertCommand = '/usr/bin/convert'
 The convert command shipped with ImageMagick.
 $wgImageMagickIdentifyCommand = '/usr/bin/identify'
 The identify command shipped with ImageMagick.
 $wgSharpenParameter = '0x0.4'
 Sharpening parameter to ImageMagick.
 $wgSharpenReductionThreshold = 0.85
 Reduction in linear dimensions below which sharpening will be enabled.
 $wgImageMagickTempDir = false
 Temporary directory used for ImageMagick.
 $wgCustomConvertCommand = false
 Use another resizing converter, e.g.
 $wgExiv2Command = '/usr/bin/exiv2'
 Some tests and extensions use exiv2 to manipulate the EXIF metadata in some image formats.
 $wgSVGConverters
 Scalable Vector Graphics (SVG) may be uploaded as images.
 $wgSVGConverter = 'ImageMagick'
 Pick a converter defined in $wgSVGConverters.
 $wgSVGConverterPath = ''
 If not in the executable PATH, specify the SVG converter path.
 $wgSVGMaxSize = 2048
 Don't scale a SVG larger than this.
 $wgSVGMetadataCutoff = 262144
 Don't read SVG metadata beyond this point.
 $wgAllowTitlesInSVG = false
 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.
 $wgMaxImageArea = 1.25e7
 The maximum number of pixels a source image can have if it is to be scaled down by a scaler that requires the full source image to be decompressed and stored in decompressed form, before the thumbnail is generated.
 $wgMaxAnimatedGifArea = 1.25e7
 Force thumbnailing of animated GIFs above this size to a single frame instead of an animated thumbnail.
 $wgTiffThumbnailType = false
 Browsers don't support TIFF inline generally...
 $wgThumbnailEpoch = '20030516000000'
 If rendered thumbnail files are older than this timestamp, they will be rerendered on demand as if the file didn't already exist.
 $wgIgnoreImageErrors = false
 If set, inline scaled images will still produce.
 $wgGenerateThumbnailOnParse = true
 Allow thumbnail rendering on page view.
 $wgShowArchiveThumbnails = true
 Show thumbnails for old images on the image description page.
 $wgUseImageResize = true
 Obsolete, always true, kept for compatibility with extensions.
 $wgEnableAutoRotation = null
 If set to true, images that contain certain the exif orientation tag will be rotated accordingly.
 $wgAntivirus = null
 Internal name of virus scanner.
 $wgAntivirusSetup
 Configuration for different virus scanners.
 $wgAntivirusRequired = true
 Determines if a failed virus scan (AV_SCAN_FAILED) will cause the file to be rejected.
 $wgVerifyMimeType = true
 Determines if the mime type of uploaded files should be checked.
 $wgMimeTypeFile = "includes/mime.types"
 Sets the mime type definition file to use by MimeMagic.php.
 $wgMimeInfoFile = "includes/mime.info"
 Sets the mime type info file to use by MimeMagic.php.
 $wgLoadFileinfoExtension = false
 Switch for loading the FileInfo extension by PECL at runtime.
 $wgMimeDetectorCommand = null
 Sets an external mime detector program.
 $wgTrivialMimeDetection = false
 Switch for trivial mime detection.
 $wgXMLMimeTypes
 Additional XML types we can allow via mime-detection.
 $wgImageLimits
 Limit images on image description pages to a user-selectable limit.
 $wgThumbLimits
 Adjust thumbnails on image pages according to a user setting.
 $wgGalleryOptions
 Default parameters for the <gallery> tag.
 $wgThumbUpright = 0.75
 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.
 $wgDirectoryMode = 0777
 Default value for chmoding of new directories.
 $wgDjvuDump = null
 DJVU settings Path of the djvudump executable Enable this and $wgDjvuRenderer to enable djvu rendering.
 $wgDjvuRenderer = null
 Path of the ddjvu DJVU renderer Enable this and $wgDjvuDump to enable djvu rendering.
 $wgDjvuTxt = null
 Path of the djvutxt DJVU text extraction utility Enable this and $wgDjvuDump to enable text layer extraction from djvu files.
 $wgDjvuToXML = null
 Path of the djvutoxml executable This works like djvudump except much, much slower as of version 3.5.
 $wgDjvuPostProcessor = 'pnmtojpeg'
 Shell command for the DJVU post processor Default: pnmtopng, since ddjvu generates ppm output Set this to false to output the ppm file directly.
 $wgDjvuOutputExtension = 'jpg'
 File extension for the DJVU post processor output.
Email settings
 $serverName = substr( $wgServer, strrpos( $wgServer, '/' ) + 1 )
 Site admin email address.
 $wgEmergencyContact = 'wikiadmin@' . $serverName
 Site admin email address.
 $wgPasswordSender = 'apache@' . $serverName
 Password reminder email address.
 $wgPasswordSenderName = 'MediaWiki Mail'
 Password reminder name.
 $wgNoReplyAddress = '[email protected]'
 Dummy address which should be accepted during mail send action.
 $wgEnableEmail = true
 Set to true to enable the e-mail basic features: Password reminders, etc.
 $wgEnableUserEmail = true
 Set to true to enable user-to-user e-mail.
 $wgUserEmailUseReplyTo = false
 Set to true to put the sending user's email in a Reply-To header instead of From.
 $wgPasswordReminderResendTime = 24
 Minimum time, in hours, which must elapse between password reminder emails for a given account.
 $wgNewPasswordExpiry = 3600 * 24 * 7
 The time, in seconds, when an emailed temporary password expires.
 $wgUserEmailConfirmationTokenExpiry = 7 * 24 * 60 * 60
 The time, in seconds, when an email confirmation email expires.
 $wgSMTP = false
 SMTP Mode For using a direct (authenticated) SMTP server connection.
 $wgAdditionalMailParams = null
 Additional email parameters, will be passed as the last argument to mail() call.
 $wgEnotifFromEditor = false
 True: from page editor if s/he opted-in.
 $wgEmailAuthentication = true
 Require email authentication before sending mail to an email addres.
 $wgEnotifWatchlist = false
 Allow users to enable email notification ("enotif") on watchlist changes.
 $wgEnotifUserTalk = false
 Allow users to enable email notification ("enotif") when someone edits their user talk page.
 $wgEnotifRevealEditorAddress = false
 Set the Reply-to address in notifications to the editor's address, if user allowed this in the preferences.
 $wgEnotifMinorEdits = true
 Send notification mails on minor edits to watchlist pages.
 $wgEnotifImpersonal = false
 Send a generic mail instead of a personalised mail for each user.
 $wgEnotifMaxRecips = 500
 Maximum number of users to mail at once when using impersonal mail.
 $wgEnotifUseJobQ = false
 Send mails via the job queue.
 $wgEnotifUseRealName = false
 Use real name instead of username in e-mail "from" field.
 $wgUsersNotifiedOnAllChanges = array()
 Array of usernames who will be sent a notification email for every change which occurs on a wiki.
Database settings
 $wgDBserver = 'localhost'
 Database host name or IP address.
 $wgDBport = 5432
 Database port number (for PostgreSQL)
 $wgDBname = 'my_wiki'
 Name of the database.
 $wgDBuser = 'wikiuser'
 Database username.
 $wgDBpassword = ''
 Database user's password.
 $wgDBtype = 'mysql'
 Database type.
 $wgDBadminuser = null
 Separate username for maintenance tasks.
 $wgDBadminpassword = null
 Separate password for maintenance tasks.
 $wgSearchType = null
 Search type.
 $wgDBprefix = ''
 Table name prefix.
 $wgDBTableOptions = 'ENGINE=InnoDB'
 MySQL table options to use during installation or update.
 $wgSQLMode = ''
 SQL Mode - default is turning off all modes, including strict, if set.
 $wgDBmwschema = 'mediawiki'
 Mediawiki schema.
 $wgSQLiteDataDir = ''
 To override default SQLite data directory ($docroot/../data)
 $wgAllDBsAreLocalhost = false
 Make all database connections secretly go to localhost.
 $wgSharedDB = null
 Shared database for multiple wikis.
 $wgSharedPrefix = false
 $wgSharedTables = array( 'user', 'user_properties' )
 $wgDBservers = false
 Database load balancer This is a two-dimensional array, an array of server info structures Fields are:
 $wgLBFactoryConf = array( 'class' => 'LBFactory_Simple' )
 Load balancer factory configuration To set up a multi-master wiki farm, set the class here to something that can return a LoadBalancer with an appropriate master on a call to getMainLB().
 $wgMasterWaitTimeout = 10
 How long to wait for a slave to catch up to the master.
 $wgDBerrorLog = false
 File to log database errors to.
 $wgDBClusterTimeout = 10
 When to give an error message.
 $wgDBAvgStatusPoll = 2000
 Scale load balancer polling time so that under overload conditions, the database server receives a SHOW STATUS query at an average interval of this many microseconds.
 $wgDBtransactions = false
 Set to true if using InnoDB tables.
 $wgDBmysql5 = false
 Set to true to engage MySQL 4.1/5.0 charset-related features; for now will just cause sending of 'SET NAMES=utf8' on connect.
 $wgLocalDatabases = array()
 Other wikis on this site, can be administered from a single developer account.
 $wgSlaveLagWarning = 10
 If lag is higher than $wgSlaveLagWarning, show a warning in some special pages (like watchlist).
 $wgSlaveLagCritical = 30
 $wgOldChangeTagsIndex = false
 Use old names for change_tags indices.
Text storage
 $wgCompressRevisions = false
 We can also compress text stored in the 'text' table.
 $wgExternalStores = false
 External stores allow including content from non database sources following URL links.
 $wgExternalServers = array()
 An array of external mysql servers, e.g.
 $wgDefaultExternalStore = false
 We can also compress text stored in the 'text' table.
 $wgRevisionCacheExpiry = 0
 Revision text may be cached in $wgMemc to reduce load on external storage servers and object extraction overhead for frequently-loaded revisions.
Performance hacks and limits
 $wgMiserMode = false
 Disable database-intensive features.
 $wgDisableQueryPages = false
 Disable all query pages if miser mode is on, not just some.
 $wgQueryCacheLimit = 1000
 Number of rows to cache in 'querycache' table when miser mode is on.
 $wgWantedPagesThreshold = 1
 Number of links to a page required before it is deemed "wanted".
 $wgAllowSlowParserFunctions = false
 Enable slow parser functions.
 $wgAllowSchemaUpdates = true
 Allow schema updates.
 $wgUseDumbLinkUpdate = false
 Do DELETE/INSERT for link updates instead of incremental.
 $wgAntiLockFlags = 0
 Anti-lock flags - bitfield.
 $wgMaxArticleSize = 2048
 Maximum article size in kilobytes.
 $wgMemoryLimit = "50M"
 The minimum amount of memory that MediaWiki "needs"; MediaWiki will try to raise PHP's memory limit if it's below this amount.
Cache settings
 $wgCacheDirectory = false
 Directory for caching data in the local filesystem.
 $wgMainCacheType = CACHE_NONE
 Main cache type.
 $wgMessageCacheType = CACHE_ANYTHING
 The cache type for storing the contents of the MediaWiki namespace.
 $wgParserCacheType = CACHE_ANYTHING
 The cache type for storing article HTML.
 $wgObjectCaches
 Advanced object cache configuration.
 $wgParserCacheExpireTime = 86400
 The expiry time for the parser cache, in seconds.
 $wgDBAhandler = 'db3'
 Select which DBA handler <http://www.php.net/manual/en/dba.requirements.php> to use as CACHE_DBA backend.
 $wgSessionsInMemcached = false
 Store sessions in MemCached.
 $wgSessionHandler = null
 This is used for setting php's session.save_handler.
 $wgMemCachedDebug = false
 If enabled, will send MemCached debugging information to $wgDebugLogFile.
 $wgMemCachedServers = array( '127.0.0.1:11000' )
 The list of MemCached servers and port numbers.
 $wgMemCachedPersistent = false
 Use persistent connections to MemCached, which are shared across multiple requests.
 $wgMemCachedTimeout = 100000
 Read/write timeout for MemCached server communication, in microseconds.
 $wgUseLocalMessageCache = false
 Set this to true to make a local copy of the message cache, for use in addition to memcached.
 $wgLocalMessageCacheSerialized = true
 Defines format of local cache true - Serialized object false - PHP source file (Warning - security risk)
 $wgAdaptiveMessageCache = false
 Instead of caching everything, keep track which messages are requested and load only most used messages.
 $wgLocalisationCacheConf
 Localisation cache configuration.
 $wgCachePages = true
 Allow client-side caching of pages.
 $wgCacheEpoch = '20030516000000'
 Set this to current time to invalidate all prior cached pages.
 $wgStyleVersion = '303'
 Bump this number when changing the global style sheets and JavaScript.
 $wgUseFileCache = false
 This will cache static pages for non-logged-in users to reduce database traffic on public sites.
 $wgFileCacheDirectory = false
 Directory where the cached page will be saved.
 $wgFileCacheDepth = 2
 Depth of the subdirectory hierarchy to be created under $wgFileCacheDirectory.
 $wgEnableParserCache = true
 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.
 $wgRenderHashAppend = ''
 Append a configured value to the parser cache and the sitenotice key so that they can be kept separate for some class of activity.
 $wgEnableSidebarCache = false
 If on, the sidebar navigation links are cached for users with the current language set.
 $wgSidebarCacheExpiry = 86400
 Expiry time for the sidebar cache, in seconds.
 $wgUseGzip = false
 When using the file cache, we can store the cached HTML gzipped to save disk space.
 $wgUseETag = false
 Whether MediaWiki should send an ETag header.
 $wgClockSkewFudge = 5
 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.
 $wgInvalidateCacheOnLocalSettingsChange = true
 Invalidate various caches when LocalSettings.php changes.
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.

 $wgUseSquid = false
 Enable/disable Squid.
 $wgUseESI = false
 If you run Squid3 with ESI support, enable this (default:false):
 $wgUseXVO = false
 Send X-Vary-Options header for better caching (requires patched Squid)
 $wgVaryOnXFP = false
 Add X-Forwarded-Proto to the Vary and X-Vary-Options headers for API requests and RSS/Atom feeds.
 $wgInternalServer = false
 Internal server name as known to Squid, if different.
 $wgSquidMaxage = 18000
 Cache timeout for the squid, will be sent as s-maxage (without ESI) or Surrogate-Control (with ESI).
 $wgForcedRawSMaxage = 300
 Default maximum age for raw CSS/JS accesses.
 $wgSquidServers = array()
 List of proxy servers to purge on changes; default port is 80.
 $wgSquidServersNoPurge = array()
 As above, except these servers aren't purged on page changes; use to set a list of trusted proxies, etc.
 $wgMaxSquidPurgeTitles = 400
 Maximum number of titles to purge in any one client operation.
 $wgHTCPMulticastAddress = false
 HTCP multicast address.
 $wgHTCPPort = 4827
 HTCP multicast port.
 $wgHTCPMulticastTTL = 1
 HTCP multicast TTL.
 $wgUsePrivateIPs = false
 Should forwarded Private IPs be accepted?
Language, regional and character encoding settings
 $wgLanguageCode = 'en'
 Site language code, should be one of .
 $wgGrammarForms = array()
 Some languages need different word forms, usually for different cases.
 $wgInterwikiMagic = true
 Treat language links as magic connectors, not inline links.
 $wgHideInterlanguageLinks = false
 Hide interlanguage links from the sidebar.
 $wgExtraLanguageNames = array()
 List of language names or overrides for default names in Names.php.
 $wgDummyLanguageCodes
 List of language codes that don't correspond to an actual language.
 $wgEditEncoding = ''
 Character set for use in the article edit box.
 $wgFixArabicUnicode = true
 Set this to true to replace Arabic presentation forms with their standard forms in the U+0600-U+06FF block.
 $wgFixMalayalamUnicode = true
 Set this to true to replace ZWJ-based chillu sequences in Malayalam text with their Unicode 5.1 equivalents.
 $wgAllUnicodeFixes = false
 Set this to always convert certain Unicode sequences to modern ones regardless of the content language.
 $wgLegacyEncoding = false
 Set this to eg 'ISO-8859-1' to perform character set conversion when loading old revisions not marked with "utf-8" flag.
 $wgBrowserBlackList
 Browser Blacklist for unicode non compliant browsers.
 $wgLegacySchemaConversion = false
 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'.
 $wgUseDynamicDates = false
 Enable to allow rewriting dates in page text.
 $wgAmericanDates = false
 Enable dates like 'May 12' instead of '12 May', this only takes effect if the interface is set to English.
 $wgTranslateNumerals = true
 For Hindi and Arabic use local numerals instead of Western style (0-9) numerals in interface.
 $wgUseDatabaseMessages = true
 Translation using MediaWiki: namespace.
 $wgMsgCacheExpiry = 86400
 Expiry time for the message cache key.
 $wgMaxMsgCacheEntrySize = 10000
 Maximum entry size in the message cache, in bytes.
 $wgDisableLangConversion = false
 Whether to enable language variant conversion.
 $wgDisableTitleConversion = false
 Whether to enable language variant conversion for links.
 $wgCanonicalLanguageLinks = true
 Whether to enable cononical language links in meta data.
 $wgDefaultLanguageVariant = false
 Default variant code, if false, the default will be the language code.
 $wgDisabledVariants = array()
 Disabled variants array of language variant conversion.
 $wgVariantArticlePath = false
 Like $wgArticlePath, but on multi-variant wikis, this provides a path format that describes which parts of the URL contain the language variant.
 $wgLoginLanguageSelector = false
 Show a bar of language selection links in the user login and user registration forms; edit the "loginlanguagelinks" message to customise these.
 $wgForceUIMsgAsContentMsg = array()
 When translating messages with wfMsg(), it is not always clear what should be considered UI messages and what should be content messages.
 $wgLocaltimezone = null
 Fake out the timezone that the server thinks it's in.
 $wgLocalTZoffset = null
 Set an offset from UTC in minutes to use for the default timezone setting for anonymous users and new user accounts.
 $wgBug34832TransitionalRollback = true
 If set to true, this will roll back a few bug fixes introduced in 1.19, emulating the 1.18 behaviour, to avoid introducing bug 34832.
Output format and skin settings
 $wgMimeType = 'text/html'
 The default Content-Type header.
 $wgJsMimeType = 'text/javascript'
 The content type used in script tags.
 $wgDocType = '-//W3C//DTD XHTML 1.0 Transitional//EN'
 The HTML document type.
 $wgDTD = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'
 The URL of the document type declaration.
 $wgXhtmlDefaultNamespace = 'http://www.w3.org/1999/xhtml'
 The default xmlns attribute.
 $wgHtml5 = true
 Should we output an HTML5 doctype? If false, use XHTML 1.0 Transitional instead, and disable HTML5 features.
 $wgHtml5Version = null
 Defines the value of the version attribute in the <html> tag, if any.
 $wgAllowRdfaAttributes = false
 Enabled RDFa attributes for use in wikitext.
 $wgAllowMicrodataAttributes = false
 Enabled HTML5 microdata attributes for use in wikitext, if $wgHtml5 is also true.
 $wgCleanupPresentationalAttributes = true
 Cleanup as much presentational html like valign -> css vertical-align as we can.
 $wgWellFormedXml = true
 Should we try to make our HTML output well-formed XML? If set to false, output will be a few bytes shorter, and the HTML will arguably be more readable.
 $wgXhtmlNamespaces = array()
 Permit other namespaces in addition to the w3.org default.
 $wgShowIPinHeader = true
 Show IP address, for non-logged in users.
 $wgSiteNotice = ''
 Site notice shown at the top of each page.
 $wgExtraSubtitle = ''
 A subtitle to add to the tagline, for skins that have it/.
 $wgSiteSupportPage = ''
 If this is set, a "donate" link will appear in the sidebar.
 $wgValidateAllHtml = false
 Validate the overall output using tidy and refuse to display the page if it's not valid.
 $wgDefaultSkin = 'vector'
 Default skin, for new users and anonymous visitors.
 $wgSkipSkin = ''
 Specify the name of a skin that should not be presented in the list of available skins.
 $wgSkipSkins = array()
 Array for more like $wgSkipSkin.
 $wgHandheldStyle = false
 Optionally, we can specify a stylesheet to use for media="handheld".
 $wgHandheldForIPhone = 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.
 $wgAllowUserJs = false
 Allow user Javascript page? This enables a lot of neat customizations, but may increase security risk to users and server load.
 $wgAllowUserCss = false
 Allow user Cascading Style Sheets (CSS)? This enables a lot of neat customizations, but may increase security risk to users and server load.
 $wgAllowUserCssPrefs = true
 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.
 $wgUseSiteJs = true
 Use the site's Javascript page?
 $wgUseSiteCss = true
 Use the site's Cascading Style Sheets (CSS)?
 $wgBreakFrames = false
 Break out of framesets.
 $wgEditPageFrameOptions = 'DENY'
 The X-Frame-Options header to send on pages sensitive to clickjacking attacks, such as edit pages.
 $wgApiFrameOptions = 'DENY'
 Disallow framing of API pages directly, by setting the X-Frame-Options header.
 $wgDisableOutputCompression = false
 Disable output compression (enabled by default if zlib is available)
 $wgExperimentalHtmlIds = false
 Should we allow a broader set of characters in id attributes, per HTML5? If not, use only HTML 4-compatible IDs.
 $wgFooterIcons
 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.
 $wgUseCombinedLoginLink = true
 Login / create account link behavior when it's possible for anonymous users to create an account true = use a combined login / create account link false = split login and create account into two separate links.
 $wgVectorUseSimpleSearch = false
 Search form behavior for Vector skin only true = use an icon search button false = use Go & Search buttons.
 $wgVectorUseIconWatch = 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.
 $wgEdititis = false
 Display user edit counts in various prominent places.
 $wgBetterDirectionality = true
 Better directionality support (bug 6100 and related).
 $wgSend404Code = true
 Some web hosts attempt to rewrite all responses with a 404 (not found) status code, mangling or hiding MediaWiki's output.
Resource loader settings
 $wgResourceModules = array()
 Client-side resource modules.
 $wgResourceLoaderSources = array()
 Extensions should register foreign module sources here.
 $wgResourceBasePath = null
 Default 'remoteBasePath' value for resource loader modules.
 $wgResourceLoaderMaxage
 Maximum time in seconds to cache resources served by the resource loader.
 $wgResourceLoaderDebug = false
 The default debug mode (on/off) for of ResourceLoader requests.
 $wgResourceLoaderUseESI = false
 Enable embedding of certain resources using Edge Side Includes.
 $wgResourceLoaderMinifierStatementsOnOwnLine = false
 Put each statement on its own line when minifying JavaScript.
 $wgResourceLoaderMinifierMaxLineLength = 1000
 Maximum line length when minifying JavaScript.
 $wgIncludeLegacyJavaScript = true
 Whether to include the mediawiki.legacy JS library (old wikibits.js), and its dependencies.
 $wgPreloadJavaScriptMwUtil = false
 Whether to preload the mediawiki.util module as blocking module in the top queue.
 $wgLegacyJavaScriptGlobals = true
 Whether or not to assing configuration variables to the global window object.
 $wgResourceLoaderMaxQueryLength = -1
 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.
 $wgResourceLoaderValidateJS = true
 If set to true, JavaScript modules loaded from wiki pages will be parsed prior to minification to validate it.
 $wgResourceLoaderValidateStaticJS = false
 If set to true, statically-sourced (file-backed) JavaScript resources will be parsed for validity before being bundled up into ResourceLoader modules.
 $wgResourceLoaderExperimentalAsyncLoading = false
 If set to true, asynchronous loading of bottom-queue scripts in the <head> will be enabled.
Page title and interwiki link settings
 $wgMetaNamespace = false
 Name of the project namespace.
 $wgMetaNamespaceTalk = false
 Name of the project talk namespace.
 $wgExtraNamespaces = array()
 Additional namespaces.
 $wgExtraGenderNamespaces = array()
 Same as above, but for namespaces with gender distinction.
 $wgNamespaceAliases = array()
 Namespace aliases These are alternate names for the primary localised namespace names, which are defined by $wgExtraNamespaces and the language file.
 $wgLegalTitleChars = " %!\"$&'()*,\\-.\\/0-9:;=?@A-Z\\\\^_`a-z~\\x80-\\xFF+"
 Allowed title characters -- regex character class Don't change this unless you know what you're doing.
 $wgLocalInterwiki = false
 The interwiki prefix of the current wiki, or false if it doesn't have one.
 $wgInterwikiExpiry = 10800
 Expiry time for cache of interwiki table.
 $wgInterwikiCache = false
 Interwiki caching settings.
 $wgInterwikiScopes = 3
 Name of the project namespace.
 $wgInterwikiFallbackSite = 'wiki'
 Name of the project namespace.
 $wgRedirectSources = false
 If local interwikis are set up which allow redirects, set this regexp to restrict URLs which will be displayed as 'redirected from' links.
 $wgCapitalLinks = true
 Set this to false to avoid forcing the first letter of links to capitals.
 $wgCapitalLinkOverrides = array()
 $wgNamespacesWithSubpages
 Which namespaces should support subpages? See Language.php for a list of namespaces.
 $wgContentNamespaces = array( NS_MAIN )
 Array of namespaces which can be deemed to contain valid "content", as far as the site statistics are concerned.
 $wgMaxRedirects = 1
 Max number of redirects to follow when resolving redirects.
 $wgInvalidRedirectTargets = array( 'Filepath', 'Mypage', 'Mytalk' )
 Array of invalid page redirect targets.
Parser settings

These settings configure the transformation from wikitext to HTML.

 $wgParserConf
 Parser configuration.
 $wgMaxTocLevel = 999
 Maximum indent level of toc.
 $wgMaxPPNodeCount = 1000000
 A complexity limit on template expansion.
 $wgMaxTemplateDepth = 40
 Maximum recursion depth for templates within templates.
 $wgMaxPPExpandDepth = 40
 $wgUrlProtocols
 The external URL protocols.
 $wgCleanSignatures = true
 If true, removes (substitutes) templates in "~~~~" signatures.
 $wgAllowExternalImages = false
 Whether to allow inline image pointing to other websites.
 $wgAllowExternalImagesFrom = ''
 If the above is false, you can specify an exception here.
 $wgEnableImageWhitelist = true
 If $wgAllowExternalImages is false, you can allow an on-wiki whitelist of regular expression fragments to match the image URL against.
 $wgAllowImageTag = false
 A different approach to the above: simply allow the.
 $wgUseTidy = false
 $wgUseTidy: use tidy to make sure HTML output is sane.
 $wgAlwaysUseTidy = false
 $wgTidyBin = 'tidy'
 $wgTidyConf = $IP.'/includes/tidy.conf'
 $wgTidyOpts = ''
 $wgTidyInternal = extension_loaded( 'tidy' )
 $wgDebugTidy = false
 Put tidy warnings in HTML comments Only works for internal tidy.
 $wgRawHtml = false
 Allow raw, unchecked HTML in <html>...</html> sections.
 $wgExternalLinkTarget = false
 Set a default target for external links, e.g.
 $wgNoFollowLinks = true
 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.
 $wgNoFollowNsExceptions = array()
 Namespaces in which $wgNoFollowLinks doesn't apply.
 $wgNoFollowDomainExceptions = 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.
 $wgAllowDisplayTitle = true
 Allow DISPLAYTITLE to change title display.
 $wgRestrictDisplayTitle = true
 For consistency, restrict DISPLAYTITLE to titles that normalize to the same canonical DB key.
 $wgExpensiveParserFunctionLimit = 100
 Maximum number of calls per parse to expensive parser functions such as PAGESINCATEGORY.
 $wgPreprocessorCacheThreshold = 1000
 Preprocessor caching threshold Setting it to 'false' will disable the preprocessor cache.
 $wgEnableScaryTranscluding = false
 Enable interwiki transcluding.
 $wgTranscludeCacheExpiry = 3600
 (see next option $wgGlobalDatabase).
Statistics
 $wgArticleCountMethod = null
 Method used to determine if a page in a content namespace should be counted as a valid article.
 $wgUseCommaCount = false
 Backward compatibility setting, will set $wgArticleCountMethod if it is null.
 $wgHitcounterUpdateFreq = 1
 wgHitcounterUpdateFreq sets how often page counters should be updated, higher values are easier on the database.
 $wgActiveUserDays = 30
 How many days user must be idle before he is considered inactive.
User accounts, authentication
 $wgPasswordSalt = true
 For compatibility with old installations set to false.
 $wgMinimalPasswordLength = 1
 Specifies the minimal length of a user password.
 $wgPasswordResetRoutes
 Whether to allow password resets ("enter some identifying data, and we'll send an email with a temporary password you can use to get back into the account") identified by various bits of data.
 $wgMaxSigChars = 255
 Maximum number of Unicode characters in signature.
 $wgMaxNameChars = 255
 Maximum number of bytes in username.
 $wgReservedUsernames
 Array of usernames which may not be registered or logged in from Maintenance scripts can still use these.
 $wgDefaultUserOptions
 Settings added to this array will override the default globals for the user preferences used by anonymous visitors and newly created accounts.
 $wgAllowRealName = true
 Whether or not to allow and use real name fields.
 $wgHiddenPrefs = array()
 An array of preferences to not show for the user.
 $wgInvalidUsernameCharacters = '@'
 Characters to prevent during new account creations.
 $wgUserrightsInterwikiDelimiter = '@'
 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.
 $wgExternalAuthType = null
 Use some particular type of external authentication.
 $wgExternalAuthConf = array()
 Configuration for the external authentication.
 $wgAutocreatePolicy = 'login'
 When should we automatically create local accounts when external accounts already exist, if using ExternalAuth? Can have three values: 'never', 'login', 'view'.
 $wgAllowPrefChange = array()
 Policies for how each preference is allowed to be changed, in the presence of external authentication.
 $wgSecureLogin = false
 This is to let user authenticate using https when they come from http.
User rights, access control and monitoring
 $wgAutoblockExpiry = 86400
 Number of seconds before autoblock entries expire.
 $wgBlockAllowsUTEdit = false
 Set this to true to allow blocked users to edit their own user talk page.
 $wgSysopEmailBans = true
 Allow sysops to ban users from accessing Emailuser.
 $wgBlockCIDRLimit
 Limits on the possible sizes of range blocks.
 $wgBlockDisablesLogin = false
 If true, blocked users will not be allowed to login.
 $wgWhitelistRead = false
 Pages anonymous user may see as an array, e.g.
 $wgEmailConfirmToEdit = false
 Should editors be required to have a validated e-mail address before being allowed to edit?
 $wgGroupPermissions = array()
 Permission keys given to users in each group.
 $wgRevokePermissions = array()
 Permission keys revoked from users in each group.
 $wgImplicitGroups = array( '*', 'user', 'autoconfirmed' )
 Implicit groups, aren't shown on Special:Listusers or somewhere else.
 $wgGroupsAddToSelf = array()
 A map of group names that the user is in, to group names that those users are allowed to add or revoke.
 $wgGroupsRemoveFromSelf = array()
 $wgRestrictionTypes = array( 'create', 'edit', 'move', 'upload' )
 Set of available actions that can be restricted via action=protect You probably shouldn't change this.
 $wgRestrictionLevels = array( '', 'autoconfirmed', 'sysop' )
 Rights which can be required for each protection level (via action=protect)
 $wgNamespaceProtection = array()
 Set the minimum permissions required to edit pages in each namespace.
 $wgNonincludableNamespaces = array()
 Pages in namespaces in this array can not be used as templates.
 $wgAutoConfirmAge = 0
 Number of seconds an account is required to age before it's given the implicit 'autoconfirm' group membership.
 $wgAutoConfirmCount = 0
 Number of edits an account requires before it is autoconfirmed.
 $wgAutopromote
 Automatically add a usergroup to any user who matches certain conditions.
 $wgAutopromoteOnce
 Automatically add a usergroup to any user who matches certain conditions.
 $wgAutopromoteOnceLogInRC = true
 Put user rights log entries for autopromotion in recent changes?
 $wgAddGroups = array()
 $wgAddGroups and $wgRemoveGroups can be used to give finer control over who can assign which groups at Special:Userrights.
 $wgRemoveGroups = array()
 $wgAvailableRights = array()
 A list of available rights, in addition to the ones defined by the core.
 $wgDeleteRevisionsLimit = 0
 Optional to restrict deletion of pages with higher revision counts to users with the 'bigdelete' permission.
 $wgAccountCreationThrottle = 0
 Number of accounts each IP address may create, 0 to disable.
 $wgSpamRegex = array()
 Edits matching these regular expressions in body text will be recognised as spam and rejected automatically.
 $wgSummarySpamRegex = array()
 Same as the above except for edit summaries.
 $wgFilterCallback = false
 Number of seconds before autoblock entries expire.
 $wgEnableDnsBlacklist = false
 Whether to use DNS blacklists in $wgDnsBlacklistUrls to check for open proxies.
 $wgEnableSorbs = false
 $wgDnsBlacklistUrls = array( 'http.dnsbl.sorbs.net.' )
 List of DNS blacklists to use, if $wgEnableDnsBlacklist is true.
 $wgSorbsUrl = array()
 $wgProxyWhitelist = array()
 Proxy whitelist, list of addresses that are assumed to be non-proxy despite what the other methods might say.
 $wgRateLimits
 Simple rate limiter options to brake edit floods.
 $wgRateLimitLog = null
 Set to a filename to log rate limiter hits.
 $wgRateLimitsExcludedIPs = array()
 Array of IPs which should be excluded from rate limits.
 $wgPutIPinRC = true
 Log IP addresses in the recentchanges table; can be accessed only by extensions (e.g.
 $wgQueryPageDefaultLimit = 50
 Integer defining default number of entries to show on special pages which are query-pages such as Special:Whatlinkshere.
 $wgPasswordAttemptThrottle = array( 'count' => 5, 'seconds' => 300 )
 Limit password attempts to X attempts per Y seconds per IP per account.
Proxy scanner settings
 $wgBlockOpenProxies = false
 If you enable this, every editor's IP address will be scanned for open HTTP proxies.
 $wgProxyPorts = array( 80, 81, 1080, 3128, 6588, 8000, 8080, 8888, 65506 )
 Port we want to scan for a proxy.
 $wgProxyScriptPath = "$IP/maintenance/proxy_check.php"
 Script used to scan.
 $wgProxyMemcExpiry = 86400
 If you enable this, every editor's IP address will be scanned for open HTTP proxies.
 $wgSecretKey = false
 This should always be customised in LocalSettings.php.
 $wgProxyList = array()
 big list of banned IP addresses, in the keys not the values
 $wgProxyKey = false
 deprecated
Cookie settings
 $wgCookieExpiration = 180*86400
 Default cookie expiration time.
 $wgCookieDomain = ''
 Set to set an explicit domain on the login cookies eg, "justthis.domain.org" or ".any.subdomain.net".
 $wgCookiePath = '/'
 Set this variable if you want to restrict cookies to a certain path within the domain specified by $wgCookieDomain.
 $wgCookieSecure = 'detect'
 Whether the "secure" flag should be set on the cookie.
 $wgDisableCookieCheck = false
 By default, MediaWiki checks if the client supports cookies during the login process, so that it can display an informative error message if cookies are disabled.
 $wgCookiePrefix = false
 Cookies generated by MediaWiki have names starting with this prefix.
 $wgCookieHttpOnly = true
 Set authentication cookies to HttpOnly to prevent access by JavaScript, in browsers that support this feature.
 $wgHttpOnlyBlacklist
 If the requesting browser matches a regex in this blacklist, we won't send it cookies with HttpOnly mode, even if $wgCookieHttpOnly is on.
 $wgCacheVaryCookies = array()
 A list of cookies that vary the cache (for use by extensions)
 $wgSessionName = false
 Override to customise the session name.
LaTeX (mathematical formulas)
 $wgUseTeX = false
 To use inline TeX, you need to compile 'texvc' (in the 'math' subdirectory of the MediaWiki package and have latex, dvips, gs (ghostscript), andconvert (ImageMagick) installed and available in the PATH.
Profiling, testing and debugging

To enable profiling, edit StartProfiler.php

 $wgDebugLogFile = ''
 Filename for debug logging.
 $wgDebugLogPrefix = ''
 Prefix for debug log lines.
 $wgDebugRedirects = false
 If true, instead of redirecting, show a page with a link to the redirect destination.
 $wgDebugRawPage = false
 If true, log debugging data from action=raw and load.php.
 $wgDebugComments = false
 Send debug data to an HTML comment in the output.
 $wgDebugDumpSql = false
 Write SQL queries to the debug log.
 $wgDebugLogGroups = array()
 Set to an array of log group keys to filenames.
 $wgShowDebug = false
 Display debug data at the bottom of the main content area.
 $wgDebugTimestamps = false
 Prefix debug messages with relative timestamp.
 $wgDebugPrintHttpHeaders = true
 Print HTTP headers for every request in the debug information.
 $wgSpecialVersionShowHooks = false
 Show the contents of $wgHooks in Special:Version.
 $wgShowSQLErrors = false
 Whether to show "we're sorry, but there has been a database error" pages.
 $wgShowExceptionDetails = false
 If set to true, uncaught exceptions will print a complete stack trace to output.
 $wgShowDBErrorBacktrace = false
 If true, show a backtrace for database errors.
 $wgShowHostnames = false
 Expose backend server host names through the API and various HTML comments.
 $wgDevelopmentWarnings = false
 If set to true MediaWiki will throw notices for some possible error conditions and for deprecated functions.
 $wgDeprecationReleaseLimit = '1.17'
 Release limitation to wfDeprecated warnings, if set to a release number development warnings will not be generated for deprecations added in releases after the limit.
 $wgProfileLimit = 0.0
 Only record profiling info for pages that took longer than this.
 $wgProfileOnly = false
 Don't put non-profiling info into log file.
 $wgProfileToDatabase = false
 Log sums from profiling into "profiling" table in db.
 $wgProfileCallTree = false
 If true, print a raw call tree instead of per-function report.
 $wgProfilePerHost = false
 Should application server host be put into profiling table.
 $wgUDPProfilerHost = '127.0.0.1'
 Host for UDP profiler.
 $wgUDPProfilerPort = '3811'
 Port for UDP profiler.
 $wgDebugProfiling = false
 Detects non-matching wfProfileIn/wfProfileOut calls.
 $wgDebugFunctionEntry = false
 Output debug message on every wfProfileIn/wfProfileOut.
 $wgStatsMethod = 'cache'
 Destination for wfIncrStats() data...
 $wgAggregateStatsID = false
 When $wgStatsMethod is 'udp', setting this to a string allows statistics to be aggregated over more than one wiki.
 $wgDisableCounters = false
 Whereas to count the number of time an article is viewed.
 $wgParserTestFiles
 Parser test suite files to be run by parserTests.php when no specific filename is passed to it.
 $wgParserTestRemote = false
 If configured, specifies target CodeReview installation to send test result data from 'parserTests.php --upload'.
 $wgEnableJavaScriptTest = false
 Allow running of javascript test suites via [[Special:JavaScriptTest]] (such as QUnit).
 $wgJavaScriptTestConfig
 Configuration for javascript testing.
 $wgCachePrefix = false
 Overwrite the caching key prefix with custom value.
 $wgDebugToolbar = false
 Display the new debugging toolbar.
Search
 $wgDisableTextSearch = false
 Set this to true to disable the full text search feature.
 $wgAdvancedSearchHighlighting = false
 Set to true to have nicer highligted text in search results, by default off due to execution overhead.
 $wgSearchHighlightBoundaries = '[\p{Z}\p{P}\p{C}]'
 Regexp to match word boundaries, defaults for non-CJK languages should be empty for CJK since the words are not separate.
 $wgCountTotalSearchHits = false
 Set to true to have the search engine count total search matches to present in the Special:Search UI.
 $wgOpenSearchTemplate = false
 Template for OpenSearch suggestions, defaults to API action=opensearch.
 $wgEnableMWSuggest = false
 Enable suggestions while typing in search boxes (results are passed around in OpenSearch format) Requires $wgEnableOpenSearchSuggest = true;.
 $wgEnableOpenSearchSuggest = true
 Enable OpenSearch suggestions requested by MediaWiki.
 $wgSearchSuggestCacheExpiry = 1200
 Expiry time for search suggestion responses.
 $wgMWSuggestTemplate = false
 Template for internal MediaWiki suggestion engine, defaults to API action=opensearch.
 $wgDisableSearchUpdate = false
 If you've disabled search semi-permanently, this also disables updates to the table.
 $wgNamespacesToBeSearchedDefault
 List of namespaces which are searched by default.
 $wgNamespacesToBeSearchedHelp
 Namespaces to be searched when user clicks the "Help" tab on Special:Search.
 $wgSearchEverythingOnlyLoggedIn = false
 If set to true the 'searcheverything' preference will be effective only for logged-in users.
 $wgDisableInternalSearch = false
 Disable the internal MySQL-based search, to allow it to be implemented by an extension instead.
 $wgSearchForwardUrl = null
 Set this to a URL to forward search requests to some external location.
 $wgUseTwoButtonsSearchForm = true
 Search form behavior true = use Go & Search buttons false = use Go button & Advanced search link.
 $wgSitemapNamespaces = false
 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.
 $wgSitemapNamespacesPriorities = false
 Custom namespace priorities for sitemaps.
 $wgEnableSearchContributorsByIP = true
 If true, searches for IP addresses will be redirected to that IP's contributions page.
Edit user interface
 $wgDiff3 = '/usr/bin/diff3'
 Path to the GNU diff3 utility.
 $wgDiff = '/usr/bin/diff'
 Path to the GNU diff utility.
 $wgPreviewOnOpenNamespaces
 Which namespaces have special treatment where they should be preview-on-open Internaly only Category: pages apply, but using this extensions (e.g.
 $wgUseExternalEditor = true
 Activate external editor interface for files and pages See http://www.mediawiki.org/wiki/Manual:External_editors.
 $wgGoToEdit = false
 Go button goes straight to the edit screen if the article doesn't exist.
 $wgUniversalEditButton = true
 Enable the UniversalEditButton for browsers that support it (currently only Firefox with an extension) See http://universaleditbutton.org for more background information.
 $wgUseAutomaticEditSummaries = true
 If user doesn't specify any edit summary when making a an edit, MediaWiki will try to automatically create one.
Maintenance

See also $wgSiteNotice

 $wgCommandLineDarkBg = false
 For colorized maintenance script output, is your terminal background dark ?
 $wgMaintenanceScripts = array()
 Array for extensions to register their maintenance scripts with the system.
 $wgReadOnly = null
 Set this to a string to put the wiki into read-only mode.
 $wgReadOnlyFile = false
 If this lock file exists (size > 0), the wiki will be forced into read-only mode.
 $wgUpgradeKey = 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.
Recent changes, new pages, watchlist and history
 $wgRCMaxAge = 13 * 7 * 24 * 3600
 Recentchanges items are periodically purged; entries older than this many seconds will go.
 $wgRCFilterByAge = false
 Filter $wgRCLinkDays by $wgRCMaxAge to avoid showing links for numbers higher than what will be stored.
 $wgRCLinkLimits = array( 50, 100, 250, 500 )
 List of Days and Limits options to list in the Special:Recentchanges and Special:Recentchangeslinked pages.
 $wgRCLinkDays = array( 1, 3, 7, 14, 30 )
 Recentchanges items are periodically purged; entries older than this many seconds will go.
 $wgRC2UDPAddress = false
 Send recent changes updates via UDP.
 $wgRC2UDPPort = false
 Port number for RC updates.
 $wgRC2UDPPrefix = ''
 Prefix to prepend to each UDP packet.
 $wgRC2UDPInterwikiPrefix = false
 If this is set to true, $wgLocalInterwiki will be prepended to links in the IRC feed.
 $wgRC2UDPOmitBots = false
 Set to true to omit "bot" edits (by users with the bot permission) from the UDP feed.
 $wgEnableNewpagesUserFilter = true
 Enable user search in Special:Newpages This is really a temporary hack around an index install bug on some Wikipedias.
 $wgUseRCPatrol = true
 Use RC Patrolling to check for vandalism.
 $wgUseNPPatrol = true
 Use new page patrolling to check new pages on Special:Newpages.
 $wgFeed = true
 Provide syndication feeds (RSS, Atom) for, e.g., Recentchanges, Newpages.
 $wgFeedLimit = 50
 Set maximum number of results to return in syndication feeds (RSS, Atom) for eg Recentchanges, Newpages.
 $wgFeedCacheTimeout = 60
 _Minimum_ timeout for cached Recentchanges feed, in seconds.
 $wgFeedDiffCutoff = 32768
 When generating Recentchanges RSS/Atom feed, diffs will not be generated for pages larger than this size.
 $wgOverrideSiteFeed = array()
 Override the site's default RSS/ATOM feed for recentchanges that appears on every page.
 $wgFeedClasses
 Available feeds objects Should probably only be defined when a page is syndicated ie when $wgOut->isSyndicated() is true.
 $wgAdvertisedFeedTypes = array( 'atom' )
 Which feed types should we provide by default? This can include 'rss', 'atom', neither, or both.
 $wgRCShowWatchingUsers = false
 Show watching users in recent changes, watchlist and page history views.
 $wgPageShowWatchingUsers = false
 Show watching users in Page views.
 $wgRCShowChangedSize = true
 Show the amount of changed characters in recent changes.
 $wgRCChangedSizeThreshold = 500
 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.
 $wgShowUpdatedMarker = true
 Show "Updated (since my last visit)" marker in RC view, watchlist and history view for watched pages with new changes.
 $wgDisableAnonTalk = false
 Disable links to talk pages of anonymous users (IPs) in listings on special pages like page history, Special:Recentchanges, etc.
 $wgAllowCategorizedRecentChanges = false
 Enable filtering of categories in Recentchanges.
 $wgUseTagFilter = true
 Allow filtering by change tag in recentchanges, history, etc Has no effect if no tags are defined in valid_tag.
Copyright and credits settings
 $wgRightsPage = null
 Override for copyright metadata.
 $wgRightsUrl = null
 Set this to specify an external URL containing details about the content license used on your wiki.
 $wgRightsText = null
 If either $wgRightsUrl or $wgRightsPage is specified then this variable gives the text for the link.
 $wgRightsIcon = null
 Override for copyright metadata.
 $wgLicenseTerms = false
 Set to an array of metadata terms.
 $wgCopyrightIcon = null
 Set this to some HTML to override the rights icon with an arbitrary logo.
 $wgUseCopyrightUpload = false
 Set this to true if you want detailed copyright information forms on Upload.
 $wgMaxCredits = 0
 Set this to the number of authors that you want to be credited below an article text.
 $wgShowCreditsIfMax = true
 If there are more than $wgMaxCredits authors, show $wgMaxCredits of them.
Import / Export
 $wgImportSources = array()
 List of interwiki prefixes for wikis we'll accept as sources for Special:Import (for sysops).
 $wgImportTargetNamespace = null
 Optional default target namespace for interwiki imports.
 $wgExportAllowHistory = true
 If set to false, disables the full-history option on Special:Export.
 $wgExportMaxHistory = 0
 If set nonzero, Special:Export requests for history of pages with more revisions than this will be rejected.
 $wgExportAllowListContributors = false
 Return distinct author list (when not returning full history)
 $wgExportMaxLinkDepth = 0
 If non-zero, Special:Export accepts a "pagelink-depth" parameter up to this specified level, which will cause it to include all pages linked to from the pages you specify.
 $wgExportFromNamespaces = false
 Whether to allow the "export all pages in namespace" option.
 $wgExportAllowAll = false
 Whether to allow exporting the entire wiki into a single file.
Extensions
 $wgExtensionFunctions = array()
 A list of callback functions which are called once MediaWiki is fully initialised.
 $wgExtensionMessagesFiles = array()
 Extension messages files.
 $wgParserOutputHooks = array()
 Parser output hooks.
 $wgValidSkinNames = array()
 List of valid skin names.
 $wgSpecialPages = array()
 Special page list.
 $wgAutoloadClasses = array()
 Array mapping class names to filenames, for autoloading.
 $wgExtensionCredits = array()
 An array of extension types and inside that their names, versions, authors, urls, descriptions and pointers to localized description msgs.
 $wgAuth = null
 A list of callback functions which are called once MediaWiki is fully initialised.
 $wgHooks = array()
 Global list of hooks.
 $wgJobClasses
 Maps jobs to their handling classes; extensions can add to this to provide custom jobs.
 $wgJobTypesExcludedFromDefaultQueue = array()
 Jobs that must be explicitly requested, i.e.
 $wgSpecialPageCacheUpdates
 Additional functions to be performed with updateSpecialPages.
 $wgExceptionHooks = array()
 Hooks that are used for outputting exceptions.
 $wgPagePropLinkInvalidations
 Page property link table invalidation lists.
Categories
 $wgUseCategoryBrowser = false
 Use experimental, DMOZ-like category browser.
 $wgCategoryMagicGallery = true
 On category pages, show thumbnail gallery for images belonging to that category instead of listing them as articles.
 $wgCategoryPagingLimit = 200
 Paging limit for categories.
 $wgCategoryCollation = 'uppercase'
 Specify how category names should be sorted, when listed on a category page.
Logging
 $wgLogTypes
 The logging system has two levels: an event type, which describes the general category and can be viewed as a named subset of all logs; and an action, which is a specific kind of event that can exist in that log type.
 $wgLogRestrictions
 This restricts log access to those who have a certain right Users without this will not see it in the option menu and can not view it Restricted logs are not added to recent changes Logs should remain non-transcludable Format: logtype => permissiontype.
 $wgFilterLogTypes
 Show/hide links on Special:Log will be shown for these log types.
 $wgLogNames
 Lists the message key string for each log type.
 $wgLogHeaders
 Lists the message key string for descriptive text to be shown at the top of each log type.
 $wgLogActions
 Lists the message key string for formatting individual events of each type and action when listed in the logs.
 $wgLogActionsHandlers
 The same as above, but here values are names of functions, not messages.
 $wgNewUserLog = true
 Maintain a log of newusers at Log/newusers?
Special pages (general and miscellaneous)
 $wgAllowSpecialInclusion = true
 Allow special page inclusions such as {{Special:Allpages}}.
 $wgDisableQueryPageUpdate = false
 Set this to an array of special page names to prevent maintenance/updateSpecialPages.php from updating those pages.
 $wgSpecialPageGroups
 List of special pages, followed by what subtitle they should go under at Special:SpecialPages.
 $wgSortSpecialPages = true
 Whether or not to sort special pages in Special:Specialpages.
 $wgCountCategorizedImagesAsUsed = false
 On Special:Unusedimages, consider images "used", if they are put into a category.
 $wgMaxRedirectLinksRetrieved = 500
 Maximum number of links to a redirect page listed on Special:Whatlinkshere/RedirectDestination.
Actions
 $wgActions
 Array of allowed values for the title=foo&action=<action> parameter.
 $wgDisabledActions = array()
 Array of disabled article actions, e.g.
 $wgAllowPageInfo = false
 Allow the "info" action, very inefficient at the moment.
Robot (search engine crawler) policy

See also $wgNoFollowLinks.

 $wgDefaultRobotPolicy = 'index,follow'
 Default robot policy.
 $wgNamespaceRobotPolicies = array()
 Robot policies per namespaces.
 $wgArticleRobotPolicies = array()
 Robot policies per article.
 $wgExemptFromUserRobotsControl = null
 An array of namespace keys in which the __INDEX__/__NOINDEX__ magic words will not function, so users can't decide whether pages in that namespace are indexed by search engines.
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.

 $wgEnableAPI = true
 Enable the MediaWiki API for convenient access to machine-readable data via api.php.
 $wgEnableWriteAPI = true
 Allow the API to be used to perform write operations (page edits, rollback, etc.) when an authorised user accesses it.
 $wgAPIModules = array()
 API module extensions Associative array mapping module name to class name.
 $wgAPIMetaModules = array()
 Enable the MediaWiki API for convenient access to machine-readable data via api.php.
 $wgAPIPropModules = array()
 Enable the MediaWiki API for convenient access to machine-readable data via api.php.
 $wgAPIListModules = array()
 Enable the MediaWiki API for convenient access to machine-readable data via api.php.
 $wgAPIMaxDBRows = 5000
 Maximum amount of rows to scan in a DB query in the API The default value is generally fine.
 $wgAPIMaxResultSize = 8388608
 The maximum size (in bytes) of an API result.
 $wgAPIMaxUncachedDiffs = 1
 The maximum number of uncached diffs that can be retrieved in one API request.
 $wgAPIRequestLog = false
 Log file or URL (TCP or UDP) to log API requests to, or false to disable API request logging.
 $wgAPICacheHelpTimeout = 60*60
 Set the timeout for the API help text cache.
 $wgUseAjax = true
 Enable AJAX framework.
 $wgAjaxExportList = array()
 List of Ajax-callable functions.
 $wgAjaxWatch = true
 Enable watching/unwatching pages using AJAX.
 $wgAjaxUploadDestCheck = true
 Enable AJAX check for file overwrite, pre-upload.
 $wgAjaxLicensePreview = true
 Enable previewing licences via AJAX.
 $wgCrossSiteAJAXdomains = 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.
 $wgCrossSiteAJAXdomainExceptions = 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.
Shell and process control
 $wgMaxShellMemory = 102400
 Maximum amount of virtual memory available to shell processes under linux, in KB.
 $wgMaxShellFileSize = 102400
 Maximum file size created by shell processes under linux, in KB ImageMagick convert for example can be fairly hungry for scratch space.
 $wgMaxShellTime = 180
 Maximum CPU time in seconds for shell processes under linux.
 $wgPhpCli = '/usr/bin/php'
 Executable path of the PHP cli binary (php/php5).
 $wgShellLocale = 'en_US.utf8'
 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.
HTTP client
 $wgHTTPTimeout = 25
 Timeout for HTTP requests done internally.
 $wgAsyncHTTPTimeout = 25
 Timeout for Asynchronous (background) HTTP requests.
 $wgHTTPProxy = false
 Proxy to use for CURL requests.
Job queue

See also $wgEnotifUseJobQ.

 $wgJobRunRate = 1
 Number of jobs to perform per request.
 $wgUpdateRowsPerJob = 500
 Number of rows to update per job.
 $wgUpdateRowsPerQuery = 100
 Number of rows to update per query.
HipHop compilation
 $wgHipHopBuildDirectory = false
 The build directory for HipHop compilation.
 $wgHipHopBuildType = 'Debug'
 The HipHop build type.
 $wgHipHopCompilerProcs = 'detect'
 Number of parallel processes to use during HipHop compilation, or "detect" to guess from system properties.
 $wgExtensionsDirectory = false
 Filesystem extensions directory.
 $wgCompiledFiles = array()
 A list of files that should be compiled into a HipHop build, in addition to those listed in $wgAutoloadClasses.
Miscellaneous
 $wgExternalDiffEngine = false
 Name of the external diff engine to use.
 $wgDisableHardRedirects = false
 Disable redirects to special pages and interwiki redirects, which use a 302 and have no "redirected from" link.
 $wgLinkHolderBatchSize = 1000
 LinkHolderArray batch size For debugging.
 $wgRegisterInternalExternals = false
 By default MediaWiki does not register links pointing to same server in externallinks dataset, use this value to override:
 $wgMaximumMovedPages = 100
 Maximum number of pages to move at once when moving subpages with a page.
 $wgFixDoubleRedirects = false
 Fix double redirects after a page move.
 $wgRedirectOnLogin = null
 Allow redirection to another page when a user logs in.
 $wgPoolCounterConf = null
 Configuration for processing pool control, for use in high-traffic wikis.
 $wgUploadMaintenance = false
 To disable file delete/restore temporarily.
 $wgEnableSelenium = false
 Allows running of selenium tests via maintenance/tests/RunSeleniumTests.php.
 $wgSeleniumTestConfigs = array()
 Name of the external diff engine to use.
 $wgSeleniumConfigFile = null
 Name of the external diff engine to use.
 $wgDBtestuser = ''
 Name of the external diff engine to use.
 $wgDBtestpassword = ''
 Name of the external diff engine to use.

Detailed Description

NEVER EDIT THIS FILE.

To customize your installation, edit "LocalSettings.php". If you make changes here, they will be lost on next upgrade of MediaWiki!

In this file, variables whose default values depend on other variables are set to false. The actual default value of these variables will only be set in Setup.php, taking into account any custom settings performed in LocalSettings.php.

Documentation is in the source and on: http://www.mediawiki.org/wiki/Manual:Configuration_settings

Definition in file DefaultSettings.php.


Variable Documentation

$serverName = substr( $wgServer, strrpos( $wgServer, '/' ) + 1 )

Site admin email address.

Definition at line 1034 of file DefaultSettings.php.

Referenced by LoadBalancer\getConnection(), LBFactory_Multi\makeServerArray(), and ApiTest\testApiGotCookie().

$wgAccountCreationThrottle = 0

Number of accounts each IP address may create, 0 to disable.

Requires memcached

Definition at line 3768 of file DefaultSettings.php.

Referenced by LoginForm\addNewAccountInternal().

$wgActionPaths = 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.

Definition at line 251 of file DefaultSettings.php.

$wgActions
Initial value:
 array(
        'credits'        => true,
        'delete'         => true,
        'edit'           => true,
        'history'        => true,
        'info'           => true,
        'markpatrolled'  => true,
        'protect'        => true,
        'purge'          => true,
        'raw'            => true,
        'render'         => true,
        'revert'         => true,
        'revisiondelete' => true,
        'rollback'       => true,
        'submit'         => true,
        'unprotect'      => true,
        'unwatch'        => true,
        'view'           => true,
        'watch'          => true,
)

Array of allowed values for the title=foo&action=<action> parameter.

Syntax is: 'foo' => 'ClassName' Load the specified class which subclasses Action 'foo' => true Load the class FooAction which subclasses Action If something is specified in the getActionOverrides() of the relevant Page object it will be used instead of the default class. 'foo' => false The action is disabled; show an error message Unsetting core actions will probably cause things to complain loudly.

Definition at line 5340 of file DefaultSettings.php.

Referenced by Action\getActionName(), and Action\getClass().

$wgActiveUserDays = 30

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.

Definition at line 3163 of file DefaultSettings.php.

Referenced by ActiveUsersPager\__construct(), SiteStatsUpdate\cacheUpdate(), ApiQueryAllUsers\execute(), SpecialActiveUsers\execute(), ApiQueryAllUsers\getParamDescription(), and SpecialStatistics\getUserStats().

$wgAdaptiveMessageCache = false

Instead of caching everything, keep track which messages are requested and load only most used messages.

This only makes sense if there is lots of interface messages customised in the wiki (like hundreds in many languages).

Definition at line 1647 of file DefaultSettings.php.

Referenced by MessageCache\getMsgFromNamespace(), MessageCache\loadFromDB(), and MessageCache\logMessages().

$wgAddGroups = array()

$wgAddGroups and $wgRemoveGroups can be used to give finer control over who can assign which groups at Special:Userrights.

Example configuration:

 // Bureaucrat can add any group
 $wgAddGroups['bureaucrat'] = true;
 // Bureaucrats can only remove bots and sysops
 $wgRemoveGroups['bureaucrat'] = array( 'bot', 'sysop' );
 // Sysops can make bots
 $wgAddGroups['sysop'] = array( 'bot' );
 // Sysops can disable other sysops in an emergency, and disable bots
 $wgRemoveGroups['sysop'] = array( 'sysop', 'bot' );

Definition at line 3750 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendUserGroups(), User\changeableByGroup(), and SpecialListGroupRights\execute().

$wgAdditionalMailParams = null

Additional email parameters, will be passed as the last argument to mail() call.

If using safe_mode this has no effect

Definition at line 1120 of file DefaultSettings.php.

Referenced by UserMailer\send().

$wgAdvancedSearchHighlighting = false

Set to true to have nicer highligted text in search results, by default off due to execution overhead.

Definition at line 4278 of file DefaultSettings.php.

Referenced by SearchResult\getTextSnippet().

$wgAdvertisedFeedTypes = array( 'atom' )

Which feed types should we provide by default? This can include 'rss', 'atom', neither, or both.

Definition at line 4649 of file DefaultSettings.php.

Referenced by OutputPage\addFeedLink(), OutputPage\getHeadLinks(), and OutputPage\setFeedAppendQuery().

$wgAggregateStatsID = false

When $wgStatsMethod is 'udp', setting this to a string allows statistics to be aggregated over more than one wiki.

The string will be used in place of the DB name in outgoing UDP packets. If this is set to false, the DB name will be used.

Definition at line 4196 of file DefaultSettings.php.

Referenced by wfIncrStats().

$wgAjaxExportList = array()

List of Ajax-callable functions.

Extensions acting as Ajax callbacks must register here

Definition at line 5502 of file DefaultSettings.php.

Referenced by AjaxDispatcher\performAction().

$wgAjaxLicensePreview = true

Enable previewing licences via AJAX.

Also requires $wgEnableAPI to be true.

Definition at line 5518 of file DefaultSettings.php.

Referenced by UploadForm\addUploadJS().

$wgAjaxUploadDestCheck = true

Enable AJAX check for file overwrite, pre-upload.

Definition at line 5513 of file DefaultSettings.php.

Referenced by UploadForm\addUploadJS().

$wgAjaxWatch = true

Enable watching/unwatching pages using AJAX.

Requires $wgUseAjax to be true too.

Definition at line 5508 of file DefaultSettings.php.

Referenced by OutputPage\addDefaultModules().

$wgAllDBsAreLocalhost = false

Make all database connections secretly go to localhost.

Fool the load balancer thinking there is an arbitrarily large cluster of servers to connect to. Useful for debugging.

Definition at line 1252 of file DefaultSettings.php.

Referenced by GetSlaveServer\execute(), and DatabaseMysql\open().

$wgAllowAsyncCopyUploads = false

Allow asynchronous copy uploads.

This feature is experimental and broken as of r81612.

Definition at line 455 of file DefaultSettings.php.

Referenced by ApiUpload\checkAsyncDownloadEnabled(), UploadFromUrl\initialize(), and UploadFromUrlTest\setUp().

$wgAllowCategorizedRecentChanges = false

Enable filtering of categories in Recentchanges.

Definition at line 4679 of file DefaultSettings.php.

Referenced by SpecialRecentChanges\getExtraOptions(), and SpecialRecentChanges\webOutput().

$wgAllowCopyUploads = false

Allow for upload to be copied from an URL.

Requires Special:Upload?source=web The timeout for copy uploads is set by $wgHTTPTimeout.

Definition at line 450 of file DefaultSettings.php.

Referenced by UploadFromUrl\isEnabled(), and UploadFromUrlTest\setUp().

$wgAllowDisplayTitle = true

Allow DISPLAYTITLE to change title display.

Definition at line 3083 of file DefaultSettings.php.

Referenced by CoreParserFunctions\register().

$wgAllowExternalImages = false

Whether to allow inline image pointing to other websites.

Definition at line 2973 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgAllowExternalImagesFrom = ''

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' );

Definition at line 2987 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgAllowImageMoving = true

Allows to move images and other media files.

Definition at line 264 of file DefaultSettings.php.

Referenced by MWNamespace\isMovable().

$wgAllowImageTag = false

A different approach to the above: simply allow the.

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.

Definition at line 3007 of file DefaultSettings.php.

Referenced by Sanitizer\removeHTMLtags(), and Sanitizer\setupAttributeWhitelist().

$wgAllowJavaUploads = false

Allow Java archive uploads.

This is not recommended for public wikis since a maliciously-constructed applet running on the same domain as the wiki can steal the user's cookies.

Definition at line 574 of file DefaultSettings.php.

Referenced by UploadBase\verifyPartialFile().

$wgAllowMicrodataAttributes = false

Enabled HTML5 microdata attributes for use in wikitext, if $wgHtml5 is also true.

Definition at line 2255 of file DefaultSettings.php.

Referenced by Sanitizer\setupAttributeWhitelist(), and Sanitizer\validateAttributes().

$wgAllowPageInfo = false

Allow the "info" action, very inefficient at the moment.

Definition at line 5370 of file DefaultSettings.php.

$wgAllowPrefChange = array()

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.

Definition at line 3374 of file DefaultSettings.php.

Referenced by User\saveOptions().

$wgAllowRdfaAttributes = false

Enabled RDFa attributes for use in wikitext.

NOTE: Interaction with HTML5 is somewhat underspecified.

Definition at line 2250 of file DefaultSettings.php.

Referenced by Sanitizer\setupAttributeWhitelist(), and Sanitizer\validateAttributes().

$wgAllowRealName = true

Whether or not to allow and use real name fields.

Deprecated:
since 1.16, use $wgHiddenPrefs[] = 'realname' below to disable real names

Definition at line 3296 of file DefaultSettings.php.

$wgAllowSchemaUpdates = true

Allow schema updates.

Definition at line 1465 of file DefaultSettings.php.

Referenced by UpdateMediaWiki\execute().

$wgAllowSlowParserFunctions = false

Enable slow parser functions.

Definition at line 1463 of file DefaultSettings.php.

Referenced by CoreParserFunctions\register().

$wgAllowSpecialInclusion = true

Allow special page inclusions such as {{Special:Allpages}}.

Definition at line 5192 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgAllowTitlesInSVG = false

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.

Definition at line 719 of file DefaultSettings.php.

Referenced by UploadBase\detectScript().

$wgAllowUserCss = false

Allow user Cascading Style Sheets (CSS)? This enables a lot of neat customizations, but may increase security risk to users and server load.

Definition at line 2380 of file DefaultSettings.php.

Referenced by OutputPage\buildCssLinks(), Preferences\generateSkinOptions(), and Preferences\skinPreferences().

$wgAllowUserCssPrefs = true

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.

Definition at line 2387 of file DefaultSettings.php.

Referenced by OutputPage\buildCssLinks(), Preferences\editingPreferences(), ResourceLoaderUserCSSPrefsModule\getStyles(), and Preferences\renderingPreferences().

$wgAllowUserJs = false

Allow user Javascript page? This enables a lot of neat customizations, but may increase security risk to users and server load.

Definition at line 2373 of file DefaultSettings.php.

Referenced by Preferences\generateSkinOptions(), OutputPage\getScriptsForBottomQueue(), and Preferences\skinPreferences().

$wgAllUnicodeFixes = false

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

Definition at line 1976 of file DefaultSettings.php.

Referenced by Language\normalize().

$wgAlwaysUseTidy = false
See also:
$wgUseTidy

Definition at line 3026 of file DefaultSettings.php.

Referenced by Parser\parse(), and ExtraParserTest\setUp().

$wgAmericanDates = false

Enable dates like 'May 12' instead of '12 May', this only takes effect if the interface is set to English.

Definition at line 2057 of file DefaultSettings.php.

$wgAntiLockFlags = 0

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.

Definition at line 1486 of file DefaultSettings.php.

Referenced by LinksUpdate\__construct(), and LinkCache\addLinkObj().

$wgAntivirus = null

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.

Definition at line 807 of file DefaultSettings.php.

Referenced by UploadBase\detectVirus().

$wgAntivirusRequired = true

Determines if a failed virus scan (AV_SCAN_FAILED) will cause the file to be rejected.

Definition at line 876 of file DefaultSettings.php.

Referenced by UploadBase\detectVirus().

$wgAntivirusSetup
Initial value:
 array(

        #setup for clamav
        'clamav' => array (
                'command' => "clamscan --no-summary ",

                'codemap' => array (
                        "0" =>  AV_NO_VIRUS, # no virus
                        "1" =>  AV_VIRUS_FOUND, # virus found
                        "52" => AV_SCAN_ABORTED, # unsupported file format (probably imune)
                        "*" =>  AV_SCAN_FAILED, # else scan failed
                ),

                'messagepattern' => '/.*?:(.*)/sim',
        ),

        #setup for f-prot
        'f-prot' => array (
                'command' => "f-prot ",

                'codemap' => array (
                        "0" => AV_NO_VIRUS, # no virus
                        "3" => AV_VIRUS_FOUND, # virus found
                        "6" => AV_VIRUS_FOUND, # virus found
                        "*" => AV_SCAN_FAILED, # else scan failed
                ),

                'messagepattern' => '/.*?Infection:(.*)$/m',
        ),
)

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). If not defined or the pattern does not match, the full message is shown to the user.

Definition at line 843 of file DefaultSettings.php.

Referenced by UploadBase\detectVirus().

$wgAPICacheHelpTimeout = 60*60

Set the timeout for the API help text cache.

If set to 0, caching disabled

Definition at line 5491 of file DefaultSettings.php.

Referenced by ApiMain\makeHelpMsg().

$wgApiFrameOptions = 'DENY'

Disallow framing of API pages directly, by setting the X-Frame-Options header.

Since the API returns CSRF tokens, allowing the results to be framed can compromise your user's account security. Options are:

  • 'DENY': Do not allow framing. This is recommended for most wikis.
  • 'SAMEORIGIN': Allow framing by pages on the same domain.
  • false: Allow all framing.

Definition at line 2432 of file DefaultSettings.php.

Referenced by ApiFormatBase\initPrinter().

$wgAPIListModules = array()

Enable the MediaWiki API for convenient access to machine-readable data via api.php.

See http://www.mediawiki.org/wiki/API

Definition at line 5462 of file DefaultSettings.php.

Referenced by ApiQuery\__construct().

$wgAPIMaxDBRows = 5000

Maximum amount of rows to scan in a DB query in the API The default value is generally fine.

Definition at line 5468 of file DefaultSettings.php.

Referenced by ApiQueryBase\checkRowCount().

$wgAPIMaxResultSize = 8388608

The maximum size (in bytes) of an API result.

Don't set this lower than $wgMaxArticleSize*1024

Definition at line 5474 of file DefaultSettings.php.

Referenced by ApiResult\addValue().

$wgAPIMaxUncachedDiffs = 1

The maximum number of uncached diffs that can be retrieved in one API request.

Set this to 0 to disable API diffs altogether

Definition at line 5480 of file DefaultSettings.php.

Referenced by ApiQueryRevisions\extractRowInfo().

$wgAPIMetaModules = array()

Enable the MediaWiki API for convenient access to machine-readable data via api.php.

See http://www.mediawiki.org/wiki/API

Definition at line 5460 of file DefaultSettings.php.

Referenced by ApiQuery\__construct().

$wgAPIModules = array()

API module extensions Associative array mapping module name to class name.

Extension modules may override the core modules.

Definition at line 5459 of file DefaultSettings.php.

Referenced by ApiMain\__construct().

$wgAPIPropModules = array()

Enable the MediaWiki API for convenient access to machine-readable data via api.php.

See http://www.mediawiki.org/wiki/API

Definition at line 5461 of file DefaultSettings.php.

Referenced by ApiQuery\__construct().

$wgAPIRequestLog = false

Log file or URL (TCP or UDP) to log API requests to, or false to disable API request logging.

Definition at line 5486 of file DefaultSettings.php.

$wgAppleTouchIcon = false

The URL path of the icon for iPhone and iPod Touch web app bookmarks.

Defaults to no icon.

Definition at line 219 of file DefaultSettings.php.

Referenced by OutputPage\getHeadLinks().

$wgArticleCountMethod = null

Method used to determine if a page in a content namespace should be counted as a valid article.

Redirect pages will never be counted as valid articles.

This variable can have the following values:

  • 'any': all pages as considered as valid articles
  • 'comma': the page must contain a comma to be considered valid
  • 'link': the page must contain a [[wiki link]] to be considered valid
  • null: the value will be set at run time depending on $wgUseCommaCount: if $wgUseCommaCount is false, it will be 'link', if it is true it will be 'comma'

See also See http://www.mediawiki.org/wiki/Manual:Article_count

Retroactively changing this variable will not affect the existing count, to update it, you will need to run the maintenance/updateArticleCount.php script.

Definition at line 3140 of file DefaultSettings.php.

Referenced by SiteStatsInit\articles(), and WikiPage\isCountable().

$wgArticlePath = false

The URL path for primary article page views.

This path should contain $1, which is replaced by the article title.

Will default to "{$wgScript}/$1" or "{$wgScript}?title=$1" in Setup.php, depending on $wgUsePathInfo.

Definition at line 187 of file DefaultSettings.php.

$wgArticleRobotPolicies = array()

Robot policies per article.

These override the per-namespace robot policies. Must be in the form of an array where the key part is a properly canonical- ised text form title and the value is a robot policy. Example: $wgArticleRobotPolicies = array( 'Main Page' => 'noindex,follow', 'User:Bob' => 'index,follow' ); Example that DOES NOT WORK because the names are not canonical text forms: $wgArticleRobotPolicies = array( # Underscore, not space! 'Main_Page' => 'noindex,follow', # "Project", not the actual project name! 'Project:X' => 'index,follow', # Needs to be "Abc", not "abc" (unless $wgCapitalLinks is false for that namespace)! 'abc' => 'noindex,nofollow' );

Definition at line 5418 of file DefaultSettings.php.

Referenced by Article\getRobotPolicy().

$wgAsyncHTTPTimeout = 25

Timeout for Asynchronous (background) HTTP requests.

Definition at line 5599 of file DefaultSettings.php.

$wgAutoblockExpiry = 86400

Number of seconds before autoblock entries expire.

Default 86400 = 1 day.

Definition at line 3394 of file DefaultSettings.php.

Referenced by Block\getAutoblockExpiry().

$wgAutoConfirmAge = 0

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.

When left at 0, all registered accounts will pass.

Example: $wgAutoConfirmAge = 600; // ten minutes $wgAutoConfirmAge = 3600*24; // one day

Definition at line 3671 of file DefaultSettings.php.

$wgAutoConfirmCount = 0

Number of edits an account requires before it is autoconfirmed.

Passing both this AND the time requirement is needed. Example:

$wgAutoConfirmCount = 50;

Definition at line 3681 of file DefaultSettings.php.

$wgAutocreatePolicy = 'login'

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').

Definition at line 3349 of file DefaultSettings.php.

Referenced by LoginForm\attemptAutoCreate(), LoginForm\authenticateUserData(), and User\loadFromSession().

$wgAutoloadClasses = array()

Array mapping class names to filenames, for autoloading.

Definition at line 4879 of file DefaultSettings.php.

Referenced by AutoLoader\autoload(), CompareParsers\checkParserLocally(), Installer\includeExtensions(), DatabaseUpdater\loadExtensions(), and ApiBase\makeHelpMsg_callback().

$wgAutopromote
Initial value:
 array(
        'autoconfirmed' => array( '&',
                array( APCOND_EDITCOUNT, &$wgAutoConfirmCount ),
                array( APCOND_AGE, &$wgAutoConfirmAge ),
        ),
)

Automatically add a usergroup to any user who matches certain conditions.

The format is array( '&' or '|' or '^' or '!', cond1, cond2, ... ) where cond1, cond2, ... are themselves conditions; *OR* APCOND_EMAILCONFIRMED, *OR* array( APCOND_EMAILCONFIRMED ), *OR* array( APCOND_EDITCOUNT, number of edits ), *OR* array( APCOND_AGE, seconds since registration ), *OR* array( APCOND_INGROUPS, group1, group2, ... ), *OR* array( APCOND_ISIP, ip ), *OR* array( APCOND_IPINRANGE, range ), *OR* array( APCOND_AGE_FROM_EDIT, seconds since first edit ), *OR* array( APCOND_BLOCKED ), *OR* array( APCOND_ISBOT ), *OR* similar constructs defined by extensions.

If $wgEmailAuthentication is off, APCOND_EMAILCONFIRMED will be true for any user who has provided an e-mail address.

Definition at line 3703 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendUserGroups(), and Autopromote\getAutopromoteGroups().

$wgAutopromoteOnce
Initial value:
 array(
        'onEdit' => array(),
        'onView' => array()
)

Automatically add a usergroup to any user who matches certain conditions.

Does not add the user to the group again if it has been removed. Also, does not remove the group if the user no longer meets the criteria.

The format is array( event => criteria, ... ) where event is 'onEdit' (when user edits) or 'onView' (when user views the wiki) and criteria has the same format as $wgAutopromote

See also:
$wgAutopromote
Since:
1.18

Definition at line 3724 of file DefaultSettings.php.

Referenced by Autopromote\getAutopromoteOnceGroups().

$wgAutopromoteOnceLogInRC = true

Put user rights log entries for autopromotion in recent changes?

Since:
1.18

Definition at line 3733 of file DefaultSettings.php.

Referenced by User\addAutopromoteOnceGroups().

$wgAvailableRights = array()

A list of available rights, in addition to the ones defined by the core.

For extensions only.

Definition at line 3758 of file DefaultSettings.php.

Referenced by User\getAllRights().

$wgBetterDirectionality = true

Better directionality support (bug 6100 and related).

Removed in 1.18, still kept here for LiquidThreads backwards compatibility.

Deprecated:
since 1.18

Definition at line 2522 of file DefaultSettings.php.

$wgBlockAllowsUTEdit = false

Set this to true to allow blocked users to edit their own user talk page.

Definition at line 3399 of file DefaultSettings.php.

Referenced by SpecialBlock\blockLogFlags(), SpecialBlock\getFormFields(), User\isBlockedFrom(), and SpecialBlock\processForm().

$wgBlockCIDRLimit
Initial value:
 array(
        'IPv4' => 16, # Blocks larger than a /16 (64k addresses) will not be allowed
        'IPv6' => 64, # 2^64 = ~1.8x10^19 addresses
)

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.

Definition at line 3411 of file DefaultSettings.php.

Referenced by Block\getIpFragment(), and SpecialBlock\validateTargetField().

$wgBlockDisablesLogin = false

If true, blocked users will not be allowed to login.

When using this with a public wiki, the effect of logging out blocked users may actually be avers: unless the user's address is also blocked (e.g. auto-block), logging the user out will again allow reading and editing, just as for anonymous visitors.

Definition at line 3423 of file DefaultSettings.php.

Referenced by LoginForm\authenticateUserData(), and User\loadFromSession().

$wgBlockOpenProxies = false

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.

Definition at line 3919 of file DefaultSettings.php.

Referenced by SpecialBlockme\execute(), and wfProxyCheck().

$wgBreakFrames = false

Break out of framesets.

This can be used to prevent clickjacking attacks, or to prevent external sites from framing your site with ads.

Definition at line 2399 of file DefaultSettings.php.

Referenced by OutputPage\getFrameOptions().

$wgBrowserBlackList
Initial value:
 array(
        
        '/^Mozilla\/2\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
        '/^Mozilla\/3\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',
        '/^Mozilla\/4\.[^ ]+ [^(]*?\((?!compatible).*; [UIN]/',

        
        '/^Mozilla\/4\.0 \(compatible; MSIE \d+\.\d+; Mac_PowerPC\)/',

        
        '/^Mozilla\/4\.0 \(compatible; MSIE 6.0; Windows NT 5.0; Google Wireless Transcoder;\)/'
)

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.

Definition at line 1995 of file DefaultSettings.php.

Referenced by EditPage\checkUnicodeCompliantBrowser().

$wgBug34832TransitionalRollback = true

If set to true, this will roll back a few bug fixes introduced in 1.19, emulating the 1.18 behaviour, to avoid introducing bug 34832.

In 1.19, language variant conversion is disabled in interface messages. Setting this to true re-enables it.

This variable should be removed (implicitly false) in 1.20 or earlier.

Definition at line 2187 of file DefaultSettings.php.

Referenced by Parser\getConverterLanguage(), and Parser\parse().

$wgCacheDirectory = false

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'].

Definition at line 1514 of file DefaultSettings.php.

Referenced by LocalisationCache\__construct(), LCStore_CDB\__construct(), MessageCache\loadFromLocal(), MessageCache\saveToLocal(), and MessageCache\saveToScript().

$wgCacheEpoch = '20030516000000'

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 +YmdHMS

Definition at line 1686 of file DefaultSettings.php.

Referenced by AjaxResponse\checkLastModified(), OutputPage\checkLastModified(), CacheTime\expired(), ParserCache\get(), MessageBlobStore\getFromDB(), ParserCache\getKey(), ResourceLoaderStartUpModule\getModifiedTime(), ResourceLoaderStartUpModule\getModuleRegistrations(), FileCacheBase\isCacheGood(), and ResourceLoader\respond().

$wgCachePages = true

Allow client-side caching of pages.

Definition at line 1678 of file DefaultSettings.php.

Referenced by AjaxResponse\checkLastModified(), and OutputPage\checkLastModified().

$wgCachePrefix = false

Overwrite the caching key prefix with custom value.

Since:
1.19

Definition at line 4251 of file DefaultSettings.php.

Referenced by wfMemcKey().

$wgCacheSharedUploads = true

Cache shared metadata in memcached.

Don't do this if the commons wiki is in a different memcached domain

Definition at line 445 of file DefaultSettings.php.

$wgCacheVaryCookies = array()

A list of cookies that vary the cache (for use by extensions)

Definition at line 4000 of file DefaultSettings.php.

Referenced by OutputPage\getCacheVaryCookies().

$wgCanonicalLanguageLinks = true

Whether to enable cononical language links in meta data.

Definition at line 2087 of file DefaultSettings.php.

Referenced by OutputPage\getHeadLinks().

$wgCanonicalServer = false

Canonical URL of the server, to use in IRC feeds and notification e-mails.

Must be fully qualified, even if $wgServer is protocol-relative.

Defaults to $wgServer, expanded to a fully qualified http:// URL if needed.

Definition at line 65 of file DefaultSettings.php.

Referenced by RecentChange\getIRCLine(), SearchEngine\getOpenSearchTemplate(), wfExpandUrl\testWfExpandUrl(), and wfExpandUrl().

$wgCapitalLinkOverrides = array()
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;

Definition at line 2850 of file DefaultSettings.php.

Referenced by MWNamespace\isCapitalized(), and MWNamespaceTest\testIsCapitalizedWithWgCapitalLinkOverrides().

$wgCapitalLinks = true

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.

Definition at line 2838 of file DefaultSettings.php.

Referenced by ParserTest\addArticle(), XmlDumpWriter\caseSetting(), NamespaceConflictChecker\checkAll(), CapsCleanup\execute(), MWNamespace\isCapitalized(), LocalFileTest\setUp(), and MWNamespaceTest\testIsCapitalizedWithWgCapitalLinks().

$wgCategoryCollation = 'uppercase'

Specify how category names should be sorted, when listed on a category page.

A sorting scheme is also known as a collation.

Available values are:

  • uppercase: Converts the category name to upper case, and sorts by that.
  • identity: Does no conversion. Sorts by binary value of the string.
  • uca-default: Provides access to the Unicode Collation Algorithm with the default element table. This is a compromise collation which sorts all languages in a mediocre way. However, it is better than "uppercase".

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.

After you change this, you must run maintenance/updateCollation.php to fix the sort keys in the database.

Extensions can define there own collations by subclassing Collation and using the Collation::factory hook.

Definition at line 5024 of file DefaultSettings.php.

Referenced by DatabaseUpdater\doCollationUpdate(), LinksUpdate\getCategoryInsertions(), and Collation\singleton().

$wgCategoryMagicGallery = true

On category pages, show thumbnail gallery for images belonging to that category instead of listing them as articles.

Definition at line 4992 of file DefaultSettings.php.

Referenced by CategoryViewer\getHTML().

$wgCategoryPagingLimit = 200

Paging limit for categories.

Definition at line 4997 of file DefaultSettings.php.

Referenced by CategoryViewer\__construct().

$wgCheckFileExtensions = true

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.

Definition at line 581 of file DefaultSettings.php.

Referenced by UploadBase\checkWarnings(), StreamFile\contentTypeFromPath(), UploadForm\getExtensionsMessage(), and UploadBase\getTitle().

$wgCleanSignatures = true

If true, removes (substitutes) templates in "~~~~" signatures.

Definition at line 2970 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser(), ExtraParserTest\testCleanSig(), and ExtraParserTest\testCleanSigDisabled().

$wgCleanupPresentationalAttributes = true

Cleanup as much presentational html like valign -> css vertical-align as we can.

Definition at line 2260 of file DefaultSettings.php.

Referenced by Sanitizer\fixDeprecatedAttributes().

$wgClockSkewFudge = 5

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.

Definition at line 1773 of file DefaultSettings.php.

Referenced by User\newTouchedTimestamp().

$wgCommandLineDarkBg = false

For colorized maintenance script output, is your terminal background dark ?

Definition at line 4494 of file DefaultSettings.php.

Referenced by AnsiTermColorer\color().

$wgCompiledFiles = array()

A list of files that should be compiled into a HipHop build, in addition to those listed in $wgAutoloadClasses.

Add to this array in an extension setup file in order to add files to the build.

The files listed here must either be either absolute paths under $IP or under $wgExtensionsDirectory, or paths relative to the virtual source root "$IP/..", i.e. starting with "phase3" for core files, and "extensions" for extension files.

Definition at line 5679 of file DefaultSettings.php.

Referenced by MWInit\extSetupPath().

$wgCompressRevisions = false

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.

Definition at line 1407 of file DefaultSettings.php.

Referenced by Revision\compressRevisionText().

$wgContentNamespaces = array( NS_MAIN )

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.

Definition at line 2874 of file DefaultSettings.php.

Referenced by Title\canUseNoindex(), RebuildFileCache\execute(), MWNamespace\getContentNamespaces(), MWNamespace\isContent(), MWNamespaceTest\testGetContentNamespaces(), MWNamespaceTest\testIsContent(), and MWNamespaceTest\testIsContentWithAdditionsInWgContentNamespaces().

$wgCookieDomain = ''

Set to set an explicit domain on the login cookies eg, "justthis.domain.org" or ".any.subdomain.net".

Definition at line 3949 of file DefaultSettings.php.

Referenced by WebResponse\setcookie(), and wfSetupSession().

$wgCookieExpiration = 180*86400

Default cookie expiration time.

Setting to 0 makes all cookies session-only.

Definition at line 3943 of file DefaultSettings.php.

Referenced by UsercreateTemplate\execute(), LoginForm\mainLoginForm(), Preferences\profilePreferences(), WebResponse\setcookie(), and SpecialChangePassword\showForm().

$wgCookieHttpOnly = true

Set authentication cookies to HttpOnly to prevent access by JavaScript, in browsers that support this feature.

This can mitigates some classes of XSS attack.

Definition at line 3986 of file DefaultSettings.php.

Referenced by WebResponse\setcookie(), and wfSetupSession().

$wgCookiePath = '/'

Set this variable if you want to restrict cookies to a certain path within the domain specified by $wgCookieDomain.

Definition at line 3956 of file DefaultSettings.php.

Referenced by WebResponse\setcookie(), and wfSetupSession().

$wgCookiePrefix = false

Cookies generated by MediaWiki have names starting with this prefix.

Set it to a string to use a custom prefix. Setting it to false causes the database name to be used as a prefix.

Definition at line 3979 of file DefaultSettings.php.

Referenced by ApiLogin\execute(), OutputPage\getCacheVaryCookies(), ResourceLoaderStartUpModule\getConfig(), WebRequest\getCookie(), and WebResponse\setcookie().

$wgCookieSecure = 'detect'

Whether the "secure" flag should be set on the cookie.

This can be:

  • true: Set secure flag
  • false: Don't set secure flag
  • "detect": Set the secure flag if $wgServer is set to an HTTPS URL

Definition at line 3964 of file DefaultSettings.php.

Referenced by WebResponse\setcookie(), and wfSetupSession().

$wgCopyrightIcon = null

Set this to some HTML to override the rights icon with an arbitrary logo.

Deprecated:
since 1.18 Use $wgFooterIcons['copyright']['copyright']

Definition at line 4730 of file DefaultSettings.php.

Referenced by Skin\getCopyrightIcon().

$wgCountCategorizedImagesAsUsed = false

On Special:Unusedimages, consider images "used", if they are put into a category.

Default (false) is not to count those as used.

Definition at line 5315 of file DefaultSettings.php.

Referenced by UnusedimagesPage\getQueryInfo().

$wgCountTotalSearchHits = false

Set to true to have the search engine count total search matches to present in the Special:Search UI.

Not supported by every search engine shipped with MW.

This could however be slow on larger wikis, and is pretty flaky with the current title vs content split. Recommend avoiding until that's been worked out cleanly; but this may aid in testing the search UI and API to confirm that the result count works.

Definition at line 4296 of file DefaultSettings.php.

Referenced by SearchMySQL\searchInternal(), and SearchSqlite\searchInternal().

$wgCrossSiteAJAXdomainExceptions = 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.

Definition at line 5547 of file DefaultSettings.php.

$wgCrossSiteAJAXdomains = 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', );

Definition at line 5539 of file DefaultSettings.php.

$wgCustomConvertCommand = 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: $wgCustomConvertCommand = "gm convert %s -resize %wx%h %d"

Leave as false to skip this.

Definition at line 677 of file DefaultSettings.php.

Referenced by BitmapHandler\getScalerType(), BitmapScalingTest\setUp(), BitmapScalingTest\tearDown(), and BitmapHandler\transformCustom().

$wgDBadminpassword = null

Separate password for maintenance tasks.

Leave as null to use the default.

Definition at line 1218 of file DefaultSettings.php.

Referenced by Maintenance\finalSetup().

$wgDBadminuser = null

Separate username for maintenance tasks.

Leave as null to use the default.

Definition at line 1216 of file DefaultSettings.php.

Referenced by Maintenance\finalSetup().

$wgDBAhandler = 'db3'

Select which DBA handler <http://www.php.net/manual/en/dba.requirements.php> to use as CACHE_DBA backend.

Definition at line 1595 of file DefaultSettings.php.

Referenced by DBABagOStuff\__construct().

$wgDBAvgStatusPoll = 2000

Scale load balancer polling time so that under overload conditions, the database server receives a SHOW STATUS query at an average interval of this many microseconds.

Definition at line 1349 of file DefaultSettings.php.

Referenced by LoadBalancer\getReaderIndex().

$wgDBClusterTimeout = 10

When to give an error message.

Definition at line 1343 of file DefaultSettings.php.

Referenced by LoadBalancer\getReaderIndex().

$wgDBerrorLog = false

File to log database errors to.

Definition at line 1340 of file DefaultSettings.php.

Referenced by wfLogDBError().

$wgDBmysql5 = false

Set to true to engage MySQL 4.1/5.0 charset-related features; for now will just cause sending of 'SET NAMES=utf8' on connect.

WARNING: THIS IS EXPERIMENTAL!

May break if you're not using the table defs from mysql5/tables.sql. May break if you're upgrading an existing wiki if set differently. Broken symptoms likely to include incorrect behavior with page titles, usernames, comments etc containing non-ASCII characters. Might also cause failures on the object cache and other things.

Even correct usage may cause failures with Unicode supplementary characters (those not in the Basic Multilingual Plane) unless MySQL has enhanced their Unicode support.

Definition at line 1370 of file DefaultSettings.php.

Referenced by DatabaseMysql\open().

$wgDBport = 5432
$wgDBserver = 'localhost'
$wgDBservers = false

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

These and any other user-defined properties will be assigned to the mLBInfo member variable of the Database object.

Leave at false to use the single-server variables above. If you set this variable, the single-server variables will generally be ignored (except perhaps in some command-line scripts).

The first server listed in this array (with key 0) will be the master. The rest of the servers will be slaves. To prevent writes to your slaves due to 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:

SET @read_only=1;

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 our masters, and then set read_only=0 on masters at runtime.

Definition at line 1322 of file DefaultSettings.php.

Referenced by Maintenance\finalSetup(), and LBFactory_Simple\newMainLB().

$wgDBTableOptions = 'ENGINE=InnoDB'

MySQL table options to use during installation or update.

Definition at line 1231 of file DefaultSettings.php.

Referenced by UpdateLogging\execute().

$wgDBtestpassword = ''

Name of the external diff engine to use.

Definition at line 5760 of file DefaultSettings.php.

Referenced by switchToTestResources().

$wgDBtestuser = ''

Name of the external diff engine to use.

Definition at line 5759 of file DefaultSettings.php.

Referenced by switchToTestResources().

$wgDBtransactions = false

Set to true if using InnoDB tables.

Definition at line 1352 of file DefaultSettings.php.

Referenced by WikiPage\doEdit().

$wgDebugComments = 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.

Definition at line 4064 of file DefaultSettings.php.

Referenced by SkinTemplate\outputPage(), and wfDebug().

$wgDebugDumpSql = false

Write SQL queries to the debug log.

Definition at line 4069 of file DefaultSettings.php.

Referenced by LBFactory_Simple\newMainLB().

$wgDebugFunctionEntry = false

Output debug message on every wfProfileIn/wfProfileOut.

Definition at line 4180 of file DefaultSettings.php.

Referenced by Profiler\getOutput(), ProfilerSimple\profileIn(), Profiler\profileIn(), ProfilerSimpleTrace\profileOut(), ProfilerSimple\profileOut(), and Profiler\profileOut().

$wgDebugLogFile = ''

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.

Definition at line 4035 of file DefaultSettings.php.

Referenced by GlobalTest\testDebugFunctionTest(), wfDebug(), and wfLogProfilingData().

$wgDebugLogGroups = array()

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.

Definition at line 4077 of file DefaultSettings.php.

Referenced by wfDebugLog().

$wgDebugLogPrefix = ''

Prefix for debug log lines.

Definition at line 4040 of file DefaultSettings.php.

Referenced by wfDebug().

$wgDebugPrintHttpHeaders = true

Print HTTP headers for every request in the debug information.

Definition at line 4095 of file DefaultSettings.php.

$wgDebugProfiling = false

Detects non-matching wfProfileIn/wfProfileOut calls.

Definition at line 4177 of file DefaultSettings.php.

$wgDebugRawPage = false

If true, log debugging data from action=raw and load.php.

This is normally false to avoid overlapping debug entries due to gen=css and gen=js requests.

Definition at line 4054 of file DefaultSettings.php.

Referenced by wfDebug(), and wfLogProfilingData().

$wgDebugRedirects = false

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.

Definition at line 4047 of file DefaultSettings.php.

Referenced by OutputPage\output().

$wgDebugTidy = false

Put tidy warnings in HTML comments Only works for internal tidy.

Definition at line 3040 of file DefaultSettings.php.

Referenced by MWTidy\execInternalTidy().

$wgDebugTimestamps = false

Prefix debug messages with relative timestamp.

Very-poor man's profiler. Since 1.19 also includes memory usage.

Definition at line 4090 of file DefaultSettings.php.

Referenced by Skin\formatDebugHTML(), GlobalTest\testDebugFunctionTest(), and wfDebugTimer().

$wgDebugToolbar = false

Display the new debugging toolbar.

This also enables profiling on database queries and other useful output. Will disable file cache.

Since:
1.19

Definition at line 4260 of file DefaultSettings.php.

Referenced by RebuildFileCache\finalSetup(), HTMLFileCache\useFileCache(), and Article\view().

$wgDefaultExternalStore = false

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.

Definition at line 1438 of file DefaultSettings.php.

Referenced by ExternalStoreDB\getSlave(), Revision\insertOn(), and ExternalStore\insertToDefault().

$wgDefaultRobotPolicy = 'index,follow'

Default robot policy.

The default policy is to encourage indexing and fol- lowing of links. It may be overridden on a per-namespace and/or per-page basis.

Definition at line 5385 of file DefaultSettings.php.

Referenced by Article\getRobotPolicy().

$wgDefaultSkin = 'vector'

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.

Definition at line 2331 of file DefaultSettings.php.

Referenced by ResourceLoaderContext\__construct(), Preferences\generateSkinOptions(), User\getDefaultOptions(), RequestContext\getSkin(), Skin\normalizeKey(), and ResourceFileCache\useFileCache().

$wgDefaultUserOptions

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;

Definition at line 3225 of file DefaultSettings.php.

Referenced by Preferences\getDateOptions(), User\getDefaultOptions(), and User\setOption().

$wgDeletedDirectory = false

What directory to place deleted uploads in.

Definition at line 279 of file DefaultSettings.php.

$wgDeleteRevisionsLimit = 0

Optional to restrict deletion of pages with higher revision counts to users with the 'bigdelete' permission.

(Default given to sysops.)

Definition at line 3764 of file DefaultSettings.php.

Referenced by Title\checkActionPermissions(), Article\delete(), MovePageForm\doSubmit(), and Title\isBigDeletion().

$wgDeprecationReleaseLimit = '1.17'

Release limitation to wfDeprecated warnings, if set to a release number development warnings will not be generated for deprecations added in releases after the limit.

Definition at line 4138 of file DefaultSettings.php.

Referenced by wfDeprecated().

$wgDevelopmentWarnings = false

If set to true MediaWiki will throw notices for some possible error conditions and for deprecated functions.

Definition at line 4131 of file DefaultSettings.php.

Referenced by wfWarn().

$wgDiff = '/usr/bin/diff'

Path to the GNU diff utility.

Definition at line 4442 of file DefaultSettings.php.

Referenced by CompareParsers\checkOptions(), and wfDiff().

$wgDiff3 = '/usr/bin/diff3'

Path to the GNU diff3 utility.

If the file doesn't exist, edit conflicts will fall back to the old behaviour (no merging).

Definition at line 4437 of file DefaultSettings.php.

Referenced by ParserTest\quickDiff(), and wfMerge().

$wgDirectoryMode = 0777

Default value for chmoding of new directories.

Definition at line 979 of file DefaultSettings.php.

Referenced by wfMkdirParents().

$wgDisableAnonTalk = false

Disable links to talk pages of anonymous users (IPs) in listings on special pages like page history, Special:Recentchanges, etc.

Definition at line 4674 of file DefaultSettings.php.

Referenced by Linker\userToolLinks().

$wgDisableCookieCheck = false

By default, MediaWiki checks if the client supports cookies during the login process, so that it can display an informative error message if cookies are disabled.

Set this to true if you want to disable this cookie check.

Definition at line 3972 of file DefaultSettings.php.

Referenced by LoginForm\hasSessionCookie().

$wgDisableCounters = false

Whereas to count the number of time an article is viewed.

Does not work if pages are cached (for example with squid).

Definition at line 4201 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendStatistics(), WikiPage\doViewUpdates(), SpecialStatistics\execute(), ApiQueryInfo\execute(), ApiQueryInfo\extractPageInfo(), SpecialPageFactory\getList(), InfoAction\onView(), SkinTemplate\outputPage(), and ApiQueryInfo\requestExtraData().

$wgDisabledActions = array()

Array of disabled article actions, e.g.

view, edit, delete, etc.

Deprecated:
since 1.18; just set $wgActions['action'] = false instead

Definition at line 5365 of file DefaultSettings.php.

$wgDisabledVariants = array()

Disabled variants array of language variant conversion.

Example: $wgDisabledVariants[] = 'zh-mo'; $wgDisabledVariants[] = 'zh-my';

or:

$wgDisabledVariants = array('zh-mo', 'zh-my');

Definition at line 2105 of file DefaultSettings.php.

Referenced by LanguageConverter\__construct().

$wgDisableHardRedirects = false

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.

Definition at line 5698 of file DefaultSettings.php.

Referenced by MediaWiki\initializeArticle().

$wgDisableInternalSearch = false

Disable the internal MySQL-based search, to allow it to be implemented by an extension instead.

Definition at line 4376 of file DefaultSettings.php.

Referenced by SpecialPageFactory\getList().

$wgDisableOutputCompression = false

Disable output compression (enabled by default if zlib is available)

Definition at line 2437 of file DefaultSettings.php.

Referenced by wfOutputHandler(), and wfResetOutputBuffers().

$wgDisableQueryPages = false

Disable all query pages if miser mode is on, not just some.

Definition at line 1457 of file DefaultSettings.php.

Referenced by QueryPage\isExpensive().

$wgDisableQueryPageUpdate = false

Set this to an array of special page names to prevent maintenance/updateSpecialPages.php from updating those pages.

Definition at line 5198 of file DefaultSettings.php.

Referenced by UpdateSpecialPages\execute(), and QueryPage\execute().

$wgDisableSearchUpdate = false

If you've disabled search semi-permanently, this also disables updates to the table.

If you ever re-enable, be sure to rebuild the search table.

Definition at line 4340 of file DefaultSettings.php.

Referenced by SearchUpdate\doUpdate(), and UpdateSearchIndex\doUpdateSearchIndex().

$wgDisableTextSearch = false

Set this to true to disable the full text search feature.

Definition at line 4272 of file DefaultSettings.php.

Referenced by SpecialSearch\showResults().

$wgDisableTitleConversion = false

Whether to enable language variant conversion for links.

Definition at line 2084 of file DefaultSettings.php.

Referenced by LanguageConverter\findVariantLink(), Parser\parse(), and Preferences\profilePreferences().

$wgDisableUploadScriptChecks = false

Setting this to true will disable the upload system's checks for HTML/JavaScript.

THIS IS VERY DANGEROUS on a publicly editable site, so USE wgGroupPermissions TO RESTRICT UPLOADING to only those that you trust

Definition at line 596 of file DefaultSettings.php.

Referenced by UploadBase\verifyPartialFile().

$wgDjvuDump = null

DJVU settings Path of the djvudump executable Enable this and $wgDjvuRenderer to enable djvu rendering.

Definition at line 987 of file DefaultSettings.php.

Referenced by DjVuHandler\isEnabled(), and DjVuImage\retrieveMetaData().

$wgDjvuOutputExtension = 'jpg'

File extension for the DJVU post processor output.

Definition at line 1025 of file DefaultSettings.php.

Referenced by DjVuHandler\getThumbType().

$wgDjvuPostProcessor = 'pnmtojpeg'

Shell command for the DJVU post processor Default: pnmtopng, since ddjvu generates ppm output Set this to false to output the ppm file directly.

Definition at line 1021 of file DefaultSettings.php.

Referenced by DjVuHandler\doTransform().

$wgDjvuRenderer = null

Path of the ddjvu DJVU renderer Enable this and $wgDjvuDump to enable djvu rendering.

Definition at line 994 of file DefaultSettings.php.

Referenced by DjVuHandler\doTransform(), and DjVuHandler\isEnabled().

$wgDjvuToXML = 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

Definition at line 1013 of file DefaultSettings.php.

Referenced by DjVuHandler\isEnabled(), and DjVuImage\retrieveMetaData().

$wgDjvuTxt = null

Path of the djvutxt DJVU text extraction utility Enable this and $wgDjvuDump to enable text layer extraction from djvu files.

Definition at line 1001 of file DefaultSettings.php.

Referenced by DjVuImage\retrieveMetaData().

$wgDnsBlacklistUrls = array( 'http.dnsbl.sorbs.net.' )

List of DNS blacklists to use, if $wgEnableDnsBlacklist is true.

This is an array of either a URL or an array with the URL and a key (should the blacklist require a key). For example:

 $wgDnsBlacklistUrls = array(
   // String containing URL
   'http.dnsbl.sorbs.net',
   // Array with URL and key, for services that require a key
   array( 'dnsbl.httpbl.net', 'mykey' ),
   // Array with just the URL. While this works, it is recommended that you
   // just use a string as shown above
   array( 'opm.tornevall.org' )
 );
Since:
1.16

Definition at line 3829 of file DefaultSettings.php.

Referenced by User\isDnsBlacklisted().

$wgDocType = '-//W3C//DTD XHTML 1.0 Transitional//EN'

The HTML document type.

Ignored if $wgHtml5 is true, since <!DOCTYPE html> doesn't actually have a doctype part to put this variable's contents in.

Definition at line 2212 of file DefaultSettings.php.

Referenced by Html\htmlHeader().

$wgDTD = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'

The URL of the document type declaration.

Ignored if $wgHtml5 is true, since HTML5 has no DTD, and <!DOCTYPE html> doesn't actually have a DTD part to put this variable's contents in.

Definition at line 2219 of file DefaultSettings.php.

Referenced by Html\htmlHeader().

$wgDummyLanguageCodes
Initial value:
 array(
        'als' => 'gsw',
        'bat-smg' => 'sgs',
        'be-x-old' => 'be-tarask',
        'bh' => 'bho',
        'fiu-vro' => 'vro',
        'no' => 'nb',
        'qqq' => 'qqq', # Used for message documentation.
        'qqx' => 'qqx', # Used for viewing message keys.
        'roa-rup' => 'rup',
        'simple' => 'en',
        'zh-classical' => 'lzh',
        'zh-min-nan' => 'nan',
        'zh-yue' => 'yue',
)

List of language codes that don't correspond to an actual language.

These codes are mostly leftoffs from renames, or other legacy things. This array makes them not appear as a selectable language on the installer, and excludes them when running the transstat.php script.

Definition at line 1920 of file DefaultSettings.php.

Referenced by WebInstaller_Language\getLanguageSelector(), and wikiStatsOutput\heading().

$wgEditEncoding = ''

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.

Definition at line 1943 of file DefaultSettings.php.

Referenced by LanguageEo\initEncoding(), Language\recodeForEdit(), and Language\recodeInput().

$wgEdititis = false

Display user edit counts in various prominent places.

Definition at line 2514 of file DefaultSettings.php.

Referenced by UsersPager\formatRow().

$wgEditPageFrameOptions = 'DENY'

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.

Definition at line 2420 of file DefaultSettings.php.

Referenced by OutputPage\getFrameOptions().

$wgEmailAuthentication = true

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.

Definition at line 1138 of file DefaultSettings.php.

Referenced by LoginForm\addNewAccount(), Autopromote\checkCondition(), SpecialPageFactory\getList(), User\isEmailConfirmationPending(), User\isEmailConfirmed(), Preferences\profilePreferences(), TitlePermissionTest\testUserBlock(), and Preferences\trySetUserEmail().

$wgEmailConfirmToEdit = false

Should editors be required to have a validated e-mail address before being allowed to edit?

Definition at line 3447 of file DefaultSettings.php.

Referenced by LoginForm\addNewAccountInternal(), Title\checkUserBlock(), LoginForm\mainLoginForm(), Preferences\profilePreferences(), and TitlePermissionTest\testUserBlock().

$wgEmergencyContact = 'wikiadmin@' . $serverName

Site admin email address.

Definition at line 1039 of file DefaultSettings.php.

$wgEnableAPI = true
$wgEnableAutoRotation = null

If set to true, images that contain certain the exif orientation tag will be rotated accordingly.

If set to null, try to auto-detect whether a scaler is available that can rotate.

Definition at line 800 of file DefaultSettings.php.

Referenced by ExifBitmapHandler\getImageSize(), ExifBitmapHandler\getRotation(), ExifRotationTest\setUp(), ExifRotationTest\tearDown(), ExifRotationTest\testMetadataNoAutoRotate(), and ExifRotationTest\testRotationRenderingNoAutoRotate().

$wgEnableDnsBlacklist = false

Whether to use DNS blacklists in $wgDnsBlacklistUrls to check for open proxies.

Since:
1.16

Definition at line 3804 of file DefaultSettings.php.

Referenced by User\isDnsBlacklisted().

$wgEnableEmail = true

Set to true to enable the e-mail basic features: Password reminders, etc.

If sending e-mail on your server doesn't work, you might want to disable this.

Definition at line 1067 of file DefaultSettings.php.

Referenced by User\canSendEmail(), SpecialPageFactory\getList(), SpecialEmailUser\getPermissionsError(), LoginForm\load(), LoginForm\mainLoginForm(), Preferences\profilePreferences(), and Preferences\trySetUserEmail().

$wgEnableImageWhitelist = true

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

Definition at line 2997 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgEnableJavaScriptTest = false

Allow running of javascript test suites via [[Special:JavaScriptTest]] (such as QUnit).

Definition at line 4235 of file DefaultSettings.php.

Referenced by ResourceLoader\__construct(), SpecialJavaScriptTest\execute(), SpecialJavaScriptTest\isListed(), and ResourceLoader\registerTestModules().

$wgEnableMWSuggest = false

Enable suggestions while typing in search boxes (results are passed around in OpenSearch format) Requires $wgEnableOpenSearchSuggest = true;.

Definition at line 4314 of file DefaultSettings.php.

Referenced by OutputPage\addDefaultModules(), ResourceLoaderStartUpModule\getConfig(), OutputPage\getJSVars(), and Preferences\searchPreferences().

$wgEnableNewpagesUserFilter = true

Enable user search in Special:Newpages This is really a temporary hack around an index install bug on some Wikipedias.

Kill it once fixed.

Definition at line 4599 of file DefaultSettings.php.

Referenced by SpecialNewpages\form(), NewPagesPager\getQueryInfo(), and SpecialNewpages\setup().

$wgEnableOpenSearchSuggest = true

Enable OpenSearch suggestions requested by MediaWiki.

Set this to false if you've disabled MWSuggest or another suggestion script and want reduce load caused by cached scripts pulling suggestions.

Definition at line 4321 of file DefaultSettings.php.

Referenced by ApiOpenSearch\execute().

$wgEnableParserCache = true

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.

Definition at line 1728 of file DefaultSettings.php.

Referenced by WikiPage\doEditUpdates(), ApiPurge\execute(), WikiPage\isParserCacheUsed(), UploadFromUrlTestSuite\setUp(), and ParserTest\setUp().

$wgEnableScaryTranscluding = false

Enable interwiki transcluding.

Only when iw_trans=1.

Definition at line 3106 of file DefaultSettings.php.

Referenced by Parser\interwikiTransclude().

$wgEnableSearchContributorsByIP = true

If true, searches for IP addresses will be redirected to that IP's contributions page.

E.g. searching for "1.2.3.4" will redirect to [[Special:Contributions/1.2.3.4]]

Definition at line 4424 of file DefaultSettings.php.

Referenced by SearchEngine\getNearMatchInternal().

$wgEnableSelenium = false

Allows running of selenium tests via maintenance/tests/RunSeleniumTests.php.

Definition at line 5756 of file DefaultSettings.php.

$wgEnableSidebarCache = false

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.

Definition at line 1745 of file DefaultSettings.php.

Referenced by Skin\buildSidebar(), and RebuildMessages\execute().

$wgEnableSorbs = false
Deprecated:
since 1.17 Use $wgEnableDnsBlacklist instead, only kept for backward compatibility

Definition at line 3810 of file DefaultSettings.php.

Referenced by User\isDnsBlacklisted().

$wgEnableUserEmail = true

Set to true to enable user-to-user e-mail.

This can potentially be abused, as it's hard to track.

Definition at line 1073 of file DefaultSettings.php.

Referenced by SpecialBlock\canBlockEmail(), User\canSendEmail(), SpecialEmailUser\getPermissionsError(), LoginForm\mainLoginForm(), and Preferences\profilePreferences().

$wgEnableWriteAPI = true

Allow the API to be used to perform write operations (page edits, rollback, etc.) when an authorised user accesses it.

Definition at line 5452 of file DefaultSettings.php.

Referenced by ResourceLoaderStartUpModule\getConfig().

$wgEnotifFromEditor = false

True: from page editor if s/he opted-in.

False: Enotif mails appear to come from $wgEmergencyContact

Definition at line 1126 of file DefaultSettings.php.

Referenced by EmailNotification\composeCommonMailtext().

$wgEnotifImpersonal = false

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.

Definition at line 1170 of file DefaultSettings.php.

Referenced by EmailNotification\compose(), EmailNotification\composeCommonMailtext(), and EmailNotification\sendMails().

$wgEnotifMaxRecips = 500

Maximum number of users to mail at once when using impersonal mail.

Should match the limit on your mail server.

Definition at line 1176 of file DefaultSettings.php.

Referenced by UserMailer\send().

$wgEnotifMinorEdits = true

Send notification mails on minor edits to watchlist pages.

This is enabled by default. Does not affect user talk notifications.

Definition at line 1161 of file DefaultSettings.php.

Referenced by EmailNotification\actuallyNotifyOnPageChange(), and EmailNotification\notifyOnPageChange().

$wgEnotifRevealEditorAddress = false

Set the Reply-to address in notifications to the editor's address, if user allowed this in the preferences.

Definition at line 1155 of file DefaultSettings.php.

Referenced by EmailNotification\composeCommonMailtext(), and Preferences\profilePreferences().

$wgEnotifUseJobQ = false

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.

Definition at line 1182 of file DefaultSettings.php.

Referenced by EmailNotification\notifyOnPageChange().

$wgEnotifUseRealName = false

Use real name instead of username in e-mail "from" field.

Definition at line 1187 of file DefaultSettings.php.

Referenced by EmailNotification\composeCommonMailtext(), EmailNotification\sendPersonalised(), and MailAddress\toString().

$wgEnotifUserTalk = false

Allow users to enable email notification ("enotif") when someone edits their user talk page.

Definition at line 1149 of file DefaultSettings.php.

Referenced by EmailNotification\actuallyNotifyOnPageChange(), EmailNotification\canSendUserTalkEmail(), EmailNotification\notifyOnPageChange(), and Preferences\profilePreferences().

$wgEnotifWatchlist = false

Allow users to enable email notification ("enotif") on watchlist changes.

Definition at line 1143 of file DefaultSettings.php.

Referenced by EmailNotification\actuallyNotifyOnPageChange(), SpecialWatchlist\execute(), EmailNotification\notifyOnPageChange(), and Preferences\profilePreferences().

$wgExceptionHooks = array()

Hooks that are used for outputting exceptions.

Format is: $wgExceptionHooks[] = $funcname or: $wgExceptionHooks[] = array( $class, $funcname ) Hooks should return strings or false

Definition at line 4963 of file DefaultSettings.php.

Referenced by MWException\runHooks().

$wgExemptFromUserRobotsControl = null

An array of namespace keys in which the __INDEX__/__NOINDEX__ magic words will not function, so users can't decide whether pages in that namespace are indexed by search engines.

If set to null, default to $wgContentNamespaces. Example: $wgExemptFromUserRobotsControl = array( NS_MAIN, NS_TALK, NS_PROJECT );

Definition at line 5427 of file DefaultSettings.php.

Referenced by Title\canUseNoindex().

$wgExiv2Command = '/usr/bin/exiv2'

Some tests and extensions use exiv2 to manipulate the EXIF metadata in some image formats.

Definition at line 682 of file DefaultSettings.php.

Referenced by RandomImageGenerator\getImageWriteMethod(), and RandomImageGenerator\writeImageWithApi().

$wgExpensiveParserFunctionLimit = 100

Maximum number of calls per parse to expensive parser functions such as PAGESINCATEGORY.

Definition at line 3095 of file DefaultSettings.php.

Referenced by Parser\incrementExpensiveFunctionCount().

$wgExperimentalHtmlIds = 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.

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.

Definition at line 2448 of file DefaultSettings.php.

Referenced by Sanitizer\escapeId(), and Parser\formatHeadings().

$wgExportAllowAll = false

Whether to allow exporting the entire wiki into a single file.

Definition at line 4814 of file DefaultSettings.php.

Referenced by SpecialExport\execute().

$wgExportAllowHistory = true

If set to false, disables the full-history option on Special:Export.

This is currently poorly optimized for long edit histories, so is disabled on Wikimedia's sites.

Definition at line 4779 of file DefaultSettings.php.

Referenced by SpecialExport\execute().

$wgExportAllowListContributors = false

Return distinct author list (when not returning full history)

Definition at line 4791 of file DefaultSettings.php.

Referenced by SpecialExport\execute().

$wgExportFromNamespaces = false

Whether to allow the "export all pages in namespace" option.

Definition at line 4809 of file DefaultSettings.php.

Referenced by SpecialExport\execute().

$wgExportMaxHistory = 0

If set nonzero, Special:Export requests for history of pages with more revisions than this will be rejected.

On some big sites things could get bogged down by very very long pages.

Definition at line 4786 of file DefaultSettings.php.

Referenced by SpecialExport\execute().

$wgExportMaxLinkDepth = 0

If non-zero, Special:Export accepts a "pagelink-depth" parameter up to this specified level, which will cause it to include all pages linked to from the pages you specify.

Since this number can become *insanely large* and could easily break your wiki, it's disabled by default for now.

There's a HARD CODED limit of 5 levels of recursion to prevent a crazy-big export from being done by someone setting the depth number too high. In other words, last resort safety net.

Definition at line 4804 of file DefaultSettings.php.

Referenced by SpecialImport\doImport(), SpecialExport\execute(), SpecialImport\showForm(), and SpecialExport\validateLinkDepth().

$wgExtensionAssetsPath = false

The URL path of the extensions directory.

Defaults to "{$wgScriptPath}/extensions".

Since:
1.16

Definition at line 173 of file DefaultSettings.php.

Referenced by ResourceLoaderFileModule\__construct(), ResourceLoaderStartUpModule\getConfig(), and ParserTest\setUp().

$wgExtensionCredits = array()

An array of extension types and inside that their names, versions, authors, urls, descriptions and pointers to localized description msgs.

Note that the version, url, description and descriptionmsg key can be omitted.

$wgExtensionCredits[$type][] = array( 'name' => 'Example extension', 'version' => 1.9, 'path' => __FILE__, 'author' => 'Foo Barstein', 'url' => 'http://wwww.example.com/Example%20Extension/', 'description' => 'An example extension', 'descriptionmsg' => 'exampleextension-desc', );

Where $type is 'specialpage', 'parserhook', 'variable', 'media' or 'other'. Where 'descriptionmsg' can be an array with message key and parameters: 'descriptionmsg' => array( 'exampleextension-desc', param1, param2, ... ),

Definition at line 4902 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendExtensions(), SpecialVersion\getExtensionCategory(), and SpecialVersion\getExtensionCredits().

$wgExtensionFunctions = array()

A list of callback functions which are called once MediaWiki is fully initialised.

Definition at line 4826 of file DefaultSettings.php.

Referenced by SpecialVersion\getExtensionCredits().

$wgExtensionMessagesFiles = array()

Extension messages files.

Associative array mapping extension name to the filename where messages can be found. The file should contain variable assignments. Any of the variables present in languages/messages/MessagesEn.php may be defined, but $messages is the most common.

Variables defined in extensions will override conflicting variables defined in the core.

Example: $wgExtensionMessagesFiles['ConfirmEdit'] = dirname(__FILE__).'/ConfirmEdit.i18n.php';

Definition at line 4843 of file DefaultSettings.php.

Referenced by Installer\__construct(), MergeMessageFileList\execute(), and LocalisationCache\recache().

$wgExtensionsDirectory = false

Filesystem extensions directory.

Defaults to $IP/../extensions.

To compile extensions with HipHop, set $wgExtensionsDirectory correctly, and use code like:

require( MWInit::extensionSetupPath( 'Extension/Extension.php' ) );

to include the extension setup file from LocalSettings.php. It is not necessary to set this variable unless you use MWInit::extensionSetupPath().

Definition at line 5667 of file DefaultSettings.php.

Referenced by MWInit\getExtensionsDirectory().

$wgExternalAuthConf = array()

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.

Definition at line 3339 of file DefaultSettings.php.

Referenced by ExternalUser_Hardcoded\authenticate(), ExternalUser_vB\getDb(), ExternalUser_Hardcoded\getPref(), ExternalUser_MediaWiki\initFromCond(), ExternalUser_vB\initFromCookie(), and ExternalUser_Hardcoded\initFromName().

$wgExternalAuthType = 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/.

Definition at line 3330 of file DefaultSettings.php.

Referenced by LoginForm\authenticateUserData(), User\loadFromSession(), ExternalUser\newFromCookie(), ExternalUser\newFromId(), ExternalUser\newFromName(), and ExternalUser\newFromUser().

$wgExternalDiffEngine = false

Name of the external diff engine to use.

Definition at line 5690 of file DefaultSettings.php.

Referenced by _DiffEngine\diff_local(), DifferenceEngine\generateDiffBody(), and DifferenceEngine\initDiffEngines().

$wgExternalLinkTarget = false

Set a default target for external links, e.g.

_blank to pop up a new window

Definition at line 3051 of file DefaultSettings.php.

Referenced by Skin\addToSidebarPlain(), ParserOptions\initialiseFromUser(), Installer\restoreLinkPopups(), and SideBarTest\testRespectExternallinktarget().

$wgExternalServers = array()

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.

Definition at line 1425 of file DefaultSettings.php.

Referenced by LBFactory_Simple\newExternalLB().

$wgExternalStores = 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

Definition at line 1418 of file DefaultSettings.php.

Referenced by ExternalStore\fetchFromURL(), ExternalStore\getStoreObject(), ExternalStoreTest\setUp(), ExternalStoreTest\tearDown(), and ExternalStoreTest\testExternalStoreDoesNotFetchIncorrectURL().

$wgExtraGenderNamespaces = array()

Same as above, but for namespaces with gender distinction.

Note: the default form for the namespace should also be set using $wgExtraNamespaces for the same index.

Since:
1.18

Definition at line 2742 of file DefaultSettings.php.

Referenced by Language\getGenderNsText(), Language\getNamespaceAliases(), and Language\needsGenderDistinction().

$wgExtraLanguageNames = array()

List of language names or overrides for default names in Names.php.

Definition at line 1912 of file DefaultSettings.php.

$wgExtraNamespaces = array()

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.

Definition at line 2734 of file DefaultSettings.php.

Referenced by MWNamespace\getCanonicalNamespaces(), Language\getNamespaces(), and Language\needsGenderDistinction().

$wgExtraSubtitle = ''

A subtitle to add to the tagline, for skins that have it/.

Definition at line 2312 of file DefaultSettings.php.

Referenced by LegacyTemplate\pageSubtitle().

$wgFavicon = '/favicon.ico'

The URL path of the shortcut icon.

Definition at line 213 of file DefaultSettings.php.

Referenced by OutputPage\getHeadLinks().

$wgFeed = true

Provide syndication feeds (RSS, Atom) for, e.g., Recentchanges, Newpages.

Definition at line 4608 of file DefaultSettings.php.

Referenced by FeedUtils\checkFeedOutput(), QueryPage\doFeed(), ApiFeedContributions\execute(), ApiFeedWatchlist\execute(), SpecialNewpages\feed(), and OutputPage\getHeadLinks().

$wgFeedCacheTimeout = 60

_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.

Definition at line 4621 of file DefaultSettings.php.

Referenced by ChangesFeed\loadFromCache().

$wgFeedClasses
Initial value:
 array(
        'rss' => 'RSSFeed',
        'atom' => 'AtomFeed',
)

Available feeds objects Should probably only be defined when a page is syndicated ie when $wgOut->isSyndicated() is true.

Definition at line 4640 of file DefaultSettings.php.

Referenced by SpecialPage\addFeedLinks(), FeedUtils\checkFeedOutput(), QueryPage\doFeed(), ApiFeedContributions\execute(), ApiFeedWatchlist\execute(), HistoryAction\feed(), SpecialNewpages\feed(), ApiFeedContributions\getAllowedParams(), ApiFeedWatchlist\getAllowedParams(), ChangesFeed\getFeedObject(), and RebuildRecentchanges\purgeFeeds().

$wgFeedDiffCutoff = 32768

When generating Recentchanges RSS/Atom feed, diffs will not be generated for pages larger than this size.

Definition at line 4625 of file DefaultSettings.php.

Referenced by FeedUtils\formatDiffRow().

$wgFeedLimit = 50

Set maximum number of results to return in syndication feeds (RSS, Atom) for eg Recentchanges, Newpages.

Definition at line 4612 of file DefaultSettings.php.

Referenced by QueryPage\doFeed(), ApiFeedWatchlist\execute(), HistoryAction\feed(), SpecialNewpages\feed(), and SpecialRecentChanges\feedSetup().

$wgFetchCommonsDescriptions = false

Fetch commons image description pages and display them on the local wiki?

Definition at line 437 of file DefaultSettings.php.

$wgFileBackends = array()

File backend structure configuration.

This is an array of file backend configuration arrays. Each backend configuration has the following parameters: 'name' : A unique name for the backend 'class' : The file backend class to use 'wikiId' : A unique string that identifies the wiki (container prefix) 'lockManager' : The name of a lock manager (see $wgLockManagers) Additional parameters are specific to the class used.

Definition at line 389 of file DefaultSettings.php.

Referenced by FileBackendGroup\initFromGlobals(), StoreBatchTest\setUp(), FileBackendTest\setUp(), and NewParserTest\setupGlobals().

$wgFileBlacklist
Initial value:
 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 extensions will never be allowed as uploads.

Definition at line 542 of file DefaultSettings.php.

Referenced by StreamFile\contentTypeFromPath(), UploadStash\getExtensionForPath(), UploadForm\getExtensionsMessage(), and UploadBase\getTitle().

$wgFileCacheDepth = 2

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.

Definition at line 1717 of file DefaultSettings.php.

Referenced by FileCacheBase\hashSubdirectory().

$wgFileCacheDirectory = false

Directory where the cached page will be saved.

Will default to "{$wgUploadDirectory}/cache" in Setup.php

Definition at line 1709 of file DefaultSettings.php.

Referenced by FileCacheBase\baseCacheDirectory(), and PruneFileCache\execute().

$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' )

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).

Definition at line 539 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendFileExtensions(), UploadBase\checkWarnings(), StreamFile\contentTypeFromPath(), ResourceLoaderStartUpModule\getConfig(), UploadForm\getExtensionsMessage(), UploadBase\getTitle(), SpecialUpload\processVerificationError(), UploadTest\testMaxUploadSize(), and ApiUpload\verifyUpload().

$wgFileStore = array()
Deprecated:
since 1.17 use $wgDeletedDirectory

Definition at line 274 of file DefaultSettings.php.

$wgFilterCallback = false

Number of seconds before autoblock entries expire.

Default 86400 = 1 day.

Definition at line 3798 of file DefaultSettings.php.

Referenced by EditPage\internalAttemptSave().

$wgFilterLogTypes
Initial value:
 array(
        'patrol' => true
)

Show/hide links on Special:Log will be shown for these log types.

This is associative array of log type => boolean "hide by default"

See $wgLogTypes for a list of available log types.

For example: $wgFilterLogTypes => array( 'move' => true, 'import' => false, );

Will display show/hide links for the move and import logs. Move logs will be hidden by default unless the link is clicked. Import logs will be shown by default, and hidden when the link is clicked.

A message of the form log-show-hide-<type> should be added, and will be used for the link text.

Definition at line 5084 of file DefaultSettings.php.

Referenced by LogPager\getFilterParams().

$wgFixArabicUnicode = true

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 inaccessible, run maintenance/cleanupTitles.php to fix this.

Definition at line 1953 of file DefaultSettings.php.

Referenced by LanguageAr\normalize().

$wgFixDoubleRedirects = false

Fix double redirects after a page move.

Tends to conflict with page move vandalism, use only on a private wiki.

Definition at line 5721 of file DefaultSettings.php.

Referenced by MovePageForm\doSubmit(), and MovePageForm\showForm().

$wgFixMalayalamUnicode = 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.

If you enable this on an existing wiki, run maintenance/cleanupTitles.php to fix any ZWJ sequences in existing page titles.

Definition at line 1964 of file DefaultSettings.php.

Referenced by LanguageMl\normalize().

$wgFooterIcons
Initial value:
 array(
        "copyright" => array(
                "copyright" => array(), 
        ),
        "poweredby" => array(
                "mediawiki" => array(
                        "src" => null, 
                        "url" => "//www.mediawiki.org/",
                        "alt" => "Powered by MediaWiki",
                )
        ),
)

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 arround the text or icon, if not set an 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.

Definition at line 2477 of file DefaultSettings.php.

Referenced by SkinTemplate\outputPage().

$wgForcedRawSMaxage = 300

Default maximum age for raw CSS/JS accesses.

Definition at line 1841 of file DefaultSettings.php.

Referenced by RawAction\onView().

$wgForceUIMsgAsContentMsg = array()

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' );

Definition at line 2145 of file DefaultSettings.php.

Referenced by SpecialUpload\getInitialPageText(), Message\inContentLanguage(), MessageTest\testInContentLanguage(), wfMsgForContent(), and wfMsgForContentNoTrans().

$wgForeignFileRepos = array()
$wgGalleryOptions
Initial value:
 array (
        'imagesPerRow' => 0, 
        'imageWidth' => 120, 
        'imageHeight' => 120, 
        'captionLength' => 25, 
        'showBytes' => true, 
)

Default parameters for the <gallery> tag.

Definition at line 961 of file DefaultSettings.php.

Referenced by ImageGallery\__construct().

$wgGenerateThumbnailOnParse = true

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).

Definition at line 785 of file DefaultSettings.php.

$wgGoToEdit = false

Go button goes straight to the edit screen if the article doesn't exist.

Definition at line 4460 of file DefaultSettings.php.

Referenced by SpecialSearch\goResult().

$wgGroupPermissions = array()

Permission keys given to users in each group.

This is an array where the keys are all groups and each value is an array of the format (right => boolean).

The second format is used to support per-namespace permissions. Note that this feature does not fully work for all permission types.

All users are implicitly in the '*' group including anonymous visitors; logged-in users are all implicitly in the 'user' group. These will be combined with the permissions of all groups that a given user is listed in in the user_groups table.

Note: Don't set $wgGroupPermissions = array(); unless you know what you're doing! This will wipe all permissions, and may mean that your users are unable to perform certain essential tasks or access new functionality when new permissions are introduced and default grants established.

Functionality to make pages inaccessible has not been extensively tested for security. Use at your own risk!

This replaces $wgWhitelistAccount and $wgWhitelistEdit

Definition at line 3472 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendUserGroups(), ProtectionForm\buildCleanupScript(), Title\checkQuickPermissions(), Title\checkReadPermissions(), SpecialListGroupRights\execute(), SpecialNewpages\filterLinks(), User\getAllGroups(), User\getGroupPermissions(), SpecialStatistics\getGroupStats(), User\getGroupsWithPermission(), NewPagesPager\getQueryInfo(), SpecialPage\isRestricted(), RawAction\onView(), RebuildRecentchanges\rebuildRecentChangesTablePass4(), TitlePermissionTest\runGroupPermissions(), ProtectionForm\save(), UserTest\setUpPermissionGlobals(), OutputPage\showPermissionsErrorPage(), and TitlePermissionTest\testQuickPermissions().

$wgGroupsAddToSelf = array()

A map of group names that the user is in, to group names that those users are allowed to add or revoke.

Setting the list of groups to add or revoke to true is equivalent to "any group".

For example, to allow sysops to add themselves to the "bot" group:

$wgGroupsAddToSelf = array( 'sysop' => array( 'bot' ) );

Implicit groups may be used for the source group, for instance:

$wgGroupsRemoveFromSelf = array( '*' => true );

This allows users in the '*' group (i.e. any user) to remove themselves from any group that they happen to be in.

Definition at line 3612 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendUserGroups(), User\changeableByGroup(), and SpecialListGroupRights\execute().

$wgGroupsRemoveFromSelf = array()
$wgHandheldForIPhone = 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.

Definition at line 2366 of file DefaultSettings.php.

Referenced by OutputPage\transformCssMedia().

$wgHandheldStyle = 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.

Definition at line 2354 of file DefaultSettings.php.

Referenced by ResourceLoaderSiteModule\getPages(), and SkinMonoBook\setupSkinUserCss().

$wgHashedSharedUploadDirectory = 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.

Definition at line 519 of file DefaultSettings.php.

$wgHashedUploadDirectory = true

Set this to false if you do not want MediaWiki to divide your images directory into many subdirectories, for improved performance.

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.

Definition at line 512 of file DefaultSettings.php.

$wgHideInterlanguageLinks = false

Hide interlanguage links from the sidebar.

Definition at line 1909 of file DefaultSettings.php.

Referenced by ApiParse\languagesHtml(), LegacyTemplate\otherLanguages(), and SkinTemplate\outputPage().

$wgHipHopBuildDirectory = false

The build directory for HipHop compilation.

Defaults to $IP/maintenance/hiphop/build.

Definition at line 5643 of file DefaultSettings.php.

$wgHipHopBuildType = 'Debug'

The HipHop build type.

Can be either "Debug" or "Release".

Definition at line 5648 of file DefaultSettings.php.

$wgHipHopCompilerProcs = 'detect'

Number of parallel processes to use during HipHop compilation, or "detect" to guess from system properties.

Definition at line 5654 of file DefaultSettings.php.

$wgHitcounterUpdateFreq = 1

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.

Definition at line 3155 of file DefaultSettings.php.

Referenced by ViewCountUpdate\collect(), and ViewCountUpdate\doUpdate().

$wgHTCPMulticastAddress = false

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.

Definition at line 1868 of file DefaultSettings.php.

Referenced by SquidUpdate\HTCPPurge(), and SquidUpdate\purge().

$wgHTCPMulticastTTL = 1

HTCP multicast TTL.

See also:
$wgHTCPMulticastAddress

Definition at line 1880 of file DefaultSettings.php.

Referenced by SquidUpdate\HTCPPurge().

$wgHTCPPort = 4827

HTCP multicast port.

See also:
$wgHTCPMulticastAddress

Definition at line 1874 of file DefaultSettings.php.

Referenced by SquidUpdate\HTCPPurge(), and SquidUpdate\purge().

$wgHtml5 = true

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. If it's true, a number of other settings will be irrelevant and have no effect.

Definition at line 2234 of file DefaultSettings.php.

Referenced by Html\dropDefaults(), Sanitizer\escapeId(), Html\expandAttributes(), Sanitizer\fixDeprecatedAttributes(), Parser\formatHeadings(), OutputPage\getHeadLinks(), Html\htmlHeader(), Html\inlineScript(), Html\linkedScript(), Sanitizer\setupAttributeWhitelist(), HtmlTest\testExpandAttributesForBooleans(), Html\textarea(), and Sanitizer\validateAttributes().

$wgHtml5Version = null

Defines the value of the version attribute in the <html> tag, if any.

This is ignored if $wgHtml5 is false. If $wgAllowRdfaAttributes and $wgHtml5 are both true, and this evaluates to boolean false (like if it's left at the default null value), it will be auto-initialized to the correct value for RDFa+HTML5. As such, you should have no reason to ever actually set this to anything.

Definition at line 2244 of file DefaultSettings.php.

Referenced by Html\htmlHeader(), and SkinTemplate\outputPage().

$wgHttpOnlyBlacklist
Initial value:
 array(
        
        
        
        '/^Mozilla\/4\.0 \(compatible; MSIE \d+\.\d+; Mac_PowerPC\)/',
)

If the requesting browser matches a regex in this blacklist, we won't send it cookies with HttpOnly mode, even if $wgCookieHttpOnly is on.

Definition at line 3992 of file DefaultSettings.php.

Referenced by wfHttpOnlySafe().

$wgHTTPProxy = false

Proxy to use for CURL requests.

Definition at line 5604 of file DefaultSettings.php.

Referenced by MWHttpRequest\proxySetup().

$wgHTTPTimeout = 25

Timeout for HTTP requests done internally.

Definition at line 5594 of file DefaultSettings.php.

Referenced by MWHttpRequest\__construct().

$wgIgnoreImageErrors = false

If set, inline scaled images will still produce.

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.

Definition at line 776 of file DefaultSettings.php.

Referenced by File\transform(), and File\transformErrorOutput().

$wgIllegalFileChars = ":"

These are additional characters that should be replaced with '-' in file names.

Definition at line 269 of file DefaultSettings.php.

Referenced by wfStripIllegalFilenameChars().

$wgImageLimits
Initial value:
 array(
        array( 320, 240 ),
        array( 640, 480 ),
        array( 800, 600 ),
        array( 1024, 768 ),
        array( 1280, 1024 ),
        array( 10000, 10000 )
)

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:

Definition at line 935 of file DefaultSettings.php.

Referenced by Preferences\getImageSizes(), and ImagePage\openShowImage().

$wgImageMagickConvertCommand = '/usr/bin/convert'
$wgImageMagickIdentifyCommand = '/usr/bin/identify'

The identify command shipped with ImageMagick.

Definition at line 651 of file DefaultSettings.php.

$wgImageMagickTempDir = false

Temporary directory used for ImageMagick.

The directory must exist. Leave this set to false to let ImageMagick decide for itself.

Definition at line 663 of file DefaultSettings.php.

Referenced by BitmapHandler\transformImageMagick().

$wgImgAuthDetails = false

Set this to true if you use img_auth and want the user to see details on why access failed.

Definition at line 284 of file DefaultSettings.php.

$wgImgAuthPublicTest = true

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.

Definition at line 291 of file DefaultSettings.php.

$wgImplicitGroups = array( '*', 'user', 'autoconfirmed' )

Implicit groups, aren't shown on Special:Listusers or somewhere else.

Definition at line 3592 of file DefaultSettings.php.

Referenced by SpecialListGroupRights\execute(), SpecialStatistics\getGroupStats(), and User\getImplicitGroups().

$wgImportSources = array()

List of interwiki prefixes for wikis we'll accept as sources for Special:Import (for sysops).

Since complete page history can be imported, these should be 'trusted'.

If a user has the 'import' permission but not the 'importupload' permission, they will only be able to run imports through this transwiki interface.

Definition at line 4763 of file DefaultSettings.php.

Referenced by SpecialImport\doImport(), ApiImport\getAllowedParams(), and SpecialImport\showForm().

$wgImportTargetNamespace = null

Optional default target namespace for interwiki imports.

Can use this to create an incoming "transwiki"-style queue. Set to numeric key, not the name.

Users may override this in the Special:Import dialog.

Definition at line 4772 of file DefaultSettings.php.

Referenced by SpecialImport\__construct().

$wgIncludeLegacyJavaScript = true

Whether to include the mediawiki.legacy JS library (old wikibits.js), and its dependencies.

Definition at line 2624 of file DefaultSettings.php.

Referenced by OutputPage\addDefaultModules().

$wgInternalServer = false

Internal server name as known to Squid, if different.

Example: $wgInternalServer = 'http://yourinternal.tld:8000';

Definition at line 1828 of file DefaultSettings.php.

Referenced by Title\getInternalURL(), and wfExpandUrl().

$wgInterwikiCache = false

Interwiki caching settings.

$wgInterwikiCache specifies path to constant database file This cdb database is generated by dumpInterwiki from maintenance and has such key formats: dbname:key - a simple key (e.g. enwiki:meta) _sitename:key - site-scope key (e.g. wiktionary:meta) __global:key - global-scope key (e.g. __global:meta) __sites:dbname - site mapping (e.g. __sites:enwiki) Sites mapping just specifies site name, other keys provide "local url" data layout. $wgInterwikiScopes specify number of domains to check for messages: 1 - Just wiki(db)-level 2 - wiki and global levels 3 - site levels $wgInterwikiFallbackSite - if unable to resolve from cache

Definition at line 2814 of file DefaultSettings.php.

Referenced by Interwiki\fetch(), Interwiki\getAllPrefixes(), Interwiki\getAllPrefixesCached(), and Interwiki\getInterwikiCacheEntry().

$wgInterwikiExpiry = 10800

Expiry time for cache of interwiki table.

Definition at line 2796 of file DefaultSettings.php.

Referenced by Interwiki\load().

$wgInterwikiFallbackSite = 'wiki'

Name of the project namespace.

If left set to false, $wgSitename will be used instead.

Definition at line 2816 of file DefaultSettings.php.

Referenced by Interwiki\getAllPrefixesCached(), and Interwiki\getInterwikiCacheEntry().

$wgInterwikiMagic = true

Treat language links as magic connectors, not inline links.

Definition at line 1906 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgInterwikiScopes = 3

Name of the project namespace.

If left set to false, $wgSitename will be used instead.

Definition at line 2815 of file DefaultSettings.php.

Referenced by Interwiki\getAllPrefixesCached(), and Interwiki\getInterwikiCacheEntry().

$wgInvalidateCacheOnLocalSettingsChange = true

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.

Definition at line 1784 of file DefaultSettings.php.

$wgInvalidRedirectTargets = array( 'Filepath', 'Mypage', 'Mytalk' )

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.

Definition at line 2893 of file DefaultSettings.php.

Referenced by Title\isValidRedirectTarget().

$wgInvalidUsernameCharacters = '@'

Characters to prevent during new account creations.

This is used in a regular expression character class during registration (regex metacharacters like / are escaped).

Definition at line 3306 of file DefaultSettings.php.

Referenced by User\isCreatableName().

$wgJavaScriptTestConfig
Initial value:
 array(
        'qunit' => array(
                'documentation' => '//www.mediawiki.org/wiki/Manual:JavaScript_unit_testing',
        ),
)

Configuration for javascript testing.

Definition at line 4240 of file DefaultSettings.php.

Referenced by SpecialJavaScriptTest\initQUnitTesting().

$wgJobClasses
Initial value:
 array(
        'refreshLinks' => 'RefreshLinksJob',
        'refreshLinks2' => 'RefreshLinksJob2',
        'htmlCacheUpdate' => 'HTMLCacheUpdateJob',
        'html_cache_update' => 'HTMLCacheUpdateJob', 
        'sendMail' => 'EmaillingJob',
        'enotifNotify' => 'EnotifNotifyJob',
        'fixDoubleRedirect' => 'DoubleRedirectJob',
        'uploadFromUrl' => 'UploadFromUrlJob',
)

Maps jobs to their handling classes; extensions can add to this to provide custom jobs.

Definition at line 4925 of file DefaultSettings.php.

Referenced by Job\factory().

$wgJobRunRate = 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.

Definition at line 5620 of file DefaultSettings.php.

Referenced by MediaWiki\doJobs().

$wgJobTypesExcludedFromDefaultQueue = array()

Jobs that must be explicitly requested, i.e.

aren't run by job runners unless special flags are set.

These can be:

  • Very long-running jobs.
  • Jobs that you would never want to run as part of a page rendering request.
  • Jobs that you want to run on specialized machines ( like transcoding, or a particular machine on your cluster has 'outside' web access you could restrict uploadFromUrl )

Definition at line 4946 of file DefaultSettings.php.

Referenced by Job\pop().

$wgJsMimeType = 'text/javascript'

The content type used in script tags.

This is mostly going to be ignored if $wgHtml5 is true, at least for actual HTML output, since HTML5 doesn't require a MIME type for JavaScript or CSS (those are the default script and style languages).

Definition at line 2206 of file DefaultSettings.php.

Referenced by RawAction\getContentType(), Html\inlineScript(), Html\linkedScript(), RawAction\onView(), and SkinTemplate\outputPage().

$wgLBFactoryConf = array( 'class' => 'LBFactory_Simple' )

Load balancer factory configuration To set up a multi-master wiki farm, set the class here to something that can return a LoadBalancer with an appropriate master on a call to getMainLB().

The class identified here is responsible for reading $wgDBservers, $wgDBserver, etc., so overriding it may cause those globals to be ignored.

The LBFactory_Multi class is provided for this purpose, please see includes/db/LBFactory_Multi.php for configuration information.

Definition at line 1334 of file DefaultSettings.php.

Referenced by LBFactory\disableBackend(), Maintenance\finalSetup(), and LBFactory\singleton().

$wgLegacyEncoding = 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 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.

Definition at line 1988 of file DefaultSettings.php.

Referenced by User\checkPassword(), and Revision\getRevisionText().

$wgLegacyJavaScriptGlobals = true

Whether or not to assing configuration variables to the global window object.

If this is set to false, old code using deprecated variables like: " if ( window.wgRestrictionEdit ) ..." or: " if ( wgIsArticle ) ..." will no longer work and needs to use mw.config instead. For example: " if ( mw.config.exists('wgRestrictionEdit') )" or " if ( mw.config.get('wgIsArticle') )".

Definition at line 2650 of file DefaultSettings.php.

Referenced by ResourceLoaderStartUpModule\getScript().

$wgLegacySchemaConversion = false

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'.

This will speed up the conversion step for large sites, but requires that the cur table be kept around for those revisions to remain viewable.

maintenance/migrateCurStubs.php can be used to complete the migration in the background once the wiki is back online.

This option affects the updaters *only*. Any present cur stub revisions will be readable at runtime regardless of this setting.

Definition at line 2046 of file DefaultSettings.php.

Referenced by MysqlUpdater\doSchemaRestructuring().

$wgLegalTitleChars = " %!\"$&'()*,\\-.\\/0-9:;=?@A-Z\\\\^_`a-z~\\x80-\\xFF+"

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

Definition at line 2786 of file DefaultSettings.php.

Referenced by ImageCleanup\buildSafeTitle(), Title\legalChars(), Title\newFromURL(), and Parser\pstPass2().

$wgLicenseTerms = false

Set to an array of metadata terms.

Else they will be loaded based on $wgRightsUrl

Definition at line 4724 of file DefaultSettings.php.

Referenced by RdfMetaData\getTerms().

$wgLinkHolderBatchSize = 1000

LinkHolderArray batch size For debugging.

Definition at line 5704 of file DefaultSettings.php.

Referenced by LinkHolderArray\isBig().

$wgLoadFileinfoExtension = false

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 library.

Definition at line 895 of file DefaultSettings.php.

Referenced by MimeMagic\__construct().

$wgLoadScript = false

The URL path to load.php.

Defaults to "{$wgScriptPath}/load{$wgScriptExtension}".

Definition at line 133 of file DefaultSettings.php.

Referenced by ResourceLoader\__construct(), ResourceLoaderStartUpModule\getConfig(), ResourceLoaderStartUpModule\getScript(), and ResourceLoader\makeLoaderURL().

$wgLocalDatabases = array()

Other wikis on this site, can be administered from a single developer account.

Array numeric key => database name

Definition at line 1377 of file DefaultSettings.php.

Referenced by RebuildMessages\execute(), clear_stats\execute(), CleanupSpam\execute(), ClearInterwikiCache\execute(), nextJobDB\getPendingDbs(), and UserRightsProxy\validDatabase().

$wgLocalFileRepo = false

File repository structures.

$wgLocalFileRepo is a single repository structure, and $wgForeignFileRepos is an array of such structures. Each repository structure is an associative 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. The core repository classes are FileRepo, LocalRepo, ForeignDBRepo. FSRepo is also supported for backwards compatibility.
  • name A unique name for the repository (but $wgLocalFileRepo should be 'local'). The name should consist of alpha-numberic characters.
  • backend A file backend name (see $wgFileBackends).

For most core repos:

  • zones Associative array of zone names that each map to an array with: container : backend container name the zone is in directory : root path within container for the zone Zones default to using <repo name>="">-<zone> as the container name and the container root as the zone directory.
  • 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], 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 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 is 0644.
  • 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.

These settings describe a foreign MediaWiki installation. They are optional, and will be ignored for local repositories:

  • 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 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

ForeignAPIRepo:

  • apibase Use for the foreign API's URL
  • apiThumbCacheExpiry How long to locally cache thumbs for

If you leave $wgLocalFileRepo set to false, Setup will fill in appropriate values. Otherwise, set $wgLocalFileRepo to a repository structure as described above. If you set $wgUseInstantCommons to true, it will add an entry for Commons. If you set $wgForeignFileRepos to an array of repostory structures, those will be searched after the local file repo. Otherwise, you will only have access to local media files.

See also:
Setup.php for an example usage and default initialization.

Definition at line 367 of file DefaultSettings.php.

Referenced by ForeignAPIRepo\__construct(), FileBackendGroup\initFromGlobals(), ParserTest\setUp(), and RepoGroup\singleton().

$wgLocalInterwiki = false

The interwiki prefix of the current wiki, or false if it doesn't have one.

Definition at line 2791 of file DefaultSettings.php.

Referenced by RecentChange\getIRCLine(), RecentChange\save(), and Title\secureAndSplit().

$wgLocalisationCacheConf
Initial value:
 array(
        'class' => 'LocalisationCache',
        'store' => 'detect',
        'storeClass' => false,
        'storeDirectory' => false,
        'manualRecache' => false,
)

Localisation cache configuration.

Associative array with keys: class: The class to use. May be overridden by extensions.

store: The location to store cache data. May be 'files', 'db' or 'detect'. If set to "files", data will be in CDB files. If set to "db", data will be stored to the database. If set to "detect", files will be used if $wgCacheDirectory is set, otherwise the database will be used.

storeClass: The class name for the underlying storage. If set to a class name, it overrides the "store" setting.

storeDirectory: If the store class puts its data in files, this is the directory it will use. If this is false, $wgCacheDirectory will be used.

manualRecache: Set this to true to disable cache updates on web requests. Use maintenance/rebuildLocalisationCache.php instead.

Definition at line 1669 of file DefaultSettings.php.

Referenced by UpdateMediaWiki\afterFinalSetup(), DatabaseUpdater\doUpdates(), RebuildLocalisationCache\execute(), PHPUnitMaintClass\finalSetup(), DumpIterator\finalSetup(), and Language\getLocalisationCache().

$wgLocalMessageCacheSerialized = true

Defines format of local cache true - Serialized object false - PHP source file (Warning - security risk)

Definition at line 1640 of file DefaultSettings.php.

Referenced by MessageCache\loadFromLocal(), and MessageCache\saveToCaches().

$wgLocalStylePath = false

The URL path of the skins directory.

Should not point to an external domain. Defaults to "{$wgScriptPath}/skins".

Definition at line 166 of file DefaultSettings.php.

Referenced by SkinVector\initPage().

$wgLocaltimezone = null

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: $wgLocaltimezone = 'GMT'; $wgLocaltimezone = 'PST8PDT'; $wgLocaltimezone = 'Europe/Sweden'; $wgLocaltimezone = 'CET';

Definition at line 2166 of file DefaultSettings.php.

Referenced by PHPUnitMaintClass\finalSetup(), Preferences\getTimezoneOptions(), Parser\getVariableValue(), Parser\pstPass2(), and TitlePermissionTest\setUp().

$wgLocalTZoffset = 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.

By default, this will be set to match $wgLocaltimezone.

Definition at line 2177 of file DefaultSettings.php.

Referenced by Preferences\getTimezoneOptions(), TimeAdjustTest\setUp(), TitlePermissionTest\setUp(), TimeAdjustTest\tearDown(), TimeAdjustTest\testUserAdjust(), TitlePermissionTest\testUserBlock(), and Language\userAdjust().

$wgLockManagers = array()

Array of configuration arrays for each lock manager.

Each backend configuration has the following parameters: 'name' : A unique name for the lock manger 'class' : The lock manger class to use Additional parameters are specific to the class used.

Definition at line 398 of file DefaultSettings.php.

Referenced by LockManagerGroup\initFromGlobals().

$wgLogActions
Initial value:
 array(
        'block/block'        => 'blocklogentry',
        'block/unblock'      => 'unblocklogentry',
        'block/reblock'      => 'reblock-logentry',
        'protect/protect'    => 'protectedarticle',
        'protect/modify'     => 'modifiedarticleprotection',
        'protect/unprotect'  => 'unprotectedarticle',
        'protect/move_prot'  => 'movedarticleprotection',
        'rights/rights'      => 'rightslogentry',
        'rights/autopromote' => 'rightslogentry-autopromote',
        'upload/upload'      => 'uploadedimage',
        'upload/overwrite'   => 'overwroteimage',
        'upload/revert'      => 'uploadedimage',
        'import/upload'      => 'import-logentry-upload',
        'import/interwiki'   => 'import-logentry-interwiki',
        'merge/merge'        => 'pagemerge-logentry',
        'suppress/block'     => 'blocklogentry',
        'suppress/reblock'   => 'reblock-logentry',
)

Lists the message key string for formatting individual events of each type and action when listed in the logs.

Extensions with custom log types may add to this array.

Definition at line 5140 of file DefaultSettings.php.

Referenced by LogPage\actionText(), and ApiQueryLogEvents\getAllowedParams().

$wgLogActionsHandlers
Initial value:
 array(
        
        'move/*'            => 'MoveLogFormatter',
        
        'delete/*'          => 'DeleteLogFormatter',
        'suppress/revision' => 'DeleteLogFormatter',
        'suppress/event'    => 'DeleteLogFormatter',
        'suppress/delete'   => 'DeleteLogFormatter',
        'patrol/patrol'     => 'PatrolLogFormatter',
)

The same as above, but here values are names of functions, not messages.

See also:
LogPage::actionText
LogFormatter

Definition at line 5166 of file DefaultSettings.php.

Referenced by LogPage\actionText(), and LogFormatter\newFromEntry().

$wgLogHeaders
Initial value:
 array(
        ''        => 'alllogstext',
        'block'   => 'blocklogtext',
        'protect' => 'protectlogtext',
        'rights'  => 'rightslogtext',
        'delete'  => 'dellogpagetext',
        'upload'  => 'uploadlogpagetext',
        'move'    => 'movelogpagetext',
        'import'  => 'importlogpagetext',
        'patrol'  => 'patrol-log-header',
        'merge'   => 'mergelogpagetext',
        'suppress' => 'suppressionlogtext',
)

Lists the message key string for descriptive text to be shown at the top of each log type.

Extensions with custom log types may add to this array.

Since 1.19, if you follow the naming convention log-description-TYPE, where TYPE is your log type, yoy don't need to use this array.

Definition at line 5120 of file DefaultSettings.php.

Referenced by LogPage\getDescription(), and LogPage\logHeader().

$wgLoginLanguageSelector = false

Show a bar of language selection links in the user login and user registration forms; edit the "loginlanguagelinks" message to customise these.

Definition at line 2128 of file DefaultSettings.php.

Referenced by LoginForm\addNewAccount(), and LoginForm\mainLoginForm().

$wgLogNames
Initial value:
 array(
        ''        => 'all-logs-page',
        'block'   => 'blocklogpage',
        'protect' => 'protectlogpage',
        'rights'  => 'rightslog',
        'delete'  => 'dellogpage',
        'upload'  => 'uploadlogpage',
        'move'    => 'movelogpage',
        'import'  => 'importlogpage',
        'patrol'  => 'patrol-log-page',
        'merge'   => 'mergelog',
        'suppress' => 'suppressionlog',
)

Lists the message key string for each log type.

The localized messages will be listed in the user interface.

Extensions with custom log types may add to this array.

Since 1.19, if you follow the naming convention log-name-TYPE, where TYPE is your log type, yoy don't need to use this array.

Definition at line 5097 of file DefaultSettings.php.

Referenced by LogPage\getName(), and LogPage\logName().

$wgLogo = false

The URL path of the wiki logo.

The logo size should be 135x135 pixels. Will default to "{$wgStylePath}/common/images/wiki.png" in Setup.php

Definition at line 208 of file DefaultSettings.php.

Referenced by Skin\getLogo(), and SkinTemplate\outputPage().

$wgLogRestrictions
Initial value:
 array(
        'suppress' => 'suppressionlog'
)

This restricts log access to those who have a certain right Users without this will not see it in the option menu and can not view it Restricted logs are not added to recent changes Logs should remain non-transcludable Format: logtype => permissiontype.

Definition at line 5060 of file DefaultSettings.php.

Referenced by SpecialLog\execute(), LogEventsList\getExcludeClause(), LogPage\getRestriction(), LogPager\limitType(), RecentChange\notifyLog(), RebuildRecentchanges\rebuildRecentChangesTablePass3(), and LogPage\saveContent().

$wgLogTypes
Initial value:
 array(
        '',
        'block',
        'protect',
        'rights',
        'delete',
        'upload',
        'move',
        'import',
        'patrol',
        'merge',
        'suppress',
)

The logging system has two levels: an event type, which describes the general category and can be viewed as a named subset of all logs; and an action, which is a specific kind of event that can exist in that log type.

Definition at line 5039 of file DefaultSettings.php.

Referenced by ApiQueryLogEvents\getAllowedParams(), SpecialLog\parseParams(), RebuildRecentchanges\rebuildRecentChangesTablePass3(), and LogPage\validTypes().

$wgMainCacheType = CACHE_NONE

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: 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.
  • (other): A string may be used which identifies a cache configuration in $wgObjectCaches.
See also:
$wgMessageCacheType, $wgParserCacheType

Definition at line 1536 of file DefaultSettings.php.

Referenced by PHPUnitMaintClass\finalSetup(), ForkController\initChild(), ObjectCache\newAnything(), ParserTest\setUp(), and wfGetMainCache().

$wgMaintenanceScripts = array()

Array for extensions to register their maintenance scripts with the system.

The key is the name of the class and the value is the full path to the file

Definition at line 4501 of file DefaultSettings.php.

Referenced by Maintenance\getMaintenanceScripts().

$wgMasterWaitTimeout = 10

How long to wait for a slave to catch up to the master.

Definition at line 1337 of file DefaultSettings.php.

Referenced by LBFactory_Multi\newLoadBalancer(), and LBFactory_Simple\newMainLB().

$wgMaxAnimatedGifArea = 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.

Definition at line 741 of file DefaultSettings.php.

Referenced by BitmapHandler\transformImageMagick(), and BitmapHandler\transformImageMagickExt().

$wgMaxCredits = 0

Set this to the number of authors that you want to be credited below an article text.

Set it to zero to hide the attribution block, and a negative number (like -1) to show all authors. Note that this will require 2-3 extra database hits, which can have a not insignificant impact on performance for large wikis.

Definition at line 4742 of file DefaultSettings.php.

Referenced by SkinTemplate\outputPage().

$wgMaxImageArea = 1.25e7

The maximum number of pixels a source image can have if it is to be scaled down by a scaler that requires the full source image to be decompressed and stored in decompressed form, before the thumbnail is generated.

This provides a limit on memory usage for the decompression side of the image scaler. The limit is used when scaling PNGs with any of the built-in image scalers, such as ImageMagick or GD. It is ignored for JPEGs with ImageMagick, and when using the VipsScaler extension.

The default is 50 MB if decompressed to RGBA form, which corresponds to 12.5 million pixels or 3500x3500.

Definition at line 734 of file DefaultSettings.php.

Referenced by BitmapHandler\normaliseParams(), BitmapScalingTest\setUp(), and BitmapScalingTest\tearDown().

$wgMaximumMovedPages = 100

Maximum number of pages to move at once when moving subpages with a page.

Definition at line 5715 of file DefaultSettings.php.

Referenced by MovePageForm\doSubmit(), Title\moveSubpages(), and MovePageForm\showForm().

$wgMaxMsgCacheEntrySize = 10000

Maximum entry size in the message cache, in bytes.

Definition at line 2078 of file DefaultSettings.php.

Referenced by MessageCache\loadFromDB(), and MessageCache\replace().

$wgMaxNameChars = 255

Maximum number of bytes in username.

You want to run the maintenance script ./maintenance/checkUsernames.php once you have changed this value.

Definition at line 3201 of file DefaultSettings.php.

Referenced by User\isValidUserName().

$wgMaxPPExpandDepth = 40
See also:
$wgMaxTemplateDepth

Definition at line 2946 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgMaxPPNodeCount = 1000000

A complexity limit on template expansion.

Definition at line 2935 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgMaxRedirectLinksRetrieved = 500

Maximum number of links to a redirect page listed on Special:Whatlinkshere/RedirectDestination.

Definition at line 5321 of file DefaultSettings.php.

Referenced by SpecialWhatLinksHere\showIndirectLinks().

$wgMaxRedirects = 1

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.

Definition at line 2881 of file DefaultSettings.php.

Referenced by Title\newFromRedirectArray(), and Title\newFromRedirectInternal().

$wgMaxShellFileSize = 102400

Maximum file size created by shell processes under linux, in KB ImageMagick convert for example can be fairly hungry for scratch space.

Definition at line 5565 of file DefaultSettings.php.

Referenced by wfShellExec().

$wgMaxShellMemory = 102400

Maximum amount of virtual memory available to shell processes under linux, in KB.

Definition at line 5559 of file DefaultSettings.php.

Referenced by wfShellExec().

$wgMaxShellTime = 180

Maximum CPU time in seconds for shell processes under linux.

Definition at line 5570 of file DefaultSettings.php.

Referenced by wfShellExec().

$wgMaxSigChars = 255

Maximum number of Unicode characters in signature.

Definition at line 3195 of file DefaultSettings.php.

Referenced by PPFuzzTest\__construct(), Parser\getUserSig(), Preferences\profilePreferences(), and Preferences\validateSignature().

$wgMaxSquidPurgeTitles = 400

Maximum number of titles to purge in any one client operation.

Definition at line 1860 of file DefaultSettings.php.

Referenced by SquidUpdate\__construct(), SquidUpdate\newFromLinksTo(), and SquidUpdate\newFromTitles().

$wgMaxTemplateDepth = 40

Maximum recursion depth for templates within templates.

The current parser adds two levels to the PHP call stack for each template, and xdebug limits the call stack to 100 by default. So this should hopefully stop the parser before it hits the xdebug limit.

Definition at line 2943 of file DefaultSettings.php.

Referenced by ParserOptions\initialiseFromUser().

$wgMaxTocLevel = 999

Maximum indent level of toc.

Definition at line 2930 of file DefaultSettings.php.

Referenced by Parser\formatHeadings().

$wgMaxUploadSize = 1024*1024*100

Max size for uploads, in bytes.

If not set to an array, applies to all uploads. If set to an array, per upload type maximums can be set, using the file and url keys. If the * key is set this value will be used as maximum for non-specified types.

For example: $wgMaxUploadSize = array( '*' => 250 * 1024, 'url' => 500 * 1024, ); Sets the maximum for all uploads to 250 kB except for upload-by-url, which will have a maximum of 500 kB.

Definition at line 472 of file DefaultSettings.php.

Referenced by UploadBase\getMaxUploadSize(), and UploadTest\testMaxUploadSize().

$wgMediaHandlers
Initial value:
 array(
        'image/jpeg' => 'JpegHandler',
        'image/png' => 'PNGHandler',
        'image/gif' => 'GIFHandler',
        'image/tiff' => 'TiffHandler',
        'image/x-ms-bmp' => 'BmpHandler',
        'image/x-bmp' => 'BmpHandler',
        'image/x-xcf' => 'XCFHandler',
        'image/svg+xml' => 'SvgHandler', 
        'image/svg' => 'SvgHandler', 
        'image/vnd.djvu' => 'DjVuHandler', 
        'image/x.djvu' => 'DjVuHandler', 
        'image/x-djvu' => 'DjVuHandler', 
)

Plugins for media file type handling.

Each entry in the array maps a MIME type to a class name

Definition at line 624 of file DefaultSettings.php.

Referenced by MediaHandler\getHandler().

$wgMemCachedDebug = false

If enabled, will send MemCached debugging information to $wgDebugLogFile.

Definition at line 1613 of file DefaultSettings.php.

$wgMemCachedPersistent = false

Use persistent connections to MemCached, which are shared across multiple requests.

Definition at line 1622 of file DefaultSettings.php.

$wgMemCachedServers = array( '127.0.0.1:11000' )

The list of MemCached servers and port numbers.

Definition at line 1616 of file DefaultSettings.php.

Referenced by mcTest\execute().

$wgMemCachedTimeout = 100000

Read/write timeout for MemCached server communication, in microseconds.

Definition at line 1627 of file DefaultSettings.php.

$wgMemoryLimit = "50M"

The minimum amount of memory that MediaWiki "needs"; MediaWiki will try to raise PHP's memory limit if it's below this amount.

Definition at line 1497 of file DefaultSettings.php.

Referenced by wfMemoryLimit().

$wgMessageCacheType = CACHE_ANYTHING

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.

Definition at line 1544 of file DefaultSettings.php.

Referenced by PHPUnitMaintClass\finalSetup(), ObjectCache\newAnything(), ParserTest\setUp(), and wfGetMessageCacheStorage().

$wgMetaNamespace = false

Name of the project namespace.

If left set to false, $wgSitename will be used instead.

Definition at line 2703 of file DefaultSettings.php.

Referenced by Language\fixVariableInNamespace(), Language\getNamespaces(), ApiQueryTest\testTitlesGetNormalized(), and wfInstallerMain().

$wgMetaNamespaceTalk = 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.

Definition at line 2712 of file DefaultSettings.php.

Referenced by Language\getNamespaces().

$wgMimeDetectorCommand = null

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: $wgMimeDetectorCommand = "file -bi"; # use external mime detector (Linux)

Definition at line 906 of file DefaultSettings.php.

Referenced by MimeMagic\detectMimeType().

$wgMimeInfoFile = "includes/mime.info"

Sets the mime type info file to use by MimeMagic.php.

Definition at line 887 of file DefaultSettings.php.

Referenced by MimeMagic\__construct().

$wgMimeType = 'text/html'
$wgMimeTypeBlacklist
Initial value:
 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',
)

Files with these mime types will never be allowed as uploads if $wgVerifyMimeType is enabled.

Definition at line 556 of file DefaultSettings.php.

Referenced by StreamFile\contentTypeFromPath(), and UploadBase\verifyMimeType().

$wgMimeTypeFile = "includes/mime.types"

Sets the mime type definition file to use by MimeMagic.php.

Definition at line 882 of file DefaultSettings.php.

Referenced by MimeMagic\__construct().

$wgMinimalPasswordLength = 1

Specifies the minimal length of a user password.

If set to 0, empty pass- words are allowed.

Definition at line 3179 of file DefaultSettings.php.

Referenced by LoginForm\addNewAccountInternal(), User\getPasswordValidity(), User\passwordChangeInputAttribs(), User\randomPassword(), and User\setPassword().

$wgMsgCacheExpiry = 86400

Expiry time for the message cache key.

Definition at line 2073 of file DefaultSettings.php.

Referenced by MessageCache\singleton().

$wgMWSuggestTemplate = false

Template for internal MediaWiki suggestion engine, defaults to API action=opensearch.

Placeholders: {searchTerms}, {namespaces}, {dbname}

Definition at line 4334 of file DefaultSettings.php.

Referenced by SearchEngine\getMWSuggestTemplate().

$wgNamespaceAliases = 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, );

Definition at line 2758 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendNamespaceAliases(), NamespaceConflictChecker\checkAll(), Language\getNamespaceIds(), UploadFromUrlTestSuite\setUp(), NewParserTest\setUp(), ParserTest\setUp(), and NewParserTest\tearDown().

$wgNamespaceProtection = array()

Set the minimum permissions required to edit pages in each namespace.

If you list more than one permission, a user must have all of them to edit pages in that namespace.

Note: NS_MEDIAWIKI is implicitly restricted to editinterface.

Definition at line 3645 of file DefaultSettings.php.

Referenced by Title\isNamespaceProtected(), UploadFromUrlTestSuite\setUp(), NewParserTest\setUp(), ParserTest\setUp(), NewParserTest\tearDown(), and TitlePermissionTest\testSpecialsAndNSPermissions().

$wgNamespaceRobotPolicies = array()

Robot policies per namespaces.

The default policy is given above, the array is made of namespace constants as defined in includes/Defines.php. You can- not specify a different default policy for NS_SPECIAL: it is always noindex, nofollow. This is because a number of special pages (e.g., ListPages) have many permutations of options that display the same data under redundant URLs, so search engine spiders risk getting lost in a maze of twisty special pages, all alike, and never reaching your actual content.

Example: $wgNamespaceRobotPolicies = array( NS_TALK => 'noindex' );

Definition at line 5399 of file DefaultSettings.php.

Referenced by Article\getRobotPolicy().

$wgNamespacesToBeSearchedDefault
Initial value:
 array(
        NS_MAIN => true,
)

List of namespaces which are searched by default.

Example:

$wgNamespacesToBeSearchedDefault[NS_MAIN] = true; $wgNamespacesToBeSearchedDefault[NS_PROJECT] = true;

Definition at line 4350 of file DefaultSettings.php.

Referenced by SearchEngine\defaultNamespaces(), and User\getDefaultOptions().

$wgNamespacesToBeSearchedHelp
Initial value:
 array(
        NS_PROJECT => true,
        NS_HELP    => true,
)

Namespaces to be searched when user clicks the "Help" tab on Special:Search.

Same format as $wgNamespacesToBeSearchedDefault

Definition at line 4360 of file DefaultSettings.php.

Referenced by SearchEngine\helpNamespaces().

$wgNamespacesWithSubpages
Initial value:
 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 should support subpages? See Language.php for a list of namespaces.

Definition at line 2855 of file DefaultSettings.php.

Referenced by MWNamespace\hasSubpages(), and MWNamespaceTest\testHasSubpages().

$wgNewPasswordExpiry = 3600 * 24 * 7

The time, in seconds, when an emailed temporary password expires.

Definition at line 1094 of file DefaultSettings.php.

Referenced by User\checkTemporaryPassword(), LoginForm\mailPasswordInternal(), and SpecialPasswordReset\onSubmit().

$wgNewUserLog = true

Maintain a log of newusers at Log/newusers?

Definition at line 5180 of file DefaultSettings.php.

Referenced by User\addNewUserLogEntry(), and User\addNewUserLogEntryAutoCreate().

$wgNoFollowDomainExceptions = 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:

$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.

Definition at line 3078 of file DefaultSettings.php.

Referenced by Skin\addToSidebarPlain(), and Parser\getExternalLinkAttribs().

$wgNoFollowLinks = true

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.

Definition at line 3059 of file DefaultSettings.php.

Referenced by Skin\addToSidebarPlain(), Parser\getExternalLinkAttribs(), and SideBarTest\testRespectWgnofollowlinks().

$wgNoFollowNsExceptions = array()

Namespaces in which $wgNoFollowLinks doesn't apply.

See Language.php for a list of namespaces.

Definition at line 3065 of file DefaultSettings.php.

Referenced by Parser\getExternalLinkAttribs().

$wgNonincludableNamespaces = array()

Pages in namespaces in this array can not be used as templates.

Elements must be numeric namespace ids. Among other things, this may be useful to enforce read-restrictions which may otherwise be bypassed by using the template machanism.

Definition at line 3653 of file DefaultSettings.php.

Referenced by Parser\braceSubstitution().

$wgNoReplyAddress = '[email protected]'

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.

Definition at line 1060 of file DefaultSettings.php.

Referenced by EmailNotification\composeCommonMailtext().

$wgObjectCaches
Initial value:
 array(
        CACHE_NONE => array( 'class' => 'EmptyBagOStuff' ),
        CACHE_DB => array( 'class' => 'SqlBagOStuff', 'table' => 'objectcache' ),
        CACHE_DBA => array( 'class' => 'DBABagOStuff' ),

        CACHE_ANYTHING => array( 'factory' => 'ObjectCache::newAnything' ),
        CACHE_ACCEL => array( 'factory' => 'ObjectCache::newAccelerator' ),
        CACHE_MEMCACHED => array( 'factory' => 'ObjectCache::newMemcached' ),

        'apc' => array( 'class' => 'APCBagOStuff' ),
        'xcache' => array( 'class' => 'XCacheBagOStuff' ),
        'wincache' => array( 'class' => 'WinCacheBagOStuff' ),
        'memcached-php' => array( 'class' => 'MemcachedPhpBagOStuff' ),
        'hash' => array( 'class' => 'HashBagOStuff' ),
)

Advanced object cache configuration.

Use this to define the class names and constructor parameters which are used for the various cache types. Custom cache types may be defined here and referenced from $wgMainCacheType, $wgMessageCacheType or $wgParserCacheType.

The format is an associative array where the key is a cache identifier, and the value is an associative array of parameters. The "class" parameter is the class name which will be used. Alternatively, a "factory" parameter may be given, giving a callable function which will generate a suitable cache object.

The other parameters are dependent on the class used.

  • CACHE_DBA uses $wgTmpDirectory by default. The 'dir' parameter let you overrides that.

Definition at line 1570 of file DefaultSettings.php.

Referenced by ObjectCache\newFromId().

$wgOldChangeTagsIndex = false
$wgOpenSearchTemplate = false

Template for OpenSearch suggestions, defaults to API action=opensearch.

Sites with heavy load would tipically have these point to a custom PHP wrapper to avoid firing up mediawiki for every keystroke

Placeholders: {searchTerms}

Definition at line 4307 of file DefaultSettings.php.

Referenced by SearchEngine\getOpenSearchTemplate().

$wgOverrideSiteFeed = array()

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'.

Definition at line 4633 of file DefaultSettings.php.

Referenced by OutputPage\getHeadLinks().

$wgPagePropLinkInvalidations
Initial value:
 array(
        'hiddencat' => 'categorylinks',
)

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.

Definition at line 4972 of file DefaultSettings.php.

Referenced by LinksUpdate\invalidateProperties().

$wgPageShowWatchingUsers = false

Show watching users in Page views.

Definition at line 4654 of file DefaultSettings.php.

Referenced by SkinTemplate\outputPage().

$wgParserCacheExpireTime = 86400

The expiry time for the parser cache, in seconds.

The default is 86.4k seconds, otherwise known as a day.

Definition at line 1590 of file DefaultSettings.php.

Referenced by PurgeParserCache\execute(), and CacheTime\getCacheExpiry().

$wgParserCacheType = 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.

Definition at line 1552 of file DefaultSettings.php.

Referenced by PHPUnitMaintClass\finalSetup(), ObjectCache\newAnything(), ParserTest\setUp(), and wfGetParserCacheStorage().

$wgParserConf
Initial value:
 array(
        'class' => 'Parser',
        #'preprocessorClass' => 'Preprocessor_Hash',
)

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.

Definition at line 2924 of file DefaultSettings.php.

Referenced by PreprocessDump\checkOptions(), DumpRenderer\execute(), ParserTest\getParser(), NewParserTest\getParser(), MessageCache\getParser(), DumpRenderer\handleRevision(), CLIParser\initParser(), PreprocessorTest\setUp(), UploadFromUrlTestSuite\setUp(), ParserTest\setUp(), TagHookTest\testBadFunctionTagHooks(), TagHookTest\testBadTagHooks(), TagHookTest\testFunctionTagHooks(), and TagHookTest\testTagHooks().

$wgParserOutputHooks = array()

Parser output hooks.

This is an associative array where the key is an extension-defined tag (typically the extension name), and the value is a PHP callback. These will be called as an OutputPageParserOutput hook, if the relevant tag has been registered with the parser output object.

Registration is done with $pout->addOutputHook( $tag, $data ).

The callback has the form: function outputHook( $outputPage, $parserOutput, $data ) { ... }

Definition at line 4857 of file DefaultSettings.php.

Referenced by OutputPage\addParserOutputNoText().

$wgParserTestFiles
Initial value:
 array(
        "$IP/tests/parser/parserTests.txt",
        "$IP/tests/parser/extraParserTests.txt"
)

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.

Definition at line 4212 of file DefaultSettings.php.

Referenced by NewParserTest\parserTestProvider(), MediaWikiParserTest\suite(), and NewParserTest\testFuzzTests().

$wgParserTestRemote = false

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 );

Definition at line 4230 of file DefaultSettings.php.

$wgPasswordAttemptThrottle = array( 'count' => 5, 'seconds' => 300 )

Limit password attempts to X attempts per Y seconds per IP per account.

Requires memcached.

Definition at line 3901 of file DefaultSettings.php.

Referenced by ApiLogin\execute(), and LoginForm\incLoginThrottle().

$wgPasswordReminderResendTime = 24

Minimum time, in hours, which must elapse between password reminder emails for a given account.

This is to prevent abuse by mail flooding.

Definition at line 1089 of file DefaultSettings.php.

Referenced by User\isPasswordReminderThrottled(), and SpecialPasswordReset\onSubmit().

$wgPasswordResetRoutes
Initial value:
 array(
        'username' => true,
        'email' => false,
)

Whether to allow password resets ("enter some identifying data, and we'll send an email with a temporary password you can use to get back into the account") identified by various bits of data.

Setting all of these to false (or the whole variable to false) has the effect of disabling password resets entirely

Definition at line 3187 of file DefaultSettings.php.

Referenced by SpecialPasswordReset\canChangePassword(), SpecialPasswordReset\getFormFields(), LoginForm\mainLoginForm(), and SpecialPasswordReset\preText().

$wgPasswordSalt = true

For compatibility with old installations set to false.

Definition at line 3173 of file DefaultSettings.php.

Referenced by User\crypt(), and User\oldCrypt().

$wgPasswordSender = 'apache@' . $serverName

Password reminder email address.

The address we should use as sender when a user is requesting his password.

Definition at line 1046 of file DefaultSettings.php.

Referenced by EmailNotification\composeCommonMailtext(), User\sendMail(), and SpecialEmailUser\submit().

$wgPasswordSenderName = 'MediaWiki Mail'

Password reminder name.

Definition at line 1053 of file DefaultSettings.php.

Referenced by EmailNotification\composeCommonMailtext(), User\sendMail(), and SpecialEmailUser\submit().

$wgPhpCli = '/usr/bin/php'

Executable path of the PHP cli binary (php/php5).

Should be set up on install.

Definition at line 5575 of file DefaultSettings.php.

Referenced by GlobalTest\provideWfShellMaintenanceCmdList(), and wfShellMaintenanceCmd().

$wgPoolCounterConf = null

Configuration for processing pool control, for use in high-traffic wikis.

An implementation is provided in the PoolCounter extension.

This configuration array maps pool types to an associative array. The only defined key in the associative array is "class", which gives the class name. The remaining elements are passed through to the class as constructor parameters. Example:

$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... );

Definition at line 5746 of file DefaultSettings.php.

Referenced by PoolCounter\factory().

$wgPreloadJavaScriptMwUtil = false

Whether to preload the mediawiki.util module as blocking module in the top queue.

Before MediaWiki 1.19, modules used to load slower/less asynchronous which allowed modules to lack dependencies on 'popular' modules that were likely loaded already. This setting is to aid scripts during migration by providing mediawiki.util unconditionally (which was the most commonly missed dependency). It doesn't cover all missing dependencies obviously but should fix most of them. This should be removed at some point after site/user scripts have been fixed. Enable this if your wiki has a large amount of user/site scripts that are lacking dependencies.

Definition at line 2637 of file DefaultSettings.php.

Referenced by OutputPage\addDefaultModules().

$wgPreprocessorCacheThreshold = 1000

Preprocessor caching threshold Setting it to 'false' will disable the preprocessor cache.

Definition at line 3101 of file DefaultSettings.php.

Referenced by PreprocessDump\checkOptions(), Preprocessor_Hash\preprocessToObj(), and Preprocessor_DOM\preprocessToObj().

$wgPreviewOnOpenNamespaces
Initial value:
 array(
        NS_CATEGORY => 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

Definition at line 4449 of file DefaultSettings.php.

Referenced by EditPage\previewOnOpen().

$wgProfileCallTree = false

If true, print a raw call tree instead of per-function report.

Definition at line 4157 of file DefaultSettings.php.

Referenced by Profiler\getOutput().

$wgProfileLimit = 0.0

Only record profiling info for pages that took longer than this.

Definition at line 4141 of file DefaultSettings.php.

Referenced by wfLogProfilingData().

$wgProfileOnly = false

Don't put non-profiling info into log file.

Definition at line 4144 of file DefaultSettings.php.

Referenced by wfDebug().

$wgProfilePerHost = false

Should application server host be put into profiling table.

Definition at line 4160 of file DefaultSettings.php.

Referenced by Profiler\logData().

$wgProfileToDatabase = false

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

Definition at line 4154 of file DefaultSettings.php.

Referenced by Profiler\logData().

$wgProxyKey = false
$wgProxyList = array()

big list of banned IP addresses, in the keys not the values

Definition at line 3929 of file DefaultSettings.php.

Referenced by User\isLocallyBlockedProxy().

$wgProxyMemcExpiry = 86400

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.

Definition at line 3925 of file DefaultSettings.php.

Referenced by wfProxyCheck().

$wgProxyPorts = array( 80, 81, 1080, 3128, 6588, 8000, 8080, 8888, 65506 )

Port we want to scan for a proxy.

Definition at line 3921 of file DefaultSettings.php.

Referenced by wfProxyCheck().

$wgProxyScriptPath = "$IP/maintenance/proxy_check.php"

Script used to scan.

Definition at line 3923 of file DefaultSettings.php.

Referenced by wfProxyCheck().

$wgProxyWhitelist = array()

Proxy whitelist, list of addresses that are assumed to be non-proxy despite what the other methods might say.

Definition at line 3841 of file DefaultSettings.php.

Referenced by User\getBlockedStatus(), and User\isDnsBlacklisted().

$wgPutIPinRC = true

Log IP addresses in the recentchanges table; can be accessed only by extensions (e.g.

CheckUser) or a DB admin

Definition at line 3889 of file DefaultSettings.php.

Referenced by RecentChange\save().

$wgQueryCacheLimit = 1000

Number of rows to cache in 'querycache' table when miser mode is on.

Definition at line 1459 of file DefaultSettings.php.

Referenced by UpdateSpecialPages\execute(), and QueryPage\execute().

$wgQueryPageDefaultLimit = 50

Integer defining default number of entries to show on special pages which are query-pages such as Special:Whatlinkshere.

Definition at line 3895 of file DefaultSettings.php.

Referenced by SpecialWhatLinksHere\execute(), and DeletedContributionsPage\execute().

$wgRateLimitLog = null

Set to a filename to log rate limiter hits.

Definition at line 3877 of file DefaultSettings.php.

Referenced by User\pingLimiter().

$wgRateLimits
Initial value:
 array(
        'edit' => array(
                'anon'   => null, 
                'user'   => null, 
                'newbie' => null, 
                'ip'     => null, 
                'subnet' => null, 
                ),
        'move' => array(
                'user'   => null,
                'newbie' => null,
                'ip'     => null,
                'subnet' => null,
                ),
        'mailpassword' => array(
                'anon' => null,
                ),
        'emailuser' => array(
                'user' => null,
                ),
        )

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.

Definition at line 3852 of file DefaultSettings.php.

Referenced by ApiQueryUserInfo\getRateLimits(), and User\pingLimiter().

$wgRateLimitsExcludedIPs = array()

Array of IPs which should be excluded from rate limits.

This may be useful for whitelisting NAT gateways for conferences, etc.

Definition at line 3883 of file DefaultSettings.php.

Referenced by User\isPingLimitable().

$wgRawHtml = false

Allow raw, unchecked HTML in <html>...</html> sections.

THIS IS VERY DANGEROUS on a publicly editable site, so USE wgGroupPermissions TO RESTRICT EDITING to only those that you trust

Definition at line 3046 of file DefaultSettings.php.

Referenced by EditPage\getPreviewText(), CoreTagHooks\html(), and CoreTagHooks\register().

$wgRC2UDPAddress = false

Send recent changes updates via UDP.

The updates will be formatted for IRC. Set this to the IP address of the receiver.

Definition at line 4567 of file DefaultSettings.php.

Referenced by RecentChange\notifyRC2UDP(), and RecentChange\sendToUDP().

$wgRC2UDPInterwikiPrefix = false

If this is set to true, $wgLocalInterwiki will be prepended to links in the IRC feed.

If this is set to a string, that string will be used as the prefix.

Definition at line 4586 of file DefaultSettings.php.

Referenced by RecentChange\getIRCLine().

$wgRC2UDPOmitBots = false

Set to true to omit "bot" edits (by users with the bot permission) from the UDP feed.

Definition at line 4592 of file DefaultSettings.php.

Referenced by RecentChange\notifyRC2UDP().

$wgRC2UDPPort = false

Port number for RC updates.

Definition at line 4572 of file DefaultSettings.php.

Referenced by RecentChange\sendToUDP().

$wgRC2UDPPrefix = ''

Prefix to prepend to each UDP packet.

This can be used to identify the wiki. A script is available called mxircecho.py which listens on a UDP port, and uses a prefix ending in a tab to identify the IRC channel to send the log line to.

Definition at line 4580 of file DefaultSettings.php.

Referenced by RecentChange\sendToUDP().

$wgRCChangedSizeThreshold = 500

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.

Definition at line 4663 of file DefaultSettings.php.

Referenced by ChangesList\showCharacterDifference().

$wgRCFilterByAge = false

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.

Definition at line 4554 of file DefaultSettings.php.

$wgRCLinkDays = array( 1, 3, 7, 14, 30 )

Recentchanges items are periodically purged; entries older than this many seconds will go.

Default: 13 weeks = about three months

Definition at line 4561 of file DefaultSettings.php.

Referenced by SpecialRecentChanges\optionsPanel().

$wgRCLinkLimits = array( 50, 100, 250, 500 )

List of Days and Limits options to list in the Special:Recentchanges and Special:Recentchangeslinked pages.

Definition at line 4560 of file DefaultSettings.php.

Referenced by SpecialRecentChanges\optionsPanel().

$wgRCMaxAge = 13 * 7 * 24 * 3600

Recentchanges items are periodically purged; entries older than this many seconds will go.

Default: 13 weeks = about three months

Definition at line 4545 of file DefaultSettings.php.

Referenced by WikiPage\doEditUpdates(), ApiQueryContributions\getParamDescription(), Preferences\rcPreferences(), RebuildRecentchanges\rebuildRecentChangesTablePass1(), RebuildRecentchanges\rebuildRecentChangesTablePass3(), and Preferences\watchlistPreferences().

$wgRCShowChangedSize = true

Show the amount of changed characters in recent changes.

Definition at line 4656 of file DefaultSettings.php.

Referenced by EnhancedChangesList\recentChangesBlockGroup(), EnhancedChangesList\recentChangesBlockLine(), and OldChangesList\recentChangesLine().

$wgRCShowWatchingUsers = false

Show watching users in recent changes, watchlist and page history views.

Definition at line 4652 of file DefaultSettings.php.

Referenced by SpecialWatchlist\execute(), Preferences\rcPreferences(), and SpecialRecentChanges\webOutput().

$wgReadOnly = null

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.

Definition at line 4511 of file DefaultSettings.php.

Referenced by LBFactory_Multi\__construct(), RebuildFileCache\execute(), LoadBalancer\getReaderIndex(), GlobalTest\testReadOnlyEmpty(), GlobalTest\testReadOnlySet(), wfReadOnly(), and wfReadOnlyReason().

$wgReadOnlyFile = false

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.

Will default to "{$wgUploadDirectory}/lock_yBgMBwiR" in Setup.php

Definition at line 4520 of file DefaultSettings.php.

Referenced by SpecialUnlockdb\checkExecutePermissions(), SpecialLockdb\checkExecutePermissions(), SpecialUnlockdb\onSubmit(), SpecialLockdb\onSubmit(), GlobalTest\setUp(), GlobalTest\tearDown(), GlobalTest\testReadOnlySet(), and wfReadOnly().

$wgRedirectOnLogin = null

Allow redirection to another page when a user logs in.

To enable, set to a string like 'Main Page'

Definition at line 5727 of file DefaultSettings.php.

Referenced by LoginForm\load().

$wgRedirectScript = false

The URL path to redirect.php.

This is a script that is used by the Nostalgia skin.

Will default to "{$wgScriptPath}/redirect{$wgScriptExtension}" in Setup.php

Definition at line 126 of file DefaultSettings.php.

$wgRedirectSources = false

If local interwikis are set up which allow redirects, set this regexp to restrict URLs which will be displayed as 'redirected from' links.

It might look something like this: $wgRedirectSources = '!^https?://[a-z-]+\.wikipedia\.org/!';

Leave at false to avoid displaying any incoming redirect markers. This does not affect intra-wiki redirects, which don't change the URL.

Definition at line 2830 of file DefaultSettings.php.

Referenced by Article\showRedirectedFromHeader().

$wgRegisterInternalExternals = false

By default MediaWiki does not register links pointing to same server in externallinks dataset, use this value to override:

Definition at line 5710 of file DefaultSettings.php.

Referenced by ParserOutput\addExternalLink().

$wgRemoveGroups = array()
$wgRenderHashAppend = ''

Append a configured value to the parser cache and the sitenotice key so that they can be kept separate for some class of activity.

Definition at line 1734 of file DefaultSettings.php.

Referenced by ChangesFeed\execute(), Skin\getCachedNotice(), User\getPageRenderingHash(), and ParserOptions\optionsHash().

$wgRepositoryBaseUrl = "http://commons.wikimedia.org/wiki/File:"

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.

Definition at line 529 of file DefaultSettings.php.

$wgReservedUsernames
Initial value:
 array(
        'MediaWiki default', 
        'Conversion script', 
        'Maintenance script', 
        'Template namespace initialisation script', 
        'ScriptImporter', 
        'msg:double-redirect-fixer', 
        'msg:usermessage-editor', 
        'msg:proxyblocker', 
)

Array of usernames which may not be registered or logged in from Maintenance scripts can still use these.

Definition at line 3207 of file DefaultSettings.php.

Referenced by User\isUsableName().

$wgResourceBasePath = null

Default 'remoteBasePath' value for resource loader modules.

If not set, then $wgScriptPath will be used as a fallback.

Definition at line 2576 of file DefaultSettings.php.

Referenced by ResourceLoaderFileModule\__construct().

$wgResourceLoaderDebug = false

The default debug mode (on/off) for of ResourceLoader requests.

This will still be overridden when the debug URL parameter is used.

Definition at line 2598 of file DefaultSettings.php.

Referenced by ResourceLoaderContext\__construct(), and ResourceLoader\inDebugMode().

$wgResourceLoaderExperimentalAsyncLoading = false

If set to true, asynchronous loading of bottom-queue scripts in the <head> will be enabled.

This is an experimental feature that's supposed to make JavaScript load faster.

Definition at line 2689 of file DefaultSettings.php.

Referenced by OutputPage\getBottomScripts(), and OutputPage\getHeadScripts().

$wgResourceLoaderMaxage
Initial value:
 array(
        'versioned' => array(
                
                'server' => 30 * 24 * 60 * 60, 
                
                'client' => 30 * 24 * 60 * 60, 
        ),
        'unversioned' => array(
                'server' => 5 * 60, 
                'client' => 5 * 60, 
        ),
)

Maximum time in seconds to cache resources served by the resource loader.

Definition at line 2581 of file DefaultSettings.php.

Referenced by ResourceLoader\sendResponseHeaders(), and ResourceLoader\tryRespondFromFileCache().

$wgResourceLoaderMaxQueryLength = -1

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.

If set to a negative number, ResourceLoader will assume there is no query string length limit.

Definition at line 2663 of file DefaultSettings.php.

Referenced by ResourceLoaderStartUpModule\getConfig().

$wgResourceLoaderMinifierMaxLineLength = 1000

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.

Definition at line 2618 of file DefaultSettings.php.

Referenced by ResourceLoader\filter(), and MinifyScript\minify().

$wgResourceLoaderMinifierStatementsOnOwnLine = false

Put each statement on its own line when minifying JavaScript.

This makes debugging in non-debug mode a bit easier.

Definition at line 2611 of file DefaultSettings.php.

Referenced by ResourceLoader\filter(), and MinifyScript\minify().

$wgResourceLoaderSources = array()

Extensions should register foreign module sources here.

'local' is a built-in source that is not in this array, but defined by ResourceLoader::__construct() so that it cannot be unset.

Example: $wgResourceLoaderSources['foo'] = array( 'loadScript' => 'http://example.org/w/load.php', 'apiScript' => 'http://example.org/w/api.php' );

Definition at line 2570 of file DefaultSettings.php.

Referenced by ResourceLoader\__construct().

$wgResourceLoaderUseESI = 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.

Definition at line 2605 of file DefaultSettings.php.

Referenced by OutputPage\makeResourceLoaderLink().

$wgResourceLoaderValidateJS = true

If set to true, JavaScript modules loaded from wiki pages will be parsed prior to minification to validate it.

Parse errors will result in a JS exception being thrown during module load, which avoids breaking other modules loaded in the same request.

Definition at line 2672 of file DefaultSettings.php.

Referenced by ResourceLoaderModule\validateScriptFile().

$wgResourceLoaderValidateStaticJS = false

If set to true, statically-sourced (file-backed) JavaScript resources will be parsed for validity before being bundled up into ResourceLoader modules.

This can be helpful for development by providing better error messages in default (non-debug) mode, but JavaScript parsing is slow and memory hungry and may fail on large pre-bundled frameworks.

Definition at line 2682 of file DefaultSettings.php.

Referenced by ResourceLoaderFileModule\readScriptFiles().

$wgResourceModules = array()

Client-side resource modules.

Extensions should add their module definitions here.

Example: $wgResourceModules['ext.myExtension'] = array( 'scripts' => 'myExtension.js', 'styles' => 'myExtension.css', 'dependencies' => array( 'jquery.cookie', 'jquery.tabIndex' ), 'localBasePath' => dirname( __FILE__ ), 'remoteExtPath' => 'MyExtension', );

Definition at line 2557 of file DefaultSettings.php.

Referenced by ResourceLoader\__construct().

$wgRestrictDisplayTitle = true

For consistency, restrict DISPLAYTITLE to titles that normalize to the same canonical DB key.

Definition at line 3089 of file DefaultSettings.php.

Referenced by CoreParserFunctions\displaytitle().

$wgRestrictionLevels = array( '', 'autoconfirmed', 'sysop' )

Rights which can be required for each protection level (via action=protect)

You can add a new protection level that requires a specific 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

Definition at line 3636 of file DefaultSettings.php.

Referenced by ProtectionForm\buildCleanupScript(), ProtectionForm\buildSelector(), ApiProtect\execute(), ApiQueryProtectedTitles\getAllowedParams(), ApiQueryAllpages\getAllowedParams(), SpecialProtectedtitles\getLevelMenu(), SpecialProtectedpages\getLevelMenu(), Title\isProtected(), and ProtectionForm\loadData().

$wgRestrictionTypes = array( 'create', 'edit', 'move', 'upload' )

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)

Definition at line 3624 of file DefaultSettings.php.

Referenced by Title\getFilteredRestrictionTypes().

$wgRevisionCacheExpiry = 0

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.

Definition at line 1446 of file DefaultSettings.php.

Referenced by Revision\loadText().

$wgRevokePermissions = array()

Permission keys revoked from users in each group.

This acts the same way as wgGroupPermissions above, except that if the user is in a group here, the permission will be removed from them.

Improperly setting this could mean that your users will be unable to perform certain essential tasks, so use at your own risk!

Definition at line 3587 of file DefaultSettings.php.

Referenced by Title\checkReadPermissions(), SpecialListGroupRights\execute(), User\getAllGroups(), User\getGroupPermissions(), and UserTest\setUpPermissionGlobals().

$wgRightsIcon = null

Override for copyright metadata.

Definition at line 4719 of file DefaultSettings.php.

Referenced by Skin\getCopyrightIcon().

$wgRightsPage = null

Override for copyright metadata.

This is the name of the page containing information about the wiki's copyright status, which will be added as a link in the footer if it is specified. It overrides $wgRightsUrl if both are specified.

Definition at line 4701 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendRightsInfo(), Skin\getCopyright(), OutputPage\getHeadLinks(), and RdfMetaData\rights().

$wgRightsText = null

If either $wgRightsUrl or $wgRightsPage is specified then this variable gives the text for the link.

If using $wgRightsUrl then this value must be specified. If using $wgRightsPage then the name of the page will also be used as the link if this variable is not set.

Definition at line 4714 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendRightsInfo(), Skin\getCopyright(), Skin\getCopyrightIcon(), EditPage\getCopywarn(), and RdfMetaData\rights().

$wgRightsUrl = null

Set this to specify an external URL containing details about the content license used on your wiki.

If $wgRightsPage is set then this setting is ignored.

Definition at line 4707 of file DefaultSettings.php.

Referenced by ApiQuerySiteinfo\appendRightsInfo(), Skin\getCopyright(), Skin\getCopyrightIcon(), OutputPage\getHeadLinks(), and RdfMetaData\rights().

$wgScriptExtension = '.php'

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.

Definition at line 111 of file DefaultSettings.php.

Referenced by WebRequest\checkUrlExtension(), ResourceLoaderStartUpModule\getConfig(), and wfScript().

$wgScriptPath = '/wiki'

The path we should point to.

It might be a virtual path in case with use apache mod_rewrite for example.

This *needs* to be set correctly.

Other paths will be set to defaults based on it unless they are directly set in LocalSettings.php

Definition at line 81 of file DefaultSettings.php.

Referenced by ResourceLoaderFileModule\__construct(), SeleniumTester\execute(), ResourceLoaderStartUpModule\getConfig(), ResourceLoaderWikiModule\getStyles(), Parser\getVariableValue(), SkinTemplate\outputPage(), ParserTest\setUp(), ApiTest\testApiGotCookie(), and wfScript().

$wgSearchEverythingOnlyLoggedIn = false

If set to true the 'searcheverything' preference will be effective only for logged-in users.

Useful for big wikis to maintain different search profiles for anonymous and logged-in users.

Definition at line 4370 of file DefaultSettings.php.

Referenced by SearchEngine\userNamespaces().

$wgSearchForwardUrl = null

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';

Definition at line 4389 of file DefaultSettings.php.

Referenced by SpecialSearch\showResults().

$wgSearchHighlightBoundaries = '[\p{Z}\p{P}\p{C}]'

Regexp to match word boundaries, defaults for non-CJK languages should be empty for CJK since the words are not separate.

Definition at line 4284 of file DefaultSettings.php.

Referenced by SearchHighlighter\highlightText().

$wgSearchSuggestCacheExpiry = 1200

Expiry time for search suggestion responses.

Definition at line 4326 of file DefaultSettings.php.

Referenced by ApiOpenSearch\execute().

$wgSearchType = null

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.

Definition at line 1226 of file DefaultSettings.php.

Referenced by SearchEngine\create(), SearchUpdateTest\setUp(), and SearchUpdateTest\tearDown().

$wgSecretKey = false

This should always be customised in LocalSettings.php.

Definition at line 3927 of file DefaultSettings.php.

Referenced by MWCryptRand\initialRandomState(), and User\setToken().

$wgSecureLogin = false

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

Definition at line 3382 of file DefaultSettings.php.

Referenced by SkinTemplate\buildPersonalUrls(), LoginForm\mainLoginForm(), and LoginForm\successfulLogin().

$wgSeleniumConfigFile = null
$wgSeleniumTestConfigs = array()

Name of the external diff engine to use.

Definition at line 5757 of file DefaultSettings.php.

$wgSend404Code = true

Some web hosts attempt to rewrite all responses with a 404 (not found) status code, mangling or hiding MediaWiki's output.

If you are using such a host, you should start looking for a better one. While you're doing that, set this to false to convert some of MediaWiki's 404 responses to 200 so that the generated error pages can be seen.

In cases where for technical reasons it is more important for MediaWiki to send the correct status code than for the body to be transmitted intact, this configuration variable is ignored.

Definition at line 2535 of file DefaultSettings.php.

Referenced by SpecialPageFactory\executePath(), ImagePage\openShowImage(), and Article\showMissingArticle().

$wgServer = WebRequest::detectServer()

URL of the server.

Example: $wgServer = 'http://example.com';

This is usually detected correctly by MediaWiki. If MediaWiki detects the wrong server, it will redirect incorrectly after you save a page. In that case, set this variable to fix it.

If you want to use protocol-relative URLs on your wiki, set this to a protocol-relative URL like '//example.com' and set $wgCanonicalServer to a fully qualified URL.

Definition at line 57 of file DefaultSettings.php.

Referenced by ParserOutput\addExternalLink(), SkinTemplate\buildPersonalUrls(), DeleteSelfExternals\execute(), SeleniumTester\execute(), Maintenance\finalSetup(), ResourceLoaderStartUpModule\getConfig(), Title\getInternalURL(), Title\getLocalURL(), SearchEngine\getMWSuggestTemplate(), Parser\getVariableValue(), LoginForm\mailPasswordInternal(), UserMailer\makeMsgId(), SkinTemplate\outputPage(), MediaWiki\performRequest(), BenchmarkPurge\randomUrl(), DBConnectionError\searchForm(), ApiTestCase\setUp(), ApiTest\testApiGotCookie(), ApiTest\testApiListPages(), ApiTest\testApiLoginBadPass(), ApiTest\testApiLoginGoodPass(), wfExpandUrl\testWfExpandUrl(), and wfExpandUrl().

$wgSessionHandler = null

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)

Definition at line 1610 of file DefaultSettings.php.

Referenced by wfSetupSession().

$wgSessionName = false

Override to customise the session name.

Definition at line 4003 of file DefaultSettings.php.

$wgSessionsInMemcached = false

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.

Definition at line 1602 of file DefaultSettings.php.

Referenced by wfSetupSession().

$wgSharedDB = null

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 preferences shared (preferences were stored in the user table prior to 1.16)

$wgSharedTables may be customized with a list of tables to share in the shared 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.

Definition at line 1272 of file DefaultSettings.php.

Referenced by DatabaseSqlite\__construct(), AlterSharedConstraints\execute(), DatabaseUpdater\getOldGlobalUpdates(), DatabaseTest\getSharedTableName(), and DatabaseBase\tableName().

$wgSharedTables = array( 'user', 'user_properties' )
$wgSharedThumbnailScriptPath = false

Uploads have to be specially set up to be secure.

Definition at line 498 of file DefaultSettings.php.

$wgSharedUploadDBname = false

DB name with metadata about shared directory.

Set this to false if the uploads do not come from a wiki.

Definition at line 441 of file DefaultSettings.php.

$wgSharedUploadDBprefix = ''

Optional table prefix used in database.

Definition at line 443 of file DefaultSettings.php.

$wgSharedUploadDirectory = "/var/www/wiki3/images"

Path on the file system where shared uploads can be found.

Definition at line 439 of file DefaultSettings.php.

$wgSharedUploadPath = "http://commons.wikimedia.org/shared/images"

Full path on the web server where shared uploads can be found.

Definition at line 435 of file DefaultSettings.php.

$wgSharpenParameter = '0x0.4'

Sharpening parameter to ImageMagick.

Definition at line 654 of file DefaultSettings.php.

Referenced by BitmapHandler\transformImageMagick(), and BitmapHandler\transformImageMagickExt().

$wgSharpenReductionThreshold = 0.85

Reduction in linear dimensions below which sharpening will be enabled.

Definition at line 657 of file DefaultSettings.php.

Referenced by BitmapHandler\transformImageMagick(), and BitmapHandler\transformImageMagickExt().

$wgShellLocale = 'en_US.utf8'

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.

Definition at line 5582 of file DefaultSettings.php.

Referenced by wfInitShellLocale().

$wgShowArchiveThumbnails = true

Show thumbnails for old images on the image description page.

Definition at line 790 of file DefaultSettings.php.

Referenced by ImageHistoryList\__construct().

$wgShowCreditsIfMax = true

If there are more than $wgMaxCredits authors, show $wgMaxCredits of them.

Otherwise, link to a separate credits page.

Definition at line 4746 of file DefaultSettings.php.

Referenced by SkinTemplate\outputPage().

$wgShowDBErrorBacktrace = false

If true, show a backtrace for database errors.

Definition at line 4120 of file DefaultSettings.php.

Referenced by DBError\getHTML(), DBConnectionError\getHTML(), DBError\getText(), and ExtraParserTest\setUp().

$wgShowDebug = false

Display debug data at the bottom of the main content area.

Useful for developers and technical users trying to working on a closed wiki.

Definition at line 4084 of file DefaultSettings.php.

Referenced by Skin\generateDebugHTML(), GlobalTest\testDebugFunctionTest(), and wfDebug().

$wgShowExceptionDetails = 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.

Definition at line 4115 of file DefaultSettings.php.

Referenced by ResourceLoader\formatException(), MWException\getHTML(), MWException\getText(), MWExceptionHandler\report(), and ApiMain\substituteResultWithError().

$wgShowEXIF = function_exists( 'exif_read_data' )

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 following lines to the "Windows extensions" section of php.ini:

extension=extensions/php_mbstring.dll extension=extensions/php_exif.dll

Definition at line 411 of file DefaultSettings.php.

Referenced by BitmapMetadataHandler\getExif(), TiffHandler\getMetadata(), ExifBitmapHandler\isMetadataValid(), FormatMetadataTest\setUp(), TiffTest\setUp(), ExifTest\setUp(), JpegTest\setUp(), ExifBitmapTest\setUp(), ExifRotationTest\setUp(), TiffTest\tearDown(), JpegTest\tearDown(), ExifTest\tearDown(), ExifBitmapTest\tearDown(), FormatMetadataTest\tearDown(), ExifRotationTest\tearDown(), BitmapMetadataHandlerTest\testMultilingualCascade(), and ImagePage\view().

$wgShowHostnames = false
$wgShowIPinHeader = true

Show IP address, for non-logged in users.

It's necessary to switch this off for some forms of caching. Will disable file cache.

Definition at line 2298 of file DefaultSettings.php.

Referenced by Skin\showIPinHeader(), and HTMLFileCache\useFileCache().

$wgShowSQLErrors = 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.

Definition at line 4107 of file DefaultSettings.php.

Referenced by Maintenance\finalSetup(), DBQueryError\getSQL(), and ApiMain\substituteResultWithError().

$wgShowUpdatedMarker = true

Show "Updated (since my last visit)" marker in RC view, watchlist and history view for watched pages with new changes.

Definition at line 4668 of file DefaultSettings.php.

Referenced by User\clearAllNotifications(), User\clearNotification(), SpecialWatchlist\execute(), Title\getNotificationTimestamp(), EmailNotification\notifyOnPageChange(), RecentChange\save(), and SpecialRecentChanges\webOutput().

$wgSidebarCacheExpiry = 86400

Expiry time for the sidebar cache, in seconds.

Definition at line 1750 of file DefaultSettings.php.

Referenced by Skin\buildSidebar().

$wgSitemapNamespaces = false

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.

Definition at line 4403 of file DefaultSettings.php.

Referenced by GenerateSitemap\generateNamespaces().

$wgSitemapNamespacesPriorities = false

Custom namespace priorities for sitemaps.

Setting this will allow you to set custom priorities to namsepaces when sitemaps are generated using the maintenance/generateSitemap.php script.

This should be a map of namespace IDs to priority Example: $wgSitemapNamespacesPriorities = array( NS_USER => '0.9', NS_HELP => '0.0', );

Definition at line 4417 of file DefaultSettings.php.

Referenced by GenerateSitemap\setNamespacePriorities().

$wgSiteNotice = ''

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.

Definition at line 2307 of file DefaultSettings.php.

Referenced by Skin\getCachedNotice().

$wgSiteSupportPage = ''

If this is set, a "donate" link will appear in the sidebar.

Set it to a URL.

Definition at line 2317 of file DefaultSettings.php.

Referenced by StandardTemplate\quickBar(), and CologneBlueTemplate\quickBar().

$wgSkipSkin = ''

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

Definition at line 2338 of file DefaultSettings.php.

$wgSkipSkins = array()

Array for more like $wgSkipSkin.

Definition at line 2340 of file DefaultSettings.php.

Referenced by Skin\getUsableSkins().

$wgSlaveLagCritical = 30
See also:
$wgSlaveLagWarning

Definition at line 1386 of file DefaultSettings.php.

Referenced by OutputPage\showLagWarning().

$wgSlaveLagWarning = 10

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.

Definition at line 1384 of file DefaultSettings.php.

Referenced by OutputPage\showLagWarning().

$wgSMTP = false

SMTP Mode For using a direct (authenticated) SMTP server connection.

Default to false or fill an array : "host" => 'SMTP domain', "IDHost" => 'domain for MessageID', "port" => "25", "auth" => true/false, "username" => user, "password" => password

Definition at line 1114 of file DefaultSettings.php.

Referenced by UserMailer\makeMsgId(), and UserMailer\send().

$wgSorbsUrl = array()
Deprecated:
since 1.17 Use $wgDnsBlacklistUrls instead, only kept for backward compatibility

Definition at line 3835 of file DefaultSettings.php.

Referenced by User\isDnsBlacklisted().

$wgSortSpecialPages = true

Whether or not to sort special pages in Special:Specialpages.

Definition at line 5309 of file DefaultSettings.php.

Referenced by SpecialSpecialpages\getPageGroups().

$wgSpamRegex = array()

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 /

Definition at line 3780 of file DefaultSettings.php.

Referenced by EditPage\matchSpamRegex().

$wgSpecialPageCacheUpdates
Initial value:
 array(
        'Statistics' => array( 'SiteStatsUpdate', 'cacheUpdate' )
)

Additional functions to be performed with updateSpecialPages.

Expensive Querypages are already updated.

Definition at line 4952 of file DefaultSettings.php.

Referenced by UpdateSpecialPages\execute().

$wgSpecialPageGroups

List of special pages, followed by what subtitle they should go under at Special:SpecialPages.

Definition at line 5204 of file DefaultSettings.php.

Referenced by SpecialPageFactory\getGroup(), and SpecialPageFactory\setGroup().

$wgSpecialPages = array()

Special page list.

See the top of SpecialPage.php for documentation.

Definition at line 4874 of file DefaultSettings.php.

Referenced by SpecialPageFactory\getList().

$wgSpecialVersionShowHooks = false

Show the contents of $wgHooks in Special:Version.

Definition at line 4100 of file DefaultSettings.php.

Referenced by SpecialVersion\execute().

$wgSQLiteDataDir = ''

To override default SQLite data directory ($docroot/../data)

Definition at line 1245 of file DefaultSettings.php.

Referenced by DatabaseSqlite\attachDatabase(), DatabaseSqlite\open(), and SqliteInstaller\openConnection().

$wgSQLMode = ''

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 :-)

Definition at line 1239 of file DefaultSettings.php.

Referenced by DatabaseMysql\open().

$wgSquidMaxage = 18000

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

Definition at line 1836 of file DefaultSettings.php.

Referenced by Skin\getDynamicStylesheetQuery(), RawAction\onView(), HistoryAction\onView(), OutputPage\sendCacheControl(), and ViewAction\show().

$wgSquidServers = array()

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.

Definition at line 1851 of file DefaultSettings.php.

Referenced by BenchmarkPurge\execute(), SquidUpdate\purge(), and wfIsTrustedProxy().

$wgSquidServersNoPurge = array()

As above, except these servers aren't purged on page changes; use to set a list of trusted proxies, etc.

Definition at line 1857 of file DefaultSettings.php.

Referenced by WebRequestTest\testGetIP(), and wfIsTrustedProxy().

$wgStatsMethod = 'cache'

Destination for wfIncrStats() data...

'cache' to go into the system cache, if enabled (memcached) 'udp' to be sent to the UDP profiler (see $wgUDPProfilerHost) false to disable

Definition at line 4188 of file DefaultSettings.php.

Referenced by wfIncrStats().

$wgStrictFileExtensions = true

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.

Definition at line 589 of file DefaultSettings.php.

Referenced by UploadForm\addUploadJS(), StreamFile\contentTypeFromPath(), UploadForm\getExtensionsMessage(), and UploadBase\getTitle().

$wgStyleDirectory = false

Filesystem stylesheets directory.

Will default to "{$IP}/skins" in Setup.php

Definition at line 178 of file DefaultSettings.php.

Referenced by Skin\getSkinNames(), File\iconThumb(), Skin\newFromKey(), UploadFromUrlTestSuite\setUp(), and ParserTest\setUp().

$wgStyleSheetPath = &$wgStylePath

The URL path of the skins directory.

Will default to "{$wgScriptPath}/skins" in Setup.php

Definition at line 160 of file DefaultSettings.php.

Referenced by ParserTest\setUp().

$wgStyleVersion = '303'

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.

Definition at line 1694 of file DefaultSettings.php.

Referenced by OutputPage\addScriptFile(), Skin\getCommonStylePath(), Skin\getSkinStylePath(), ChannelFeed\outXmlHeader(), and OutputPage\styleLink().

$wgSummarySpamRegex = array()

Same as the above except for edit summaries.

Definition at line 3783 of file DefaultSettings.php.

Referenced by EditPage\matchSummarySpamRegex().

$wgSVGConverter = 'ImageMagick'

Pick a converter defined in $wgSVGConverters.

Definition at line 703 of file DefaultSettings.php.

Referenced by SvgHandler\isEnabled(), and SvgHandler\rasterize().

$wgSVGConverterPath = ''

If not in the executable PATH, specify the SVG converter path.

Definition at line 705 of file DefaultSettings.php.

Referenced by SvgHandler\rasterize().

$wgSVGConverters
Initial value:
 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',
        'ImagickExt' => array( 'SvgHandler::rasterizeImagickExt' ),
        )

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. If set to an array, the first item is a PHP callable and any further items are passed as parameters after $srcPath, $dstPath, $width, $height

Definition at line 693 of file DefaultSettings.php.

Referenced by SvgHandler\isEnabled(), and SvgHandler\rasterize().

$wgSVGMaxSize = 2048

Don't scale a SVG larger than this.

Definition at line 707 of file DefaultSettings.php.

Referenced by Linker\makeImageLink2(), and SvgHandler\normaliseParams().

$wgSVGMetadataCutoff = 262144

Don't read SVG metadata beyond this point.

Default is 1024*256 bytes

Definition at line 710 of file DefaultSettings.php.

Referenced by SVGReader\__construct(), and UploadBase\checkXMLEncodingMissmatch().

$wgSysopEmailBans = true

Allow sysops to ban users from accessing Emailuser.

Definition at line 3402 of file DefaultSettings.php.

Referenced by SpecialBlock\canBlockEmail().

$wgThumbLimits
Initial value:
 array(
        120,
        150,
        180,
        200,
        250,
        300
)

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:

Definition at line 949 of file DefaultSettings.php.

Referenced by Preferences\getThumbSizes(), and Linker\makeImageLink2().

$wgThumbnailEpoch = '20030516000000'

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.

Definition at line 763 of file DefaultSettings.php.

Referenced by File\transform().

$wgThumbnailScriptPath = 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.

Example: $wgThumbnailScriptPath = "{$wgScriptPath}/thumb{$wgScriptExtension}";

Definition at line 497 of file DefaultSettings.php.

Referenced by ParserTest\setUp().

$wgThumbUpright = 0.75

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.

Definition at line 974 of file DefaultSettings.php.

Referenced by Linker\makeImageLink2().

$wgTidyBin = 'tidy'
See also:
$wgUseTidy

Definition at line 3028 of file DefaultSettings.php.

Referenced by MWTidy\execExternalTidy().

$wgTidyConf = $IP.'/includes/tidy.conf'
See also:
$wgUseTidy

Definition at line 3030 of file DefaultSettings.php.

Referenced by MWTidy\execExternalTidy(), and MWTidy\execInternalTidy().

$wgTidyInternal = extension_loaded( 'tidy' )
See also:
$wgUseTidy

Definition at line 3034 of file DefaultSettings.php.

Referenced by MWTidy\checkErrors(), and MWTidy\tidy().

$wgTidyOpts = ''
See also:
$wgUseTidy

Definition at line 3032 of file DefaultSettings.php.

Referenced by MWTidy\execExternalTidy().

$wgTiffThumbnailType = false

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.

Example: // 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' );

Definition at line 755 of file DefaultSettings.php.

Referenced by TiffHandler\canRender(), and TiffHandler\getThumbType().

$wgTmpDirectory = false

The local filesystem path to a temporary directory.

This is not required to be web accessible.

Will default to "{$wgUploadDirectory}/tmp" in Setup.php

Definition at line 227 of file DefaultSettings.php.

Referenced by DBABagOStuff\__construct(), DifferenceEngine\generateDiffBody(), and CheckStorage\restoreText().

$wgTranscludeCacheExpiry = 3600

(see next option $wgGlobalDatabase).

Definition at line 3111 of file DefaultSettings.php.

Referenced by Parser\fetchScaryTemplateMaybeFromCache().

$wgTranslateNumerals = true

For Hindi and Arabic use local numerals instead of Western style (0-9) numerals in interface.

Definition at line 2062 of file DefaultSettings.php.

Referenced by Language\formatNum().

$wgTrivialMimeDetection = false

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.

Definition at line 913 of file DefaultSettings.php.

Referenced by StreamFile\contentTypeFromPath().

$wgTrustedMediaFormats
Initial value:
 array(
        MEDIATYPE_BITMAP, 
        MEDIATYPE_AUDIO,  
        MEDIATYPE_VIDEO,  
        "image/svg+xml",  
        "application/pdf",  
        #"application/x-shockwave-flash", 
)

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.

Definition at line 611 of file DefaultSettings.php.

Referenced by File\_getIsSafeFile().

$wgUDPProfilerHost = '127.0.0.1'

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

Definition at line 4168 of file DefaultSettings.php.

Referenced by ProfilerSimpleUDP\logData(), and wfIncrStats().

$wgUDPProfilerPort = '3811'

Port for UDP profiler.

See also:
$wgUDPProfilerHost

Definition at line 4174 of file DefaultSettings.php.

Referenced by ProfilerSimpleUDP\logData(), and wfIncrStats().

$wgUniversalEditButton = true

Enable the UniversalEditButton for browsers that support it (currently only Firefox with an extension) See http://universaleditbutton.org for more background information.

Definition at line 4467 of file DefaultSettings.php.

Referenced by OutputPage\getHeadLinks().

$wgUpdateCompatibleMetadata = false

If to automatically update the img_metadata field if the metadata field is outdated but compatible with the current version.

Defaults to false.

Definition at line 418 of file DefaultSettings.php.

Referenced by ImageBuilder\__construct(), LocalFile\maybeUpgradeRow(), and RefreshImageMetadata\setupParameters().

$wgUpdateRowsPerJob = 500

Number of rows to update per job.

Definition at line 5625 of file DefaultSettings.php.

Referenced by HTMLCacheUpdate\__construct(), and LinksUpdate\queueRecursiveJobs().

$wgUpdateRowsPerQuery = 100

Number of rows to update per query.

Definition at line 5630 of file DefaultSettings.php.

Referenced by HTMLCacheUpdate\__construct().

$wgUpgradeKey = 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.

Definition at line 4531 of file DefaultSettings.php.

$wgUploadBaseUrl = ''

If set, this URL is added to the start of $wgUploadPath to form a complete upload URL.

Definition at line 233 of file DefaultSettings.php.

$wgUploadDirectory = false

The filesystem path of the images directory.

Defaults to "{$IP}/images".

Definition at line 202 of file DefaultSettings.php.

$wgUploadMaintenance = false

To disable file delete/restore temporarily.

Definition at line 5751 of file DefaultSettings.php.

Referenced by FileDeleteForm\execute(), and SpecialUndelete\undelete().

$wgUploadMissingFileUrl = 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.

Definition at line 487 of file DefaultSettings.php.

Referenced by Linker\getUploadUrl(), and Linker\makeBrokenImageLinkObj().

$wgUploadNavigationUrl = false

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';

Definition at line 480 of file DefaultSettings.php.

Referenced by SkinTemplate\buildNavUrls(), LegacyTemplate\getUploadLink(), Linker\getUploadUrl(), and Linker\makeBrokenImageLinkObj().

$wgUploadPath = false

The URL path for the images directory.

Will default to "{$wgScriptPath}/images" in Setup.php

Definition at line 192 of file DefaultSettings.php.

Referenced by switchToTestResources().

$wgUploadSizeWarning = false

Warn if uploaded files are larger than this (in bytes), or false to disable.

Definition at line 599 of file DefaultSettings.php.

Referenced by UploadBase\checkWarnings().

$wgUploadStashMaxAge = 6 * 3600

The maximum age of temporary (incomplete) uploaded files.

Definition at line 197 of file DefaultSettings.php.

Referenced by UploadStashCleanup\execute().

$wgUploadStashScalerBaseUrl = false

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.

Definition at line 241 of file DefaultSettings.php.

Referenced by SpecialUploadStash\outputRemoteScaledThumb(), and SpecialUploadStash\outputThumbFromStash().

$wgUrlProtocols
Initial value:
 array(
        'http://',
        'https://',
        'ftp://',
        'irc://',
        'ircs://',  
        'gopher://',
        'telnet://', 
        'nntp://', 
        'worldwind://',
        'mailto:',
        'news:',
        'svn://',
        'git://',
        'mms://',
        '//', 
)

The external URL protocols.

Definition at line 2949 of file DefaultSettings.php.

Referenced by LinkSearchPage\execute(), ApiQueryExtLinksUsage\getProtocolPrefix(), ApiQueryExtLinksUsage\prepareProtocols(), GlobalTest\setUp(), GlobalTest\tearDown(), wfParseUrl(), and wfUrlProtocols().

$wgUseAutomaticEditSummaries = 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.

Definition at line 4474 of file DefaultSettings.php.

Referenced by WikiPage\doEdit().

$wgUseCategoryBrowser = false

Use experimental, DMOZ-like category browser.

Definition at line 4986 of file DefaultSettings.php.

Referenced by Skin\getCategoryLinks().

$wgUseCombinedLoginLink = true

Login / create account link behavior when it's possible for anonymous users to create an account true = use a combined login / create account link false = split login and create account into two separate links.

Definition at line 2495 of file DefaultSettings.php.

Referenced by SkinTemplate\useCombinedLoginLink().

$wgUseCommaCount = false

Backward compatibility setting, will set $wgArticleCountMethod if it is null.

Deprecated:
since 1.18; use $wgArticleCountMethod instead

Definition at line 3146 of file DefaultSettings.php.

$wgUseCopyrightUpload = false

Set this to true if you want detailed copyright information forms on Upload.

Definition at line 4733 of file DefaultSettings.php.

Referenced by UploadForm\getDescriptionSection(), and SpecialUpload\getInitialPageText().

$wgUseDatabaseMessages = true

Translation using MediaWiki: namespace.

Interface messages will be loaded from the database.

Definition at line 2068 of file DefaultSettings.php.

Referenced by SpecialAllmessages\execute(), PHPUnitMaintClass\finalSetup(), DumpIterator\finalSetup(), and MessageCache\singleton().

$wgUseDumbLinkUpdate = false

Do DELETE/INSERT for link updates instead of incremental.

Definition at line 1470 of file DefaultSettings.php.

Referenced by LinksUpdate\doUpdate().

$wgUseDynamicDates = false

Enable to allow rewriting dates in page text.

DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES.

Definition at line 2052 of file DefaultSettings.php.

Referenced by User\getPageRenderingHash(), ParserOptions\initialiseFromUser(), ParserOptions\legacyOptions(), and ParserOptionsTest\testGetParserCacheKeyWithDynamicDates().

$wgUseESI = false

If you run Squid3 with ESI support, enable this (default:false):

Definition at line 1808 of file DefaultSettings.php.

Referenced by OutputPage\sendCacheControl(), and AjaxResponse\sendHeaders().

$wgUseETag = false

Whether MediaWiki should send an ETag header.

Seems to cause broken behavior with Squid 2.6, see bug 7098.

Definition at line 1766 of file DefaultSettings.php.

Referenced by OutputPage\sendCacheControl(), and Article\view().

$wgUseExternalEditor = true

Activate external editor interface for files and pages See http://www.mediawiki.org/wiki/Manual:External_editors.

Definition at line 4457 of file DefaultSettings.php.

Referenced by Preferences\editingPreferences(), and ImagePage\uploadLinksBox().

$wgUseFileCache = false

This will cache static pages for non-logged-in users to reduce database traffic on public sites.

Must set $wgShowIPinHeader = false ResourceLoader requests to default language and skins are cached as well as single module requests.

Definition at line 1703 of file DefaultSettings.php.

Referenced by HTMLFileCache\clearFileCache(), PoolWorkArticleView\doWork(), PruneFileCache\execute(), RebuildFileCache\execute(), HTMLCacheUpdate\invalidateTitles(), MediaWiki\main(), HistoryAction\onView(), DBConnectionError\reportHTML(), ResourceLoader\respond(), FileCacheBase\saveText(), HTMLFileCache\saveToFileCache(), ResourceFileCache\useFileCache(), HTMLFileCache\useFileCache(), and Article\view().

$wgUseGzip = 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.

Definition at line 1760 of file DefaultSettings.php.

Referenced by FileCacheBase\__construct().

$wgUseImageMagick = 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.

Use Image Magick instead of PHP builtin functions.

Definition at line 647 of file DefaultSettings.php.

Referenced by RandomImageGenerator\getImageWriteMethod(), and BitmapHandler\getScalerType().

$wgUseImageResize = true

Obsolete, always true, kept for compatibility with extensions.

Definition at line 793 of file DefaultSettings.php.

Referenced by BitmapHandler\getScalerType().

$wgUseInstantCommons = false

Use Commons as a remote file repository.

Essentially a wrapper, when this is enabled $wgForeignFileRepos will point at Commons with a set of default settings

Definition at line 377 of file DefaultSettings.php.

$wgUseLocalMessageCache = false

Set this to true to make a local copy of the message cache, for use in addition to memcached.

The files will be put in $wgCacheDirectory.

Definition at line 1633 of file DefaultSettings.php.

Referenced by MessageCache\load(), and MessageCache\saveToCaches().

$wgUseNPPatrol = true

Use new page patrolling to check new pages on Special:Newpages.

Definition at line 4605 of file DefaultSettings.php.

Referenced by WikiPage\doEdit(), RecentChange\doMarkPatrolled(), RecentChange\getIRCLine(), User\isAllowed(), and User\useNPPatrol().

$wgUsePathInfo
Initial value:
        ( strpos( php_sapi_name(), 'cgi' ) === false ) &&
        ( strpos( php_sapi_name(), 'apache2filter' ) === false ) &&
        ( strpos( php_sapi_name(), 'isapi' ) === false )

Whether to support URLs like index.php/Page_title These often break when PHP is set up in CGI mode.

PATH_INFO *may* be correct if cgi.fix_pathinfo is set, but then again it may not; lighttpd converts incoming path data to lowercase on systems with case-insensitive filesystems, and there have been reports of problems on Apache as well.

To be safe we'll continue to keep it off by default.

Override this to false if $_SERVER['PATH_INFO'] contains unexpectedly incorrect garbage, or to true if it is really correct.

The default $wgArticlePath will be set based on this value at runtime, but if you have customized it, having this incorrectly set to true can cause redirect loops when "pretty URLs" are used.

Definition at line 99 of file DefaultSettings.php.

Referenced by HTMLForm\getHiddenFields(), WebRequest\interpolateTitle(), and MediaWiki\performRequest().

$wgUsePrivateIPs = false

Should forwarded Private IPs be accepted?

Definition at line 1883 of file DefaultSettings.php.

Referenced by WebRequestTest\testGetIP().

$wgUserEmailConfirmationTokenExpiry = 7 * 24 * 60 * 60

The time, in seconds, when an email confirmation email expires.

Definition at line 1099 of file DefaultSettings.php.

Referenced by User\confirmationToken().

$wgUserEmailUseReplyTo = false

Set to true to put the sending user's email in a Reply-To header instead of From.

($wgEmergencyContact will be used as From.)

Some mailers (eg sSMTP) set the SMTP envelope sender to the From value, which can cause problems with SPF validation and leak recipient addressses when bounces are sent to the sender.

Definition at line 1083 of file DefaultSettings.php.

Referenced by SpecialEmailUser\submit().

$wgUserrightsInterwikiDelimiter = '@'

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).

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

Definition at line 3317 of file DefaultSettings.php.

Referenced by UserrightsPage\fetchUser(), and LogPage\getTitleLink().

$wgUsersNotifiedOnAllChanges = array()

Array of usernames who will be sent a notification email for every change which occurs on a wiki.

Users will not be notified of their own changes.

Definition at line 1193 of file DefaultSettings.php.

Referenced by EmailNotification\actuallyNotifyOnPageChange(), and EmailNotification\notifyOnPageChange().

$wgUseSharedUploads = false

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.

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.

Definition at line 433 of file DefaultSettings.php.

$wgUseSiteCss = true

Use the site's Cascading Style Sheets (CSS)?

Definition at line 2393 of file DefaultSettings.php.

Referenced by OutputPage\buildCssLinks().

$wgUseSiteJs = true

Use the site's Javascript page?

Definition at line 2390 of file DefaultSettings.php.

Referenced by OutputPage\getScriptsForBottomQueue().

$wgUseTagFilter = true

Allow filtering by change tag in recentchanges, history, etc Has no effect if no tags are defined in valid_tag.

Definition at line 4685 of file DefaultSettings.php.

Referenced by ChangeTags\buildTagFilterSelector(), and ChangeTags\modifyDisplayQuery().

$wgUseTeX = false

To use inline TeX, you need to compile 'texvc' (in the 'math' subdirectory of the MediaWiki package and have latex, dvips, gs (ghostscript), andconvert (ImageMagick) installed and available in the PATH.

Please see math/README for more information.

Definition at line 4018 of file DefaultSettings.php.

Referenced by EditPage\getEditToolbar().

$wgUseTidy = 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 or the libtidy (PHP >= 5) extension to use an in-process tidy library instead of spawning a separate program. Normally you shouldn't need to override the setting except for debugging. To install, use 'pear install tidy' and add a line 'extension=tidy.so' to php.ini.

Definition at line 3024 of file DefaultSettings.php.

Referenced by CompareParsers\checkOptions(), RefreshLinks\doRefreshLinks(), Parser\parse(), Sanitizer\removeHTMLtags(), NewParserTest\tidy(), and ParserTest\tidy().

$wgUseTwoButtonsSearchForm = true

Search form behavior true = use Go & Search buttons false = use Go button & Advanced search link.

Definition at line 4396 of file DefaultSettings.php.

Referenced by MonoBookTemplate\searchBox(), LegacyTemplate\searchForm(), and CologneBlueTemplate\searchForm().

$wgUseXVO = false

Send X-Vary-Options header for better caching (requires patched Squid)

Definition at line 1811 of file DefaultSettings.php.

Referenced by OutputPage\sendCacheControl(), ApiMain\sendCacheHeaders(), and wfGzipHandler().

$wgValidateAllHtml = false

Validate the overall output using tidy and refuse to display the page if it's not valid.

Definition at line 2323 of file DefaultSettings.php.

Referenced by wfOutputHandler().

$wgValidSkinNames = array()

List of valid skin names.

The key should be the name in all lower case, the value should be a properly cased name for the skin. This value will be prefixed with "Skin" to create the class name of the skin to load, and if the skin's class cannot be found through the autoloader it will be used to load a .php file by that name in the skins directory. The default skins will be added later, by Skin::getSkinNames(). Use Skin::getSkinNames() as an accessor if you wish to have access to the full list.

Definition at line 4868 of file DefaultSettings.php.

Referenced by Skin\getSkinNames().

$wgVariantArticlePath = false

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.

Definition at line 2121 of file DefaultSettings.php.

Referenced by ResourceLoaderStartUpModule\getConfig(), Title\getLocalURL(), and WebRequest\getPathInfo().

$wgVaryOnXFP = false

Add X-Forwarded-Proto to the Vary and X-Vary-Options headers for API requests and RSS/Atom feeds.

Use this if you have an SSL termination setup and need to split the cache between HTTP and HTTPS for API requests, feed requests and HTTP redirect responses in order to prevent cache pollution. This does not affect 'normal' requests to index.php other than HTTP redirects.

Definition at line 1820 of file DefaultSettings.php.

Referenced by ChannelFeed\httpHeaders(), OutputPage\output(), and ApiMain\sendCacheHeaders().

$wgVectorUseIconWatch = 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.

Definition at line 2509 of file DefaultSettings.php.

Referenced by VectorTemplate\execute().

$wgVectorUseSimpleSearch = false

Search form behavior for Vector skin only true = use an icon search button false = use Go & Search buttons.

Definition at line 2502 of file DefaultSettings.php.

Referenced by VectorTemplate\renderNavigation(), and Preferences\searchPreferences().

$wgVerifyMimeType = true

Determines if the mime type of uploaded files should be checked.

Definition at line 879 of file DefaultSettings.php.

Referenced by StreamFile\contentTypeFromPath(), UploadBase\verifyFile(), and UploadBase\verifyMimeType().

$wgWantedPagesThreshold = 1

Number of links to a page required before it is deemed "wanted".

Definition at line 1461 of file DefaultSettings.php.

Referenced by WantedPagesPage\getQueryInfo().

$wgWellFormedXml = true

Should we try to make our HTML output well-formed XML? If set to false, output will be a few bytes shorter, and the HTML will arguably be more readable.

If set to true, life will be much easier for the authors of screen-scraping bots, and the HTML will arguably be more readable.

Setting this to false may omit quotation marks on some attributes, omit slashes from some self-closing tags, omit some ending tags, etc., where permitted by HTML5. Setting it to true will not guarantee that all pages will be well-formed, although non-well-formed pages should be rare and it's a bug if you find one. Conversely, setting it to false doesn't mean that all XML-y constructs will be omitted, just that they might be.

Because of compatibility with screen-scraping bots, and because it's controversial, this is currently left to true by default.

Definition at line 2278 of file DefaultSettings.php.

Referenced by Html\closeElement(), Html\expandAttributes(), Html\inlineScript(), Html\inlineStyle(), and Html\rawElement().

$wgWhitelistRead = false

Pages anonymous user may see as an array, e.g.

$wgWhitelistRead = array ( "Main Page", "Wikipedia:Help");

Special:Userlogin and Special:ChangePassword 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

Definition at line 3441 of file DefaultSettings.php.

Referenced by Title\checkReadPermissions().

$wgXhtmlDefaultNamespace = 'http://www.w3.org/1999/xhtml'

The default xmlns attribute.

Ignored if $wgHtml5 is true (or it's supposed to be), since we don't currently support XHTML5, and in HTML5 (i.e., served as text/html) the attribute has no effect, so why bother?

Definition at line 2226 of file DefaultSettings.php.

Referenced by Html\htmlHeader(), and SkinTemplate\outputPage().

$wgXhtmlNamespaces = array()

Permit other namespaces in addition to the w3.org default.

Use the prefix for the key and the namespace for the value. For example: $wgXhtmlNamespaces['svg'] = 'http://www.w3.org/2000/svg'; Normally we wouldn't have to define this in the root <html> element, but IE needs it there in some circumstances.

This is ignored if $wgHtml5 is true, for the same reason as $wgXhtmlDefaultNamespace.

Definition at line 2291 of file DefaultSettings.php.

Referenced by Html\htmlHeader(), and SkinTemplate\outputPage().

$wgXMLMimeTypes
Initial value:
 array(
        'http://www.w3.org/2000/svg:svg'               => 'image/svg+xml',
        'svg'                                          => 'image/svg+xml',
        'http://www.lysator.liu.se/~alla/dia/:diagram' => 'application/x-dia-diagram',
        'http://www.w3.org/1999/xhtml:html'            => 'text/html', 
        'html'                                         => 'text/html', 
)

Additional XML types we can allow via mime-detection.

array = ( 'rootElement' => 'associatedMimeType' )

Definition at line 919 of file DefaultSettings.php.

Referenced by MimeMagic\doGuessMimeType().