Plugins
Überblick
Praktisch jeder Fachbereich dieses Systems ist ein Plugin — Angebote, Rechnungen, Projekte, Lager, Zeiterfassung. Diese Seite verwaltet sie: installieren, aktivieren, deaktivieren, deinstallieren.
Das ist keine Nebenfläche, sondern der Hauptschalter für den Funktionsumfang. Was hier deaktiviert ist, gibt es für alle nicht: keine Menüpunkte, keine Schnittstellen-Endpunkte, keine Hintergrundläufe, keine Auswertungen. Ein deaktiviertes Modul ist wirklich aus, nicht nur ausgeblendet.
Kernaufgaben
Den Bestand überblicken. Die Liste zeigt je Plugin Icon, Namen, Vertrauensstufe und Status. Die Stufen sind First-Party (vom Hersteller), Verifizierter Partner und Community — sie sagen, wie weit Sie einem Paket trauen können, bevor Sie es installieren.
Aktivieren und deaktivieren. Der Zustandswechsel wirkt sofort und für alle Nutzer.
Sichtbarkeit auf Marken und Rollen beschränken. Auf der Detailseite eines Plugins legt der Abschnitt Sichtbarkeit fest, für wen ein aktives Modul da ist — etwa um es erst in einer Marke oder für eine Abteilung einzuführen. Wer nicht dazugehört, sieht das Modul nicht im Menü und erreicht weder seine Seiten noch seine Schnittstelle noch die KI-Werkzeuge (MCP). Die Marken-Auswahl gilt auch im Kundenportal über die Marke des Kunden: Portal-Nutzer anderer Marken sehen das Modul dort nicht. Ohne Auswahl gilt es für alle, wie bisher. In der Liste trägt ein so beschränktes Modul das Kennzeichen beschränkt.
Aus dem Marktplatz installieren. Marktplatz öffnet den Katalog. Nicht erworbene kostenpflichtige Erweiterungen führen zum Kauf beim Anbieter, erworbene lassen sich direkt installieren. Ist kein Marktplatz eingerichtet, sagt die Seite das und bietet den Upload an.
Eigenes Paket hochladen. Plugin hochladen nimmt ein .zip-Paket entgegen. Wichtig: Ein hochgeladenes Plugin wird deaktiviert installiert. Sie schalten es danach bewusst frei. Die Installation läuft im Hintergrund; bei größeren Paketen erscheint das Ergebnis erst nach einer Aktualisierung der Liste.
Fähigkeiten prüfen, bevor ein Fremd-Modul läuft. Ein Modul, das nicht vom Hersteller stammt, muss in seinem Paket erklären, was es darf: welche Adressen im Internet es ansprechen will, ob es auf die Datei-Ablage zugreift, auf welche Ereignisse anderer Module es hört und welche fremden Rechte es Rollen zuteilt. Die Detailseite zeigt im Abschnitt Fähigkeiten die Erklärung neben dem, was das Modul tatsächlich nutzt; die Liste der Ordner-Pakete nennt die Erklärung schon vor der Installation. Nutzt ein Fremd-Modul mehr als erklärt, lässt es sich weder installieren noch einschalten — die Meldung nennt jede Abweichung mit Fundstelle. Module des Herstellers brauchen keine Erklärung.
Netzzugriffe sind abgesichert. Jedes Modul — auch eines des Herstellers — erreicht das Netz nur über einen geprüften Ausgang: nur http und https, keine Cloud-Metadaten-Adressen, jede Weiterleitung wird erneut geprüft, bei Fremd-Modulen nur die erklärten Ziele. Adressen im eigenen Netz erreichen nur Module des Herstellers und verifizierte Partner. Ein abgewiesener Aufruf verhält sich für das Modul wie ein Netzausfall.
Verifizierte Partner festlegen. Ob ein Fremd-Modul als Verifizierter Partner gilt, entscheiden Sie — kein Paket kann sich das selbst bescheinigen. Auf der Detailseite schaltet Als verifizierten Partner führen (nach einer Rückfrage) die Stufe ein, Partner-Status entziehen wieder aus. Ein Partner wird direkt in die Anwendung eingebaut und darf Adressen im eigenen Netz ansprechen; die Oberfläche wird dafür im Hintergrund neu gebaut. Seine Fähigkeiten muss er trotzdem erklären. Jede Änderung steht im Audit-Log. Module des Herstellers tragen ihre Stufe fest.
Oberflächen unverifizierter Fremd-Module laufen abgeschirmt. Ein hochgeladenes oder per Composer eingespieltes Modul ohne Partner-Status wird nicht in die Anwendung eingebaut. Bringt es eine eigene Oberfläche mit, erscheint sie im Menü unter Erweiterungen (und über Oberfläche öffnen auf der Detailseite) in einem abgeschirmten Rahmen: Sie sieht weder Ihre Anmeldung noch andere Daten und erreicht nur die eigene Schnittstelle des Moduls — mit Ihren Rechten.
Deinstallieren mit Wahl. Beim Deinstallieren entscheiden Sie, ob die Daten des Plugins erhalten bleiben oder mit entfernt werden. Behaltene Daten nimmt eine spätere Neuinstallation wieder auf. Diese Wahl ist der Grund, warum Deinstallieren kein Einbahnweg ist — aber auch der Punkt, an dem ein Fehlgriff endgültig wird.
Starter-Pakete und Module freischalten
Nicht jedes Haus braucht jedes Modul. Ein Starter-Paket legt fest, mit welchen Modulen Sie arbeiten; alle übrigen bleiben installiert, sind aber aus. Die Karte Starter-Paket oben auf dieser Seite zeigt das gewählte Paket.
Die Pakete.
| Paket | Module an |
|---|---|
| Agentur | CRM, Projekte, Zeiterfassung, Tickets, Angebote, Faktura, Abrechnung, Verträge, Reporting, Wissen |
| Dienstleister | CRM, Angebote, Aufträge, Faktura, Abrechnung, Verträge, Zeiterfassung, Termine, Reporting |
| Handel | Produkte, Lieferanten, Waren-Einkauf, Aufträge, Faktura, Versand, Reporting |
| Support | Tickets, Wissen, CRM, Verträge, Termine, Reporting |
| Alles | jedes installierte Modul |
Kunden, Kontakte, Aufgaben, Dateien, Kalender, Suche und Hilfe gehören zum Kern und sind in jedem Paket an. Eine bestehende Installation arbeitet mit Alles — durch die Einführung der Pakete schaltet sich nichts ab. Eine neue Installation startet ebenfalls mit Alles, bis Sie ein Paket wählen.
Paket wechseln. Paket wechseln zeigt die Pakete als Kacheln. Wählen Sie eines, nennt die Vorschau, welche Module dabei ein- und welche ausgeschaltet werden. Bestätigen schaltet in einem Schritt. Es ändern sich nur die Schalter der Module — alle Daten bleiben erhalten. Ein ausgeschaltetes Modul ist aus, nicht gelöscht: schalten Sie es wieder an, ist alles wieder da. Lässt sich ein einzelnes Modul nicht schalten (etwa weil ein anderes Modul widerspricht), nennt die Meldung es; die übrigen werden trotzdem geschaltet.
Module freischalten. Der Marktplatz beginnt mit Mehr freischalten: alle installierten Module, die gerade aus sind. Jede Karte nennt den Nutzen des Moduls und seine Voraussetzungen — mit welchen anderen Modulen es zusammenarbeitet und was danach noch einzurichten ist. Aktivieren schaltet das Modul mit einem Klick an; das gewählte Paket bleibt dabei unverändert.
Mit Beispieldaten. Ist das Kästchen gesetzt, lädt das Freischalten die Beispieldaten des Moduls nach — damit Sie sofort sehen, wie es aussieht. Das geht nur, wenn die Beispiel-Firma geladen ist und das Modul noch keine eigenen Daten enthält. Sonst ist das Kästchen gesperrt und nennt den Grund; Ihre Daten werden nie mit Beispielen vermischt.
Was noch fehlt. Ein Modul meldet selbst, was ihm zum Loslegen fehlt — die Faktura etwa den Absender für Rechnungen, die Rechnungsnummern und das Zahlungsziel, der Versand einen angebundenen Versanddienstleister, die Zeiterfassung einen Stundensatz. In der Liste trägt ein aktives Modul dann das Kennzeichen Einrichtung: n (offene Schritte); auf seiner Detailseite steht im Abschnitt Einrichtung je Lücke eine Kachel mit Konfigurieren. Der Schritt ist ein Feld: Absender-Adresse, nächste laufende Rechnungsnummer, Zahlungsziel in Tagen oder Stundensatz. Wo Zugangsdaten gebraucht werden (Versand), führt der Schritt zur Einrichtungs-Seite. Dieselbe Frage kommt an der Stelle, an der es fehlt: wer eine Rechnung senden will, bevor die Marke einen Absender hat, bekommt das eine Feld statt einer Fehlermeldung — und danach geht es direkt weiter zum Versand. Wer den Schritt nicht ausführen darf, sieht, dass die Administration ihn einrichtet.
Felder im Detail
Die Übersicht zeigt Module und bietet Handlungen. Eingaben gibt es nur im Abschnitt Sichtbarkeit der Detailseite; was ein Modul fachlich einstellt, steht in dessen eigener Einstellungsseite.
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Marken visibleBrandIds | nein | Auswahl aus den Marken, leer = alle | Das Modul gilt nur für Nutzer mit einer Mitgliedschaft in einer der gewählten Marken. Eine markenübergreifende Mitgliedschaft passt zu jeder Marke. Im Kundenportal zählt die Marke des Portal-Zugangs (bei der Einladung die Marke des Kunden); ein Zugang ohne Marke sieht nur unbeschränkte Module. |
Rollen visibleRoleIds | nein | Auswahl aus den Rollen, leer = alle | Das Modul gilt nur für Nutzer mit einer der gewählten Rollen. Sind Marken und Rollen gewählt, muss eine Mitgliedschaft beides erfüllen — Rolle aus der einen, Marke aus der anderen Mitgliedschaft zählt nicht. Im Kundenportal wirkt die Rollen-Auswahl nicht — Portal-Nutzer haben keine Rollen. |
Die Beschränkung ist ein Sichtbarkeits-Tor, kein Datenfilter. Wer das Modul sieht, sieht darin weiterhin genau das, was seine Rechte je Marke erlauben. Sie wirkt für angemeldete Mitarbeiter und — über die Marke des Kunden — im Kundenportal (Menü, Seiten und Portal-Schnittstelle antworten dort wie bei einem abgeschalteten Modul). Automationen und Hintergrund-Läufe sehen ausschließlich den Hauptschalter aktiviert/deaktiviert.
| Angabe | Woher | Was sie bedeutet |
|---|---|---|
| Modul | installierte Module | Name, Symbol und Kurzbeschreibung. |
| Version | Modul | Welcher Stand installiert ist. |
| Zustand | Modul-Schalter | Ein oder aus. |
| Angabe | Woher | Was sie bedeutet |
|---|---|---|
Fähigkeiten — erklärt capabilities.declared | capabilities in der plugin.json des Pakets | Netz-Ziele (z. B. api.example.com, *.example.com), Datei-Ablage, fremde Ereignisse, fremde Rechte. Leer heißt: das Modul darf nichts davon. |
Fähigkeiten — genutzt capabilities.used | aus dem eingebauten Modul ermittelt | Was das Modul wirklich verwendet. |
Nicht erklärt capabilities.violations | Vergleich beider Seiten | Jede Abweichung mit Fundstelle. Solange eine Zeile steht, lässt sich ein Fremd-Modul nicht installieren oder einschalten. |
Vertrauensstufe trustTier | Hersteller-Liste bzw. Ihre Partner-Freigabe | First-Party (Hersteller), Verifizierter Partner (von Ihnen freigegeben) oder Community. Die Angabe im Paket selbst zählt nicht. |
| Handlung | Was sie bewirkt |
|---|---|
| Einschalten | Macht das Modul vollständig verfügbar: Menüpunkte, Rechte, Hintergrund-Verarbeitung, Schnittstelle. |
| Ausschalten | Blendet es vollständig aus — Seiten, Schnittstelle und Hintergrund-Verarbeitung. Die Daten bleiben unberührt und kommen beim Einschalten zurück. Das ist der Unterschied zu deinstallieren. |
| Deinstallieren | Entfernt das Modul. Sie werden gefragt, ob die Daten behalten oder gelöscht werden sollen. Behalten heißt: Eine spätere Neuinstallation nimmt sie wieder auf. Gelöscht ist gelöscht. |
Ein ausgeschaltetes Modul ist wirklich aus. Es gibt keine halb offene Tür: Auch die Schnittstelle antwortet dann nicht mehr, und eine Automation, die auf das Modul zielt, läuft ins Leere statt heimlich weiterzuarbeiten.
Einstellungen & Rechte
- Recht
platform.plugin.manage. Ohne dieses Recht sind Verwaltung, Marktplatz und Detailseite
nicht erreichbar. Dasselbe Recht pflegt die Sichtbarkeit.
- Recht
platform.setup.manage. Starter-Paket wählen und wechseln sowie Module unter *Mehr
freischalten* anschalten (mit Beispieldaten). Ohne dieses Recht fehlen Karte und Abschnitt.
- Einrichtungs-Schritte am Recht des Schritts. Den Absender richtet ein, wer Marken pflegen darf
(platform.brand.manage, in dieser Marke), Rechnungsnummern und Zahlungsziel, wer die Einstellungen pflegt (platform.settings.manage), den Stundensatz, wer Tätigkeiten pflegt (time.category.manage).
- Recht
platform.plugin.trust. Nur wer es hat, vergibt oder entzieht den Partner-Status — auch der
Umweg über die allgemeinen Einstellungen ist ohne dieses Recht gesperrt.
- Keine Ausnahme für Administratoren. Die Sichtbarkeit richtet sich nach Marke und Rolle, auch
für Sie. Die Verwaltung selbst bleibt immer erreichbar — eine zu enge Auswahl lässt sich hier jederzeit zurücknehmen.
- Plugin-Module erscheinen nicht bei den Feature-Flags. Sie werden hier ein- und ausgeschaltet,
nicht unter System & Feature-Flags.
- Jedes Plugin bringt eigene Rechte mit. Nach dem Aktivieren erscheinen sie unter
Rollen & Rechte — zunächst nicht vergeben.
- Deaktivierung wirkt fail-closed. Im Zweifel bleibt eine Fläche verborgen, statt zu erscheinen
und dann zu scheitern.
FAQ & Fehlerbilder
Ein hochgeladenes Plugin taucht nicht auf. Die Installation läuft im Hintergrund. Aktualisieren Sie die Liste; erscheint es weiterhin nicht, ist die Installation fehlgeschlagen und die Meldung nennt den Grund.
Nach dem Aktivieren fehlen die neuen Menüpunkte. Prüfen Sie Ihre Rechte: Ein neues Plugin vergibt niemandem automatisch Befugnisse. Die Rechte müssen einer Rolle zugewiesen werden.
Ein Kollege sieht ein aktives Modul nicht. Prüfen Sie auf der Detailseite den Abschnitt Sichtbarkeit: Gehört er zu keiner der gewählten Marken oder Rollen, ist das Modul für ihn ausgeblendet — auch über die Schnittstelle. Erst danach die Rechte seiner Rolle.
Ein Fremd-Modul lässt sich nicht einschalten — „nutzt Fähigkeiten, die es nicht erklärt". Das Paket verwendet mehr, als seine plugin.json unter capabilities angibt. Der Abschnitt Fähigkeiten nennt jede Abweichung. Abhilfe schafft nur ein korrigiertes Paket des Anbieters — die Erklärung lässt sich in der Oberfläche bewusst nicht übersteuern.
Ein Modul meldet „Netzaufruf abgewiesen". Das Ziel ist eine Metadaten-Adresse, bei einem Fremd-Modul nicht erklärt oder liegt im eigenen Netz, das nur Module des Herstellers und verifizierte Partner erreichen. Soll ein geprüftes Fremd-Modul ins eigene Netz, führen Sie es als verifizierten Partner.
Nach dem Paket-Wechsel fehlen Daten eines Moduls. Sie fehlen nicht — das Modul ist nur aus. Unter Mehr freischalten schalten Sie es wieder an, und alles ist wie zuvor. Ein Paket-Wechsel löscht nie Daten.
„Mit Beispieldaten" ist gesperrt. Entweder ist die Beispiel-Firma nicht geladen, das Modul bringt keine Beispieldaten mit, oder es enthält schon eigene Daten. Der Grund steht neben dem Kästchen.
Der Marktplatz ist leer. Dann ist er nicht eingerichtet. Der Weg über den Paket-Upload bleibt nutzbar.
Wir haben versehentlich mit Datenlöschung deinstalliert. Die Plugin-Daten sind dann fort. Der Papierkorb greift hier nicht — nur eine Sicherung hilft. Deshalb bei der Deinstallation die Wahl bewusst treffen.