Manual:Configuration settings

From MediaWiki.org
Jump to: navigation, search

Contents

This is an index of all supported configuration options based on the DefaultSettings.php file.

Never edit DefaultSettings.php; copy appropriate lines to LocalSettings.php instead and amend them as appropriate.

Listed alphabetically | Listed by function | Category:MediaWiki configuration settings

[edit] General Settings

  • $wgProto (deprecated in 1.18) - The URL prefix defining the protocol in use.
  • $wgServer - The base URL of the server.
  • $wgServerName (deprecated in 1.17) - The name of the server without the protocol. (eg, en.wikipedia.org)
  • $wgCanonicalServer - Canonical URL of the server, to use in IRC feeds and notification e-mails.
  • $wgSitename - The name of the site. Should be changed
  • $wgVersion - Contains the current version of MediaWiki, as displayed to the user. You should not change this!

[edit] Paths

See also TeX for LaTeX specific path settings.
See also Uploads for file/image upload path settings.
See also Skins for skins path settings.

[edit] Global Objects

  • $wgConf - Create a site configuration object. Not used for much in a default install.

[edit] Email settings

See Also User Access: $wgEmailConfirmToEdit

[edit] Email notification (Enotif) settings

Actual notifications for each user are defined in the options. You can change defaults with $wgDefaultUserOptions.
  • $wgEnotifFromEditor - Email notifications appear to be coming from the page editor (not from Wiki server)
  • $wgEnotifImpersonal - Send a generic mail instead of a personalised mail for each user.
  • $wgEnotifMaxRecips - Maximum number of users to mail at once when using impersonal mail.
  • $wgEnotifMinorEdits - Email notifications also for "minor edits" (user preference is shown and user needs to opt-in)
  • $wgEnotifRevealEditorAddress - reply-to address of Email notifications may be filled with page editor's address (user preference is shown and user needs to opt-in)
  • $wgEnotifUseJobQ - Send mails via the job queue.
  • $wgEnotifUseRealName - Use real name instead of username in e-mail "from" field
  • $wgEnotifUserTalk - Email notifications can be sent for first change on a user_talk page (user preference is shown and user needs to opt-in)
  • $wgEnotifWatchlist - Email notifications can be sent for the first change on watched pages (user preference is shown and user needs to opt-in)
  • $wgUsersNotifiedOnAllChanges (formerly $wgUsersNotifedOnAllChanges!) - Array of usernames who will be sent a notification email for every change which occurs on a wiki

[edit] Database settings

[edit] LoadBalancer settings

[edit] MySQL-specific

[edit] PostgreSQL-specific

  • $wgDBmwschema - Schema that Postgres stores the MediaWiki tables in. Defaults to 'mediawiki'
  • $wgDBts2schema - Schema that the Tsearch2 tables live in for Postgres. Defaults to 'public'

[edit] SQLite-specific

[edit] Shared DB settings

[edit] Compressed Storage Support

  • $wgCompressRevisions - If this is set on, all future revisions will be compressed on page save, but only if zlib support is available and enabled in PHP.
  • $wgDisableOutputCompression - Disable output compression (compression is enabled by default if zlib is available).

[edit] Localization

[edit] Timezone settings

[edit] Language-specific

English
  • $wgAmericanDates - Enable for English module to print dates as eg 'May 12' instead of '12 May'.
Arabic/Hindi
  • $wgTranslateNumerals - For Hindi and Arabic use local numerals instead of Western style (0-9) numerals in interface.

[edit] Debug/logging

See also: Manual:How to debug

[edit] Profiling

[edit] Site customization

[edit] Ajax

[edit] CSS/Js

[edit] Resource loader

See ResourceLoader for more information.

[edit] Namespaces

[edit] Output

The following settings are only used if $wgHtml5 is set to "false":

[edit] Robot policies

[edit] Mobile support

[edit] Site Statistics

[edit] Skins

[edit] Category

[edit] Cache

Main article: Manual:Cache

See Interwiki for Interwiki cache settings.

[edit] Client side caching

[edit] File Cache

Setting for Server side file caching

  • $wgFileCacheDepth - Depth of the subdirectory hierarchy to be created under $wgFileCacheDirectory.
  • $wgFileCacheDirectory - Directory where the cached page will be saved when using server-side caching.
  • $wgUseFileCache - This will cache static pages for non-logged-in users to reduce database traffic on public sites.

[edit] Message Cache

[edit] Sidebar Cache

[edit] Parser Cache

[edit] Memcached settings

Settings for configuring the Memcached memory-based object store (if you are using it) docs/memcached.txt has more details.

[edit] Interwiki

[edit] Interwiki cache

See interwiki cache for more information.

[edit] Access

