Manual talk:Configuration settings

Some archived discussion from when the page was located on meta can be found in /archive from meta (including full page history).

Configuration Settings - Index Creation
As a big thank you to Brion, for all his useful help over IRC, I decided I'd put a bit back and make a more useful 'configuration settings' index.

All data has come from the configuration page on meta, and has been translated partially by machine, partially by hand. Errors or omissions are bound to have crept in (in particular links within the summaries/descriptions).

All settings pages currently have 2 warnings. The first indicates that the information is not necessarily accurate or up-to-date. The second indicates that the version information has not been checked. Initially, all settings are listed as being available in 1.5, whether they are or not!

Please hold off editing any of these pages until I have removed the notice from the top of this main page.

-- HappyDog 02:32, 21 October 2005 (UTC)


 * I have completed the update. ALL information from  should now be incorporated here.  I have even included notes that were not attached to a particular setting (i.e. attached to a heading), even though I think these are probably not wanted here.  We can move/remove them later though, once things are bedded in.
 * There are sure to be some conversion errors, even aside from the version data that I have flagged, so be warned!
 * --HappyDog 04:39, 21 October 2005 (UTC)
 * Well done and a Thank you again :-) -- :Bdk: 10:14, 16 January 2006 (UTC)

Subdomains??
My mediawiki is reachable under http://mydomain.com/mediawiki/ Is it possible that the mediawiki is reachable under http://wiki.mydomain.com?

What I have to do? I use Apache2 under Debian Sarge. 07 May 2006


 * Point wiki.mydomain.com to your ip, create a new virtual host for it under /etc/apache2/sites-enabled (default is a good example). Also use the apache rules under /etc/mediawiki/apache.conf for it. I'm sure you'll figure it all out. 129.241.139.198 17:20, 24 May 2006 (UTC)


 * If have your subdomain at your webserver set up correctly, it's easily possible to perform a fresh install of the MediaWiki software there. It is also possible to move an existing installation from http://mydomain.com/mediawiki/ to http://wiki.mydomain.com by changing all the relevant entries in LocalSetting.php - but this may require a few trial-and-error interations before you got everything right. --Klaws 14:24, 15 June 2006 (UTC)


 * I don't understand... I suck at English... should i go to http://85.30.155.6/smashbros.elwiki.com/ (my wiki isa t smashbros.elwiki.com) 85.30.155.6 23:04, 26 August 2006 (UTC)

File Uploads
My testing indicates that the only flag from the upload section that still works is wgEnableUploads. (Backward step imo from 1.4, where I could select whether or not to allow certain file types to be uploaded) - Kevin 192.85.50.2 10:02, 16 January 2006 (UTC)

Adjust Time
My Server is running on Greenwich Main Time but I would like to set it to German Time. Can I do that in LocalSettings.php? I tried to set $wgLocaltimezone but it has no effect. 212.126.218.123 11:18, 28 January 2006 (UTC)

Hi, I have the same problem, the $wgLocaltimezone doesn't working correct, so I experiment a little bit and find out, that following entries set the german time:


 * 1) Set Default Timezone
 * $wgLocaltimezone = "EUR-1";
 * $oldtz = getenv("TZ");
 * putenv("TZ=$wgLocaltimezone");
 * $wgLocalTZoffset = date("Z") / 3600;
 * putenv("TZ=$oldtz");

--84.246.248.39 12:01, 10 March 2006 (UTC)

dumpMessages.php
I don't find no information about this "dumpMessages.php". Is is deprecated ? Or just no one writing a help file ? --tr:katpatuka

User Options
How can I change the default options for non-logged-in users? I mean things like numberheadings or justify the text. When I'm logged-in, I can change the options for me, but not for the non-logged-in users.

thx!


 * $wgDefaultUserOptions

Trail
Is there a configuration parameter for adding the 'Trail' somewhere on the GUI. I'm looking for the list of pages that you have visited that gets stored at the top of the page. I can then click on any page and go back to that page. The previous version of Wiki (JSPWiki v2.2.33) had this and I can't seem to find it in MediaWiki.

