Implementing user levels management. This is only a very basic interface and several...
[lhc/web/wiklou.git] / includes / DefaultSettings.php
index 2b0a5dd..06b7b3a 100644 (file)
 <?php
-# $Id$
-# DO NOT EDIT THIS FILE!
 /**
+ * DO NOT EDIT THIS FILE!
+ *
  * To customize your installation, edit "LocalSettings.php".
  *
  * Note that since all these string interpolations are expanded
  * before LocalSettings is included, if you localize something
  * 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';
 
-$wgSitename         = 'MediaWiki'; # Please customize!
-$wgMetaNamespace    = FALSE; # will be same as you set $wgSitename
+/** 
+ * Name of the site.
+ * It must be changed in LocalSettings.php
+ * @global string $wgSitename
+ */
+$wgSitename         = 'MediaWiki';
 
+/**
+ * Will be same as you set @see $wgSitename
+ * @global mixed $wgMetaNamespace
+ */
+$wgMetaNamespace    = FALSE;
+
+
+/** 
+ * URL of the server
+ * It will be automaticly build including https mode
+ * @global string $wgServer
+ */
+$wgServer = '';
+
+if( isset( $_SERVER['SERVER_NAME'] ) ) {
+       $wgServerName = $_SERVER['SERVER_NAME'];
+} elseif( isset( $_SERVER['HOSTNAME'] ) ) {
+       $wgServerName = $_SERVER['HOSTNAME'];
+} else {
+       # FIXME: Fall back on... something else?
+       $wgServerName = 'localhost';
+}
 
 # check if server use https:
 $wgProto = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] == 'on') ? 'https' : 'http';
 
