Remove Special:Asksql; moving it out to an extension.
[lhc/web/wiklou.git] / includes / DefaultSettings.php
index 9ea4796..e7d619e 100644 (file)
@@ -9,38 +9,22 @@
  * like $wgScriptPath, you must also localize everything that
  * depends on it.
  *
- * @version $Id$
  * @package MediaWiki
  */
 
 # This is not a valid entry point, perform no further processing unless MEDIAWIKI is defined
 if( defined( 'MEDIAWIKI' ) ) {
 
-/**
- * MediaWiki version number
- * @global string $wgVersion
- */
-$wgVersion                     = '1.4-prealpha';
+/** MediaWiki version number */
+$wgVersion                     = '1.5pre-alpha';
 
-/** 
- * Name of the site.
- * It must be changed in LocalSettings.php
- * @global string $wgSitename
- */
+/** Name of the site. It must be changed in LocalSettings.php */
 $wgSitename         = 'MediaWiki';
 
-/**
- * Will be same as you set @see $wgSitename
- * @global mixed $wgMetaNamespace
- */
+/** Will be same as you set @see $wgSitename */
 $wgMetaNamespace    = FALSE;
 
-
-/** 
- * URL of the server
- * It will be automaticly build including https mode
- * @global string $wgServer
- */
+/** URL of the server. It will be automaticly build including https mode */
 $wgServer = '';
 
 if( isset( $_SERVER['SERVER_NAME'] ) ) {
@@ -65,7 +49,6 @@ unset($wgProto);
 /**
  * The path we should point to.
  * It might be a virtual path in case with use apache mod_rewrite for example
- * @global string $wgScriptPath
  */
 $wgScriptPath      = '/wiki';
 
@@ -119,30 +102,46 @@ $wgTmpDirectory     = "{$wgUploadDirectory}/tmp";
 $wgUploadBaseUrl    = "";
 /**#@-*/
 
-# If you operate multiple wikis, you can define a shared upload
-# path here. Uploads to this wiki will NOT be put there - they
-# will be put into $wgUploadDirectory.
-#
-# If $wgUseSharedUploads is set, the wiki will look in the
-# shared repository if no file of the given name is found in
-# the local repository (for [[Image:..]], [[Media:..]] links).
-# Thumbnails will also be looked for and generated in this
-# directory.
-#
+/**
+ * If you operate multiple wikis, you can define a shared upload path here.
+ * Uploads to this wiki will NOT be put there - they will be put into
+ * $wgUploadDirectory.
+ * If $wgUseSharedUploads is set, the wiki will look in the shared repository if
+ * no file of the given name is found in the local repository (for [[Image:..]],
+ * [[Media:..]] links). Thumbnails will also be looked for and generated in this
+ * directory.
+ */
 $wgUseSharedUploads = false;
-# Full path on the web server where shared uploads can be found
+/** Full path on the web server where shared uploads can be found */
 $wgSharedUploadPath = "http://commons.wikimedia.org/shared/images";
-# Path on the file system where shared uploads can be found
+/** Path on the file system where shared uploads can be found */
 $wgSharedUploadDirectory = "/var/www/wiki3/images";
-# Set this 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.
+
+/**
+ * Set the following to false especially if you have a set of files that need to
+ * be accessible by all wikis, and you do not want to use the hash (path/a/aa/)
+ * directory layout.
+ */
 $wgHashedSharedUploadDirectory = true;
-# set true if the repository uses latin1 filenames
+
+/** set true if the repository uses latin1 filenames */
 $wgSharedLatin1=false;
 
+/**
+ * Base URL for a repository wiki. Leave this blank if uploads are just stored
+ * in a shared directory and not meant to be accessible through a separate wiki.
+ * Otherwise the image description pages on the local wiki will link to the
+ * image description page on this wiki.
+ *
+ * Please specify the namespace, as in the example below.
+ */
+$wgRepositoryBaseUrl="http://commons.wikimedia.org/wiki/Image:";
+
+
+#
 # Email settings
 #
+
 /**
  * Site admin email address
  * Default to wikiadmin@SERVER_NAME
@@ -158,6 +157,28 @@ $wgEmergencyContact = 'wikiadmin@' . $wgServerName;
  */
 $wgPasswordSender      = 'Wikipedia Mail <apache@' . $wgServerName . '>';
 
+/**
+ * dummy address which should be accepted during mail send action
+ * It might be necessay to adapt the address or to set it equal
+ * to the $wgEmergencyContact address
+ */
+#$wgNoReplyAddress     = $wgEmergencyContact;
+$wgNoReplyAddress      = 'reply@not.possible';
+
+/**
+ * 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.
+ * @global bool $wgEnableEmail
+ */
+$wgEnableEmail = true;
+
+/**
+ * Set to true to enable user-to-user e-mail.
+ * This can potentially be abused, as it's hard to track.
+ * @global bool $wgEnableUserEmail
+ */
+$wgEnableUserEmail = true;
 
 /**
  * SMTP Mode
@@ -208,11 +229,12 @@ $wgDBschema           = 'mediawiki';
 
 
 
-# Shared database for multiple wikis.
-# Presently used for storing a user table for single sign-on
-# The server for this database must be the same as for the main
-# database.
-# EXPERIMENTAL
+/**
+ * Shared database for multiple wikis. Presently used for storing a user table
+ * for single sign-on. The server for this database must be the same as for the
+ * main database.
+ * EXPERIMENTAL
+ */
 $wgSharedDB = null;
 
 # Database load balancer
@@ -234,31 +256,31 @@ $wgSharedDB = null;
 # Leave at false to use the single-server variables above
 $wgDBservers           = false; 
 
-# Sysop SQL queries
-#   The sql user shouldn't have too many rights other the database, restrict
-#   it to SELECT only on 'cur' table for example
-#
-$wgAllowSysopQueries = false; # Dangerous if not configured properly.
-$wgDBsqluser           = 'sqluser';
-$wgDBsqlpassword       = 'sqlpass';
-$wgDBpassword       = 'userpass';
-$wgSqlLogFile           = "{$wgUploadDirectory}/sqllog_mFhyRe6";
-$wgDBerrorLog          = false; # File to log MySQL errors to
-
-# wgDBminWordLen :
-#  MySQL 3.x : used to discard words that MySQL will not return any results for
-#  shorter values configure mysql directly
-#  MySQL 4.x : ignore it and configure mySQL
-# See: http://dev.mysql.com/doc/mysql/en/Fulltext_Fine-tuning.html
+/** How long to wait for a slave to catch up to the master */ 
+$wgMasterWaitTimeout = 10;
+
+/** File to log MySQL errors to */
+$wgDBerrorLog          = false;
+
+/**
+ * wgDBminWordLen :
+ * MySQL 3.x : used to discard words that MySQL will not return any results for
+ * shorter values configure mysql directly.
+ * MySQL 4.x : ignore it and configure mySQL
+ * See: http://dev.mysql.com/doc/mysql/en/Fulltext_Fine-tuning.html
+ */
 $wgDBminWordLen     = 4;
-$wgDBtransactions      = false; # Set to true if using InnoDB tables
-$wgDBmysql4                    = false; # Set to true to use enhanced fulltext search
+/** Set to true if using InnoDB tables */
+$wgDBtransactions      = false;
+/** Set to true to use enhanced fulltext search */
+$wgDBmysql4                    = false;
 $wgSqlTimeout          = 30;
 
-$wgBufferSQLResults     = true; # use buffered queries by default
-
-# Other wikis on this site, can be administered from a single developer account
-# Array, interwiki prefix => database name
+/**
+ * Other wikis on this site, can be administered from a single developer
+ * account.
+ * Array, interwiki prefix => database name
+ */ 
 $wgLocalDatabases   = array();
 
 
@@ -285,26 +307,21 @@ $wgUseTurckShm      = false;
 
 # Language settings
 #
-/**
- * Site language code
- * Default to 'en'. Should be one of ./language/Language(.*).php
- * @global string $wgLanguageCode
- */
+/** Site language code, should be one of ./language/Language(.*).php */
 $wgLanguageCode     = 'en';
 
-/**
- * Filename of a language file generated by dumpMessages.php
- * @global string|false $wgLanguageFile (default:false)
- */
+/** Filename of a language file generated by dumpMessages.php */
 $wgLanguageFile     = false;
-/**
- * Treat language links as magic connectors, not inline links
- * @global bool $wgInterwikiMagic (default:true)
- */
+
+/** Treat language links as magic connectors, not inline links */
 $wgInterwikiMagic      = true;
-$wgInputEncoding       = 'ISO-8859-1'; # LanguageUtf8.php normally overrides this
-$wgOutputEncoding      = 'ISO-8859-1'; # unless you set the next option to true:
-$wgUseLatin1           = false; # Enable ISO-8859-1 compatibility mode
+
+/** LanguageUtf8.php normally overrides this */
+$wgInputEncoding       = 'ISO-8859-1';
+/** unless you set the next option to true: */
+$wgOutputEncoding      = 'ISO-8859-1'; 
+/** Enable ISO-8859-1 compatibility mode */
+$wgUseLatin1           = false;
 $wgEditEncoding                = '';
 
 # Set this to eg 'ISO-8859-1' to perform character set
@@ -320,12 +337,17 @@ $wgLegacyEncoding   = false;
 $wgMimeType                    = 'text/html';
 $wgDocType                     = '-//W3C//DTD XHTML 1.0 Transitional//EN';
 $wgDTD                         = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd';
-$wgUseDynamicDates  = false; # Enable to allow rewriting dates in page text
-                                                        # DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES
-$wgAmericanDates    = false; # Enable for English module to print dates
-                                                        # as eg 'May 12' instead of '12 May'
-$wgTranslateNumerals = true; # For Hindi and Arabic use local numerals instead
-                             # of Western style (0-9) numerals in interface.
+
+/** Enable to allow rewriting dates in page text.
+ * DOES NOT FORMAT CORRECTLY FOR MOST LANGUAGES */
+$wgUseDynamicDates  = false; 
+/** Enable for English module to print dates as eg 'May 12' instead of '12 May' */
+$wgAmericanDates    = false; 
+/**
+ * For Hindi and Arabic use local numerals instead of Western style (0-9)
+ * numerals in interface.
+ */
+$wgTranslateNumerals = true;
 
 
 # Translation using MediaWiki: namespace
@@ -339,9 +361,11 @@ $wgPartialMessageCache = false;
 # supports this function, to convert between Traditional and Simplified
 # Chinese. This flag is meant to isolate the (untested) conversion 
 # code, so that if it breaks, only zh will be affected
-$wgDisableLangConversion = true;
+$wgDisableLangConversion = false;
 
 # Whether to use zhdaemon to perform Chinese text processing
+# zhdaemon is under developement, so normally you don't want to
+# use it unless for testing
 $wgUseZhdaemon = false;
 $wgZhdaemonHost="localhost";
 $wgZhdaemonPort=2004;
@@ -359,10 +383,10 @@ $wgExtraSubtitle  = '';
 $wgSiteSupportPage     = ''; # A page where you users can receive donations
 
 $wgReadOnlyFile         = "{$wgUploadDirectory}/lock_yBgMBwiR";
-$wgUseData = false ;
 
-# The debug log file should be not be publicly accessible if it is
-# used, as it may contain private data.
+/**
+ * The debug log file should be not be publicly accessible if it is used, as it
+ * may contain private data. */
 $wgDebugLogFile         = '';
 
 /**#@+
@@ -376,9 +400,12 @@ $wgReadOnly             = false;
 $wgLogQueries           = false;
 $wgDebugDumpSql         = false;
 
-# Whether to disable automatic generation of "we're sorry,
-# but there has been a database error" pages.
-$wgIgnoreSQLErrors      = false;
+/**
+ * Whether to show "we're sorry, but there has been a database error" pages.
+ * Displaying errors aids in debugging, but may display information useful
+ * to an attacker.
+ */
+$wgShowSQLErrors        = false;
 
 # Should [[Category:Dog]] on a page associate it with the
 # category "Dog"? (a link to that category page will be
@@ -386,28 +413,40 @@ $wgIgnoreSQLErrors      = false;
 # all articles in the category)
 $wgUseCategoryMagic            = true;
 
-# disable experimental dmoz-like category browsing. Output things like:
-# Encyclopedia > Music > Style of Music > Jazz
-# FIXME: need fixing
+/**
+ * disable experimental dmoz-like category browsing. Output things like:
+ * Encyclopedia > Music > Style of Music > Jazz
+ */
 $wgUseCategoryBrowser   = false;
 
 $wgEnablePersistentLC  = false;        # Obsolete, do not use
 $wgCompressedPersistentLC = true; # use gzcompressed blobs
 $wgUseOldExistenceCheck = false;  # use old prefill link method, for debugging only
 
-$wgEnableParserCache = false; # requires that php was compiled --with-zlib
-/**#@-*/
+/**
+ * Keep parsed pages in a cache (objectcache table, turck, 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.
+ */
+$wgEnableParserCache = true;
 
-# 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.
+/**#@-*/
 
+/**
+ * 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.
+*/
 $wgHitcounterUpdateFreq = 1;
 
-# User rights
-#   It's not 100% safe, there could be security hole using that one. Use at your
+# User rights settings
+#
+#  It's not 100% safe, there could be security hole using that one. Use at your
 # own risks.
 
 $wgWhitelistEdit = false;   # true = user must login to edit.
@@ -424,174 +463,287 @@ $wgAutoblockExpiry              = 86400; # Number of seconds before autoblock entries expire
 
 # Proxy scanner settings
 #
-$wgBlockOpenProxies = false; # Automatic open proxy test on edit
+
+/**
+ * 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.
+ */
+$wgBlockOpenProxies = false;
+/** Port we want to scan for a proxy */
 $wgProxyPorts = array( 80, 81, 1080, 3128, 6588, 8000, 8080, 8888, 65506 );
+/** Script used to scan */
 $wgProxyScriptPath = "$IP/proxy_check.php";
+/** */
 $wgProxyMemcExpiry = 86400;
+/** */
 $wgProxyKey = 'W1svekXc5u6lZllTZOwnzEk1nbs';
-$wgProxyList = array();  # big list of banned IP addresses, in the keys not the values
+/** big list of banned IP addresses, in the keys not the values */
+$wgProxyList = array();
 
-# Number of accounts each IP address may create, 0 to disable.
-# Requires memcached
+/** Number of accounts each IP address may create, 0 to disable.
+ * Requires memcached */
 $wgAccountCreationThrottle = 0;
 
-
 # Client-side caching:
-$wgCachePages       = true; # Allow client-side caching of pages
 
-# Set this to current time to invalidate all prior cached pages.
-# Affects both client- and server-side caching.
+/** Allow client-side caching of pages */
+$wgCachePages       = true;
+
+/**
+ * Set this to current time to invalidate all prior cached pages. Affects both
+ * client- and server-side caching.
+ */
 $wgCacheEpoch = '20030516000000';
 
 
 # Server-side caching:
-#  This will cache static pages for non-logged-in users
-#  to reduce database traffic on public sites.
-#  Must set $wgShowIPinHeader = false
+
+/**
+ * This will cache static pages for non-logged-in users to reduce
+ * database traffic on public sites.
+ * Must set $wgShowIPinHeader = false
+ */  
 $wgUseFileCache = false;
+/** Directory where the cached page will be saved */
 $wgFileCacheDirectory = "{$wgUploadDirectory}/cache";
 
-# 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.
+/**
+ * When using the file cache, we can store the cached HTML gzipped to save disk
+ * space. Pages will then also be served compressed to clients that support it.
+ * THIS IS NOT COMPATIBLE with ob_gzhandler which is now enabled if supported in
+ * the default LocalSettings.php! If you enable this, remove that setting first.
+ * 
+ * Requires zlib support enabled in PHP.
+ */
 $wgUseGzip = false;
 
+# Email notification settings
+#
 
-$wgCookieExpiration = 2592000;
+/** 
+ * Program to run when the email is actually sent out. You might want to make
+ * your server beep for example. Usermailer.php will make a system() call with
+ * exactly that string as parameter.
+ */
+# $wgEmailNotificationSystembeep = '/usr/bin/beep -f 4000 -l 20 &';
+$wgEmailNotificationSystembeep = '';
+
+/** For email notification on page changes */
+$wgPasswordSender = $wgEmergencyContact;
+
+# true: from PageEditor if s/he opted-in
+# false: Enotif mails appear to come from $wgEmergencyContact
+$wgEmailNotificationMailsSentFromPageEditor    = false; 
+
+// TODO move UPO to preferences probably ?
+# If set to true, users get a corresponding option in their preferences and can choose to enable or disable at their discretion
+# If set to false, the corresponding input form on the user preference page is suppressed
+# It call this to be a "user-preferences-option (UPO)"
+$wgEmailAuthentication                         = true; # UPO (if this is set to false, texts referring to authentication are suppressed)
+$wgEmailNotificationForWatchlistPages          = false; # UPO
+$wgEmailNotificationForUserTalkPages           = false;        # UPO
+$wgEmailNotificationRevealPageEditorAddress    = false;        # UPO; reply-to address may be filled with page editor's address (if user allowed this in the preferences)
+$wgEmailNotificationForMinorEdits              = true; # UPO; false: "minor edits" on pages do not trigger notification mails.
+#                                                      # Attention: _every_ change on a user_talk page trigger a notification mail (if the user is not yet notified)
+
+
+/** Show watching users in recent changes, watchlist and page history views */
+$wgRCShowWatchingUsers                                 = false; # UPO
+/** Show watching users in Page views */
+$wgPageShowWatchingUsers                       = false;
+/**
+ * Show "Updated (since my last visit)" marker in RC view, watchlist and history
+ * view for watched pages with new changes */
+$wgShowUpdatedMarker                           = true; # UPO
 
+$wgCookieExpiration = 2592000;
 
 # Squid-related settings
 #
 
-# Enable/disable Squid
- $wgUseSquid = false;
+/** Enable/disable Squid */
+$wgUseSquid = false;
  
-# If you run Squid3 with ESI support, enable this (default:false):
- $wgUseESI = false;
+/** If you run Squid3 with ESI support, enable this (default:false): */
+$wgUseESI = false;
  
-# Internal server name as known to Squid, if different
+/** Internal server name as known to Squid, if different */
 # $wgInternalServer = 'http://yourinternal.tld:8000';
- $wgInternalServer = $wgServer;
+$wgInternalServer = $wgServer;
  
-# Cache timeout for the squid, will be sent as s-maxage (without ESI) or 
-# Surrogate-Control (with ESI). Without ESI, you should strip out s-maxage in the Squid config.
-# 18000 seconds = 5 hours, more cache hits with 2678400 = 31 days
- $wgSquidMaxage = 18000;
+/**
+ * Cache timeout for the squid, will be sent as s-maxage (without ESI) or
+ * Surrogate-Control (with ESI). Without ESI, you should strip out s-maxage in
+ * the Squid config. 18000 seconds = 5 hours, more cache hits with 2678400 = 31
+ * days
+ */
+$wgSquidMaxage = 18000;
  
-# A list of proxy servers (ips if possible) to purge on changes
-# don't specify ports here (80 is default)
+/**
+ * A list of proxy servers (ips if possible) to purge on changes don't specify
+ * ports here (80 is default)
+ */
 # $wgSquidServers = array('127.0.0.1');
+$wgSquidServers = array();
+$wgSquidServersNoPurge = array();
 
-# Maximum number of titles to purge in any one client operation
+/** Maximum number of titles to purge in any one client operation */
 $wgMaxSquidPurgeTitles = 400;
 
 
 # Cookie settings:
-#   Set to set an explicit domain on the login cookies
-#   eg, "justthis.domain.org" or ".any.subdomain.net"
+#
+/**
+ * Set to set an explicit domain on the login cookies eg, "justthis.domain. org"
+ * or ".any.subdomain.net"
+ */
 $wgCookieDomain = '';
 $wgCookiePath = '/';
 $wgDisableCookieCheck = false;
 
-# Whether to allow inline image pointing to other websites
+/**  Whether to allow inline image pointing to other websites */
 $wgAllowExternalImages = true;
 
-$wgMiserMode = false; # Disable database-intensive features
-$wgDisableQueryPages = false; # Disable all query pages if miser mode is on, not just some
-$wgUseWatchlistCache = false; # Generate a watchlist once every hour or so
-$wgWLCacheTimeout = 3600;     # The hour or so mentioned above
+/** Disable database-intensive features */
+$wgMiserMode = false;
+/** Disable all query pages if miser mode is on, not just some */
+$wgDisableQueryPages = false;
+/** Generate a watchlist once every hour or so */
+$wgUseWatchlistCache = false;
+/** The hour or so mentioned above */
+$wgWLCacheTimeout = 3600;
 
-# 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 math/README for more information.
+/**
+ * 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.
+ */
 $wgUseTeX = false;
-$wgTexvc = './math/texvc'; # Location of the texvc binary
+/** Location of the texvc binary */
+$wgTexvc = './math/texvc';
 
+#
 # Profiling / debugging
-$wgProfiling = false; # Enable for more detailed by-function times in debug log
-$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.
-$wgProfileSampleRate = 1; # Only profile every n requests when profiling is turned on
-$wgDebugProfiling = false; # Detects non-matching wfProfileIn/wfProfileOut calls
-$wgDebugFunctionEntry = 0; # Output debug message on every wfProfileIn/wfProfileOut
-$wgDebugSquid = false; # Lots of debugging output from SquidUpdate.php
+#
+
+/** Enable for more detailed by-function times in debug log */
+$wgProfiling = false; 
+/** Only record profiling info for pages that took longer than this */
+$wgProfileLimit = 0.0;
+/** Don't put non-profiling info into log file */
+$wgProfileOnly = false; 
+/** Log sums from profiling into "profiling" table in db. */
+$wgProfileToDatabase = false;
+/** Only profile every n requests when profiling is turned on */
+$wgProfileSampleRate = 1;
+/** If true, print a raw call tree instead of per-function report */
+$wgProfileCallTree = false; 
+
+/** Detects non-matching wfProfileIn/wfProfileOut calls */
+$wgDebugProfiling = false;
+/** Output debug message on every wfProfileIn/wfProfileOut */
+$wgDebugFunctionEntry = 0;
+/** Lots of debugging output from SquidUpdate.php */
+$wgDebugSquid = false;
 
 $wgDisableCounters = false;
 $wgDisableTextSearch = false;
-$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.
-$wgDisableUploads = true; # Uploads have to be specially set up to be secure
-$wgRemoteUploads = false; # Set to true to enable the upload _link_ while local uploads are disabled. Assumes that the special page link will be bounced to another server where uploads do work.
+/**
+ * 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.
+ */
+$wgDisableSearchUpdate = false;
+/** Uploads have to be specially set up to be secure */
+$wgDisableUploads = true;
+/**
+ * Set to true to enable the upload _link_ while local uploads are disabled.
+ * Assumes that the special page link will be bounced to another server where
+ * uploads do work.
+ */
+$wgRemoteUploads = false; 
 $wgDisableAnonTalk = false;
 
-# Path to the GNU diff3 utility. If the file doesn't exist,
-# edit conflicts will fall back to the old behaviour (no merging).
+/**
+ * Path to the GNU diff3 utility. If the file doesn't exist, edit conflicts will
+ * fall back to the old behaviour (no merging).
+ */
 $wgDiff3 = '/usr/bin/diff3';
 
-
-# We can also compress text in the old revisions table. If this is set on,
-# old 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.
+/** 
+ * We can also compress text in the old revisions table. If this is set on, old
+ * revisions will be compressed on page save if zlib support is available. Any
+ * compressed revisions will be decompressed on load regardless of this setting
+ * *but will not be readable at all* if zlib support is not available.
+ */
 $wgCompressRevisions = false;
 
-# This is the list of preferred extensions for uploading files. Uploading
-# files with extensions not in this list will trigger a warning.
-$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'ogg' );
+/**
+ * This is the list of preferred extensions for uploading files. Uploading files
+ * with extensions not in this list will trigger a warning.
+ */
+$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );
 