Thx


 * Nope. There might be a third-party extension, try googling it up. The usual term is something like 'breadcrumbs'. --Brion VIBBER 21:36, 11 April 2006 (UTC)

Updates
I am updating all the individual configuration settings sub-pages, with the following changes: Note that I will not be checking accuracy or completeness at this stage. I may do so in the future - but then again I may not :) --HappyDog 00:37, 16 April 2006 (UTC)
 * If the page still has the 'unchecked version' it will be removed, and the version will be listed as '??'.
 * The name of the setting will be passed to the template minus the $wg part, so it can be used to order the category listings appropriately (as well as being available for future use within the template itself).
 * Adding a '== Details ==' header, as this needs to be removed from the template. In the current situation, clicking the section-edit link to edit the details section takes you to the template instead.


 * All done. Still a lot of tidying up/fact checking to do, but it's getting better. --HappyDog 03:06, 16 April 2006 (UTC)

localsettings.php
It may sound stupid but could someone please tell me how to access the localsettings page to enter all these configurations. TIA --172.143.130.105 18:47, 16 April 2006 (UTC)
 * localsettings.php is in the top level of your mediawiki directory. --Rick 01:35, 24 May 2006 (UTC)


 * OK, I hate to sound twice as stupid, but I have the same question, and that answer didn't help. Could you pleeeeeeeeese explain, really simple like, exactly what I have to do to find this page??? 70.105.24.59 06:48, 27 August 2006 (UTC)


 * You have to log into your server account and go to the wiki root directory and then if you list the contents of that directory, then you will see the file named LocalSettings.php. Open and edit using your favourite text editor.  Or using your ftp client, connect to the server, again go to the wiki root directory, then transfer the file to your computer, edit using your favourite text editor, then upload back to the server the new version. --Dr DBW 00:12, 12 December 2006 (UTC)

When I edit my LocalSettings.php and then upload it and refresh... no changes happen! I tried just changing the logo and no go.

Yup, same here. Is $wgLogo special? I just moved my logo into the wiki.png image file, but I'd prefer to, you know, "do it right." --Brad Eleven 19:30, 28 June 2007 (UTC)

How to enable IFRAME Tag?
Hi, I need to learner how to enable IFRAME HTml tag in this script. Or I need to understand which line of file creat a Title of Article. I put a code is this line. Thanks.

Sorry for my bad english.

contatc: flaviogomes (a) correios.net.br --201.10.139.15 12:37, 26 April 2006 (UTC)

In your LocalSettings.php, set $wgRawHtml=true. Note that will allow raw HTML for everyone, on every page!

In one of my Wikis, I have an extension which allows raw HTML for Sysops only (on protected pages only), to prevent abuse. Available upon request. --Klaws 12:09, 15 June 2006 (UTC)

When I edit my LocalSettings.php and then upload it and refresh... no changes happen! I tried jsut changing the logo and no go.
 * Maybe you made a typographical error?

Using $wgDBuser
Hi! I want to use the variables $wgDBuser, $wgDBPassword, $wgDB... in an other file.

How can i get informations from this variable in there?

Thanks Sascha Brockmeyer.S@atlas.de

How to override functions in SpecialUpload.php???
I want to customize some of the functions in SpecialUpload.php. I do NOT want to edit that file. Instead I want to "subclass" it or in some other way get wiki to read another file with custom functions. What is the best way to override one of the standard wiki phps??
 * Depending on what you are trying to do, you may be able to acheive what you're after by writing an extension using one of the supplied hooks. See Manual:MediaWiki hooks for more details. --HappyDog 23:09, 3 May 2006 (UTC)

Is there a configuration to turn off section edit links, globally?
Is there any configuration setting to remove the section edit links for all pages? Something like a global " " which could be set in "localSettings.php"...  any ideas? thanks, --Zeroasterisk 04:13, 4 May 2006 (UTC)
 * I don't know of a setting for this (doesn't mean there isn't one...) but it is something that individual users can enable/disable through their preferences. You could set the default option for non-logged-in and new users to be off, though I don't know if you could stop someone turning it on if they chose. --HappyDog 13:11, 4 May 2006 (UTC)
 * That's a great idea - it's a least a good start. (how to do it: )  It would still be nice to know if anyone knew of the actual setting...?  --Zeroasterisk 15:59, 5 May 2006 (UTC)

