Open Source Dokumentenmanagement
Dokumentation

Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > Übersicht tags

agorum core plugin manager

Über den agorum core plugin manager verwalten Sie Ihre Plugins in agorum core. Sie können Plugins:

Hinweis: Der agorum core plugin manager steht dem Super-Administrator roi standardmäßig zur Verfügung. Sie können den plugin manager auch für andere Benutzer / Administratoren freischalten. Tragen Sie dazu den zu berechtigenden Benutzer in folgende ACL ein:

ACL_acpluginmanager_agorum.acpluginmanager_pluginInstaller

Symbole

Die nachfolgend aufgeführten Symbole begegnen Ihnen in agorum core, wenn Sie mit Plugins arbeiten:

Plugin-/Paket-Bereich

agorum core plugin manager öffnen

  1. Klicken Sie links in der Seitenleiste auf Plugins verwalten.

    Ergebnis: Der agorum core plugin manager öffnet sich.

Aufbau des agorum core plugin managers

Aufbau des agorum core plugin managers
  1. Übersicht der Plugins
    Enthält eine Übersicht der zur Verfügung stehenden und installierten Plugins sowie Plugins, die Sie aktualisieren können.
  2. Informationen über das Plugin
    Wählen Sie mit einem Mausklick ein Plugin, erscheinen rechts eine Beschreibung und im Bereich links oben je nach Status des Plugins folgende Schaltflächen:

    • installieren
    • erneut installieren
    • aktualisieren
    • deinstallieren

    Unterhalb der Informationen zu einem gewählten Plugin werden nach Klick auf die oben genannten Schaltflächen Logs zum jeweiligen Plugin angezeigt. Diese Logs sind nur solange sichtbar, wie das Plugin installiert, aktualisiert oder deinstalliert wird. Das Log verschwindet danach wieder.

Ein Plugin installieren

Installieren Sie ein Plugin immer zuerst auf einem Testsystem, sofern Sie es ausprobieren möchten.

  1. Wählen Sie das Plugin, das Sie installieren möchten.

    Bei manchen Plugins wird eine Lizenz vorausgesetzt. Sie müssen bei diesen Plugins einen Haken für eine gültige Lizenz oder eine Testlizenz setzen, bevor Sie den nächsten Schritt durchführen können.
  2. Klicken Sie bei den Informationen über das Plugin auf installieren.
  3. Bestätigen Sie die Warnmeldung.

    Ergebnis: Das System installiert das gewählte Plugin.
Ein Plugin installieren

Ein Plugin erneut installieren

Haben Sie ein Plugin installiert, steht in der Übersicht der Plugins die installierte Versionsnummer einschließlich der Information, ob diese noch aktuell ist, zur Verfügung. Sie können das Plugin an dieser Stelle erneut installieren. Das System entfernt dabei alle bereits vorhandene Strukturen und erstellt sie neu.

  1. Wählen Sie das Plugin, das Sie erneut installieren möchten.

    Bei manchen Plugins wird eine Lizenz vorausgesetzt. Sie müssen bei diesen Plugins einen Haken für eine gültige Lizenz oder eine Testlizenz setzen, bevor Sie den nächsten Schritt durchführen können.
  2. Klicken Sie bei den Informationen über das Plugin auf erneut installieren.
  3. Bestätigen Sie die Warnmeldung.

    Ergebnis: Das System installiert das gewählte Plugin erneut.
Ein Plugin erneut installieren

Die Plugin-Liste aktualisieren

Aktualisieren Sie die Plugin-Liste regelmäßig, um die Information zu erhalten, ob Updates zu installierten oder neue Plugins vorliegen.

So aktualisieren Sie die Plugin-Liste:

  1. Klicken Sie links in der Übersicht über Plugins auf Plugin-Liste aktualisieren (Internet).

    Ergebnis: Das System lädt die Bedienoberfläche neu und zeigt die aktualisierten Informationen an.
Die Plugin-Liste aktualisieren

Hinweis: Wenn Sie auf die Schaltfläche Plugin-Liste aktualisieren (Internet) klicken und der agorum core-Server zu diesem Zeitpunkt keine Internetverbindung hat, kann die Plugin-Liste nicht aktualisiert werden. Ein entsprechender Hinweis mit einem Link erscheint. Diesen Link können Sie kopieren, um die Plugins auf einem anderen PC mit Internetverbindung manuell als ZIP-Paket herunterzuladen und auf den agorum core-Server zu kopieren.

Ein Plugin aktualisieren

Überprüfen Sie regelmäßig, ob es eine neue Version eines Plugins gibt. Darin enthalten sind Bugfixes, Neuerungen und Änderungen. Alle Dokumentationen zu Plugins beziehen sich zudem immer auf die neueste Plugin-Version.

Nachdem Sie die Plugin-Liste aktualisiert haben, erscheint in der Spalte update ein Eintrag mit update, wenn Ihre Plugin-Version veraltet ist.