-# Files with these extensions will never be allowed as uploads.
+/** Files with these extensions will never be allowed as uploads. */
 $wgFileBlacklist = array(
        # HTML may contain cookie-stealing JavaScript and web bugs
        'html', 'htm',
        # PHP scripts may execute arbitrary code on the server
        'php', 'phtml', 'php3', 'php4', 'phps',
        # Other types that may be interpreted by some servers
-       'shtml', 'jhtml', 'pl', 'py',
+       'shtml', 'jhtml', 'pl', 'py', 'cgi',
        # May contain harmful executables for Windows victims
        'exe', 'scr', 'dll', 'msi', 'vbs', 'bat', 'com', 'pif', 'cmd', 'vxd', 'cpl' );
 
-# This is a flag to determine whether or not to check file extensions on
-# upload.
+/** This is a flag to determine whether or not to check file extensions on upload. */
 $wgCheckFileExtensions = true;
 
-# If this is turned off, users may override the warning for files not
-# covered by $wgFileExtensions.
+/**
+ * If this is turned off, users may override the warning for files not covered
+ * by $wgFileExtensions.
+ */
 $wgStrictFileExtensions = true;
 
-# Warn if uploaded files are larger than this
+/** Warn if uploaded files are larger than this */
 $wgUploadSizeWarning = 150000;
 
