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… :-)

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
logiciel:internet:dokuwiki:plugins:confmanager:start [2022/08/25 14:46] – modification externe 127.0.0.1logiciel:internet:dokuwiki:plugins:confmanager:start [2022/10/01 23:26] (Version actuelle) – modification externe 127.0.0.1
Ligne 1: Ligne 1:
 +{{tag>Logiciel}}
  
 +====== confmanager : gérer divers fichiers .conf ======
 +
 +  * Plugin pour gérer divers fichiers .conf
 +  * Fournit Admin, Action, Remote
 +  * Repository :
 +    * [[https://github.com/cosmocode/confmanager/|Source]]
 +    * [[https://github.com/cosmocode/confmanager/zipball/master|Téléchargement]]
 +
 +===== 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.
 +
 +<code php >
 +<?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;
 +        }
 +    }
 +}
 +</code>
 +
 +=== 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.
 +<code - >
 +$scheme = new ConfigManagerSingleLineCoreConfig('<name>');
 +$acronyms = new ConfigManagerTwoLineCascadeConfig('<name>');
 +$mime = new ConfigManagerTwoLineLeftImageConfigCascade('<name>', '<image path>', '<image extension>');
 +</code>
 +
 +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éé.
 +
 +<code - >$config = new ConfigManagerTwoLine('<Title>', '<Description>', '<Config path>');</code>
 +
 +===== 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 =====
 +
 +  * **(en)** [[https://www.dokuwiki.org/plugin:confmanager]]
 +
 +----
 +//Basé sur << [[https://www.dokuwiki.org/plugin:confmanager|confmanager Plugin]] >> par Dominik Eckelmann, Julian Heise, Michael Große.//