Plugin-System

Kohas Plugins erlauben es, zusätzliche Tools und Reports in Koha verfügbar zu machen, die speziell auf die Bedürfnisse Ihrer Bibliothek ausgerichtet sind. Plugins werden durch Upload einer KPZ-Datei (Koha Plugin Zip) installiert. Eine KPZ-Datei ist ein gepacktes Verzeichnis mit den benötigten Perldateien, Templates und weiteren benötigten Dateien, die für das Plugin benötigt werden.

Warnung

Für Plugins gibt es in der Koha-Community keinen Qualitätssicherungsprozess. Jedes Plugin wird durch den Ersteller/die Erstellerin und die Beitragenden gewartet. Verwenden Sie Plugins auf eigene Verantwortung.

Das Plugin-System muss von einem Systemadministrator aktiviert werden.

Konfiguration

Um das Plugin-System zu aktivieren, müssen zunächst einige Änderungen an Ihrer Installation vorgenommen werden.

  • Ändern Sie <enable_plugins>0</enable_plugins> zu <enable_plugins>1</enable_plugins> in der Datei koha-conf.xml

  • Starten Sie den Webbrowser neu

Unter Werkzeuge werden Sie die Werkzeug-Plugins und unter Reports die Report-Plugins finden.

Ein Plugin-Repository einrichten

In der Datei koha-conf.xml finden Sie das Element <plugin_repos>. Dieses Element wird verwendet, um git-Repositorien für die Suche nach Plugins in Koha zu konfigurieren.

Jedes Repository wird in einem <repo>-Element aufgelistet. Innerhalb des Elements finden sich alle Informationen zum Repository.

  • :code:`<name>`ist der Name des Herstellers oder des Individuums, der das Repository gehört.

  • :code:`<org_name>`ist der Benutzername des Herstellers oder Individuums innerhalb der git-Plattform.

  • <service> ist die git-Plattform, auf der das Repository gehostet wird.

In der Standardkonfiguration sind bereits mehrere Repositories verfügbar. Einzelne oder alle können auskommentiert werden.

<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>

Plugins installieren und verwenden

Informationen zur Installation und zur Verwendung von Plugins finden Sie unter Administration > Plugins in diesem Handbuch.