Manual:LocalSettings.php/nl

Het bestand   bevat basis instellingen (gebaseerd op ) voor een MediaWiki-aangedreven wiki. U zou de tijd moeten nemen om een kijkje te nemen in dit bestand. Dit bestand wordt normaliter aangemaakt door het webgebaseerde MediaWiki installatieprogramma, maar u kunt zelf ook de instellingen aanpassen, meestal voor de Apache-instellingen. Voor installaties die worden gebruikt voor een wikifamilie, zou een bestand met de naam  gebruikt kunnen worden.



Waar op de server te vinden
Een  is geen wikipagina, het is niet beschikbaar in uw webbrowser.

Het is een bestand op de server. De inhoud wordt aangemaakt bij de eerste keer instellen van de wiki, het aangemaakte bestand moet handmatig naar de server worden overgezet. Het bestand moet komen te staan in de map waarin MediaWiki is geïnstalleerd, op hetzelfde niveau als de mappen,   en bestanden als. Als dit bestand daar niet staat zal de wiki helemaal niet werken. Als u niet weet waar het bestand staat, dan kunt u met find / -iname LocalSettings.php -print zoeken.

(Als u Vagrant gebruikt: lees dan ook dit.)

Veiligheid
Dit bestand bevat meestal privégegevens zoals wachtwoorden voor databasetoegang. Deze gegevens mogen nooit openbaar worden gemaakt! Door een mogelijk veiligheidslek zou het kunnen gebeuren dat andere gebruikers de inhoud van bestanden kunnen bekijken. Om uw gegevens beter te beveiligen zou u de UNIX rechten voor dit bestand als volgt moeten instellen: De webserver gebruiker moet toegang tot dit bestand hebben. Als dit account ook de eigenaar is dan kunnen de rechten op 600 worden gezet. Soms is de webserver gebruiker niet de eigenaar van het bestand, maar is die wel ingedeeld in UNIX gebruikergroep die eigenaar is. In dat geval zouden de rechten 640 moeten voldoen. Hoe minder rechten dan noodzakelijk, hoe beter de beveiliging is.

U kunt daarnaast ook een databasegebruiker aanmaken welke alleen toegang heeft tot de database gebruikt door de wiki, en de gegevens van deze gebruiker toe te voegen aan de LocalSettings.php Als laatste kunt u uw databaseserver ook zo aanpassen dat deze alleen verbindingen accepteert vanaf localhost (de server waarop uw databasesoftware runt) - hierdoor zal men geen toegang tot de data krijgen mochten de gegevens van de databasegebruiker gelekt worden.

Lees voor het verplaatsen van gevoelige delen van van   naar een ander bestand in een andere map.



Inhoud
Als u de LocalSettings.php aanpast, moet de tekencodering tijdens het opslaan hetzelfde blijven. U moet de codering "ANSI/UTF-8" gebruiken, hierdoor wordt de LocalSettings.php opgeslagen zonder een byte order mark (BOM).

De LocalSettings.php bevat PHP-code - voor het grootste deel krijgt een variabele data toegewezen. Het veranderen van een instelling betekent meestal het veranderen van een PHP-variabele. Nadat u een nieuwe versie van de LocalSettings.php heeft opgeslagen, worden de wijzigingen gelijk waargenomen door de server. Er hoeft niks opnieuw opgestart te worden, alhoewel het in sommige gevallen wel mogelijk is dat u de cache van uw webbrowser moet legen om de veranderingen die u heeft gemaakt te zien.

Vele variabelen (instellingen) zijn al ingesteld in, dit bestand moet niet worden bewerkt. Als u de waarde van een variabele wilt veranderen (deze variabele hoeft niet al in de  te staan), moet dat gebeuren in de. In de  kunt u de variabele toevoegen op een nieuwe regel helemaal onderaan.

Er kunnen ook verschillende regels zijn die code bevatten welke lijkt op ' '. Deze stukjes code zijn ervoor om extensies (uitbreidingen) in te schakelen op de wiki. Deze extensies kunnen afhankelijk zijn van bepaalde PHP-variabelen in, neem alstublieft de documentatie van deze extensies door voor instructies.

Zoals de meeste bestanden in MediaWiki mag uw  niet eindigen met een PHP-sluitingstag ( ). Dit is gedaan zodat men niet per ongeluk PHP-code neerzet onder de sluitingstag. Daarnaast zal PHP goed blijven functioneren zonder sluitingstag.

