# Plugin-Hub verwenden

Im [öffentlichen Plugin-Hub](/plugins) findest du veröffentlichte Plugin-Definitionen. Eine Definition enthält Datenmodelle, Ansichten und Abläufe. Deine eigenen Kontakte und andere Datensätze gehören nicht zum veröffentlichten Paket.

## Ein Plugin finden und installieren

1. Öffne den [Hub](/plugins). Die öffentliche Suche ist ohne Anmeldung erreichbar, sofern der Betreiber sie freigeschaltet hat.
2. Suche nach einem Begriff und grenze bei Bedarf Kategorie, Sprache oder Schlagwort ein. Du kannst auch nach Neuheit oder Bewertung sortieren.
3. Öffne einen Treffer. Lies **Was dieses Plugin enthält**, die Rollen und Berechtigungen, die Version sowie **Herkunft und Paket** mit Lizenz und Namensnennung.
4. Wähle **Diese Version installieren**. Melde dich an; für die Installation brauchst du Eigentümer- oder Administratorrechte in der Organisation.
5. Öffne das Plugin unter [Plugins verwalten](/account/plugins) und lege den ersten Eintrag an.

Du erhältst eine unabhängige Kopie genau dieser Version. Eine Installation erteilt keinen Zugriff auf Datensätze des Herausgebers oder anderer Nutzer. Plugin-Inhalte teilst du über ihre eigene Zugriffsverwaltung.

Die mit meinKontext bereitgestellten Plugins aktivierst du ebenfalls unter **Plugins verwalten**. Ihre [eigenen Anleitungen](/docs#plugins) erklären die jeweiligen Abläufe. Ein aus dem Konfigurator veröffentlichtes Plugin installierst du über seine Hub-Seite.

## Privat, organisationsintern oder öffentlich

| Gewünschte Nutzung | Vorgehen |
| --- | --- |
| Nur selbst verwenden | Erstelle im [Konfigurator](/docs/plugin-builder) eine Version und verwende sie. Eine Hub-Veröffentlichung ist dafür nicht nötig. |
| In deiner Organisation teilen | Wähle bei der Veröffentlichung **Nur meine Organisation**. Aktuelle Mitglieder finden sie im [internen Hub](/account/plugins/hub). |
| Öffentlich anbieten | Wähle **Öffentlicher Hub — nach Prüfung** und reiche die Version zur Moderation ein. Erst nach Freigabe erscheint sie öffentlich. |

Die Sichtbarkeit betrifft die Definition. Echte Datensätze, Mitgliedschaften und Zugangsdaten werden nicht mitveröffentlicht. Auch ein organisationsinternes Plugin teilt keine Datensätze automatisch.

## Eine eigene Version veröffentlichen

1. Erstelle eine Version im [Konfigurator](/account/plugins/build). Unter **Plugin verwenden → Versionen und Veröffentlichung** folgst du dem Link, der diese Version im Hub veröffentlicht.
2. Prüfe die angezeigten Modelle, Ansichten, Aktionen und Rollen.
3. Wähle die Sichtbarkeit. Ergänze Titel, Beschreibung, Herausgebername, Lizenz und bei Bedarf Schlagwörter, Kategorie, Sprache oder Quellnachweis.
4. Bestätige, dass du die Definition geprüft hast und unter der gewählten Lizenz teilen darfst. Wähle **Veröffentlichung einreichen**.

Öffentliche Einreichungen können auf deiner Instanz noch gesperrt sein. Die Seite zeigt das an; eine private Nutzung bleibt davon getrennt. Neue Versionen brauchen eine eigene Veröffentlichung. Bei importierten Plugins bleiben die mitgelieferte Lizenz und Herkunft erhalten.

## Bewerten und Probleme melden

Nach einer erfolgreich ausgeführten Aktion in genau dieser installierten Version kannst du auf ihrer öffentlichen Hub-Seite **Eigene Erfahrung bewerten** öffnen. Vergib einen bis fünf Sterne und optional einen Kommentar. Du kannst deine Bewertung später ändern; pro Nutzer gibt es eine Bewertung. Eigene Plugins kannst du nicht bewerten. Die private Vorschau allein gilt nicht als Nutzung einer Installation.

Unter **Problem melden** beschreibst du einen Fehler oder ein Problem mit einer öffentlichen Veröffentlichung. Die Meldung geht an die Moderation der Instanz.

## Eine installierte Version aktualisieren

Eine neue Veröffentlichung verändert deine Installation nicht automatisch. Öffne die [Update-Prüfung](/account/plugins/upgrade), wähle dein Plugin und die gewünschte Version. Prüfe die Änderungen und die Zahl der betroffenen Datensätze, bevor du **Geprüftes Update anwenden** bestätigst.

Diese Version unterstützt bestimmte ergänzende Änderungen. Ein neues Pflichtfeld braucht einen passenden festen Wert für bestehende Datensätze. Feldlöschungen, Änderungen bestehender Auswahloptionen, hinzugefügte oder entfernte Datenmodelle und Änderungen an Workflows oder Ereignissen werden als Update abgelehnt. Ändern sich Daten oder Rechte seit der Vorschau, erstelle eine neue Prüfung. Ein allgemeiner Rücksprung auf ältere Versionen ist nicht vorgesehen.

Zieht ein Herausgeber eine Veröffentlichung zurück, bleibt deine installierte Kopie erhalten. Sperrt die Moderation eine betroffene Version, können ihre Aktionen blockiert sein; berechtigtes Lesen und Exportieren bleiben möglich.

## Definition oder Datensätze exportieren

**Definition mit Lizenz herunterladen** auf der Hub-Seite liefert das wiederverwendbare Plugin-Paket. Du kannst es unter **Einstellungen → Import / Export** im Konfigurator einer kompatiblen Instanz importieren. Das Paket enthält keine echten Datensätze, Freigaben oder Verbindungen. Ein eigener abgeleiteter Entwurf braucht eine freie Kennung und behält die Herkunft des Originals.

**Datensätze exportieren** in einem installierten Plugin liefert dagegen die Datensätze des gewählten Plugin-Inhalts, soweit du sie lesen darfst. Prüfe vor dem Weitergeben, welchen der beiden Exporte du erstellt hast.

## Wenn etwas fehlt

Prüfe bei einer internen Veröffentlichung deine aktuelle Organisationsmitgliedschaft. Fehlt die Installationsberechtigung, wende dich an Eigentümer oder Administratoren deiner Organisation. Ist die öffentliche Einreichung gesperrt, muss der Betreiber zunächst die Veröffentlichung und Moderation freischalten. Fehlende Datensätze können an fehlenden Rechten, Filtern oder der gewählten Seite liegen; eine erneute Installation erweitert diese Rechte nicht.
