Inhoud
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:
conf/plugins.php
– standaard pluginsconf/plugins.local.php
– wordt gewijzigd door extension managerconf/plugins.required.php
– deze kernplugins kunnen niet worden gewijzigd door de extension managerconf/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:
conf/dokuwiki.php
– de standaard instellingen, wordt bijgewerkt bij upgradesconf/local.php
– plaats hier je wijzigingen, de Configuratiemanager zal ook dit bestand gebruiken. Wordt niet gewijzigd bij upgrades.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
of0
- Arrays bevatten meerdere waardes van een van de bovenstaande soorten.
Beschikbare opties
- Basisinstellingen
- Beeldinstellingen
- Authenticatie-instellingen
- Anti-spaminstellingen
- Pagina-wijzigingsinstellingen
- Link-instellingen
- Media-instellingen
- Geavanceerde instellingen
- Netwerkinstellingen