Configuration Manager Plugin

The Config Manager allows wiki administrators to easily alter the wiki configuration settings online from the comfort of their favorite web browser. This plugin manages basic DokuWiki configurations as well as other settings for installed plugins and currently used template.

The Plugin is bundled with DokuWiki and does not need to be installed separately. The Config Manager is accessible from the admin screen (Login as superuser, click “Admin” and choose “Configuration Settings”).

Settings are shown with different backgrounds to highlight their current status. A blue background is used to show default values (conf/dokuwiki.php), eg. values that have not been modified by the user. A white background indicates local changes (conf/local.php). A light red background shows protected settings (conf/local.protected.php) which can not be modified.

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.

By default DokuWiki loads its configuration files in the following order:

1. conf/dokuwiki.php
2. conf/local.php
3. conf/local.protected.php

This way, it is ensured that any values previously set from conf/dokuwiki.php and conf/local.php will be overridden by protected values from conf/local.protected.php. Any settings found in conf/local.protected.php will be displayed by the plugin surrounded in light-red to indicate their protected status. Editing of protected values is disabled.

The loading order of configuration files is controlled by the global $config_cascade variable in the DokuWiki release 2009-02-14 and above. Meanwhile, in the release 2008-05-05 and below this plugin used to add the following line to the bottom of conf/local.php to load protected settings.

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

To be able to save the configuration data, the file permissions of conf/local.php needs 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.

The source code is available from Git.

Submit bugs and feature wishes in the DokuWiki Bugtracker.