DokuWiki

It's better when it's simple

Gebruikershulpmiddelen

Site-hulpmiddelen


Zijbalk

Vertaling van deze pagina?:

Leer over DokuWiki

Geavanceerd Gebruik

Bedrijfsmatig Gebruik

Onze Gemeenschap


Volg ons op Facebook, Twitter en andere sociale networken.

nl:config

Configureren van DokuWiki

Veel van functies van DokuWiki kunnen worden geconfigureerd met verschillende config-opties. De makkelijkste manier om deze opties aan te passen is door de Configuratie Manager te gebruiken. Hiermee kunnen wikibeheerders de instellingen online wijzigen met hun eigen favoriete webbrowser.

Om de Configuratie Manager te starten moet je inloggen als superuser en op de Beheer-knop klikken.

Wat kan worden geconfigureerd

De “systeem”opties van DokuWiki zijn te vinden in het bestand conf/dokuwiki.php. Echter dit bestand bevat de standaardwaarden van het systeem. Om deze aan te passen moet je het bestand conf/local.php wijzigen of aanmaken al het niet nog niet bestaat. Om te ontdekken wat je kun configureren in dit bestand, bekijk de lijst met beschikbare opties hieronder.

Gebruikersnamen, (geëncrypteerde) wachtwoorden en Access Control regels worden bewaard in de users.auth.php en acl.auth.php.

Wanneer een nieuw bestand wordt geupload naar de media manager, kun je een “Upload denied. This file extension is forbidden!” bericht tegenkomen. Dit gedrag wordt geregeld in het bestand conf/mime.conf. Om een nieuwe soort bestandtype te kunnen uploaden, moet je deze specificeren in mime.conf.

Soms wordt automatisch tekst vervangen als je pagina's bewerkt. Soms worden er tooltips, smileys of enkele bijzondere tekens gegenereerd. Dit gedrag wordt geregeld met acronyms.conf, smileys.conf of entities.conf.

Configuratiebestanden

Alle configuratie bestanden zijn te vinden in de ./conf-map of in /etc/dokuwiki als je installeert vanuit een Debian package.

“Hoofdbestanden” worden meestal met DokuWiki meegeleverd, waar “lokale bestanden” worden aangemaakt bij het beheren van de wiki.

Als lokale bestanden mogelijk zijn moet je deze gebruiken in plaats van de hoofdbestanden te wijzigen, hiermee vermijd je upgrade-problemen.

hoofdbestand lokaal bestand soort configuratie korte info
dokuwiki.php local.php
local.protected.php
zie hieronder algemene wikiconfiguratie
acronyms.conf acronyms.local.conf afkortingen automatische afkortings uitleghints
entities.conf entities.local.conf entities automatische tekstvervanging
interwiki.conf interwiki.local.conf interwiki simpele interwiki links
mime.conf mime.local.conf mime mimetype instellingen voor uploads
smileys.conf smileys.local.conf smileys afbeeldingenvervangingen
acl.auth.php zie acl ToegangsControl instellingen
users.auth.php zie acl Gebruikers en wachtwoorden
license.php license.local.php license lijst van beschikbare licensies
scheme.conf scheme.local.conf urlschema's URL schema's die herkend worden als urls
mediameta.php exif Metadata bewerkbaar voor afbeeldingen
wordblock.conf wordblock.local.conf blacklist Spam blacklist
plugins.required.php plugins.local.php
plugins.protected.php
zie hieronder In-/Uitschakelen van plugins
userscript.js javascript Eigen JavaScript aanpassingen
userstyle.css css Eigen CSS aanpassingen

In-/Uitschakelen van plugins

Geïnstalleerde plugins worden standaard ingeschakeld. Ze kunnen uitgeschakeld worden door de Extensie Manager te gebruiken. Deze schrijft dit weg naar het bestand plugins.local.php . Je kunt ook plugins beschermen door hen in conf/plugins.protected.php te plaatsen.

Standaard laadt DokuWiki haar configuratiebestanden in de volgende volgorde:

  1. conf/plugins.php – standaard plugins
  2. conf/plugins.local.php – wordt gewijzigd door extension manager
  3. conf/plugins.required.php – deze kernplugins kunnen niet worden gewijzigd door de extension manager
  4. conf/plugins.protected.php – heeft voorrang op instellingen in de andere bestanden

De laadvolgorde van configuratiebestanden wordt geregeld met de globale $config_cascade variabele. Door het bestand preload.php te gebruiken kun je dit gedrag wijzigen.

Configuratieopties

De meeste functies van DokuWiki kunnen aangepast worden met verschillende config-opties. De makkelijkste manier om opties te wijzigen is via de Configuratiemanager.

De beschikbare configuratiebestanden:

  1. conf/dokuwiki.php – de standaard instellingen, wordt bijgewerkt bij upgrades
  2. conf/local.php – plaats hier je wijzigingen, de Configuratiemanager zal ook dit bestand gebruiken. Wordt niet gewijzigd bij upgrades.
  3. conf/local.protected.php – gebruik dit bestand voor instellingen die niet via de Configuratiemanager mogen worden gewijzigd. Heeft voorrang op instelling in de eerste twee bestanden

Hier een voorbeeld van conf/local.php:

<?php
$conf['title']     = "Klaas' Wiki. ";
 
$conf['useacl']    = 1;
$conf['superuser'] = 'admin';

Enkele opmerkingen over het config-bestand. Het bestand is een stuk PHP code, dus PHP-syntax moet intact blijven. Bijv. elke regel moet eindigen met een puntkomma. Er zijn meer soorten variabelen:

  • Nummers kunnen worden geschreven zoals ze zijn. Bijvoorbeeld: 9
  • Strings moeten tussen enkele of dubbele quotes worden geplaatst. Bijvoorbeeld: 'foo bar'
  • Booleans zijn enkel 1 of 0
  • Arrays bevatten meerdere waardes van een van de bovenstaande soorten.

Beschikbare opties

nl/config.txt · Laatst gewijzigd: 2018-05-30 20:17 door Klap-in