$wgEmailConfirmToEdit
Please add the above setting to the "Email settings" list. Archon 19:46, 9 May 2006 (UTC)

Wiki on old MySQL
Is pssible installing Wiki on MySQL 3.23.40 and PHP Version 4.3.8? Wich version?--82.200.186.12 22:11, 19 May 2006 (UTC)

and it works fine, Im sure there are some security threats, but its a private Wiki with a great crew to help me maintain it.
 * I Had a similar problem, I just used an older stable version of MediaWiki (1.6.X) I beleive

Windows path quoting
To whom it may concern: I (as 67.170.224.143, sorry, I forgot I didn't have an account on this site) added a note in Manual:$wgSVGConverters about quoting the executable path for Windows. Hope this is OK. It doesn't seem to apply to $wgImageMagickConvertCommand, which (at least in 1.6) is properly escaped by Image.php before use. JohanTheGhost 20:31, 21 May 2006 (UTC)

$wgRightsText
There appears to be very little info about how to get this this variable to work.

I found that if I place a string in it, I can only get the string to display if I also put something into the '$wgRightsPage' variable, but I don't want a rights page, so I placed a space into it, which works, but I'm still left with the 'Content is available under' as lead in to the page link.

Why are these two variables so interdependent?

Why are there no docs anywhere about them?

tia

Never mind - I finally found the info (on Meta) $wgRightsText is the string displayname for the page located by $wgRightsPage


 * I added some more information to Manual:$wgRightsPage, Manual:$wgRightsText and Manual:$wgRightsUrl. Please add to this if there is anything else I missed. --HappyDog 00:08, 28 June 2006 (UTC)

LocalSettings.php as an article
I've always preferred having my LocalSettings.php available as an article rather than a file so configuration can be done directly from within the wiki (sysop only because you can break the wiki if the article has a fatal error in it). So if any admin thinks this is useful, could you move it to the article or somewhere appropriate? I can't edit much here now that its all locked down :-(

To get it to execute the LocalSettings.php article, add the following lines to your index.php file after the line containing the wfProfileIn('main-misc-setup'); statement: $tmp = new Article(Title::newFromText('LocalSettings.php')); eval($tmp->fetchContent(0, false, false));
 * 1) eval($tmp->getContentWithoutUsingSoManyDamnGlobals); # use this for version 1.4x or less
 * --Nad 22:31, 28 June 2006 (UTC)


 * However, it may be impractical that after saving a version with a fatal error, you have to undo the changes above in order to be able to correct the error.--Patrick 14:09, 14 February 2007 (UTC)

$wgSitename
Is it possible to use special chars like the German ä in $wgSitename? I tried using ä and &auml; in the $wgSitename-String, in both cases it´s not displayed as ä the Browser- as well as for the Project-Link in the Navigation bar. What can I do? --89.48.62.134 14:24, 7 July 2006 (UTC) (I use the latest stable MetaWiki Version with German localization)
 * That's due to the way your browser handles special characters. If not sure if newer browsers or browsers running on computers set in German may display this correctly.  Anyway, you site users may not have updated browswers, so that won't work.  Unfortunly non-English characters can not reliably be used on the Internet today. Sorry --141.158.62.105 17:38, 7 August 2006 (UTC)
 * Actually you can use accentuated characters in $wgSitename, but it needs to be encoded in UTF-8. Probably your LocalSettings.php file is encoded in IS0-8859-1 (latin1) if you use Windows (depends on your text editor too). For the $wgSitename to contain UTF-8 encoded string, use the PHP function $wgSitename=ut8_encode('Schwarzwälderkirschtorte'); and it will display fine.


 * The issue is not related to 'reliability' of browsers, but to understanding of character encoding. English people who can rely entirely on ASCII (the 128 first characters common to most encodings) tend to forget about that and make things 'unreliable' for the rest of the planet. So be carefull! :) BigueNique@yahoo.ca --64.18.180.117 19:54, 31 May 2007 (UTC)