-$wgPasswordSalt = true; # For compatibility with old installations set to false
+/** For compatibility with old installations set to false */
+$wgPasswordSalt = true; 
 
-# Which namespaces should support subpages?
-# See Language.php for a list of namespaces.
-#
+/** Which namespaces should support subpages?
+ * See Language.php for a list of namespaces.
+ */
 $wgNamespacesWithSubpages = array( -1 => 0, 0 => 0, 1 => 1,
   2 => 1, 3 => 1, 4 => 0, 5 => 1, 6 => 0, 7 => 1, 8 => 0, 9 => 1, 10 => 0, 11 => 1);
 
 $wgNamespacesToBeSearchedDefault = array( -1 => 0, 0 => 1, 1 => 0,
   2 => 0, 3 => 0, 4 => 0, 5 => 0, 6 => 0, 7 => 0, 8 => 0, 9 => 1, 10 => 0, 11 => 1 );
 
-# If set, a bold ugly notice will show up at the top of every page.
-$wgSiteNotice = "";
+/** If set, a bold ugly notice will show up at the top of every page. */
+$wgSiteNotice = '';
 
-## Set $wgUseImageResize to true if you want to enable dynamic
-## server side image resizing ("Thumbnails")
-# 
-$wgUseImageResize              = false;
 
