Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement… :-)

confmanager : gérer divers fichiers .conf

Pré-requis

Installation

Recherchez et installez le plugin confmanager à l'aide du gestionnaire d'extensions.

Configuration

Utilisation du gestionnaire de configuration pour votre propre plugin

Vous pouvez utiliser ConfManager avec votre propre plugin.

Le plugin ConfManager prend en charge différents types de fichiers de configuration décrits ci-dessous.

Pour ajouter la configuration, vous devez ajouter un composant d'action qui s'accroche à l'événement CONFMANAGER_CONFIGFILES_REGISTER.

Vous pouvez ajouter votre fichier de configuration au tableau $event→data.

L'exemple suivant montre l'utilisation du type de configuration ConfigManagerTwoLine.

<?php
 
class action_plugin_docsearch_confmanager extends DokuWiki_Action_Plugin {
 
    public function register(Doku_Event_Handler $controller) {
        $controller->register_hook('CONFMANAGER_CONFIGFILES_REGISTER', 'BEFORE',  $this, 'addConfigFile', array());
    }
 
    public function addConfigFile(Doku_Event $event, $params) {
        if (class_exists('ConfigManagerTwoLine')) {
            $config = new ConfigManagerTwoLine('My Config', 'Description of my plugin', DOKU_INC . 'path to my config');
            $event->data[] = $config;
        }
    }
}

Types de configuration en cascade

Le ConfManager prend en charge certains formats de configuration utilisés par DokuWiki.

DokuWiki utilise le tableau global $config_cascade pour obtenir le chemin d'accès au fichier de configuration.

Les types de configuration suivants sont disponibles :

Nom de la classe Description
ConfigManagerSingleLineCoreConfig Chaque ligne est une option de configuration.
Les valeurs de configuration sont un tableau.
C'est la configuration de la liste noire.
ConfigManagerTwoLineCascadeConfig Chaque ligne est une option de configuration.
Le premier mot de la ligne est une clé de configuration.
La configuration est un tableau associatif. C'est la configuration des abréviations
ConfigManagerTwoLineLeftImageConfigCascade Comme ConfigManagerTwoLineCascadeConfig mais avec prise en charge d'image.
Une image peut être attribuée à chaque touche. C'est à dire. la config mime
ConfigManagerTwoLineLeftImageConfigCascade Comme ConfigManagerTwoLineCascadeConfig mais avec prise en charge d'image.
Une image peut être attribuée à chaque touche. C'est la configuration du mime

Le code suivant montre comment créer une instance de chaque type de configuration à partir du tableau ci-dessus.

Notations utilisées :

<name>
Nom de la configuration dans le tableau $config_cascade.
<image path>
Chemin à partir de DOKU_INC vers le dossier d'images.
<image extension>
Extension des images à utiliser. Les icônes utilisent png.
$scheme = new ConfigManagerSingleLineCoreConfig('<name>');
$acronyms = new ConfigManagerTwoLineCascadeConfig('<name>');
$mime = new ConfigManagerTwoLineLeftImageConfigCascade('<name>', '<image path>', '<image extension>');

Ces trois types de configuration ont tous les méthodes suivantes pour fournir des informations supplémentaires:

setName (string)
Le nom du fichier de configuration. Ceci est indiqué dans la liste déroulante et en titre.
setDescription (string)
Un texte de description pour expliquer le fichier de configuration. Le balisage DokuWiki est autorisé.

Type de configuration ConfigManagerTwoLine

Le type de configuration ConfigManagerTwoLine stocke un tableau associatif comme la configuration des abréviations.

Le code suivant montre comment créer une instance du type de configuration ConfigManagerTwoLine.

Codes utilisés :

<Title> (string)
nom du fichier de configuration qui s'affiche dans la liste déroulante et en titre.
<Description> (string)
texte de description du fichier de configuration. Le balisage DokuWiki est autorisé.
<Config path> (string)
Chemin absolu vers le fichier de configuration. Si le fichier n'est pas présent, il sera créé.
$config = new ConfigManagerTwoLine('<Title>', '<Description>', '<Config path>');

Utilisation

Vous pouvez utiliser ce plugin pour éditer plusieurs fichiers *.conf depuis le répertoire conf via le menu d'administration de DokuWiki.

Désinstallation

Voir aussi


Basé sur « confmanager Plugin » par Dominik Eckelmann, Julian Heise, Michael Große.

QR Code
QR Code confmanager : gérer divers fichiers .conf (generated for current page)