Sitenotice
Can someone change the listing for $wgSiteNotice, because it is currently full of POV. The notice does not have to be bold or ugly. --141.158.62.105 17:31, 7 August 2006 (UTC)


 * Done. --HappyDog 17:34, 8 August 2006 (UTC)

File Upload
Hello, I need some help. I have started a wikisite, and had the host install the wikifiles, I belive with the very latest version as of Thursday, August 17th. I cannot seem to get file upload activated, but the documentation seems to say it should be...--Trek84 20:47, 18 August 2006 (UTC)

Add this please
Manual:$wgBlockAllowsUTEdit. Oh and I probably didn't format it properly when writing it so it may need some template stuff. I don't know which version it started being active, either. 12.72.105.234 07:46, 8 September 2006 (UTC)
 * Done; thanks for reporting this. —dto 08:12, 8 September 2006 (UTC)

New 1.7 Configuration Settings
Please add the two configuration settings added in MediaWiki 1.7: $wgSaveDeletedFiles and $wgSaveDeletedFiles /** * By default deleted files are simply discarded; to save them and * make it possible to undelete images, create a directory which * is writable to the web server but is not exposed to the internet. * * Set $wgSaveDeletedFiles to true and set up the save path in * $wgFileStore['deleted']['directory']. */ $wgSaveDeletedFiles = false;

/** * New file storage paths; currently used only for deleted files. * Set it like this: * *  $wgFileStore['deleted']['directory'] = '/var/wiki/private/deleted'; * */ $wgFileStore = array; $wgFileStore['deleted']['directory'] = null; // Don't forget to set this. $wgFileStore['deleted']['url'] = null;      // Private $wgFileStore['deleted']['hash'] = 3;        // 3-level subdirectory split Many thanks! --130.202.234.240 04:42, 10 October 2006 (UTC)

Selecting default fonts
Which config file specifies the font selections for the skin? I looked in MonoBook.js, MonoBook.css, and localsettings.php. Perhaps I missed it, but I didn't see it there. I'd like to tweak the skin so that section headers use a different font. Thanks.

Templates not working for me
There are many templates (mostly for Infoboxes) that I have been trying to copy from Wikipedia to my Wikia. The Conditionals, I think, are crashing the code. (Example: http://wiki.raceNOSPAMtotheright.com/index.php?title=Template:Infobox_Radio_station) I have installed the Parser extensions. H-E-L-P, please. --Mnyakko 19:38, 30 October 2006 (UTC)

Images not showing up
Mine is a new installation, and I'm trying to insert images in the wiki pages. The images are hosted in a seperate gallery software (PhotoPost), but on the same domain.

Anyway, I'm still calling the images using a full url (I would love to see a bridge for PP-MW, but that's for another day), by typing bracket bracket Image: http:// fullurletc .jpg pipe title bracket bracket.

However, it's creating a link to the Special:Upload page instead of embedding the photo. I have $wgAllowExternalImages = true; in LocalSettings.php - so why is it not inserting the photo? I have gone through the documentation and I cannot seem to figure what I've overlooked. I don't want people uploading images to the wiki directly, I want them to upload them to the PhotoPost installation, so I want to steer away from enabling uploads.

While I have you, speaking of not enabling uploads, where can I locate the file I use to edit the text on Special:Upload -> "Uploads disabled... File uploads are disabled on this wiki." I want to change that and tell them to go to the PP gallery and upload them there instead (with the respective link).

