Il registro dei plugin è il catalogo supportato per i plugin sandbox. Chiunque può esplorare i plugin pubblicati su plugins.emdashcms.com. Gli amministratori possono esaminarli e installarli dalla sezione Registry del pannello di amministrazione EmDash.
EmDash utilizza il registro ospitato su https://registry.emdashcms.com per impostazione predefinita quando il sito ha un sandbox dei plugin abilitato.
Nomi pubblici dei plugin
Ogni plugin del registro ha un nome pubblico formato dall’handle dell’account Atmosphere corrente del suo editore e dal suo slug del pacchetto. Ad esempio, un pacchetto con lo slug my-gallery pubblicato da example.com appare come @example.com/my-gallery.
Il nome pubblico appare nei risultati del registro e sotto Plugins dopo l’installazione. Selezionalo per aprire la pagina dei dettagli del plugin, o incolla il nome completo nella ricerca del registro per trovare quel pacchetto esatto. EmDash risolve l’handle nell’identificatore di account stabile dell’editore prima di caricare il pacchetto.
Se l’handle smette di risolversi in modo conclusivo all’editore, EmDash visualizza INVALID HANDLE e impedisce nuove installazioni dalla pagina dei dettagli del pacchetto. Le installazioni esistenti rimangono nel loro stato corrente in modo che una ricerca di identità non possa disabilitare un sito in esecuzione. Esamina il plugin installato e contatta il suo editore prima di aggiornarlo. Un errore temporaneo di ricerca visualizza l’identificatore dell’editore stabile con Handle unavailable invece di segnalare un handle non valido.
Abilitare le installazioni del registro
Per installare plugin dal registro, configura lo storage e un runner sandbox disponibile. Completa prima la configurazione del sandbox dei plugin specifica della piattaforma.
Aggiungi il runner sandbox Cloudflare alla configurazione emdash() in astro.config.mjs:
import { defineConfig } from "astro/config";
import { sandbox } from "@emdash-cms/cloudflare";
import emdash from "emdash/astro";
export default defineConfig({
integrations: [
emdash({
sandboxRunner: sandbox(),
}),
],
});
EmDash visualizza il catalogo Registry dopo che il runner sandbox è configurato. Consulta il riferimento di configurazione registry per selezionare un aggregatore diverso, impostare la politica del registro o disabilitare la scoperta.
Installare un plugin del registro
- Apri Registry nel pannello di amministrazione.
- Cerca per titolo, descrizione o un nome pubblico completo come
@example.com/my-gallery, quindi apri la pagina dei dettagli del plugin. - Seleziona una versione e esamina il suo editore, metadati, permessi richiesti e stato di verifica.
- Seleziona Install.
- Esamina lo stato di verifica e i permessi nel dialogo di consenso, quindi conferma.
Prima di mostrare il dialogo di consenso, EmDash verifica il checksum, il nome, la versione e i permessi del bundle scaricato. Se l’editore richiede la provenienza della build, EmDash verifica anche queste prove. L’installazione si interrompe se una verifica fallisce. Il dialogo di consenso mostra lo stato di verifica e i permessi esatti prima dell’installazione.
Gli aggiornamenti del registro ripetono queste verifiche. Un aggiornamento attende conferma quando aggiunge permessi o strumenti MCP, o cambia una route da autenticata a pubblica. La disinstallazione rimuove il bundle e conserva i dati di archiviazione del plugin a meno che non selezioni Also delete plugin storage data. Consulta Installazione di plugin per i passaggi condivisi di aggiornamento e disinstallazione.
Pagine correlate
- Interrogare il registro documenta il client sperimentale di scoperta di sola lettura.
- Pacchettizzazione e pubblicazione copre la pubblicazione di un plugin sandbox.
- Capacità e sicurezza descrive il modello di permessi del sandbox.