Le Gestionnaire de configuration permet aux administrateurs de modifier facilement, directement depuis leur navigateur Internet, la configuration du wiki, ainsi que d'autres paramètres pour les extensions installées et le thème installé. Cette extension est fournie avec DokuWiki et n'a pas besoin d'être installée séparément.

Les paramètres de configuration sont accessibles depuis le panneau d'administration. Connectez-vous en tant que super utilisateur, cliquez sur Administrer puis sur Paramètres de configuration.

Les paramètres possèdent différentes couleurs pour refléter leur statut :

• un fond bleu indique une valeur par défaut (conf/dokuwiki.php) eg. les valeurs non modifiées par l'utilisateur.
• un fond blanc indique que le paramètre a été changé (conf/local.php)
• un fond rouge indique que ce paramètre est protégé et ne peut être modifié (conf/local.protected.php)

Modifier les paramètres selon vos besoins et sauver la configuration en cliquant sur Enregistrer en bas de page, en appuyant sur 'Entrée' dans une zone de texte ou en utilisant les touches d'accès rapide de votre navigateur : <touche_accès> + S

Quand vous sauvegardez la configuration, l'extension copie le fichier de configuration local (conf/local.php) dans un fichier conf/local.php.bak puis sauvegarde les paramètres mis à jour dans conf/local.php. Il ne modifiera jamais les réglages par défaut stockés dans conf/dokuwiki.php. Cependant, tout réglage présent dans le fichier conf/local.php aura la priorité sur les réglages par défaut, comme expliqué dans la page sur la configuration de DokuWiki.

L'extension ajoute automatiquement les lignes suivantes au début du fichier conf/local.php chaque fois qu'il le met à jour :

conf/local.php

/*
 * 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)>
 */

Vous pouvez protéger certains paramètres en les plaçant dans le fichier conf/local.protected.php (créer ce fichier s'il n'existe pas).

Par défaut, DokuWiki charge ses fichiers de configuration dans cet ordre :

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

Ceci assure que les paramètres protégés prendront le dessus sur ceux présents dans conf/dokuwiki.php et conf/local.php. Tout paramètre se trouvant dans ce dernier sera entouré de rouge dans le Gestionnaire de configuration, indiquant que leur statut est verrouillé. Il est alors impossible de les modifier depuis le Gestionnaire.

L'ordre de chargement des fichiers de configuration est contrôlé par la variable globale $config_cascade depuis la version 2009-02-14 de DokuWiki.

conf/local.protected.php

<?php
/**
 * Protected settings
 * Do override DokuWiki default settings and local settings from Config Manager
 */
$conf['useacl'] = 1;

Dans la version 2008-05-05 et précédentes, cette extension est utilisée pour ajouter la ligne suivante au bas de conf/local.php pour charger les paramètres protégés.

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

Pour que l'extension puisse sauvegarder vos réglages, les fichiers conf/local.php et conf/local.php.bak doivent être accessibles en écriture pour le serveur, ainsi que le répertoire de configuration lui-même. Consultez la page des permissions pour apprendre comment régler ces permissions (valables pour différents systèmes).

Quand l'extension détecte qu'elle ne peut pas écrire dans le fichier de configuration, un message d'information apparaîtra en haut de page, indiquant que les paramètres ne peuvent être modifiés. En outre, le bouton Enregistrer sera masqué.

Certains champs de la page de configuration montrent:

• Un signe d'avertissement jaune (), ou
• Un point d'exclamation dans un cercle rouge (), ou
• Le dessin d'un cadenas ()

Voici la signification de ces trois symboles :
Marque jaune ⇒ changer cette option peut entraîner des comportements indésirables.
Cercle rouge ⇒ changer cette option pourrait rendre votre wiki et le menu de configuration inaccessibles.
Cadenas ⇒ la modification de cette option peut présenter un risque de sécurité.

S'il vous plaît, soyez vigilant quand vous modifiez ces champs.