Installazione Plugin

I plugin EmDash possono essere installati in due modi: dal marketplace tramite il dashboard admin, o aggiunti direttamente nella configurazione Astro. I plugin del marketplace vengono eseguiti in un sandbox isolato; i plugin basati su configurazione vengono eseguiti in-process.

Dal marketplace

Il dashboard admin include un browser del marketplace dove puoi cercare, installare e gestire i plugin.

Prerequisiti

Per installare plugin dal marketplace, il tuo sito necessita di:

1. Sandbox runner configurato — I plugin del marketplace vengono eseguiti in worker V8 isolati, che richiedono il runtime sandbox:

   import { emdash } from "emdash/astro";
   
   export default defineConfig({
     integrations: [
       emdash({
         marketplace: "https://marketplace.emdashcms.com",
         sandboxRunner: true,
       }),
     ],
   });

2. Accesso admin — Solo gli amministratori possono installare o rimuovere plugin.

Sfogliare e installare

Il plugin verrà scaricato, memorizzato nel bucket R2 del tuo sito e caricato nel sandbox runner. È attivo immediatamente.

Consenso capacità

Prima dell’installazione, vedrai un dialogo che elenca a cosa il plugin ha bisogno di accedere:

Audit di sicurezza

Ogni versione di plugin nel marketplace ha superato un audit di sicurezza automatizzato. Il verdetto dell’audit appare sulla card del plugin:

• Superato — Nessun problema trovato
• Avviso — Preoccupazioni minori segnalate (rivedi i risultati)
• Fallito — Problemi di sicurezza significativi rilevati

Puoi visualizzare il rapporto di audit completo sulla pagina di dettaglio del plugin, inclusi i singoli risultati e la loro gravità.

Aggiornamenti

Quando è disponibile una versione più recente di un plugin installato:

1. Vai a Plugin nel pannello admin
2. I plugin del marketplace mostrano un badge Aggiornamento disponibile
3. Clicca su Aggiorna per vedere il changelog e eventuali modifiche alle capacità
4. Se la nuova versione richiede capacità aggiuntive, vedrai un diff e dovrai approvare
5. Conferma per aggiornare

Disinstallazione

1. Vai a Plugin nel pannello admin
2. Clicca sul plugin del marketplace che vuoi rimuovere
3. Clicca su Disinstalla
4. Scegli se mantenere o eliminare i dati memorizzati del plugin
5. Conferma

Il codice sandbox del plugin viene rimosso dal tuo bucket R2 e smette di essere eseguito immediatamente.

Dalla configurazione

Per i plugin nativi (il tuo codice, o pacchetti installati via npm), aggiungili direttamente alla tua config Astro:

import { defineConfig } from "astro/config";
import { emdash } from "emdash/astro";
import seoPlugin from "@emdash-cms/plugin-seo";

export default defineConfig({
  integrations: [
    emdash({
      plugins: [
        seoPlugin({ generateSitemap: true }),
      ],
    }),
  ],
});

Plugin nativi:

• Vengono eseguiti in-process (non sandboxati)
• Hanno accesso completo alle API Node.js
• Vengono caricati al momento del build e a ogni avvio del server
• Non possono essere installati o rimossi dall’interfaccia admin

Marketplace vs Config: Quando usare quale