====== 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 [[plugin:config|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 [[acl|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|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 [[abbreviations|acronyms.conf]], [[smileys|smileys.conf]] of [[entities|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'' |[[abbreviations|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'' |[[config:license]] | lijst van beschikbare licensies | |''scheme.conf'' |''scheme.local.conf'' |[[urlschemes|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'' |[[devel:javascript]] | Eigen JavaScript aanpassingen | | |''userstyle.css'' |[[devel:css]] | Eigen CSS aanpassingen | ===== In-/Uitschakelen van plugins ===== Geïnstalleerde plugins worden standaard ingeschakeld. Ze kunnen uitgeschakeld worden door de [[plugin:extension|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 [[devel:preload|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 [[plugin:config|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'': 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: * **Nummer**s kunnen worden geschreven zoals ze zijn. Bijvoorbeeld: ''9'' * **String**s moeten tussen enkele of dubbele quotes worden geplaatst. Bijvoorbeeld: ''%%'foo bar'%%'' * **Boolean**s zijn enkel ''1'' of ''0'' * **Array**s bevatten meerdere waardes van een van de bovenstaande soorten. ==== Beschikbare opties ==== * **Basisinstellingen ** * [[config:title]] * [[config:startpage|start]] * [[config:lang]] * [[config:template]] * [[config:license]] * [[config:savedir]] * [[config:basedir]] * [[config:baseurl]] * [[config:dmode]] * [[config:fmode]] * [[config:allowdebug]] * **Beeldinstellingen** * [[config:recent]] * [[config:breadcrumbs]] * [[config:youarehere]] * [[config:fullpath]] * [[config:typography]] * [[config:dformat]] * [[config:signature]] * [[config:showuseras]] * [[config:toptoclevel]] * [[config:tocminheads]] * [[config:maxtoclevel]] * [[config:maxseclevel]] * [[config:camelcase]] * [[config:deaccent]] * [[config:useheading]] * [[config:refcheck]] * **Authenticatie-instellingen** * [[config:useacl]] * [[config:autopasswd]] * [[config:authtype]] * [[config:passcrypt]] * [[config:defaultgroup]] * [[config:superuser]] * [[config:manager]] * [[config:profileconfirm]] * [[config:rememberme]] * [[config:registernotify]] * [[config:disableactions]] * [[config:sneaky_index]] * [[config:auth_security_timeout]] * [[config:securecookie]] * ** Anti-spaminstellingen ** * [[config:usewordblock]] * [[config:relnofollow]] * [[config:indexdelay]] * [[config:mailguard]] * [[config:iexssprotect]] * ** Pagina-wijzigingsinstellingen ** * [[config:usedraft]] * [[config:htmlok]] * [[config:phpok]] * [[config:notify]] * [[config:subscribers]] * [[config:locktime]] * [[config:cachetime]] * ** Link-instellingen ** * [[config:target|target (wiki, interwiki, extern, media, windows)]] * ** Media-instellingen ** * [[config:gdlib]] * [[config:im_convert]] * [[config:jpg_quality]] * [[config:fetchsize]] * ** Geavanceerde instellingen ** * [[config:updatecheck]] * [[config:userewrite]] * [[config:useslash]] * [[config:sepchar]] * [[config:canonical]] * [[config:fnencode]] * [[config:autoplural]] * [[config:mailfrom]] * [[config:compress]] * [[config:cssdatauri]] * [[config:gzip_output]] * [[config:hidepages]] * [[config:send404]] * [[config:compression]] * [[config:sitemap]] * [[config:rss_type]] * [[config:rss_linkto]] * [[config:rss_content]] * [[config:rss_update]] * [[config:recent_days]] * [[config:rss_show_summary]] * [[config:broken_iua]] * [[config:xsendfile]] * [[config:remote]] * [[config:remoteuser]] * [[config:renderer_xhtml]] * [[config:readdircache]] * ** Netwerkinstellingen ** * [[config:proxy|proxy (host, port, user, pass, ssl)]] * [[config:safemodehack]] * [[config:ftp|ftp (host, port, user, pass, root)]]