2 questions. Thank you for your time. MediaHound 01:09, 3 November 2006 (UTC)


 * bump MediaHound 01:26, 6 November 2006 (UTC)


 * where exactly are you trying to bump to? --HappyDog 04:22, 13 November 2006 (UTC)
 * the 2 questions above that I'm asking for help with, can you help? thanks MediaHound 18:34, 15 November 2006 (UTC)
 * Not 'what', 'where'. :) --HappyDog 03:18, 16 November 2006 (UTC)
 * Right here :) MediaHound 15:57, 9 April 2007 (UTC)


 * As you read above I was calling the images with brackets. What I did to fix my problem, (yes, I worked around it), was drop the brackets and call the image by the full url AND since I was using dynamic image urls chock-full-of ? and & characters etc it did not end with a common image filetype. So I added &filefix=.jpg to the end of my urls and that got it to parse properly as an image. I'm still wondering where to edit the text "File uploads are disabled on this wiki.", but since I worked around the problem that led me to that page, I care less now. MediaHound 15:57, 9 April 2007 (UTC)
 * found it /index.php?title=MediaWiki:Uploaddisabledtext&action=edit :blows kisses: MediaHound 16:19, 9 April 2007 (UTC)

How to set upload limit?
As title, how to set upload limit to my Wiki?


 * Are you after a total upload limit for a user, or per file? The latter is quite easy to do, but it only provides a warning, not something that stops it from being done entirely.  See, Manual:$wgUploadSizeWarning.  --Dr DBW 00:19, 12 December 2006 (UTC)

undocumented option $wgEnableScaryTranscluding
$wgEnableScaryTranscluding allows you include template from another wiki.

--84.32.99.253 11:12, 24 November 2006 (UTC)
 * in LocalSettings.php add $wgEnableScaryTranscluding = true
 * in database in interwiki table in column 'iw_trans' you must set to 1.
 * then use   in page

$wgUseTidy
The manual entry for this is here: Manual:%24wgUseTidy. Is there any further information around about how this actually works, how to configure etc? Would be nice to know what the code is actually being run too, is it already incorporated into the distribution of MediaWiki, or where is it actually been run? Where it the default configuration file for Tidy, or does one not exist and all defaults are being used?

Reason being that I have enabled it to solve some issues with HTML table coding not rendering correctly, but now it messes up the coding for all images within the wiki. Full details are on the talk page - Manual_talk:%24wgUseTidy --Dr DBW 00:19, 12 December 2006 (UTC)


 * From what I can tell, looking in DefaultSettings.php, tidy is run off the server that MediaWiki is installed on (on my server it is at /usr/bin/tidy). There is no configuration file being used, but if you do the default location is at /extensions/tidy/tidy.conf --Dr DBW 01:02, 12 December 2006 (UTC)

Problem with implementing Infoboxes
I'm having the same issue as mentioned in an early comment with setting up Infoboxes and other coding that uses the #if parameter in on my local MediaWiki site. Any ideas? --TotalBalance
 * What exactly is the problem? Or a link to where it is detailed?--Dr DBW 01:10, 9 January 2007 (UTC)

changed LocalSettings.php does not work
The installation was succesfull. After enabling image uploads, and thus only changing false into true, de LocalSettings.php doesn't work anymore. I get this error:

Warning: Cannot modify header information - headers already sent by (output started at /opt/www/avontsk/web/www.derepubliek.eu/vvp/wiki/LocalSettings.php:1) in /opt/www/avontsk/web/www.derepubliek.eu/vvp/wiki/includes/WebResponse.php on line 9

Only the original LocalSettings.php seems to work. I've tried chmodding, but to no effect. Can anyone help me?

Avonts 16:13, 14 January 2007 (UTC)


 * You have probably added whitespace before the opening  tag. --HappyDog 15:29, 15 January 2007 (UTC)


 * Thanks for your reaction. I've checked it. I didn't add any whitespace. It still doesn't work.
 * Since the initial LocalSettings.php works, but later uploads (which overwrite the old ones) don't, I was thinking it may have something to do with FileZilla. Any ideas? Avonts 17:18, 15 January 2007 (UTC)
 * In that case, I don't know. The error is caused by some output being generated before the page headers are sent, and is normally caused by whitespace generated by include calls, or by PHP errors.  However, when there is an error, you should see that on the screen too.  All I can suggest is to try checking the source of the page that is generated, and to undo your change and see if the problem goes away.  Maybe someone else can offer some more advice. --HappyDog 18:11, 15 January 2007 (UTC)
 * It seems that it is BOM at the beginning of LocalSettings.php. Use editor which can save in UTF-8 without BOM. 84.32.103.78 15:25, 16 January 2007 (UTC)
 * I'm using Windows Notepad now. I'll try another one. Avonts 17:28, 16 January 2007 (UTC)
 * You can fix it with Notepad, by using 'save as' and selecting "ANSI" as the encoding type. --HappyDog 23:19, 16 January 2007 (UTC)
 * Yes, it was the BOM-thing. I'm using jEdit now. Thanks for your help.Avonts 08:05, 17 January 2007 (UTC)