Wiki locking, blocking/banning, and some other related settings.

See Manual:Preventing access for more methods and settings concerning access. See also Manual:User rights management for more information about $wgGroupPermissions, $wgAddGroups, $wgRemoveGroups, etc.

See User Access for User Access settings.

[edit] Rate limiter

[edit] API

[edit] Wiki locking

  • $wgReadOnly - Disallows editing, displaying the string given as the reason.
  • $wgReadOnlyFile - If this file is found, the database is locked for the reason given in the contents of the file.

[edit] Reduction

[edit] Uploads

Uploads have to be specially set up to be secure.

[edit] Shared uploads

These settings are kept for backward compatibility, see $wgForeignFileRepos for the new setting, or $wgUseInstantCommons if you only need read access to images on Commons.

[edit] MIME types

Warning Warning: This is not a configuration setting, but a global state variable. It should be used solely by thumb.php!

See also Manual:Mime type detection

[edit] Images

See also Manual:Configuring file uploads

[edit] DjVu

[edit] EXIF

  • $wgShowEXIF - Determines whether EXIF metadata is to be displayed. Set to false for not showing data.
  • $wgUpdateCompatibleMetadata - Whether to automatically update the img_metadata field if the metadata field is outdated but compatible with the current version.

[edit] ImageMagick

Set $wgUseImageMagick to true to use ImageMagick instead of the builtin functions.

[edit] SVG

[edit] Thumbnail settings

[edit] Antivirus

[edit] Parser

[edit] HTML

  • $wgRawHtml - Allow raw, unchecked HTML in <html>...</html> sections.

[edit] TeX

In MediaWiki 1.18 and later, these settings are used for the Math extension.

To use inline TeX, you need to compile 'texvc' (in the 'math' subdirectory of the MediaWiki package and have latex, dvips, gs (ghostscript), and convert (ImageMagick) installed and available in the PATH. Please see Manual:Enable TeX, Manual:Math and the math/README in the MediaWiki source code.

  • $wgMathCheckFiles - Check whether directory and file exist when generating math images.
  • $wgMathDirectory - The file system path of the directory containing LaTeX math images.
  • $wgMathPath - The URL base of the directory containing LaTeX math images.
  • $wgTexvc - Location of the texvc binary.
  • $wgTexvcBackgroundColor - Texvc background color.
  • $wgUseTeX - Enables the use of <math> (TeX) tags (MediaWiki 1.17 and earlier only -- on 1.18 simply enable the Math extension)

[edit] Tidy

Tidy is an open source tool that cleans up broken HTML. You can use this to ensure that broken HTML in articles doesn't affect the layout of your wiki.

  • $wgAlwaysUseTidy
  • $wgDebugTidy - Put tidy warnings in HTML comments, only works for internal tidy.
  • $wgTidyBin - Should be set to the path of the tidy binary.
  • $wgTidyConf - Should be set to the path of the tidy configuration file.
  • $wgTidyInternal - Controls the use of the PECL extension to use an inprocess tidy library instead of spawning a separate program.
  • $wgTidyOpts - Options passed to tidy on the command line.
  • $wgUseTidy - Use tidy to make sure HTML output is sane.
  • $wgValidateAllHtml - Validate the overall output using tidy and refuse to display the page if it's not valid.

See also Manual:Build Tidy from source.

[edit] Special pages

[edit] Recent changes

See also Help:Recent changes and Manual:$wgDefaultUserOptions

[edit] UDP updates

Send RC updates via UDP. See: Manual:Simple IRC RC Bot

[edit] Users

[edit] Authentication

[edit] User Access

[edit] User agent

[edit] Cookies

[edit] Feed

  • $wgFeed - Toggle syndication feeds on and off.
  • $wgAdvertisedFeedTypes - Which feed types should be provided by default.
  • $wgFeedCacheTimeout - 'Minimum' timeout for cached Recentchanges feed, in seconds.
  • $wgFeedClasses - Available feeds objects.
  • $wgFeedDiffCutoff - When generating Recentchanges RSS/Atom feed, diffs will not be generated for pages larger than this size.
  • $wgFeedLimit - Set maximum number of results to return in syndication feeds (RSS, Atom) for eg Recentchanges, Newpages.
  • $wgOverrideSiteFeed - Override the site's default rss/atom feed that appears on every page.

[edit] Copyright

[edit] Search

[edit] Jobs

[edit] Proxies

[edit] Squid

[edit] HTCP multicast purging

[edit] Extensions

[edit] Maintenance Scripts setting

[edit] Miscellaneous settings


Language: English  • Deutsch • español • français • Bahasa Indonesia • 日本語 • 한국어 • polski • português do Brasil • русский • 中文 • 中文(繁體)‎