-if ( @$wgCommandLineMode ) {
-       $wgServer = $wgProto.'://localhost';
-} else {
-       $wgServer           = $wgProto.'://' . $_SERVER['SERVER_NAME'];
-       if( $_SERVER['SERVER_PORT'] != 80 ) $wgServer .= ":" . $_SERVER['SERVER_PORT'];
+$wgServer = $wgProto.'://' . $wgServerName;
+if( isset( $_SERVER['SERVER_PORT'] ) && $_SERVER['SERVER_PORT'] != 80 ) {
+       $wgServer .= ":" . $_SERVER['SERVER_PORT'];
 }
 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';
 
-# Whether to support URLs like index.php/Page_title
+/**
+ * Whether to support URLs like index.php/Page_title
+ * @global bool $wgUsePathInfo
+ */
 $wgUsePathInfo         = ( strpos( php_sapi_name(), 'cgi' ) === false );
 
-# ATTN: Old installations used wiki.phtml and redirect.phtml -
-# make sure that LocalSettings.php is correctly set!
+
+/**#@+
+ * Script users will request to get articles
+ * ATTN: Old installations used wiki.phtml and redirect.phtml -
+ * make sure that LocalSettings.php is correctly set!
+ * @deprecated
+ */
+/** 
+ *     @global string $wgScript
+ */
 $wgScript           = "{$wgScriptPath}/index.php";
+/**
+ *     @global string $wgRedirectScript
+ */
 $wgRedirectScript   = "{$wgScriptPath}/redirect.php";
+/**#@-*/
 
 
-# Paths Settings
-# 
-$wgStylePath   = "{$wgScriptPath}/style";
-$wgStyleDirectory = "{$IP}/style";
+/**#@+
+ * @global string
+ */
+/**
+ * style path as seen by users
+ * @global string $wgStylePath
+ */
+$wgStylePath   = "{$wgScriptPath}/skins";
+/**
+ * filesystem stylesheets directory
+ * @global string $wgStyleDirectory
+ */
+$wgStyleDirectory = "{$IP}/skins";
 $wgStyleSheetPath = &$wgStylePath;
 $wgStyleSheetDirectory = &$wgStyleDirectory;
 $wgArticlePath      = "{$wgScript}?title=$1";
 $wgUploadPath       = "{$wgScriptPath}/upload";
 $wgUploadDirectory     = "{$IP}/upload";
+$wgHashedUploadDirectory       = true;
 $wgLogo                                = "{$wgUploadPath}/wiki.png";
 $wgMathPath         = "{$wgUploadPath}/math";
 $wgMathDirectory    = "{$wgUploadDirectory}/math";
 $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.
+#
+$wgUseSharedUploads = false;
+# Leave this blank if it is the same server. NO FINAL SLASH -
+# it is concatenated with $wgSharedUploadPath.
+# Example: "http://commons.wikimedia.org"
+$wgSharedUploadBaseUrl = "";
+# Path on the web server where shared uploads can be found
+$wgSharedUploadPath = "/shared/images";
+# 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.
+$wgHashedSharedUploadDirectory = true;
 
 
 # Email settings
 #
-$wgEmergencyContact = 'wikiadmin@' . getenv( 'SERVER_NAME' );
-$wgPasswordSender      = 'Wikipedia Mail <apache@' . getenv( 'SERVER_NAME' ) . '>';
+/**
+ * Site admin email address
+ * Default to wikiadmin@SERVER_NAME
+ * @global string $wgEmergencyContact
+ */
+$wgEmergencyContact = 'wikiadmin@' . $wgServerName;
+
+/**
+ * Password reminder email address
+ * The address we should use as sender when a user is requesting his password
+ * Default to apache@SERVER_NAME
+ * @global string $wgPasswordSender
+ */
+$wgPasswordSender      = 'Wikipedia Mail <apache@' . $wgServerName . '>';
+
 
-# For using a direct (authenticated) SMTP server connection.
-# "host" => 'SMTP domain', "IDHost" => 'domain for MessageID', "port" => "25", "auth" => true/false, "username" => user, "password" => password
+/**
+ * SMTP Mode
+ * For using a direct (authenticated) SMTP server connection. 
+ * Default to false or fill an array :
+ * <code>
+ * "host" => 'SMTP domain',
+ * "IDHost" => 'domain for MessageID',
+ * "port" => "25",
+ * "auth" => true/false,
+ * "username" => user,
+ * "password" => password
+ * </code>
+ *
+ * @global mixed $wgSMTP
+ */
 $wgSMTP                                = false;
 
 
-# Database settings
-#
+/**#@+
+ * Database settings
+ */
+/** database host name or ip address */
 $wgDBserver         = 'localhost';
+/** name of the database */
 $wgDBname           = 'wikidb';
+/** */
 $wgDBconnection     = '';
+/** Database username */
 $wgDBuser           = 'wikiuser';
-$wgDBtype           = "mysql"; # "mysql" for working code and "PostgreSQL" for development/broken code
-$wgDBprefix         = ''; # Table name prefix
+/** Database type
+ * "mysql" for working code and "PostgreSQL" for development/broken code
+ */
+$wgDBtype           = "mysql";
+/** Search type
+ * "MyISAM" for MySQL native full text search, "Tsearch2" for PostgreSQL
+ * based search engine
+ */
+$wgSearchType      = "MyISAM";
+/** Table name prefix */
+$wgDBprefix         = ''; 
+/** Database schema
+ * on some databases this allows separate 
+ * logical namespace for application data
+ */
+$wgDBschema        = 'mediawiki';
+/**#@-*/
+
+
 
 # Shared database for multiple wikis.
 # Presently used for storing a user table for single sign-on
@@ -138,21 +275,51 @@ $wgMemCachedDebug   = false;
 $wgSessionsInMemcached = false;
 $wgLinkCacheMemcached = false; # Not fully tested
 
-# Turck MMCache shared memory
-# You can use this for persistent caching where your wiki runs on a small number of 
-# servers. Mutually exclusive with memcached. MMCache must be installed.
-$wgUseTurckShm      = false;
+/**
+ * Turck MMCache shared memory
+ * You can use this for persistent caching where your wiki runs on a single 
+ * server. Enabled by default if Turck is installed. Mutually exclusive with
+ * memcached, memcached is used if both are specified.
+ *
+ * @global bool $wgUseTurckShm Enable or disabled Turck MMCache
+ */
+$wgUseTurckShm      = function_exists( 'mmcache_get' ) && php_sapi_name() == 'apache';
 
 
 # Language settings
 #
+/**
+ * Site language code
+ * Default to 'en'. Should be one of ./language/Language(.*).php
+ * @global string $wgLanguageCode
+ */
 $wgLanguageCode     = 'en';
-$wgLanguageFile     = false; # Filename of a language file generated by dumpMessages.php
-$wgInterwikiMagic      = true; # Treat language links as magic connectors, not inline links
+
+/**
+ * Filename of a language file generated by dumpMessages.php
+ * @global string|false $wgLanguageFile (default:false)
+ */
+$wgLanguageFile     = false;
+/**
+ * Treat language links as magic connectors, not inline links
+ * @global bool $wgInterwikiMagic (default:true)
+ */
+$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
 $wgEditEncoding                = '';
+
+# Set this to eg 'ISO-8859-1' to perform character set
+# conversion when loading old revisions not marked with
+# "utf-8" flag. Use this when converting wiki to UTF-8
+# without the burdensome mass conversion of old text data.
+#
+# NOTE! This DOES NOT touch any fields other than old_text.
+# Titles, comments, user names, etc still must be converted
+# en masse in the database before continuing as a UTF-8 wiki.
+$wgLegacyEncoding   = false;
+
 $wgMimeType                    = 'text/html';
 $wgDocType                     = '-//W3C//DTD XHTML 1.0 Transitional//EN';
 $wgDTD                         = 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd';
@@ -169,7 +336,13 @@ $wgTranslateNumerals = true; # For Hindi and Arabic use local numerals instead
 # Interface messages will be get from the database.
 $wgUseDatabaseMessages = true;
 $wgMsgCacheExpiry      = 86400;
+$wgPartialMessageCache = false;
 
+# Whether to enable language variant conversion. Currently only zh 
+# 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;
 
 # Miscellaneous configuration settings
 #
@@ -184,10 +357,15 @@ $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.
 $wgDebugLogFile         = '';
+
+/**#@+
+ * @global bool
+ */
 $wgDebugRedirects              = false;
 $wgDebugRawPage         = false; # Avoid overlapping debug entries by leaving out CSS
 
@@ -216,6 +394,7 @@ $wgCompressedPersistentLC = true; # use gzcompressed blobs
 $wgUseOldExistenceCheck = false;  # use old prefill link method, for debugging only
 
 $wgEnableParserCache = false; # requires that php was compiled --with-zlib
+/**#@-*/
 
 # wgHitcounterUpdateFreq sets how often page counters should be
 # updated, higher values are easier on the database. A value of 1
@@ -342,7 +521,6 @@ $wgDebugSquid = false; # Lots of debugging output from SquidUpdate.php
 
 $wgDisableCounters = false;
 $wgDisableTextSearch = false;
-$wgDisableFuzzySearch = 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.
@@ -404,10 +582,6 @@ $wgSiteNotice = "";
 # 
 $wgUseImageResize              = false;
 
-## Set maximum width of images on image description pages.
-## Images bigger than this will be rendered down.
-$wgMaxImageWidth = 800;
-
 ## 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.
@@ -418,6 +592,20 @@ $wgMaxImageWidth = 800;
 $wgUseImageMagick              = false;
 $wgImageMagickConvertCommand    = '/usr/bin/convert';
 
+# Scalable Vector Graphics (SVG) may be uploaded as images.
+# Since SVG support is not yet standard in browsers, it is
+# necessary to rasterize SVGs to PNG as a fallback format.
+#
+# An external program is required to perform this conversion:
+$wgSVGConverters = array(
+       'ImageMagick' => '$path/convert -background white -geometry $width $input $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',
+       );
+$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.
@@ -494,9 +682,9 @@ $wgGoToEdit = false;
 $wgUserHtml = true;
 
 # Allow raw, unchecked HTML in <html>...</html> sections.
-# THIS IS VERY DANGEROUS on a publically editable site.
-# Don't enable it unless you've restricted editing to trusted
-# users only.
+# 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.
@@ -555,16 +743,78 @@ $wgUseRCPatrol = true;
 # If you rename it, then you can access them through the new namespace name.
 #
 # Custom namespaces should start at 100.
-#$wgExtraNamespaces
-#      array(100 => "Hilfe", 
+#$wgExtraNamespaces =
+#      array(100 => "Hilfe",
 #            101 => "Hilfe_Diskussion",
-#            102 =>"Aide", 
-#            103 =>"Discussion_Aide"
+#            102 => "Aide",
+#            103 => "Discussion_Aide"
 #            );
+$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.
 $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:
+$wgImageLimits = array (
+       array(320,240),
+       array(640,480),
+       array(800,600),
+       array(1024,768),
+       array(1280,1024),
+       array(10000,10000) );
+
+
+/** Navigation links for the user sidebar.
+ * 'text' is the name of the MediaWiki message that contains the label of this link
+ * 'href' is the name of the MediaWiki message that contains the link target of this link.
+ *        Link targets starting with http are considered remote links. Ones not starting with
+ *        http are considered as names of local wiki pages.
+ */
+$wgNavigationLinks = array (
+       array( 'text'=>'mainpage',      'href'=>'mainpage' ),
+       array( 'text'=>'portal',        'href'=>'portal-url' ),
+       array( 'text'=>'currentevents', 'href'=>'currentevents-url' ),
+       array( 'text'=>'recentchanges', 'href'=>'recentchanges-url' ),
+       array( 'text'=>'randompage',    'href'=>'randompage-url' ),
+       array( 'text'=>'help',          'href'=>'helppage' ),
+       array( 'text'=>'sitesupport',   'href'=>'sitesupport-url' ),
+);
+
+# 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
+$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
+# $wgLocaltimezone = 'GMT';
+# $wgLocaltimezone = 'PST8PDT';
+# $wgLocaltimezone = 'Europe/Sweden';
+# $wgLocaltimezone = 'CET';
+
+# 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;
+
+$wgWhitelistRead = array ( ':Accueil', ':Main_Page');
+
 } else {
        die();
 }