-## Resizing can be done using PHP's internal image libraries
-## or using ImageMagick. The later supports more file formats
-## than PHP, which only supports PNG, GIF, JPG, XBM and WBMP.
-##
-## Set $wgUseImageMagick to true to use Image Magick instead
-## of the builtin functions
 #
+# Images settings
+#
+
+/** dynamic server side image resizing ("Thumbnails") */
+$wgUseImageResize              = false;
+
+/**
+ * Resizing can be done using PHP's internal image libraries or using
+ * ImageMagick. The later supports more file formats than PHP, which only
+ * supports PNG, GIF, JPG, XBM and WBMP.
+ * 
+ * Use Image Magick instead of PHP builtin functions.
+ */
 $wgUseImageMagick              = false;
+/** The convert command shipped with ImageMagick */
 $wgImageMagickConvertCommand    = '/usr/bin/convert';
 
 # Scalable Vector Graphics (SVG) may be uploaded as images.
@@ -605,156 +757,211 @@ $wgSVGConverters = array(
        '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',
        );
-$wgSVGConverter = 'ImageMagick'; # Pick one of the above
-$wgSVGConverterPath = ''; # If not in the executable PATH, specify
-
-# PHPTal is a library for page templates. MediaWiki includes
-# a recent PHPTal distribution. It is required to use the
-# Monobook (default) skin.
-#
-# Currently it does not work on PHP5.
-$wgUsePHPTal = version_compare( phpversion(), "5.0", "lt" );
+/** Pick one of the above */
+$wgSVGConverter = 'ImageMagick';
+/** If not in the executable PATH, specify */
+$wgSVGConverterPath = '';
 