Als u een wiki op een MediaWiki wikifamilie heeft, is het mogelijk dat nu geen schrijftoegang (of leestoegang) heeft tot de (o.a. ). De beslissing of uw gewenste instellingen wel of niet zullen worden toegevoegd aan de LocalSettings.php ligt dan bij de systeembeheerders van de wikifamilie, het is goed mogelijk dat zij de meeste instellingen op alle wiki's gelijk willen houden.



Lijst van beschikbare instellingen
Zie deze categorie (en de bijbehorende opmerkingen) voor meer informaties wat alle beschikbare instellingen doen. Een verkorte lijst van de meest belangrijke instellingen (en de meestgebruikte instellingen) staat hieronder.



Standaardinstellingen


Installatie pad
De variabele  (installatie pad) bevat het lokale bestandspad naar de map waar de installatie van uw wiki staat. De waarde van $IP wordt sinds MediaWiki 1.18 automatisch gezet. Het handmatig zetten van in   is dus niet nodig. zal standaard naar de huidige werkmap gaan en het kan gebruikt worden zonder het handmatig te definiëren. Attempting to set (or  ) in   may produce unexpected results.

Het bestand wordt geladen uit de map aangegeven door de variabele IP.



Wikinaam
De variabele  bevat de naam van uw wiki. Deze naam is veelgebruikt in MediaWiki, zoals op MediaWiki:Pagetitle. De Wikipedia tagline "Uit Wikipedia, de vrije encyclopedie" maakt ook gebruik van deze instelling.



Wijzigingen van de websitenaam
Het vertalen van de interface kan gevolgen hebben voor de websitenaam. U kunt goede namen in variabelen ' zetten (Voorbeeld op de documentatie-pagina van ').



Taal
 geeft de standaardtaal van uw wiki interface aan. Gebruikers kunnen de taal waarin ze willen werken in de eigen Voorkeuren instellen, deze variabele zet de standaardtaal die alle anonieme gebruikers en de geregistreerde gebruikers zullen zien.



Scriptpad
 is de prefix van het URL-pad voor het benaderen van de het MediaWiki hoofdscript dat de centrale regelaar is in de MediaWiki. Deze instelling moet overeenkomen met de Apache instellingen, vooral als u de rewrite regels van Apache gebruikt.



Servernaam
 bevat de basis URL van de server, inclusief het protocol maar zonder de slash achteraan en ook zonder eventuele submap. Als de wiki benadert van de localhost waarop het draait of via intranet / internet, worden e-mail notificaties en wat andere automatische berichten verstuurd met verschillende URL's.

Vanaf MediaWiki 1.34 moet worden gezet in LocalSettings.php. In eerdere versie probeerde MediaWiki zelf de naam van de server te herkennen en was optioneel, het overschreef dan wat herkend was.

Als het serveradres van uw wiki op het internet www.example.com is, voeg dan toe:

Het magische woord variabele  kan op wiki pagina's worden gebruikt, het heeft de waarde. Echter op een wiki, zoals in een Wikimedia familie, waar relatieve paden worden gebruikt, zal het niet volledig aangevoegd worden. Het zal tonen, wat geen link is.

U kunt ook een protocol relatieve URL gebruiken, dat staat hieronder. When using a protocol relative URL, be sure to set. is needed for some places in the code where an origin with a protocol and hostname is needed.



Scriptnaam
 is de naam van het (index) MediaWiki PHP script, met standaard de naam. Het wijzigen van de scriptnaam is waarschijnlijk geen goed idee. U kunt het hier wel aanpassen, als het dan echt moet en u weet zelf waarom.



Artikelpad
 is het te gebruiken pad bij het benaderen van een pagina op de MediaWiki. Het bevat het pad naar het hoofdscript (meestal met gebruik van ), de placeholder  wordt vervangen door de artikelnaam.

Als u de Apache rewrite regels gebruikt om korte URL's te maken, dan moet u mogelijk instellen om het goede pad aan te geven. wgArticlePath wordt gebruikt om de URL's te maken binnen de MediaWiki. als u daarbij een foutje maakt, dan zullen interne links verkeerd worden getoond, maar u kunt nog wel de hoofdpagina bereiken door de goede URL handmatig aan te geven. Meer informatie over URL-configuratie:.

Typische waarden zijn:



