Changes to "Plugins" between 2014-03-20 15:08:17 and 2014-03-20 17:06:22

    18     18   
    19     19     *  infos.ini : informations sur le plugin
    20     20     *  index.php : affiché quand on clique sur le plugin
    21     21     *  install.php (optionnel) : appelé lors de l'installation du plugin
    22     22     *  upgrade.php (optionnel) : appelé lors de la mise à jour du plugin, qu'elle soit une mise à jour vers une version supérieure ou inférieure (downgrade)
    23     23     *  uninstall.php (optionnel) : appelé lors de la suppression du plugin
    24     24     *  signals.php (optionnel) : appelé quand un signal enregistré est activé
           25  +  *  config.php (optionnel, si le plugin peut être configuré) : appelé depuis la page de configuration des plugins
           26  +  *  config.json (optionnel, si le plugin peut être configuré) : configuration par défaut du plugin
    25     27    
    26     28   <h3>Contenu de infos.ini</h3>
    27     29   
    28     30   <pre>
    29     31   nom="Nom du plugin"
    30     32   description="Description courte du plugin"
    31     33   auteur="Nom de l'auteur"
    32     34   url="URL du site du plugin"
    33     35   version="Numéro de version"
    34     36   menu=0 ; ou 1 pour qu'une sous-entrée apparaisse dans le menu des plugins
           37  +config=0 ; ou 1 pour que le plugin ait une configuration personnalisable, dans ce cas il faut fournir les fichiers config.json (configuration par défaut) et config.php (modification de la configuration par l'utilisateur)
    35     38   </pre>
    36     39   
    37     40   Ces informations sont enregistrées dans la base de données de l'association
    38     41   
    39     42   <h3>Méthodes de l'objet \Garradin\Plugin</h3>
    40     43   
    41         -  *  __construct()
           44  +  *  __construct(string $id)
    42     45     *  setConfig(string $key, string $value) : enregistre la configuration du plugin, si $value est null alors cette clé est effacée de la configuration
    43     46     *  getConfig(string $key) : récupère la valeur de la clé $key pour la configuration du plugin
    44     47     *  getInfos() : renvoie les informations enregistrées sur le plugin
           48  +  *  upgrade() : mise à jour du plugin
           49  +  *  needsUpgrade() : le plugin doit-il être mis à jour ?
           50  +  *  uninstall() : désinstaller le plugin
    45     51   
    46     52   <h2>Plugins officiels</h2>
    47     53   
    48     54   Garradin offre deux possibilités d'installer des plugins :
    49     55   
    50     56     *  simplement en copiant un fichier PHAR dans le répertoire 'plugins' de Garradin
    51     57     *  en passant par un "répertoire" officiel, sorte d'appstore des plugins Garradin