+/** @todo FIXME what does it do here ?? [ashar] */
 if( !isset( $wgCommandLineMode ) ) {
        $wgCommandLineMode = false;
 }
 
-# Show seconds in Recent Changes
+
+#
+# Recent changes settings
+#
+
+/** Show seconds in Recent Changes */
 $wgRCSeconds = false;
 
-# Log IP addresses in the recentchanges table
+/** Log IP addresses in the recentchanges table */
 $wgPutIPinRC = false;
 
-# RDF metadata toggles
+/**
+ * Recentchanges items are periodically purged; entries older than this many
+ * seconds will go.
+ * For one week : 7 * 24 * 3600
+ */
+$wgRCMaxAge = 7 * 24 * 3600;
+
+
+#
+# Copyright and credits settings
+#
+
+/** RDF metadata toggles */
 $wgEnableDublinCoreRdf = false;
 $wgEnableCreativeCommonsRdf = false;
 
-# Override for copyright metadata.
-# TODO: these options need documentation
+/** Override for copyright metadata.
+ * TODO: these options need documentation
+ */
 $wgRightsPage = NULL;
 $wgRightsUrl = NULL;
 $wgRightsText = NULL;
 $wgRightsIcon = NULL;
 
-# Set this to true if you want detailed copyright information forms on Upload.
+/** Set this to some HTML to override the rights icon with an arbitrary logo */
+$wgCopyrightIcon = NULL;
+
+/** Set this to true if you want detailed copyright information forms on Upload. */
 $wgUseCopyrightUpload = false;
 
