Système de plugin

Le système de plugin de Koha vous permet d’ajouter à Koha des outils et des rapports supplémentaires spécifiques à votre bibliothèque. Les plugins s’installent en téléchargeant les packages KPZ (Koha Plugin Zip). Un fichier KPZ est simplement un fichier 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 plugins d’outils et sur la page Rapports, vous verrez les plugins de rapports.

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.