Veraltete Plugins

So aktualisieren Sie ein Plugin:

  1. Wählen Sie ein Plugin, das in der Spalte update einen Eintrag aufweist.

    Bei manchen Plugins wird eine Lizenz vorausgesetzt. Sie müssen bei diesen Plugins einen Haken für eine gültige Lizenz oder eine Testlizenz setzen, bevor Sie den nächsten Schritt durchführen können.
  2. Klicken Sie bei den Informationen über das Plugin auf aktualisieren.
  3. Bestätigen Sie die Warnmeldung.

    Ergebnis: Das System aktualisiert das gewählte Plugin.
Ein Plugin aktualisieren

Ein Plugin deinstallieren

Sie benötigen die jeweils aktuelle Version eines Plugins, um es deinstallieren zu können. Aktualisieren Sie das Plugin, sofern es nicht aktuell ist.

So deinstallieren Sie ein Plugin:

  1. Wählen Sie links in der Liste ein Plugin.
  2. Klicken Sie bei den Informationen auf deinstallieren.

     
    Plugin im agorum core plugin manager deinstallieren


    Ergebnis: Ein Dialog öffnet sich.
  3. Wählen Sie links in der Liste einen Eintrag.

    Ergebnis:
    • Rechts erscheint eine Beschreibung dessen, was bei einer Deinstallation genau gelöscht wird. Die Beschreibung kann Ihr Administrator individuell festlegen.
    • Der Haken bei Testmodus aktiv ist standardmäßig gesetzt und verhindert, dass das System das gewählte Plugin direkt deinstalliert. Stattdessen führt das Log nur auf, was das System deinstalliert, wenn Sie die Deinstallation ausführen. Möchten Sie das Plugin direkt deinstallieren, entfernen Sie den Haken.

    Tipp: Ihr Administrator / Entwickler kann definieren, was bei einer Deinstallation eines Plugins gelöscht wird. Diese Definition führt er in der Uninstall-Datei des Plugins durch.

     

    Folgende Unterscheidungen kann der Administrator / Entwickler etwa vornehmen:


    • Sichtbare Daten des Plugins deinstallieren, sodass das Plugin nicht mehr als solches zu sehen ist, die Daten dazu aber bestehen bleiben.

    • Komplettes Plugin deinstallieren: Das System entfernt die Sichtbarkeit des Plugins und alle Daten zum Plugin.

    • Nur einen Teil des Plugins deinstallieren, etwa ein Workflow von mehreren Workflows.

  4. Klicken Sie auf Deinstallieren.

     
    Gewähltes Plugin deinstallieren
  5. Bestätigen Sie die Abfrage zum Deinstallieren.

    Ergebnis (bei inaktivem Testmodus): Das System deinstalliert das markierte Plugin und lädt eine ZIP-Datei auf den lokalen Rechner herunter. Die ZIP-Datei können Sie etwa dazu verwenden, um nach der Deinstallation das gelöschte Plugin wieder zu installieren. Eine solche Sicherung befindet sich außerdem zusätzlich im Ordner Eigene Dateien/Administration/workspace/agorum.uninstall.manager/save.

    Ergebnis (bei aktivem Testmodus): Das System deinstalliert das markierte Plugin nicht. Es lädt eine ZIP-Datei auf den lokalen Rechner herunter. Die ZIP-Datei können Sie etwa dazu verwenden, um nach der Deinstallation das gelöschte Plugin wieder zu installieren. Eine solche Sicherung befindet sich zudem zusätzlich im Ordner Eigene Dateien/Administration/workspace/agorum.uninstall.manager/save.

Beschreibung der Spalten in der Plugin-Auswahl

Spalte Beschreibung
Plugin Definiert den Namen des Plugins.

Taucht hier ein Plugin mehrmals unter demselben Namen auf, handelt es sich etwa um verschiedene Deinstallationsschritte. Etwa löscht diese Deinstallation nur einen Teil eines Plugins, etwa nur einen Workflow.
Version Definiert die Version des Plugins.
Dateiname Definiert den Namen des Deinstallationsschrittes.

Ein Administrator definiert diesen Namen. Er kann etwa eine Deinstallation, bei der immer der Testmodus aktiviert ist, mit uninstall-test betiteln.
Name Definiert den Namen des Projekts, das zum Plugin gehört.

Ein Plugin deaktivieren

Neben dem Deinstallieren von Plugins können Sie Plugins deaktivieren. Verwenden Sie dazu die Aktion agorum core smart assistant Add-ons aktiv / inaktiv schalten des agorum core template managers.

Verwenden Sie ein Plugin, das auch Ordner anlegt, etwa das agorum core basic archive, können Sie diese Ordner nur anhand von Berechtigungen oder manuellem Löschen aus dem System entfernen. Beim manuellen Löschen dieser Ordner verbleiben jedoch Altdaten im System, etwa Benutzergruppen und ACLs.