-# Set this to false if you want to disable checking that detailed 
-# copyright information values are not empty.
+/** Set this to false if you want to disable checking that detailed copyright
+ * information values are not empty. */
 $wgCheckCopyrightUpload = true;
 
+/**
+ * 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.
+ */
+$wgMaxCredits = 0;
+
+/** If there are more than $wgMaxCredits authors, show $wgMaxCredits of them.
+ * Otherwise, link to a separate credits page. */
+$wgShowCreditsIfMax = 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.
+
+
+/**
+ * Set this to false to avoid forcing the first letter of links to capitals.
+ * WARNING: may break links! This makes links COMPLETELY case-sensitive. Links
+ * appearing with a capital at the beginning of a sentence will *not* go to the
+ * same place as links in the middle of a sentence using a lowercase initial.
+ */
 $wgCapitalLinks = true;
 
-# 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'.
+/**
+ * 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'.
+ */
 $wgImportSources = array();
 
-# 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.
-$wgMaxCredits = 0;
 
-# If there are more than $wgMaxCredits authors, show $wgMaxCredits of them.
-# Otherwise, link to a separate credits page.
-$wgShowCreditsIfMax = true;
 
-# Text matching this regular expression will be recognised as spam
-# See http://en.wikipedia.org/wiki/Regular_expression
+/** Text matching this regular expression will be recognised as spam
+ * See http://en.wikipedia.org/wiki/Regular_expression */
 $wgSpamRegex = false; 
-# Similarly if this function returns true
+/** Similarly if this function returns true */
 $wgFilterCallback = false;
 
-# Go button goes straight to the edit screen if the article doesn't exist
+/** Go button goes straight to the edit screen if the article doesn't exist. */
 $wgGoToEdit = false;
 
-# Allow limited user-specified HTML in wiki pages?
-# It will be run through a whitelist for security.
-# Set this to false if you want wiki pages to consist only of wiki
-# markup. Note that replacements do not yet exist for all HTML
-# constructs.
+/** Allow limited user-specified HTML in wiki pages?
+ * It  will be run through a whitelist for security. Set this to false if you
+ * want wiki pages to consist only of wiki markup. Note that replacements do not
+ * yet exist for all HTML constructs.*/
 $wgUserHtml = true;
 