$wgMaxUploadSize
Please add $wgMaxUploadSize. 71.133.74.137 01:07, 3 February 2007 (UTC)
 * Done --HappyDog 01:02, 7 February 2007 (UTC)

broken Redirects
Is there anything I need to do to enable the special page "Broken redirects"? it does not seem to be updating at all.

Auto-Logout
Is there a parameter where I can config after what time a session gets closed? --GunterS 15:33, 14 March 2007 (UTC)
 * Seconding this question: Is there an option to modify this timer? --Elonka 00:58, 8 April 2007 (UTC)
 * Session timout is set in php.ini, see ini.session.cache-expire --Nad 01:38, 8 April 2007 (UTC)

Page organization
I would like to see the site list a 10 most common settings at the top of the page. It should include login required for editing.

External images
$wgAllowExternalImages is listed under "#Parser" instead of "#Images", but I think it should be at least mentioned at the "Images" section. --Kjoonlee 17:33, 5 May 2007 (UTC)

$wgNoFollowNsExceptions
Could someone add $wgNoFollowNsExceptions to the list? (Why is this page protected while the alphabetical list isn't, anyway? Shouldn't they have the same protection status?  And why doesn't the protection log show anything?)  --Ilmari Karonen 18:21, 13 May 2007 (UTC)
 * Good point. Will do so. This page was protected way back then when it was located in Help:Configuration settings, and the protection log doesn't follow pages across page moves. (See Bug 8296 and Bug 7011.) Titoxd (?!?) 18:35, 13 May 2007 (UTC)

Category/ies: link
How to modify the "Category/ies:" link (that is, Special:Categories by default) at the bottom of pages ?

nb: I think the topmost category should be a better default value. STyx 00:16, 27 May 2007 (UTC)

How to change language??
How to change the language to swedish? I've tried to change : "$wgLanguageCode = "en" " to "$wgLanguageCode = "sv" " but it doesn't work. How should I do it??
 * Maybe it's because there's no LanguageSv.php in the language/classes directory of the standard installation - there is a MessagesSv.php file though, but I think it needs both... --Nad 21:26, 28 May 2007 (UTC)
 * You have right, there is no LanguageSv.php but where can I get it? I can't do it myself cuz I can't PHP.

Cookies?
Can i turn the cookies off because the login doesn't work in IE7. It says: "Login error:SWiki uses cookies to log in users. You have cookies disabled. Please enable them and try again. ". I have all cookies accepted and session-cookies accepted. And plz help with the launguage problem over this post. And plz get a forum like phpBB or vBulletin. It should be easier to get answers so.


 * Try to add this line to your LocalSettings.php:
 * header('P3P: CP="NOI ADM DEV PSAi COM NAV OUR OTRo STP IND DEM"');
 * It's a tweak for cookies to be accepted by IE6+. It worked for me on another PHP project, so who knows.  BigueNique@yahoo.ca --64.18.180.117 20:06, 31 May 2007 (UTC)


 * It is still the same problem :(

using search for a 3 letter word
searching for "IBM" or anyother 3 letter word doesnt work on my wiki.

anywhere i can config this?

its a mysql config problem Change your 'my.cnf' file to contain at least the following: [mysqld] ft_min_word_len=2 [myisamchk] ft_min_word_len=2 and then even 2-character words should be searchable. Once you change this parameter, you need to rebuild the text index by running maintenance/rebuildtextindex.php