Stylesheet locatie
Gebruik  voor het instellen van het URL-pad naar de stylesheets (CSS) van de MediaWiki installatie.  dient naar dezelfde plek te verwijzen, dit is echter een pad op een lokaal bestandssysteem, het wordt gebruikt door interne scripts.



Upload map
De map upload is de plek waar de bestanden die geüpload worden door gebruikers worden opgeslagen. ' is het URL pad, ' is het lokale systeempad voor de bestanden.

Logo
 geeft aan welk grafisch logo er in de linkerbovenhoek wordt getoond op alle MediaWiki pagina's. Deze stappen vervangen het standaardlogo in de map /wiki/skins/common/images/. Vervang hier /wiki met het pad waar u de MediaWiki software heeft geïnstalleerd.

Begin met het kopiëren van het nieuwe logo naar de map /wiki/skins/common/images/ (vervang /wiki met het pad waar de MediaWiki is geïnstalleerd).

Zoek vervolgens de regel op die er ongeveer zo uit ziet in bestand :

Als er niet een dergelijke regel is, kopieer de bovenstaande regel dan en voeg die onderaan toe.

Wijzig daarna de regel die naar uw logo verwijst. Dit logo moet door via het web te benaderen zijn. Bij twijfel wat hier in te vullen, ga in uw webbrowser naar het bestand toe (op deze wiki is de URL van het logo http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png ), en zet de volledige URL in dit veld.

Soms vervangt men het bestand skins/common/images/wiki.png door een eigen bestand. Dat is niet de goede manier, omdat dan bij de eerstvolgende upgrade het oorspronkelijke bestand van de logo wordt teruggezet.

In MediaWiki 1.35 is toegevoegd, daarmee zijn er sindsdien meerdere versies van hetzelfde logo mogelijk. Onderstaand een voorbeeld met gebruik van meerdere logo's.



Contact
 is het e-mailadres van de gebruiker die benaderd moet worden bij problemen. Als u een intern foutrapport wilt sturen, doe dat dan naar dit adres. Als beheerder kunt u uw e-mailadres hieraan toevoegen.

 is het e-mailadres van waar e-mail wordt verzonden (Van), indien wachtwoorden moeten worden verzonden naar elke gebruiker die het eigen wachtwoord is vergeten. Sta toe dat er ook een reactie op een verzonden e-mail kan worden gedaan voor het geval de gebruiker vragen heeft.



Databaseinstellingen
MediaWiki heeft toegang tot de database (MySQL of PostgreSQL) nodig, voor opslaan pagina's, bewerkingen, gebruikersinformatie, enz.

 bevast de naam van de host waar de database op staat. Het kan "localhost" zijn als de database op dezelfde server als de applicatie. Bij een gedistribueerde installatie dient de volledige domeinnaam te worden worden ingevuld van de computer waarop de database staat.

 is de databasenaam van de database die MediaWiki moet gebruiken. Een MySQL of PostgreSQL installatie kan meerdere databases bevatten, er kunnen op een server ook meerdere MediaWiki installaties staan. Gebruik uiteraard een andere databasenaam als er meerdere installaties zijn op een server.

' en ' bevatten de loginnaam en wachtwoord die de MediaWiki mag gebruiken om de database te benaderen. Deze specifieke gebruiker moet de goede toegangsrechten hebben en o.a. update rechten hebben op de databasetabellen.

Also see for a method to move the sensitive parts of   to a different file in a different directory.

<span id="User_rights">

Gebruikersrechten
 is een associatief array, voor de rechten voor het aanmaken en wijzigen van pagina's door de verschillende gebruikersgroepen. Zie voor meer informatie over de verschillende rechten en de beschikbare gebruikersgroepen.

<span id="Force_capital_links">

Links in hoofdletters forceren
Een paginanaam kan standaard niet met een kleine letter beginnen: als poging om dit te doen wordt de eerste letter omgezet in een hoofdletter. Dit betreft ook het doel in een link, inclusief pagina, afbeelding of categorie.

Een paginanaam kan met een kleine letter beginnen door het instellen van . Dan moet de waarde false worden gezet, de standaardwaarde is true.

<span id="Enabling_subpages">

Subpagina's inschakelen
In  worden subpagina's per namespace ingeschakeld met gebruik van . Om bijvoorbeeld in de namespace 'main' subpagina's in te schakelen:

<span id="Image_uploads">

