Il pannello di amministrazione è l’interfaccia di editing inclusa con un sito EmDash. È servito dall’applicazione Astro su /_emdash/admin/ e utilizza lo stesso database, archiviazione media, modello di contenuto e estensioni delle pagine pubbliche.
La prima visita alla route di amministrazione di un nuovo sito apre la procedura guidata di configurazione. Dopo la configurazione, i permessi di un utente che ha effettuato l’accesso determinano quali contenuti e strumenti di amministrazione sono disponibili.
Aree di lavoro
La navigazione si adatta alle collezioni e alle estensioni installate del sito. Queste sono le aree principali che un editore o amministratore può vedere:
| Area | A cosa serve |
|---|---|
| Dashboard | Una vista iniziale con widget del sito e delle estensioni |
| Nomi di collezioni, come Post | Elencare, creare, modificare, pubblicare e spostare le voci nel cestino |
| Gruppi di collezioni | Cartelle richiudibili che contengono collezioni che condividono un gruppo, più tassonomie assegnate solo alle collezioni in quella cartella |
| Media | Caricare, cercare, ispezionare, sostituire ed eliminare file |
| Tassonomie e Firme | Organizzare i contenuti e gestire gli autori accreditati |
| Menu e Aree Widget | Gestire la navigazione e le regioni controllate dall’editore renderizzate dal sito |
| Commenti | Rivedere e moderare i commenti quando una collezione li abilita |
| Tipi di Contenuto | Creare collezioni e campi e modificarne le impostazioni |
| Estensioni | Installare, configurare e aprire pagine fornite dalle estensioni |
| Impostazioni | Configurare il sito, autenticazione, backup, trasferimento sito, email, ricerca e altri servizi |
Questa interfaccia gestisce dati e configurazione. Le pagine e i componenti Astro definiscono ancora il layout pubblico. L’aggiunta di una voce di menu o widget nell’admin modifica il sito pubblico solo quando un componente Astro interroga e renderizza quel menu o area widget.
Editor di contenuti
L’editor di contenuti costruisce il suo modulo dalla collezione selezionata. Un campo di testo breve diventa un input di testo, un campo portableText diventa l’editor di testo ricco, un campo media apre il selettore multimediale e un campo di riferimento consente all’editore di selezionare un’altra voce. Le impostazioni della collezione aggiungono controlli di pubblicazione, anteprima, revisione, commento e ricerca dove applicabile.
L’editor di testo ricco supporta intestazioni, elenchi, citazioni, codice, link, immagini e blocchi personalizzati registrati. Se il contenuto importato contiene un blocco che l’editor non può visualizzare, EmDash conserva il blocco memorizzato anziché rimuoverlo durante il prossimo salvataggio.
Salvare e pubblicare sono stati separati per le collezioni con bozze. Salva memorizza il lavoro corrente come bozza. Pubblica o Pubblica modifiche rende quella versione salvata disponibile per le query pubbliche. La pianificazione registra quando una bozza o una modifica in sospeso dovrebbe diventare pubblica.
Quando il blocco di modifica è abilitato per una collezione, l’apertura di una voce mantiene un blocco per quell’editore. Altri scrittori vengono rifiutati mentre il blocco è attivo invece di sovrascrivere silenziosamente la voce. Se una voce cambia dopo che un editore l’ha caricata, EmDash rifiuta anche il salvataggio obsoleto in modo che l’editore possa ricaricare la versione più recente invece di sovrascriverla.
Ruoli e permessi
EmDash include cinque ruoli: Abbonato, Contributore, Autore, Editore e Admin. I permessi aumentano man mano che il livello di ruolo aumenta, ma la proprietà conta ancora per le azioni di contenuto e media. Ad esempio, gli Autori possono modificare e pubblicare le proprie voci, mentre gli Editori possono farlo per qualsiasi voce.
Le aree amministrative hanno controlli dei permessi separati:
- Gli Editori possono gestire tassonomie, menu, firme, widget, sezioni e contenuti di altri autori.
- Gli Admin possono modificare il modello di contenuto, utenti, estensioni, reindirizzamenti, backup e impostazioni, possono esportare o importare l’intero sito e possono eliminare definitivamente i contenuti cestinati.
- Il server controlla i permessi per ogni azione. Nascondere una voce di navigazione non è il confine di sicurezza.
Leggi Autenticazione e ruoli utente per la configurazione dell’account e le descrizioni complete dei ruoli.
Media
La libreria multimediale può mostrare i file in una griglia o lista, cercarli e filtrarli, visualizzare i metadati ed eseguire azioni multi-elemento. Il comportamento di caricamento dipende dall’adattatore di archiviazione configurato. Quando l’adattatore supporta caricamenti firmati, il browser invia il file all’archiviazione utilizzando un URL firmato di breve durata e quindi conferma il caricamento completato con EmDash.
L’eliminazione di un elemento multimediale può influenzare le voci che vi fanno riferimento. Usa le informazioni sull’utilizzo dei media e gli strumenti di sostituzione prima di rimuovere un asset utilizzato su pagine pubbliche. Consulta Libreria multimediale per i flussi di lavoro di caricamento, sostituzione ed eliminazione.
Interfacce delle estensioni
Le estensioni possono aggiungere widget della dashboard, sezioni delle impostazioni, controlli dell’editor o pagine di amministrazione complete. Una pagina di estensione è montata sotto la propria route di amministrazione di quella estensione; non può sostituire una schermata di amministrazione principale. L’estensione ha ancora bisogno di controlli dei permessi lato server per qualsiasi azione protetta, anche quando il link di amministrazione viene mostrato solo a un ruolo particolare.
Leggi Installazione delle estensioni per aggiungere un’estensione. Gli sviluppatori di siti che costruiscono un’interfaccia dovrebbero utilizzare le API di amministrazione delle estensioni native invece di modificare l’applicazione di amministrazione principale.
Requisiti di configurazione
L’admin è un’applicazione React, quindi il progetto Astro deve installare @astrojs/react, react e react-dom e registrare react() in astro.config.mjs. Il sito ha anche bisogno di output server, un database e archiviazione media. Aggiungere EmDash a un progetto Astro esistente mostra la configurazione locale completa.