-# Allow raw, unchecked HTML in <html>...</html> sections.
-# THIS IS VERY DANGEROUS on a publically editable site, so
-# you can't enable it unless you've restricted editing to
-# trusted users only with $wgWhitelistEdit.
+/** Allow raw, unchecked HTML in <html>...</html> sections.
+ * THIS IS VERY DANGEROUS on a publically editable site, so you can't enable it
+ * unless you've restricted editing to trusted users only with $wgWhitelistEdit.
+ */
 $wgRawHtml = false;
 
-# $wgUseTidy: use tidy to make sure HTML output is sane.
-# This should only be enabled if $wgUserHtml is true.
-# 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.
+/**
+ * $wgUseTidy: use tidy to make sure HTML output is sane.
+ * This should only be enabled if $wgUserHtml is true.
+ * 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.
+ */
 $wgUseTidy = false;
 $wgTidyBin = 'tidy';
 $wgTidyConf = $IP.'/extensions/tidy/tidy.conf'; 
 $wgTidyOpts = '';
 
-# See list of skins and their symbolic names in language/Language.php
+/** See list of skins and their symbolic names in languagel/Language.php */
 $wgDefaultSkin = 'monobook';
 
-# Whether or not to allow real name fields. Defaults to true.
-$wgAllowRealName = true;
+/**
+ * Settings added to this array will override the language globals for the user
+ * preferences used by anonymous visitors and newly created accounts. (See names
+ * and sample values in languages/Language.php)
+ * For instance, to disable section editing links:
+ *  $wgDefaultUserOptions ['editsection'] = 0;
+ * 
+ */
+$wgDefaultUserOptions = array();
 
-# Use XML parser?
+/** Whether or not to allow and use real name fields. Defaults to true. */
+$wgAllowRealName = true;
 
+/** Use XML parser? */
 $wgUseXMLparser = false ;
 
-# Extensions
+/** Extensions */
 $wgSkinExtensionFunctions = array();
 $wgExtensionFunctions = array();
 
-# Allow user Javascript page?
-$wgAllowUserJs = true;
+/**
+ * Allow user Javascript page?
+ * This enables a lot of neat customizations, but may
+ * increase security risk to users and server load.
+ */
+$wgAllowUserJs = false;
 
-# Allow user Cascading Style Sheets (CSS)?
-$wgAllowUserCss = true;
+/**
+ * Allow user Cascading Style Sheets (CSS)?
+ * This enables a lot of neat customizations, but may
+ * increase security risk to users and server load.
+ */
+$wgAllowUserCss = false;
 
-# Use the site's Javascript page?
+/** Use the site's Javascript page? */
 $wgUseSiteJs = true;
 
-# Use the site's Cascading Style Sheets (CSS)?
+/** Use the site's Cascading Style Sheets (CSS)? */
 $wgUseSiteCss = true;
        
-# Filter for Special:Randompage. Part of a WHERE clause
+/** Filter for Special:Randompage. Part of a WHERE clause */
 $wgExtraRandompageSQL = false;
 
-# Allow the "info" action, very inefficient at the moment
+/** Allow the "info" action, very inefficient at the moment */
 $wgAllowPageInfo = false;
 
-# Maximum indent level of toc.
+/** Maximum indent level of toc. */
 $wgMaxTocLevel = 999;
 
-# Recognise longitude/latitude coordinates
-$wgUseGeoMode = false;
-
-# Validation for print or other production versions
-$wgUseValidation = false;
-
-# Use external C++ diff engine (module wikidiff from the
-# extensions package)
+/** Use external C++ diff engine (module wikidiff from the extensions package) */
 $wgUseExternalDiffEngine = false;
 
-# Use RC Patrolling to check for vandalism
+/** Use RC Patrolling to check for vandalism */
 $wgUseRCPatrol = true;
 
-# Additional namespaces. If the namespaces defined in Language.php and Namespace.php are insufficient,
-# you can create new ones here, for example, to import Help files in other languages.
-# PLEASE NOTE: Once you delete a namespace, the pages in that namespace will no longer be accessible.
-# If you rename it, then you can access them through the new namespace name.
-#
-# Custom namespaces should start at 100.
+/** Set maximum number of results to return in syndication feeds (RSS, Atom) for
+ * eg Recentchanges, Newpages. */
+$wgFeedLimit = 50;
+
+/** _Minimum_ timeout for cached Recentchanges feed, in seconds.
+ * A cached version will continue to be served out even if changes
+ * are made, until this many seconds runs out since the last render. */
+$wgFeedCacheTimeout = 60;
+
+/** When generating Recentchanges RSS/Atom feed, diffs will not be generated for
+ * pages larger than this size. */
+$wgFeedDiffCutoff = 32768;
+
+
+/**
+ * Additional namespaces. If the namespaces defined in Language.php and
+ * Namespace.php are insufficient,# you can create new ones here, for example,
+ * to import Help files in other languages.
+ * PLEASE  NOTE: Once you delete a namespace, the pages in that namespace will
+ * no longer be accessible. If you rename it, then you can access them through
+ * the new namespace name.
+ * 
+ * Custom namespaces should start at 100 and stop at 255 (hard limit set by
+ * database).
+ */
 #$wgExtraNamespaces =
 #      array(100 => "Hilfe",
 #            101 => "Hilfe_Diskussion",