Afbeelding uploaden
Om het uploaden van bestanden in de MediaWiki door gebruikers mogelijk te maken dient eenmalig die functie te worden ingeschakeld. De map waar de uploads in komen te staan moet goed geconfigureerd zijn en schrijfbaar zijn voor de webserver. Zet  op true om de functie beschikbaar te stellen aan de gebruikers.

Hier wat voorbeeld van code uit includes/DefaultSettings.php die in   kan worden gezet:

Als u het aanpassen van de grootte van een afbeelding door de gebruiker wilt toestaan om zo een miniatuur te maken, dan heeft de MediaWiki een werkende ImageMagick installatie nodig is. Zet  op true na het installeren en testen van ImageMagick. Zorg dat ' de locatie van het programma  bevat, dat het uitgevoerd mag worden door de webserver en dat ' groot genoeg is.

Bekijk ook of er een aanpassing nodig is van het type bestanden dat geüpload mag worden.

Als ImageMagick een fout geeft als:
 * Fatal error: mime_magic could not be initialized, magic file is not available in includes/MimeMagic.php on line 506

probeer dat dan op lossen met het toevoegen aan het bestand  van:

<span id="Interwiki_support">

Interwiki ondersteuning
De InterWiki ondersteuning is onderdeel van MediaWiki, maar het is wel nodig dat de prefix van de interne links wordt ingesteld. Deze prefix is meestal gelijk aan, maar als u dat wilt aanpassen dan kan dat met de variabele.

<span id="Language_of_user_interface">

Taal van de gebruikersinterface
MediaWiki bevat een gebruikersinterface die door vertalers naar hun eigen taal kan worden vertaald. De MediaWiki is standaard in het Engels maar staat veel gebruikerstalen toe. Als u uw wiki in een ander taal wilt laten draaien stel dan de variabele in met de gewenste taalcode (bijv. "nl" voor Nederlands).

De toegestane talen zijn alle talen met een bestand in deze map op. Als u bijvoorbeeld, ziet dan kunt u   gebruiken, doe dat dan alleen als u Vlaams als taal van de interface wilt instellen. Gebruik geen. Hoeveel er van de interface dan in het Vlaams is, hangt af van de vertalers naar die taal.

Niet alle talen worden ondersteund. Hier staan statistieken met de lokalisatie van versie  (verouderd!). Op translatewiki.net kunt u dat per release bekijken.

<span id="Setting_copyright_for_the_site">

Copyright instellen van de website

 *  is de wiki-pagina die de copyrights beschrijft. Meestal is dat in het Project:Copyrights.
 * De pagina  beschrijft de volledige details van uw licentie. (Voor de GNU FDL, bijvoorbeeld, dit zou de  zijn.)
 *  is de tekst in de voettekst die volgt op "Content is available under". Het wordt gelinkt aan de gespecificeerde pagina in.
 *  is de URL van de afbeelding die links in de voettekst staat.

Om de copyright beschrijving op de site aan te passen, voeg dan aan  toe:

Wijzig daarna met MediaWiki:Copyright het bericht op de pagina, gebruik  op de plek in het bericht waar de link naar uw copyright pagina moet komen te staan.

Voorbeeld: voor het instellen van de Creative Commons licentie

Doe het volgende:


 * Choose your license: http://creativecommons.org/choose/
 * Examine the returned HTML code, e.g.:


 * For  enter the href info from the first anchor:
 * For  enter the text the second anchor links from (add the "a" to the Wiki variable for a more grammatically correct version)
 * For  enter the src info from the img link in the first anchor. You want to copy the badge to your own site instead of using the one from the Creative Commons site.
 * For using RDF metadata about copyright add one or both of the following lines to your :

<span id="Custom_namespaces">

Eigen namespaces
By declaring ', and modifying ', and ', extra namespaces can be added to a MediaWiki installation; and by declaring the ' array namespace aliases can be added. Take heed not to have any pages already titled in that namespace, for instance if you had a page called "Technical:Support" and you created the Technical: namespace, then that page would not only be lost, but you cannot remove it from Special:Allpages. To fix this delete the namespace, move "Technical:Support" to "Support" in mainspace, delete the redirect, reinsert the namespace, and move it back to "Technical:Support". See for more information as to how to do so.

Skins
The default skin of the site can be modified via .

<span id="See_also">

Zie ook

 * source code, which generates the inital contents of  during installation.
 * Wiki families can share the same.
 * - a guide to securing your database passwords and  file.