Configurando o DokuWiki

Muitos dos recursos do DokuWiki podem ser configurados por meio de várias opções de configuração. A maneira mais fácil de modificar essas opções é usando o Gerenciador de Configuração, que permite que os administradores do wiki alterem facilmente as configurações do wiki on-line a partir do conforto de seu navegador favorito.

Para iniciar o Gerenciador de Configuração, faça login como superusuário, clique em “Administrar” e escolha “Configurações do DokuWiki”.

O que pode ser configurado

As opções de “sistema” do DokuWiki serão encontradas no arquivo conf/dokuwiki.php. No entanto, este arquivo contém os valores “padrão” do sistema. Para personalizá-lo, você deve editar o arquivo conf/local.php ou criá-lo se ele não existir. Para descobrir o que você pode configurar nesse arquivo, consulte a lista de opções disponíveis.

Nomes de usuário, senhas (criptografadas) e regras de controle de acesso são armazenados nos arquivos conf/users.auth.php e conf/acl.auth.php.

Ao enviar um novo arquivo no Gerenciador de mídias, você pode encontrar a mensagem “O envio foi bloqueado. Essa extensão de arquivo é proibida!”. Este comportamento é controlado no arquivo conf/mime.conf. Para fazer upload de um novo tipo de arquivo, especifique-o no arquivo mime.local.conf.

Algumas substituições automáticas são feitas quando você edita suas páginas. Alguns geram dicas, smileys ou alguns caracteres especiais. Este comportamento é controlado por acronyms.conf, smileys.conf ou entities.conf.

Arquivos de configuração

Todos os arquivos de configuração podem ser encontrados no diretório ./conf ou /etc/dokuwiki quando instalados a partir de um pacote Debian.

Os “arquivos principais” geralmente vêm com o DokuWiki, enquanto os “arquivos locais” devem ser criados pelo administrador do wiki.

Se os arquivos locais são suportados, você deve usá-los em vez de modificar os arquivos principais para evitar que suas configurações especiais não sejam sobrescritas por uma atualização posterior.

arquivo principal	arquivo local	tipo de configuração	informação rápida
`dokuwiki.php`	`local.php` `local.protected.php`	ver abaixo	Configuração geral do wiki
`acronyms.conf`	`acronyms.local.conf`	abbreviations	Tooltips de abreviatura automática
`entities.conf`	`entities.local.conf`	entities	Substituições automáticas de texto
`interwiki.conf`	`interwiki.local.conf`	interwiki	Links de atalho interwiki
`mime.conf`	`mime.local.conf`	mime	Configurações MIME para uploads
`smileys.conf`	`smileys.local.conf`	smileys	Substituições de imagem
	`acl.auth.php`	acl	Configurações de controle de acesso
	`users.auth.php`	acl	Usuários e senhas
`license.php`	`license.local.php`	config:license	Lista de licenças disponíveis
`scheme.conf`	`scheme.local.conf`	urlschemes	Esquemas de URL a serem reconhecidos como links
`mediameta.php`	`mediameta.local.php`	exif	Metadados editáveis para imagens
`wordblock.conf`	`wordblock.local.conf`	blacklist	Lista negra de SPAM
`plugins.required.php`	`plugins.local.php` `plugins.protected.php`	ver abaixo	Ativar/Desativar plug-ins
	`userscript.js`	devel:javascript	JavaScripts presonalizados
	`userstyle.css`	devel:css	CSS personalizados
`manifest.json`	`manifest.local.json`	devel:manifest	PWA Manifest

Arquivos de configuração de tema

Arquivos de configuração adicionais são encontrados em /var/lib/dokuwiki/lib/tpl/dokuwiki (Debian), por exemplo, style.ini. Style.ini é um arquivo de texto que é lido pelo tema padrão e o usuário pode configurar, por exemplo, a cor de fundo.

Ativando/Desativando plug-ins

Os plug-ins instalados são habilitados por padrão. Eles podem ser desabilitados usando o Gerenciador de extensões, que grava no arquivo plugins.local.php. Você pode proteger certos plug-ins colocando-os em conf/plugins.protected.php.

Por padrão, o DokuWiki carrega seus arquivos de configuração na seguinte ordem:

conf/plugins.php - plug-ins padrão
conf/plugins.local.php - alterado pelo gerenciador de extensão
conf/plugins.required.php - esses plug-ins principais não podem ser controlados pelo gerenciador de extensão
conf/plugins.protected.php - sobrescreve a configuração nos outros arquivos

A ordem de carregamento dos arquivos de configuração é controlada pela variável global $config_cascade. Usando um arquivo preload.php, você pode alterar esse comportamento.

Opções de configuração

A maioria dos recursos do DokuWiki podem ser configurados por meio de várias opções de configuração. A maneira mais fácil de modificar essas opções é usando o Gerenciador de configuração.

As configurações disponíveis estão listadas aqui. Seus valores padrão são armazenados em um arquivo chamado conf/dokuwiki.php. Se você quiser modificar uma configuração, deve fazer isso em um arquivo chamado conf/local.php - isso garante que suas configurações especiais não sejam sobrescritas por uma atualização posterior. O Config Manager também usará esse arquivo. O arquivo conf/local.protected.php pode ser usado para configurações que não podem ser modificadas no Config Manager.

Aqui está um exemplo de arquivo conf/local.php:

<?php
$conf['title']     = 'Admin\'s Wiki';
 
$conf['useacl']    = 1;
$conf['superuser'] = 'admin';

Algumas notas sobre o arquivo de configuração. O arquivo é uma parte do código PHP, portanto, a sintaxe do PHP deve ser preservada. Por exemplo. cada linha deve ter um ponto e vírgula no final. Existem vários tipos de variáveis:

Os números podem ser escritos como estão. Exemplo: 9
As strings devem ser colocadas entre aspas simples ou duplas. Exemplo: 'foo bar'
Os booleanos podem ser 1 ou 0
Os arrays contêm vários valores de um dos tipos acima

Opções Disponíveis

Veja Available Options (em inglês).