Système de plugin

Le système de plugin de Koha permet d’ajouter des outils et des rapports supplémentaires à Koha qui sont spécifiques à votre bibliothèque. Les plugins s’installent en téléchargeant des fichiers KPZ (Koha Plugin Zip). Ce sont simplement des fichiers zip contenant les fichiers perl, les fichiers de templates et tout les autres fichiers nécessaires au fonctionnement du plugin.

Avertissement

Il n’y a pas de processus de contrôle des plugins par la communauté Koha. Chaque plugin est maintenu et testé par ses fournisseur et contributeurs. Utilisez les plugins à vos propres risques.

Le système de plugin doit être activé par l’administrateur du système.

Configuration

Pour configurer le système de plugin de Koha, vous devez d’abord effectuer des changements dans votre installation.

  • Changez <enable_plugins>0</enable_plugins> en <enable_plugins>1</enable_plugins> dans votre fichier koha-conf.xml

  • Redémarrer votre serveur web

Sur la page Outils, vous verrez les Extensions d’outils et sur la page Bilans et statistiques, vous verrez les Extensions de rapport.

Installer un dépôt de plugin

Dans le fichier koha-conf.xml, il devrait y avoir un champ <plugin_repos>. Ce champ est utile pour signaler à Koha dans quels dépôts git rechercher des plugins.

Chaque dépôt individuel est dans un champ <repo>. A l’intérieur de ce champ, se situent les informations sur le dépôt.

  • <name> est le nom de la société ou de l’individu à qui appartient le dépôt.

  • <org_name> est l’identifiant de la société ou de l’individu sur le service git.

  • <service> est la plateforme git hébergeant le dépôt.

Plusieurs dépôts sont disponibles dans le fichier de configuration par défaut. Vous pouvez en éliminer un ou tous.

<plugin_repos>
  <repo>
    <name>ByWater Solutions</name>
    <org_name>bywatersolutions</org_name>
    <service>github</service>
  </repo>
  <repo>
    <name>Theke Solutions</name>
    <org_name>thekesolutions</org_name>
    <service>gitlab</service>
  </repo>
  <repo>
    <name>PTFS Europe</name>
    <org_name>ptfs-europe</org_name>
    <service>github</service>
  </repo>
   <repo>
     <name>Solutions inLibro</name>
     <org_name>inLibro</org_name>
     <service>github</service>
 </repo>
   -->
</plugin_repos>

Installer et utiliser des plugins

Consultez la section Plugins du chapitre Administration de ce manuel pour savoir comment installer et utiliser des plugins dans Koha.