E EmDash CMS Everything Guides, use cases, plugins, templates
Deutsch

Das Plugin-Registry

Auf dieser Seite

Das Plugin-Registry ist der unterstützte Katalog für Sandbox-Plugins. Jeder kann veröffentlichte Plugins unter plugins.emdashcms.com durchsuchen. Administratoren können sie im Registry-Bereich des EmDash-Admin-Panels überprüfen und installieren.

EmDash verwendet standardmäßig das gehostete Registry unter https://registry.emdashcms.com, wenn die Site eine aktivierte Plugin-Sandbox hat.

Plugin-öffentliche Namen

Jedes Registry-Plugin hat einen öffentlichen Namen, der sich aus dem aktuellen Atmosphere-Account-Handle des Publishers und seinem Paket-Slug zusammensetzt. Beispielsweise erscheint ein Paket mit dem Slug my-gallery, das von example.com veröffentlicht wurde, als @example.com/my-gallery.

Der öffentliche Name erscheint in Registry-Ergebnissen und unter Plugins nach der Installation. Wählen Sie ihn aus, um die Plugin-Detailseite zu öffnen, oder fügen Sie den vollständigen Namen in die Registry-Suche ein, um genau dieses Paket zu finden. EmDash löst den Handle auf die stabile Account-ID des Publishers auf, bevor das Paket geladen wird.

Wenn der Handle endgültig nicht mehr auf den Publisher zurückauflöst, zeigt EmDash INVALID HANDLE an und verhindert neue Installationen von der Paket-Detailseite. Bestehende Installationen bleiben in ihrem aktuellen Zustand, sodass eine Identitätsprüfung keine laufende Site deaktivieren kann. Überprüfen Sie das installierte Plugin und kontaktieren Sie seinen Publisher, bevor Sie es aktualisieren. Ein temporärer Lookup-Fehler zeigt die stabile Publisher-ID mit Handle unavailable anstatt einen ungültigen Handle zu melden.

Registry-Installationen aktivieren

Um Plugins aus dem Registry zu installieren, konfigurieren Sie Speicher und einen verfügbaren Sandbox-Runner. Führen Sie zuerst die plattformspezifische Plugin-Sandbox-Einrichtung durch.

Fügen Sie den Cloudflare-Sandbox-Runner zur emdash()-Konfiguration in astro.config.mjs hinzu:

import { defineConfig } from "astro/config";
import { sandbox } from "@emdash-cms/cloudflare";
import emdash from "emdash/astro";

export default defineConfig({
	integrations: [
		emdash({
			sandboxRunner: sandbox(),
		}),
	],
});

EmDash zeigt den Registry-Katalog an, nachdem der Sandbox-Runner konfiguriert wurde. Siehe die registry-Konfigurationsreferenz, um einen anderen Aggregator auszuwählen, Registry-Richtlinien festzulegen oder die Entdeckung zu deaktivieren.

Ein Registry-Plugin installieren

  1. Öffnen Sie Registry im Admin-Panel.
  2. Suchen Sie nach Titel, Beschreibung oder einem vollständigen öffentlichen Namen wie @example.com/my-gallery und öffnen Sie dann die Detailseite des Plugins.
  3. Wählen Sie ein Release aus und überprüfen Sie Publisher, Metadaten, angeforderte Berechtigungen und Verifizierungsstatus.
  4. Wählen Sie Install.
  5. Überprüfen Sie Verifizierungsstatus und Berechtigungen im Zustimmungsdialog und bestätigen Sie dann.

Bevor der Zustimmungsdialog angezeigt wird, prüft EmDash die Prüfsumme, den Namen, die Version und die Berechtigungen des heruntergeladenen Bundles. Wenn der Publisher Build-Provenance erfordert, verifiziert EmDash auch diese Nachweise. Die Installation stoppt, wenn eine Prüfung fehlschlägt. Der Zustimmungsdialog zeigt den Verifizierungsstatus und die genauen Berechtigungen vor der Installation an.

Registry-Updates wiederholen diese Prüfungen. Ein Update wartet auf Bestätigung, wenn es Berechtigungen oder MCP-Tools hinzufügt oder eine Route von authentifiziert auf öffentlich ändert. Das Deinstallieren entfernt das Bundle und bewahrt Plugin-Speicherdaten, es sei denn, Sie wählen Also delete plugin storage data aus. Siehe Plugins installieren für die gemeinsamen Update- und Deinstallationsschritte.

Verwandte Seiten