@@ -763,17 +970,21 @@ $wgUseRCPatrol = true;
 #            );
 $wgExtraNamespaces = NULL;
 
-# Enable SOAP interface. Off by default
-# SOAP is a protocoll for remote procedure calls (RPC) using http as middleware.
-# This interface can be used by bots or special clients to receive articles from
-# a wiki.
-# Most bots use the normal HTTP interface and don't use SOAP.
-# If unsure, set to false.
+/**
+ * Enable SOAP interface. Off by default
+ * SOAP is a protocoll for remote procedure calls (RPC) using http as
+ * middleware. This interface can be used by bots or special clients to receive
+ * articles from a wiki.
+ * Most bots use the normal HTTP interface and don't use SOAP.
+ * If unsure, set to false.
+ */
 $wgEnableSOAP = false;
 
-# 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. This is the list of
-# settings the user can choose from:
+/**
+ * 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. This is the
+ * list of settings the user can choose from:
+ */
 $wgImageLimits = array (
        array(320,240),
        array(640,480),
@@ -799,35 +1010,118 @@ $wgNavigationLinks = array (
        array( 'text'=>'sitesupport',   'href'=>'sitesupport-url' ),
 );
 
-# On category pages, show thumbnail gallery for images belonging to that category
-# instead of listing them as articles.
+/**
+ *  On  category pages, show thumbnail gallery for images belonging to that
+ * category instead of listing them as articles.
+ */
 $wgCategoryMagicGallery = true;
 
-# Browser Blacklist for unicode non compliant browsers
-# Contains a list of regexps : "/regexp/"  matching problematic browsers
+/**
+ * Browser Blacklist for unicode non compliant browsers
+ * Contains a list of regexps : "/regexp/"  matching problematic browsers
+ */
 $wgBrowserBlackList = array(
        "/Mozilla\/4\.78 \[en\] \(X11; U; Linux/"
        // FIXME: Add some accurate, true things here
        );
 
-# 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 is the same as the timezone
+/**
+ * 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 is the same as the timezone.
+ */
 # $wgLocaltimezone = 'GMT';
 # $wgLocaltimezone = 'PST8PDT';
 # $wgLocaltimezone = 'Europe/Sweden';
 # $wgLocaltimezone = 'CET';
+$wgLocaltimezone = null;
 
-# User level management
-# The number is the database id of a group you want users to be attached by
-# default. A better interface should be coded [av]
+/**
+ * User level management
+ * The number is the database id of a group you want users to be attached by
+ * default. A better interface should be coded [av]
+ */
 $wgAnonGroupId = 1;
 $wgLoggedInGroupId = 2;
+$wgSysopGroupId = 3;
+$wgBureaucratGroupId = 4;
 
-$wgWhitelistRead = array ( ':Accueil', ':Main_Page');
+/**
+ * When translating messages with wfMsg(), it is not always clear what should be
+ * considered UI messages and what shoud be content messages.
+ *
+ * For example, for regular wikipedia site like en, there should be only one
+ * 'mainpage', therefore when getting the link of 'mainpage', we should treate
+ * it as content of the site and call wfMsgForContent(), while for rendering the
+ * text of the link, we call wfMsg(). The code in default behaves this way.
+ * However, sites like common 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 mainpage and
+ * community portal, set
+ *
+ * $wgForceUIMsgAsContentMsg = array( 'mainpage', 'portal-url' );
+ */
+$wgForceUIMsgAsContentMsg = array();
+
+
+/**
+ * Authentication plugin.
+ */
+$wgAuth = null;
+
+/**
+ * Global list of hooks.
+ * Add a hook by doing:
+ *     $wgHooks['event_name'][] = $function;
+ * or:
+ *     $wgHooks['event_name'][] = array($function, $data);
+ * or:
+ *     $wgHooks['event_name'][] = array($object, 'method');
+ */    
+$wgHooks = array();
+
+/**
+ * Experimental preview feature to fetch rendered text
+ * over an XMLHttpRequest from JavaScript instead of
+ * forcing a submit and reload of the whole page.
+ * Leave disabled unless you're testing it.
+ */
+$wgLivePreview = false;
+
+/**
+ * Disable the internal MySQL-based search, to allow it to be
+ * implemented by an extension instead.
+ */
+$wgDisableInternalSearch = false;
+
+/**
+ * Set this to a URL to forward search requests to some external location.
+ * If the URL includes '$1', this will be replaced with the URL-encoded
+ * search term.
+ * 
+ * For example, to forward to Google you'd have something like:
+ * $wgSearchForwardUrl = 'http://www.google.com/search?q=$1' .
+ *                       '&domains=http://example.com' .
+ *                       '&sitesearch=http://example.com' .
+ *                       '&ie=utf-8&oe=utf-8';
+ */
+$wgSearchForwardUrl = null;
+
+/**
+ * If true, external URL links in wiki text will be given the
+ * rel="nofollow" attribute as a hint to search engines that
+ * they should not be followed for ranking purposes as they
+ * are user-supplied and thus subject to spamming.
+ */
+$wgNoFollowLinks = true;
+
+/**
+ * Specifies the minimal length of a user password. If set to
+ * 0, empty passwords are allowed.
+ */
+$wgMinimalPasswordLength = 0;
 
 } else {
        die();
 }
-?>
+?>
\ No newline at end of file