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 plugins
conf/plugins.local.php – wordt gewijzigd door extension manager
conf/plugins.required.php – deze kernplugins kunnen niet worden gewijzigd door de extension manager
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:

conf/dokuwiki.php – de standaard instellingen, wordt bijgewerkt bij upgrades
conf/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 of 0
Arrays bevatten meerdere waardes van een van de bovenstaande soorten.

Beschikbare opties

Basisinstellingen
- title
- start
- lang
- template
- license
- savedir
- basedir
- baseurl
- dmode
- fmode
- allowdebug
Beeldinstellingen
- recent
- breadcrumbs
- youarehere
- fullpath
- typography
- dformat
- signature
- showuseras
- toptoclevel
- tocminheads
- maxtoclevel
- maxseclevel
- camelcase
- deaccent
- useheading
- refcheck
Authenticatie-instellingen
Anti-spaminstellingen
Pagina-wijzigingsinstellingen
- usedraft
- htmlok
- phpok
- notify
- subscribers
- locktime
- cachetime
Link-instellingen
- target (wiki, interwiki, extern, media, windows)
Media-instellingen
Geavanceerde instellingen
- updatecheck
- userewrite
- useslash
- sepchar
- canonical
- fnencode
- autoplural
- mailfrom
- compress
- cssdatauri
- gzip_output
- hidepages
- send404
- compression
- sitemap
- rss_type
- rss_linkto
- rss_content
- rss_update
- recent_days
- rss_show_summary
- broken_iua
- xsendfile
- remote
- remoteuser
- renderer_xhtml
- readdircache
Netwerkinstellingen