PicApport Add-on Guide

Was ist ein Add-on?

Add-ons wurden in PicApport Version 9 eingeführt und ermöglichen es, die Funktionalität von PicApport zu erweitern. Einsatzszenarios sind:

  • Benutzen von externen Tools oder Webdiensten, um Fotos mit weiteren Metadaten anzureichern, wie z.B. automatisches Taggen usw.

  • Benutzen von externen Tools oder Webdiensten, um mit Fotos irgendetwas zu machen, wie z.B. (Upload, versenden, usw.)

  • Erweitern der PicApport-Datenbank um eigene Datenfelder wie z.B. Projektnummern, Kundennummer, usw.

  • Erweiterte Filtermöglichkeiten des PicApport internen Crawlers

Mit Erscheinen von PicApport 9 stehen bereits 8 fertige Add-ons zur Verfügung (siehe weiter unten)

Eigenschaften von Add-ons

  • Add-ons sind in der Programmiersprache Groovy erstellte Skripte welche die Funktionalität des PicApportServers erweitern

  • Alle Add-ons sind im Sourcecode installiert und können bei Bedarf angepasst werden.

  • Stand September 2020 (Version 9.0) gibt es 3 Arten von Add-ons:

    • Prozeduren (pagp)
      Die Scripte werden vom Anwender serverseitig für selektierte Fotos der Thumbnail-View aufgerufen

    • Felderweiterung der Datenbank (pagf)
      Erweitert die PicApport interne Datenbank um neue Datenfelder mit folgenden Möglichkeiten:
      • Felder können optional in der globalen Volltextsuche verfügbar gemacht werden
      • Felder können selbst als Index mit folgenden Möglichkeiten angesprochen werden:
        • Volltext mit Wildcardsupport
        • PicApport hierarchischer Index mit Wildcardsupport
        • ID-Index ohne Wildcardsupport

    • Crawlerfilter (pagc)
      Erweitert den PicApport Crawler um weitere Dateifiltermöglichkeiten.

Wie wird ein Add-on installiert?

  • Jedes Add-on wird in Form einer einzelnen ZIP-Datei bereitgestellt.
    Die Installation erfolgt durch einfaches Kopieren dieser Datei auf den Server.

  • Die Beschreibung dazu gibt es hier: PicApport Add-on Installation Guide 

Anwendung der Add-ons

Werden in der Thumbnailansicht Bilder selektiert, erscheint im üblichen Menüband ein neuer Menüpunkt „Add-ons“. Über diesen Menüpunkt können die einzelnen Add-ons ausgewählt und auf die selektierten Bilder angewendet werden.

Liste der Verfügbaren Add-on's

Add-on Referenz für Entwickler

Das Handbuch für Entwickler ist im englischsprachigen Teil unseres Wikis verfügbar: Siehe PicApport Add-on Programming Reference