El Administrador de Configuracion permite a los administradores cambiar las opciones de configuración del wiki en línea desde el confort de su navegador web favorito.

Este plugin viene incluído en DokuWiki y no necesita ser instalado separadamente. El Administrador de Configuración es accesible desde la página de administrador (Ingrese como superusuario, haga click en “Administrar” y escoja “Parámetros de Configuración”).

Las configuraciones se muestran con diferentes fondos para mostrar su estado actual. Se utiliza un fondo azul para mostrar valores por defecto (conf/dokuwiki.php), o sea, valores que no han sido modificados por el usuario. Un fondo blanco indica cambios locales (conf/local.php). Un fondo color rojo claro muestra configuraciones protegidas (conf/local.protected.php) que no pueden ser modificadas.

On saving changed settings this plugin will copy the current local settings file (conf/local.php) to conf/local.php.bak and save the updated settings to conf/local.php. It will never make any changes to the default settings stored in conf/dokuwiki.php. However, any settings found in conf/local.php will override the default settings as explained in the configuration options page.

The plugin adds the following lines to the top of conf/local.php when it updates it:

/*
 * DokuWiki's Main Configuration File - Local Settings 
 * Auto-generated by config plugin 
 * Run for user: <username>
 * Date: <current date/time, rfc 2822 format (day, dd MMM YYYY hh:mm:ss TZ)>
 */

You can protect certain settings by placing them in conf/local.protected.php. This plugin adds the following line to the bottom of conf/local.php —

@include(DOKU_CONF.'local.protected.php');

— thereby ensuring the protected settings are included and will override any previously set values from conf/dokuwiki.php and conf/local.php. Any settings found in this file will be displayed by the plugin surrounded in light-red to indicated their protected status. Editing of protected values is disabled.

To be able to save the configuration data, the file permissions of conf/local.php and conf/local.php.bak need to be writable by the webserver, as well as the configuration directory itself. Refer to permissions on details how set file permissions on various systems.

When the plugin detects that the config file can not be written, it will show a message box at the top of the page that says

  "The settings file can not be updated, if this is unintentional,
 ensure the local settings file name and permissions are correct."

When this happens, the save button won't be shown.